From df6a42e14454b43bec2fcfcda678d282bf09822e Mon Sep 17 00:00:00 2001
From: morganava <morganava@users.noreply.github.com>
Date: Sat, 28 Sep 2024 21:29:31 +0000
Subject: [PATCH] deploy: b9bfbeeee4f74c6527c0a0be79bf8c30be1008ed

---
 coverage.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/coverage.html b/coverage.html
index 5f688b15..5513998b 100644
--- a/coverage.html
+++ b/coverage.html
@@ -118,7 +118,7 @@
 <body>
     <div id="root"></div>
     <script>
-        var data = {"files":[{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","build.rs"],"content":"extern crate cbindgen;\nextern crate regex;\nextern crate serde;\nextern crate serde_json;\n\nuse std::fs::File;\nuse std::io::Write;\nuse std::path::PathBuf;\n\nuse regex::Regex;\nuse serde::Serialize;\n\n#[derive(Serialize)]\nstruct ConfigFlag {\n    comments: Vec\u003cString\u003e,\n    name: String,\n    enabled: bool,\n}\n\n#[derive(Serialize)]\nstruct Constant {\n    comments: Vec\u003cString\u003e,\n    name: String,\n    value: usize,\n}\n\n#[derive(Serialize)]\nstruct Alias {\n    comments: Vec\u003cString\u003e,\n    name: String,\n    typename: String,\n}\n\n#[derive(Serialize)]\nstruct Param {\n    name: String,\n    typename: String,\n}\n\n#[derive(Serialize)]\nstruct Function {\n    comments: Vec\u003cString\u003e,\n    name: String,\n    return_param: String,\n    input_params: Vec\u003cParam\u003e,\n}\n\n#[derive(Serialize)]\nstruct Data {\n    config_flags: Vec\u003cConfigFlag\u003e,\n    constants: Vec\u003cConstant\u003e,\n    aliases: Vec\u003cAlias\u003e,\n    callbacks: Vec\u003cFunction\u003e,\n    functions: Vec\u003cFunction\u003e,\n}\n\nfn preprocess_any(source: String, features: \u0026Vec\u003c\u0026str\u003e) -\u003e String {\n\n    let block_regex = Regex::new(r\"(?m)(?\u003canyblock\u003e#if \\(?(defined\\(([A-Z_]+)\\)( \\|\\| )?)+\\)?([^#]*\\n)*#endif\\n\\n)\").unwrap();\n\n    if !block_regex.is_match(\u0026source) {\n        return source;\n    }\n\n    let mut cleared_blocks: Vec\u003cString\u003e = Default::default();\n\n    let feature_regex = Regex::new(r\"defined\\((?\u003cfeature\u003e[A-Z0-9_]+)\\)\").unwrap();\n    let mut preprocessed_source = source.clone();\n    for caps in block_regex.captures_iter(source.as_str()) {\n        let anyblock = caps.name(\"anyblock\").unwrap().as_str();\n\n        let mut clear_block: bool = true;\n        for caps in feature_regex.captures_iter(anyblock) {\n            let feature = caps.name(\"feature\").unwrap().as_str();\n            if features.contains(\u0026feature) {\n                clear_block = false;\n                break;\n            }\n        }\n        if clear_block {\n            preprocessed_source = preprocessed_source.replace(\u0026anyblock, \"\");\n            cleared_blocks.push(anyblock.to_string());\n        }\n    }\n    preprocessed_source\n}\n\nfn preprocess_all(source: String, _features: \u0026Vec\u003c\u0026str\u003e) -\u003e String {\n    let block_regex = Regex::new(r\"(?m)(?\u003canyblock\u003e#if \\((defined\\(([A-Z_]+)\\)( \u0026\u0026 )?)+\\)([^#]*\\n)*#endif)\").unwrap();\n\n    if block_regex.is_match(\u0026source) {\n        panic!(\"unexpected #[cfg(all(..))]\");\n        return source;\n    }\n\n    source\n}\n\nfn preprocess_header(source: String) -\u003e String {\n    let mut features: Vec\u003c\u0026str\u003e = Default::default();\n\n    // OS features\n    #[cfg(target_os = \"windows\")]\n    features.push(\"GOSLING_PLATFORM_WINDOWS\");\n    #[cfg(target_os = \"macos\")]\n    features.push(\"GOSLING_PLATFORM_MACOS\");\n    #[cfg(target_os = \"linux\")]\n    features.push(\"GOSLING_PLATFORM_LINUX\");\n\n    // tor-provider implementations\n    #[cfg(feature = \"mock-tor-provider\")]\n    features.push(\"GOSLING_HAVE_MOCK_TOR_PROVIDER\");\n    #[cfg(feature = \"legacy-tor-provider\")]\n    features.push(\"GOSLING_HAVE_LEGACY_TOR_PROVIDER\");\n\n    let source = preprocess_any(source.to_string(), \u0026features);\n    let source = preprocess_all(source, \u0026features);\n\n    source\n}\n\nfn parse_param(params_raw: \u0026str) -\u003e Vec\u003cParam\u003e {\n    // function param\n    let param_pattern = Regex::new(r\"(?m)(?P\u003ctype\u003e(\\w+ \\**)+)(?P\u003cname\u003e\\w+)\").unwrap();\n    // pattern for our gosling structs\n    let struct_gosling_pattern = Regex::new(r\"(?m)struct (?P\u003cname\u003egosling_[\\w]+) \").unwrap();\n\n    let mut params: Vec\u003cParam\u003e = Default::default();\n    for param in param_pattern.captures_iter(params_raw) {\n        let t = \u0026param[\"type\"];\n        let t = match struct_gosling_pattern.captures(t) {\n            Some(cap) =\u003e struct_gosling_pattern.replace(t, \u0026cap[\"name\"]).to_string(),\n            None =\u003e t.to_string(),\n        };\n        let t = t.replace(\" *\", \"*\");\n        let n = \u0026param[\"name\"];\n\n        params.push(Param {\n            name: n.to_string(),\n            typename: t.trim().to_string(),\n        });\n    }\n    params\n}\n\nfn parse_header(source: \u0026str) -\u003e Data {\n    // all of the lines we cre about have this general form of muliple // style comments,\n    // followed by a single source line we care about\n    let commented_source_pattern =\n        Regex::new(r\"(?m)(?\u003ccomments\u003e(?:\\/\\/.*\\n)+)(?\u003csource\u003e.+)\").unwrap();\n    let comment_pattern = Regex::new(r\"(?m)^\\/\\/[ ]?\").unwrap();\n\n    // constant pattern\n    let constant_pattern = Regex::new(r\"^#define (?P\u003cname\u003e[A-Z0-9_]+) (?P\u003cvalue\u003e[0-9]+)$\").unwrap();\n    // primitive types\n    let typedef_pattern =\n        Regex::new(r\"^typedef (?P\u003ctype\u003e[\\w \\*]+) (?P\u003cname\u003egosling_[\\w]+);$\").unwrap();\n    // callback types\n    let callback_pattern = Regex::new(\n        r\"^typedef (?P\u003creturn\u003e[\\w \\*]+) \\(\\*(?P\u003cname\u003egosling_[\\w]+_t)\\)\\((?P\u003cparams\u003e[\\w ,\\*]*)\\);$\",\n    )\n    .unwrap();\n    // function declaration\n    let function_pattern = Regex::new(\n        r\"^(?P\u003creturn\u003e[\\w \\*]+( | \\*))(?P\u003cname\u003egosling_[\\w]+)\\((?P\u003cparams\u003e[\\w ,\\*]*)\\);$\",\n    )\n    .unwrap();\n\n    let mut config_flags: Vec\u003cConfigFlag\u003e = Default::default();\n    let mut constants: Vec\u003cConstant\u003e = Default::default();\n    let mut aliases: Vec\u003cAlias\u003e = Default::default();\n    let mut callbacks: Vec\u003cFunction\u003e = Default::default();\n    let mut functions: Vec\u003cFunction\u003e = Default::default();\n\n    config_flags.push(ConfigFlag {\n        comments: vec![\"Defined if cgosling is built with mock tor-provider support\".to_string()],\n        name: \"GOSLING_HAVE_MOCK_TOR_PROVIDER\".to_string(),\n        enabled: cfg!(feature = \"mock-tor-provider\"),\n    });\n    config_flags.push(ConfigFlag {\n        comments: vec![\"Defined if cgosling is built with legacy tor-provider support\".to_string()],\n        name: \"GOSLING_HAVE_LEGACY_TOR_PROVIDER\".to_string(),\n        enabled: cfg!(feature = \"legacy-tor-provider\"),\n    });\n\n    for commmented_source in commented_source_pattern.captures_iter(source) {\n        let comments = \u0026commmented_source[\"comments\"];\n        let comments = comment_pattern.replace_all(comments, \"\");\n        let comments = comments.trim();\n        let comments = comments.split('\\n').map(|s| s.to_string()).collect();\n\n        let source = \u0026commmented_source[\"source\"];\n\n        // try parse constant\n        if let Some(constant) = constant_pattern.captures(source) {\n            let name = constant[\"name\"].to_lowercase();\n            let value = constant[\"value\"].parse::\u003cusize\u003e().unwrap();\n            constants.push(Constant {\n                name,\n                value,\n                comments,\n            });\n        // try parse alias\n        } else if let Some(alias) = typedef_pattern.captures(source) {\n            let t = \u0026alias[\"type\"];\n            let n = \u0026alias[\"name\"];\n\n            if t == format!(\"struct {}\", n) {\n                aliases.push(Alias {\n                    name: n.to_string(),\n                    typename: \"uintptr_t\".to_string(),\n                    comments,\n                });\n            } else {\n                aliases.push(Alias {\n                    name: n.to_string(),\n                    typename: t.trim().to_string(),\n                    comments,\n                });\n            }\n        // try parse callback declaration\n        } else if let Some(callback) = callback_pattern.captures(source) {\n            let r = \u0026callback[\"return\"];\n            let n = \u0026callback[\"name\"];\n            let p = \u0026callback[\"params\"];\n\n            // move the pointer char next to the type\n            let r = r.trim().replace(\" *\", \"*\");\n\n            let params = parse_param(p);\n            callbacks.push(Function {\n                name: n.to_string(),\n                return_param: r,\n                input_params: params,\n                comments,\n            });\n        // try parse function declaration\n        } else if let Some(function) = function_pattern.captures(source) {\n            let r = \u0026function[\"return\"];\n            let n = \u0026function[\"name\"];\n            let p = \u0026function[\"params\"];\n\n            // move the pointer char next to the type\n            let r = r.trim().replace(\" *\", \"*\");\n\n            let params = parse_param(p);\n            functions.push(Function {\n                name: n.to_string(),\n                return_param: r,\n                input_params: params,\n                comments,\n            });\n        }\n    }\n\n    Data {\n        config_flags,\n        constants,\n        aliases,\n        callbacks,\n        functions,\n    }\n}\n\nfn main() {\n    if cfg!(not(feature = \"impl-lib\")) {\n        // set by cargo\n        let crate_dir = std::env::var(\"CARGO_MANIFEST_DIR\").unwrap();\n        // set by cargo\n        let profile = match std::env::var(\"PROFILE\") {\n            Ok(target) =\u003e target,\n            Err(_) =\u003e panic!(\"PROFILE not set\"),\n        };\n        // set by cmake\n        let target_dir = match std::env::var(\"CARGO_TARGET_DIR\") {\n            Ok(target) =\u003e PathBuf::from(target).join(profile),\n            Err(_) =\u003e panic!(\"CARGO_TARGET_DIR not set\"),\n        };\n\n        let header_file_path = target_dir.join(\"cgosling.h\");\n        println!(\"cargo:rerun-if-changed={}\", header_file_path.display());\n\n        // generate libgosling.h C header\n        match cbindgen::generate(\u0026crate_dir) {\n            Ok(bindings) =\u003e bindings.write_to_file(header_file_path.clone().into_os_string()),\n            Err(cbindgen::Error::ParseSyntaxError { .. }) =\u003e return, // ignore in favor of cargo's syntax check\n            Err(err) =\u003e panic!(\"{:?}\", err),\n        };\n\n        // pre-process and re-write header\n        let source = std::fs::read_to_string(header_file_path.clone()).unwrap();\n        let source = preprocess_header(source);\n        std::fs::write(header_file_path, source.clone()).unwrap();\n\n        // convert generated header to json IDL\n        let idl = parse_header(source.as_str());\n\n        // and write json IDL to disk\n        let json_file_path = target_dir.join(\"cgosling.json\");\n        println!(\"cargo:rerun-if-changed={}\", json_file_path.display());\n        let mut json_file = match File::create(json_file_path) {\n            Ok(file) =\u003e file,\n            Err(err) =\u003e panic!(\"{:?}\", err),\n        };\n        writeln!(json_file, \"{}\", serde_json::to_string_pretty(\u0026idl).unwrap()).unwrap();\n    }\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","fuzz","fuzz_targets","fuzz_cgosling.rs"],"content":"#![no_main]\n\nuse std::ffi::{c_char, c_int};\nuse std::ptr;\n\nuse libfuzzer_sys::fuzz_target;\nuse libfuzzer_sys::arbitrary;\nuse libfuzzer_sys::arbitrary::Arbitrary;\n\nuse cgosling::callbacks::*;\nuse cgosling::context::*;\nuse cgosling::crypto::*;\nuse cgosling::error::*;\nuse cgosling::ffi::*;\nuse cgosling::tor_provider::*;\nuse cgosling::utils::*;\n\n#[derive(Arbitrary, Debug)]\nenum Handle {\n    Null,\n    Valid(usize),\n    Invalid(usize),\n}\n\n#[derive(Arbitrary, Debug)]\nenum PHandle {\n    Null,\n    Valid,\n}\n\n#[derive(Arbitrary, Debug)]\nenum Callback {\n    Null,\n    Valid,\n}\n\n#[derive(Arbitrary, Debug)]\nenum Buffer\u003cT\u003e {\n    Null,\n    Valid(Vec\u003cT\u003e),\n}\n\n#[derive(Arbitrary, Debug)]\nenum Primitive\u003cT\u003e {\n    Valid(T),\n    Invalid(T),\n}\n\n#[derive(Arbitrary, Debug)]\nenum Function {\n    ErrorGetMessage{\n        error: Handle,\n    },\n    ErrorClone{\n        error_copy: PHandle,\n        orig_error: Handle,\n        out_error: PHandle,\n    },\n    ErrorFree{\n        error: Handle,\n    },\n    Ed25519PrivateKeyFree{\n        private_key: Handle,\n    },\n    X25519PrivateKeyFree{\n        private_key: Handle,\n    },\n    X25519PublicKeyFree{\n        public_key: Handle,\n    },\n    V3OnionServiceIdFree{\n        service_id: Handle,\n    },\n    IpAddressFree{\n        ip_address: Handle,\n    },\n    TargetAddressFree{\n        target_address: Handle,\n    },\n    ContextFree{\n        context: Handle,\n    },\n    TorProviderFree{\n        tor_provider: Handle,\n    },\n    LibraryInit{\n        out_library: PHandle,\n        out_error: PHandle,\n    },\n    LibraryFree{\n        library: Handle,\n    },\n    // Ed25519 Priavate Key Functions\n    Ed25519PrivateKeyGenerate{\n        out_private_key: PHandle,\n        out_error: PHandle,\n    },\n    Ed25519PrivateKeyClone{\n        out_private_key: PHandle,\n        private_key: Handle,\n        out_error: PHandle,\n    },\n    Ed25519PrivateKeyFromKeyblob{\n        out_private_key: PHandle,\n        key_blob: Buffer\u003cc_char\u003e,\n        key_blob_length: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    Ed25519PrivateKeyToKeyblob{\n        private_key: Handle,\n        out_key_blob: Buffer\u003cc_char\u003e,\n        key_blob_size: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    // X25519 Private Key Functions\n    X25519PrivateKeyClone{\n        out_private_key: PHandle,\n        private_key: Handle,\n        out_error: PHandle,\n    },\n    X25519PrivateKeyFromBase64{\n        out_private_key: PHandle,\n        base64: Buffer\u003cc_char\u003e,\n        base64_length: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    X25519PrivateKeyToBase64{\n        private_key: Handle,\n        out_base64: Buffer\u003cc_char\u003e,\n        base64_size: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    // X25519 Public Key Functions\n    X25519PublicKeyClone{\n        out_public_key: PHandle,\n        public_key: Handle,\n        out_error: PHandle,\n    },\n    X25519PublicKeyFromBase32{\n        out_public_key: PHandle,\n        base32: Buffer\u003cc_char\u003e,\n        base32_length: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    X25519PublicKeyToBase32{\n        public_key: Handle,\n        out_base32: Buffer\u003cc_char\u003e,\n        base32_size: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    // V3 Onion Service Id Functions\n    V3OnionServiceIdClone{\n        out_service_id: PHandle,\n        service_id: Handle,\n        out_error: PHandle,\n    },\n    V3OnionServiceIdFromString{\n        out_service_id: PHandle,\n        service_id_string: Buffer\u003cc_char\u003e,\n        service_id_string_length: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    V3OnionServiceIdFromEd25519PrivateKey{\n        out_service_id: PHandle,\n        ed25519_private_key: Handle,\n        out_error: PHandle,\n    },\n    V3OnionServiceIdToString{\n        service_id: Handle,\n        out_service_id_string: Buffer\u003cc_char\u003e,\n        service_id_string_size: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    StringIsValidV3OnionServiceId{\n        service_id_string: Buffer\u003cc_char\u003e,\n        service_id_string_length: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    // TorProvider Functions\n    TorProviderConfigNewMockClientConfig{\n        out_tor_provider_config: PHandle,\n        out_error: PHandle,\n    },\n    TorProviderFromTorProviderConfig{\n        out_tor_provider: PHandle,\n        tor_provider_config: Handle,\n        out_error: PHandle,\n    },\n    // Context Functions\n    ContextInit{\n        out_context: PHandle,\n        tor_provider: Handle,\n        identity_port: u16,\n        endpoint_port: u16,\n        identity_private_key: Handle,\n        out_error: PHandle,\n    },\n    ContextBootstrapTor{\n        context: Handle,\n        out_error: PHandle,\n    },\n    ContextStartIdentityServer{\n        context: Handle,\n        out_error: PHandle,\n    },\n    ContextStopIdentityServer{\n        context: Handle,\n        out_error: PHandle,\n    },\n    ContextStartEndpointServer{\n        context: Handle,\n        endpoint_private_key: Handle,\n        endpoint_name: Buffer\u003cc_char\u003e,\n        endpoint_name_length: Primitive\u003cusize\u003e,\n        client_identity: Handle,\n        client_auth_public_key: Handle,\n        out_error: PHandle,\n    },\n    ContextStopEndpointServer{\n        context: Handle,\n        endpoint_private_key: Handle,\n        out_error: PHandle,\n    },\n    ContextBeginIdentityHandshake{\n        context: Handle,\n        identity_service_id: Handle,\n        endpoint_name: Buffer\u003cc_char\u003e,\n        endpoint_name_length: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    ContextAbortIdentityClientHandshake{\n        context: Handle,\n        handshake_handle: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    ContextBeginEndpointHandshake{\n        context: Handle,\n        endpoint_service_id: Handle,\n        client_auth_private_key: Handle,\n        channel_name: Buffer\u003cc_char\u003e,\n        channel_name_length: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    ContextAbortEndpointClientHandshake{\n        context: Handle,\n        handshake_handle: Primitive\u003cusize\u003e,\n        out_error: PHandle\n    },\n    ContextPollEvents{\n        context: Handle,\n        out_error: PHandle,\n    },\n    // Callback Setters\n    ContextSetTorBootstrapStatusReceivedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetTorBootstrapCompletedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetTorLogReceivedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityClientChallengeResponseSizeCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityClientBuildChallengeResponseCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityClientHandshakeCompletedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityClientHandshakeFailedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityServerPublishedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityServerHandshakeStartedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityServerClientAllowedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityServerEndpointSupportedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityServerChallengeSizeCallack{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityServerBuildChallengeCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityServerVerifyChallengeResponseCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityServerHandshakeCompletedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityServerHandshakeRejectedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityServerHandshakeFailedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetEndpointClientHandshakeCompletedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetEndpointClientHandshakeFailedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetEndpointServerPublishedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetEndpointServerHandshakeStartedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetEndpointServerChannelSupportedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetEndpointServerHandshakeCompletedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetEndpointServerHandshakeRejectedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetEndpointServerHandshakeFailedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    // Context Utility Functions\n    ContextGenerateCircuitToken{\n        context: Handle,\n        out_error: PHandle,\n    },\n    ContextReleaseCircuitToken{\n        context: Handle,\n        circuit_token: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    // IpAddress Functions\n    IpAddressClone{\n        out_ip_address: PHandle,\n        ip_address: Handle,\n        out_error: PHandle,\n    },\n    IpAddressFromIpv4{\n        out_ip_address: PHandle,\n        a: u8,\n        b: u8,\n        c: u8,\n        d: u8,\n        out_error: PHandle,\n    },\n    IpAddressFromIpv6{\n        out_ip_address: PHandle,\n        a: u16,\n        b: u16,\n        c: u16,\n        d: u16,\n        e: u16,\n        f: u16,\n        g: u16,\n        h: u16,\n        out_error: PHandle,\n    },\n    // TargetAddress Functions\n    TargetAddressClone{\n        out_target_address: PHandle,\n        target_address: Handle,\n        out_error: PHandle,\n    },\n    TargetAddressFromIpAddress{\n        out_target_address: PHandle,\n        ip_address: Handle,\n        port: u16,\n        out_error: PHandle,\n    },\n    TargetAddressFromDomain{\n        out_target_address: PHandle,\n        domain: Buffer\u003cc_char\u003e,\n        domain_length: Primitive\u003cusize\u003e,\n        port: u16,\n        out_error: PHandle,\n    },\n    TargetAddressFromV3OnionServiceId{\n        out_target_address: PHandle,\n        service_id: Handle,\n        port: u16,\n        out_error: PHandle,\n    },\n    TargetAddressFromString{\n        out_target_address: PHandle,\n        target_address: Buffer\u003cc_char\u003e,\n        target_address_length: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n}\n\nfn handle_as_pointer\u003cT\u003e(value: Handle, handles: \u0026Vec\u003c*mut T\u003e) -\u003e *mut T {\n    let result: *mut T = match value {\n        Handle::Null =\u003e ptr::null_mut(),\n        Handle::Valid(value) =\u003e if !handles.is_empty() {\n            let index = value % handles.len();\n            handles[index]\n        } else {\n            ptr::null_mut()\n        },\n        Handle::Invalid(value) =\u003e if !handles.contains(\u0026(value as *mut T)) {\n            value as *mut T\n        } else {\n            ptr::null_mut()\n        }\n    };\n    result\n}\n\nfn handle_to_pointer\u003cT\u003e(value: Handle, handles: \u0026mut Vec\u003c*mut T\u003e) -\u003e *mut T {\n    let result: *mut T = match value {\n        Handle::Null =\u003e ptr::null_mut(),\n        Handle::Valid(value) =\u003e if !handles.is_empty() {\n            let index = value % handles.len();\n            handles.remove(index) as *mut T\n        } else {\n            ptr::null_mut()\n        },\n        Handle::Invalid(value) =\u003e if !handles.contains(\u0026(value as *mut T)) {\n            value as *mut T\n        } else {\n            ptr::null_mut()\n        },\n    };\n    result\n}\n\nfn phandle_to_out_pointer\u003cT\u003e(value: PHandle, out_pointer: *mut *mut T) -\u003e *mut *mut T {\n    match value {\n        PHandle::Null =\u003e ptr::null_mut(),\n        PHandle::Valid =\u003e out_pointer,\n    }\n}\n\nfn primitive_to_value\u003cT: Default + std::cmp::PartialEq\u003e(value: Primitive\u003cT\u003e, values: \u0026mut Vec\u003cT\u003e) -\u003e T where usize: From\u003cT\u003e{\n    match value {\n        Primitive::Valid(value) =\u003e if !values.is_empty() {\n            let index: usize = value.into();\n            let index = index % values.len();\n            values.remove(index)\n        } else {\n            Default::default()\n        },\n        Primitive::Invalid(value) =\u003e if !values.contains(\u0026value) {\n            value\n        } else {\n            Default::default()\n        }\n    }\n}\n\nfn buffer_to_size\u003cT\u003e(buffer: \u0026Buffer\u003cT\u003e, buffer_size: \u0026Primitive\u003cusize\u003e) -\u003e usize {\n    let size: usize = match (buffer, buffer_size) {\n        (Buffer::Null, Primitive::Valid(_)) =\u003e 0usize,\n        (Buffer::Null, Primitive::Invalid(value)) =\u003e *value,\n        (Buffer::Valid(buffer), Primitive::Valid(_)) =\u003e buffer.len(),\n        (Buffer::Valid(buffer), Primitive::Invalid(value)) =\u003e std::cmp::min(*value, buffer.len()),\n    };\n    size\n}\n\nfn buffer_as_pointer\u003cT\u003e(buffer: \u0026Buffer\u003cT\u003e) -\u003e *const T {\n    let pointer: *const T = match buffer {\n        Buffer::Null =\u003e ptr::null(),\n        Buffer::Valid(value) =\u003e value.as_ptr(),\n    };\n    pointer\n}\n\nfn buffer_as_mut_pointer\u003cT\u003e(buffer: \u0026mut Buffer\u003cT\u003e) -\u003e *mut T {\n    let pointer: *mut T = match buffer {\n        Buffer::Null =\u003e ptr::null_mut(),\n        Buffer::Valid(value) =\u003e value.as_mut_ptr(),\n    };\n    pointer\n}\n\nmacro_rules! impl_set_callback {\n    ($context:ident, $callback:ident, $out_error:ident, $contexts:ident, $errors:ident,$setter:ident, $func:ident) =\u003e {\n        let context = handle_as_pointer($context, \u0026$contexts);\n        let mut error: *mut GoslingError = ptr::null_mut();\n        let out_error = phandle_to_out_pointer($out_error, \u0026mut error);\n        match $callback {\n            Callback::Null =\u003e $setter(context, None, out_error),\n            Callback::Valid =\u003e $setter(context, Some($func), out_error),\n        }\n        if !error.is_null() {\n            $errors.push(error);\n        }\n    }\n}\n\n// no-op (or minimal op) callbacks for setters\n\nextern \"C\" fn bootstrap_status_received(_context: *mut GoslingContext, _progress: u32, _tag: *const c_char, _tag_length: usize, _summary: *const c_char, _summary_length: usize) {\n\n}\n\nextern \"C\" fn bootstrap_complete(_context: *mut GoslingContext) -\u003e () {\n\n}\n\nextern \"C\" fn tor_log_received(_context: *mut GoslingContext, _line: *const c_char, _line_length: usize) {\n\n}\n\nextern \"C\" fn identity_client_handshake_challenge_response_size(_context: *mut GoslingContext, _handshake_handle: usize, _challenge_buffer: *const u8, _challenge_buffer_size: usize) -\u003e usize {\n    return 0;\n}\n\nextern \"C\" fn identity_client_handshake_build_challenge_response(_context: *mut GoslingContext, _handshake_handle: usize, _challenge_buffer: *const u8, _challenge_buffer_size: usize, _out_challenge_response_buffer: *mut u8, _challenge_response_buffer_size: usize) {\n\n}\n\nextern \"C\" fn identity_client_handshake_completed(_context: *mut GoslingContext, _handshake_handle: usize, _identity_service_id: *const GoslingV3OnionServiceId, _endpoint_service_id: *const GoslingV3OnionServiceId, _endpoint_name: *const c_char, _endpoint_name_length: usize, _client_auth_private_key: *const GoslingX25519PrivateKey) {\n\n}\n\nextern \"C\" fn identity_client_handshake_failed(_context: *mut GoslingContext, _handshake_handle: usize, _error: *const GoslingError) {\n\n}\n\nextern \"C\" fn identity_server_published(_context: *mut GoslingContext) {\n\n}\n\nextern \"C\" fn identity_server_handshake_started(_context: *mut GoslingContext, _handshake_handle: usize) {\n\n}\n\nextern \"C\" fn identity_server_handshake_client_allowed(_context: *mut GoslingContext, _handshake_handle: usize, _client_service_id: *const GoslingV3OnionServiceId) -\u003e bool {\n    true\n}\n\nextern \"C\" fn identity_server_endpoint_supported(_context: *mut GoslingContext, _handshake_handle: usize, _endpoint_name: *const c_char, _endpoint_name_length: usize) -\u003e bool {\n    true\n}\n\nextern \"C\" fn identity_server_handshake_challenge_size(_context: *mut GoslingContext, _handshake_handle: usize) -\u003e usize {\n    0usize\n}\n\nextern \"C\" fn identity_server_handshake_build_challenge(_context: *mut GoslingContext, _handshake_handle: usize, _out_challenge_buffer: *mut u8, _challenge_buffer_size: usize) {\n\n}\n\nextern \"C\" fn identity_server_handshake_verify_challenge_response(_context: *mut GoslingContext, _handshake_handle: usize, _challenge_response_buffer: *const u8, _challenge_response_buffer_size: usize) -\u003e bool {\n    true\n}\n\nextern \"C\" fn identity_server_handshake_completed(_context: *mut GoslingContext, _handshake_handle: usize, _endpoint_private_key: *const GoslingEd25519PrivateKey, _endpoint_name: *const c_char, _endpoint_name_length: usize, _client_service_id: *const GoslingV3OnionServiceId, _client_auth_public_key: *const GoslingX25519PublicKey) {\n\n}\n\nextern \"C\" fn identity_server_handshake_rejected(_context: *mut GoslingContext, _handshake_handle: usize, _client_allowed: bool, _client_requested_endpoint_valid: bool, _client_proof_signature_valid: bool, _client_auth_signature_valid: bool, _challenge_response_valid: bool) {\n\n}\n\nextern \"C\" fn identity_server_handshake_failed(_cntext: *mut GoslingContext, _handshake_handle: usize, _error: *const GoslingError) {\n\n}\n\nextern \"C\" fn endpoint_client_handhsake_completed(_context: *mut GoslingContext, _handshake_handle: usize, _endpoint_service_id: *const GoslingV3OnionServiceId, _channel_name: *const c_char, _channel_name_length: usize, _stream: c_int) {\n\n}\n\nextern \"C\" fn endpoint_client_handshake_failed(_context: *mut GoslingContext,\n    _handshake_handle: usize, _error: *const GoslingError) {\n\n}\n\nextern \"C\" fn endpoint_server_published(_context: *mut GoslingContext, _endpoint_service_id: *const GoslingV3OnionServiceId, _endpoint_name: *const c_char, _endpoint_name_length: usize) {\n\n}\n\nextern \"C\" fn endpoint_server_handshake_started(_context: *mut GoslingContext, _handshake_handle: usize) {\n\n}\n\nextern \"C\" fn endpoint_server_channel_supported(_context: *mut GoslingContext,\n_handshake_handle: usize, _client_service_id: *const GoslingV3OnionServiceId, _channel_name: *const c_char, _channel_name_length: usize) -\u003e bool {\n    true\n}\n\nextern \"C\" fn endpoint_server_handshake_completed(_context: *mut GoslingContext, _handshake_handle: usize, _endpoint_service_id: *const GoslingV3OnionServiceId, _client_service_id: *const GoslingV3OnionServiceId, _channel_name: *const c_char, _channel_name_length: usize, _stream: c_int) {\n\n}\n\nextern \"C\" fn endpoint_server_handshake_rejected(_context: *mut GoslingContext, _handshake_handle: usize, _client_allowed: bool, _client_requested_channel_valid: bool, _client_proof_signature_valid: bool) {\n\n}\n\nextern \"C\" fn endpoint_server_handshake_failed(_context: *mut GoslingContext,\n    _handshake_handle: usize, _error: *const GoslingError) {\n\n}\n\n#[derive(Arbitrary, Debug)]\nstruct Data {\n    functions: Vec\u003cFunction\u003e,\n}\n\nfuzz_target!(|data: Data| {\n    let mut libraries: Vec\u003c*mut GoslingLibrary\u003e = Default::default();\n    let mut errors: Vec\u003c*mut GoslingError\u003e = Default::default();\n    let mut contexts: Vec\u003c*mut GoslingContext\u003e = Default::default();\n    let mut ed25519_private_keys: Vec\u003c*mut GoslingEd25519PrivateKey\u003e = Default::default();\n    let mut v3_onion_service_ids: Vec\u003c*mut GoslingV3OnionServiceId\u003e = Default::default();\n    let mut x25519_private_keys: Vec\u003c*mut GoslingX25519PrivateKey\u003e = Default::default();\n    let mut x25519_public_keys : Vec\u003c*mut GoslingX25519PublicKey\u003e = Default::default();\n    let mut tor_provider_configs: Vec\u003c*mut GoslingTorProviderConfig\u003e = Default::default();\n    let mut tor_providers: Vec\u003c*mut GoslingTorProvider\u003e = Default::default();\n    let mut identity_handshakes: Vec\u003cusize\u003e = Default::default();\n    let mut endpoint_handshakes: Vec\u003cusize\u003e = Default::default();\n    let mut ip_addresses: Vec\u003c*mut GoslingIpAddress\u003e = Default::default();\n    let mut target_addresses: Vec\u003c*mut GoslingTargetAddress\u003e = Default::default();\n    let mut circuit_tokens: Vec\u003cGoslingCircuitToken\u003e = Default::default();\n\n    for function in data.functions {\n        match function {\n            Function::ErrorGetMessage{error} =\u003e {\n                let error = handle_as_pointer(error, \u0026errors);\n                gosling_error_get_message(error);\n            },\n            Function::ErrorClone{error_copy, orig_error, out_error} =\u003e {\n                let mut dest: *mut GoslingError = ptr::null_mut();\n                let error_copy = phandle_to_out_pointer(error_copy, \u0026mut dest);\n                let orig_error = handle_as_pointer(orig_error, \u0026errors);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_error_clone(error_copy, orig_error, out_error) };\n                if !dest.is_null() {\n                    errors.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ErrorFree{error} =\u003e {\n                let error = handle_to_pointer(error, \u0026mut errors);\n                gosling_error_free(error);\n            },\n            Function::Ed25519PrivateKeyFree{private_key} =\u003e {\n                let private_key = handle_to_pointer(private_key, \u0026mut ed25519_private_keys);\n                gosling_ed25519_private_key_free(private_key);\n            },\n            Function::X25519PrivateKeyFree{private_key} =\u003e {\n                let private_key = handle_to_pointer(private_key, \u0026mut x25519_private_keys);\n                gosling_x25519_private_key_free(private_key);\n            },\n            Function::X25519PublicKeyFree{public_key} =\u003e {\n                let public_key = handle_to_pointer(public_key, \u0026mut x25519_public_keys);\n                gosling_x25519_public_key_free(public_key);\n            },\n            Function::V3OnionServiceIdFree{service_id} =\u003e {\n               let service_id = handle_to_pointer(service_id, \u0026mut v3_onion_service_ids);\n               gosling_v3_onion_service_id_free(service_id);\n            },\n            Function::ContextFree{context} =\u003e {\n                let context = handle_to_pointer(context, \u0026mut contexts);\n                gosling_context_free(context);\n            },\n            Function::TorProviderFree{tor_provider} =\u003e {\n                let tor_provider = handle_to_pointer(tor_provider, \u0026mut tor_providers);\n                gosling_tor_provider_free(tor_provider);\n            },\n            Function::LibraryInit{out_library, out_error} =\u003e {\n                let mut library: *mut GoslingLibrary = ptr::null_mut();\n                let out_library = phandle_to_out_pointer(out_library, \u0026mut library);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_library_init(out_library, out_error) };\n                if !library.is_null() {\n                    libraries.push(library);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::LibraryFree{library} =\u003e {\n                let library = handle_to_pointer(library, \u0026mut libraries);\n                gosling_library_free(library);\n            },\n            Function::Ed25519PrivateKeyGenerate{out_private_key, out_error} =\u003e {\n                let mut private_key: *mut GoslingEd25519PrivateKey = ptr::null_mut();\n                let out_private_key = phandle_to_out_pointer(out_private_key, \u0026mut private_key);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_ed25519_private_key_generate(out_private_key, out_error) };\n                if !private_key.is_null() {\n                    ed25519_private_keys.push(private_key);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::Ed25519PrivateKeyClone{out_private_key, private_key, out_error} =\u003e {\n                let mut dest: *mut GoslingEd25519PrivateKey = ptr::null_mut();\n                let out_private_key = phandle_to_out_pointer(out_private_key, \u0026mut dest);\n                let private_key = handle_as_pointer(private_key, \u0026ed25519_private_keys);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_ed25519_private_key_clone(out_private_key, private_key, out_error) };\n                if !dest.is_null() {\n                    ed25519_private_keys.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::Ed25519PrivateKeyFromKeyblob{out_private_key, key_blob, key_blob_length, out_error} =\u003e {\n                let mut private_key: *mut GoslingEd25519PrivateKey = ptr::null_mut();\n                let out_private_key = phandle_to_out_pointer(out_private_key, \u0026mut private_key);\n                let key_blob_length = buffer_to_size(\u0026key_blob, \u0026key_blob_length);\n                let key_blob = buffer_as_pointer(\u0026key_blob);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_ed25519_private_key_from_keyblob(out_private_key, key_blob, key_blob_length, out_error) };\n                if !private_key.is_null() {\n                    ed25519_private_keys.push(private_key);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::Ed25519PrivateKeyToKeyblob{private_key, mut out_key_blob, key_blob_size, out_error} =\u003e {\n                let private_key = handle_as_pointer(private_key, \u0026ed25519_private_keys);\n                let key_blob_size = buffer_to_size(\u0026out_key_blob, \u0026key_blob_size);\n                let out_key_blob = buffer_as_mut_pointer(\u0026mut out_key_blob);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                gosling_ed25519_private_key_to_keyblob(private_key, out_key_blob, key_blob_size, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::X25519PrivateKeyClone{out_private_key, private_key, out_error} =\u003e {\n                let mut dest: *mut GoslingX25519PrivateKey = ptr::null_mut();\n                let out_private_key = phandle_to_out_pointer(out_private_key, \u0026mut dest);\n                let private_key = handle_as_pointer(private_key, \u0026x25519_private_keys);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_x25519_private_key_clone(out_private_key, private_key, out_error) };\n                if !dest.is_null() {\n                    x25519_private_keys.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::X25519PrivateKeyFromBase64{out_private_key, base64, base64_length, out_error} =\u003e {\n                let mut private_key: *mut GoslingX25519PrivateKey = ptr::null_mut();\n                let out_private_key = phandle_to_out_pointer(out_private_key, \u0026mut private_key);\n                let base64_length = buffer_to_size(\u0026base64, \u0026base64_length);\n                let base64 = buffer_as_pointer(\u0026base64);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_x25519_private_key_from_base64(out_private_key, base64, base64_length, out_error) };\n                if !private_key.is_null() {\n                    x25519_private_keys.push(private_key);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::X25519PrivateKeyToBase64{private_key, mut out_base64, base64_size, out_error} =\u003e {\n                let private_key = handle_as_pointer(private_key, \u0026x25519_private_keys);\n                let base64_size = buffer_to_size(\u0026out_base64, \u0026base64_size);\n                let out_base64 = buffer_as_mut_pointer(\u0026mut out_base64);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                gosling_x25519_private_key_to_base64(private_key, out_base64, base64_size, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::X25519PublicKeyClone{out_public_key, public_key, out_error} =\u003e {\n                let mut dest: *mut GoslingX25519PublicKey = ptr::null_mut();\n                let out_public_key = phandle_to_out_pointer(out_public_key, \u0026mut dest);\n                let public_key = handle_as_pointer(public_key, \u0026x25519_public_keys);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_x25519_public_key_clone(out_public_key, public_key, out_error) };\n                if !dest.is_null() {\n                    x25519_public_keys.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::X25519PublicKeyFromBase32{out_public_key, base32, base32_length, out_error} =\u003e {\n                let mut public_key: *mut GoslingX25519PublicKey = ptr::null_mut();\n                let out_public_key = phandle_to_out_pointer(out_public_key, \u0026mut public_key);\n                let base32_length = buffer_to_size(\u0026base32, \u0026base32_length);\n                let base32 = buffer_as_pointer(\u0026base32);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_x25519_public_key_from_base32(out_public_key, base32, base32_length, out_error) };\n                if !out_public_key.is_null() {\n                    x25519_public_keys.push(public_key);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::X25519PublicKeyToBase32{public_key, mut out_base32, base32_size, out_error} =\u003e {\n                let public_key = handle_as_pointer(public_key, \u0026x25519_public_keys);\n                let base32_size = buffer_to_size(\u0026out_base32, \u0026base32_size);\n                let out_base32 = buffer_as_mut_pointer(\u0026mut out_base32);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                gosling_x25519_public_key_to_base32(public_key, out_base32, base32_size, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::V3OnionServiceIdClone{out_service_id, service_id, out_error} =\u003e {\n                let mut dest: *mut GoslingV3OnionServiceId = ptr::null_mut();\n                let out_service_id = phandle_to_out_pointer(out_service_id, \u0026mut dest);\n                let service_id = handle_as_pointer(service_id, \u0026v3_onion_service_ids);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_v3_onion_service_id_clone(out_service_id, service_id, out_error) };\n                if !dest.is_null() {\n                    v3_onion_service_ids.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::V3OnionServiceIdFromString{out_service_id, service_id_string, service_id_string_length, out_error} =\u003e {\n                let mut service_id: *mut GoslingV3OnionServiceId = ptr::null_mut();\n                let out_service_id = phandle_to_out_pointer(out_service_id, \u0026mut service_id);\n                let service_id_string_length = buffer_to_size(\u0026service_id_string, \u0026service_id_string_length);\n                let service_id_string = buffer_as_pointer(\u0026service_id_string);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_v3_onion_service_id_from_string(out_service_id, service_id_string, service_id_string_length, out_error) };\n                if !out_service_id.is_null() {\n                    v3_onion_service_ids.push(service_id);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::V3OnionServiceIdFromEd25519PrivateKey{out_service_id, ed25519_private_key, out_error} =\u003e {\n                let mut service_id: *mut GoslingV3OnionServiceId = ptr::null_mut();\n                let out_service_id = phandle_to_out_pointer(out_service_id, \u0026mut service_id);\n                let ed25519_private_key = handle_as_pointer(ed25519_private_key, \u0026ed25519_private_keys);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_v3_onion_service_id_from_ed25519_private_key(out_service_id, ed25519_private_key, out_error) };\n                if !out_service_id.is_null() {\n                    v3_onion_service_ids.push(service_id);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::V3OnionServiceIdToString{service_id, mut out_service_id_string, service_id_string_size, out_error} =\u003e {\n                let service_id = handle_as_pointer(service_id, \u0026v3_onion_service_ids);\n                let service_id_string_size = buffer_to_size(\u0026out_service_id_string, \u0026service_id_string_size);\n                let out_service_id_string = buffer_as_mut_pointer(\u0026mut out_service_id_string);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                gosling_v3_onion_service_id_to_string(service_id, out_service_id_string, service_id_string_size, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::StringIsValidV3OnionServiceId{service_id_string, service_id_string_length, out_error} =\u003e {\n                let service_id_string_length = buffer_to_size(\u0026service_id_string, \u0026service_id_string_length);\n                let service_id_string = buffer_as_pointer(\u0026service_id_string);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                gosling_string_is_valid_v3_onion_service_id(service_id_string, service_id_string_length, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            }\n            Function::TorProviderConfigNewMockClientConfig{out_tor_provider_config, out_error} =\u003e {\n                let mut tor_provider_config: *mut GoslingTorProviderConfig = ptr::null_mut();\n                let out_tor_provider_config = phandle_to_out_pointer(out_tor_provider_config, \u0026mut tor_provider_config);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                unsafe { gosling_tor_provider_config_new_mock_client_config(out_tor_provider_config, out_error) };\n                if !tor_provider_config.is_null() {\n                    tor_provider_configs.push(tor_provider_config);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::TorProviderFromTorProviderConfig{out_tor_provider, tor_provider_config, out_error} =\u003e {\n                let mut tor_provider: *mut GoslingTorProvider = ptr::null_mut();\n                let out_tor_provider = phandle_to_out_pointer(out_tor_provider, \u0026mut tor_provider);\n                let tor_provider_config = handle_as_pointer(tor_provider_config, \u0026tor_provider_configs);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                unsafe { gosling_tor_provider_from_tor_provider_config(out_tor_provider, tor_provider_config, out_error) };\n                if !tor_provider.is_null() {\n                    tor_providers.push(tor_provider);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextInit{out_context, tor_provider, identity_port, endpoint_port, identity_private_key, out_error} =\u003e {\n                let mut context: *mut GoslingContext = ptr::null_mut();\n                let out_context = phandle_to_out_pointer(out_context, \u0026mut context);\n                let tor_provider = handle_as_pointer(tor_provider, \u0026tor_providers);\n                let identity_private_key = handle_as_pointer(identity_private_key, \u0026ed25519_private_keys);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                unsafe { gosling_context_init(out_context, tor_provider, identity_port, endpoint_port, identity_private_key, out_error) };\n                if !context.is_null() {\n                    contexts.push(context);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextBootstrapTor{context, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                gosling_context_bootstrap_tor(context, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextStartIdentityServer{context, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                gosling_context_start_identity_server(context, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextStopIdentityServer{context, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                gosling_context_stop_identity_server(context, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextStartEndpointServer{context, endpoint_private_key, endpoint_name, endpoint_name_length, client_identity, client_auth_public_key, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let endpoint_private_key = handle_as_pointer(endpoint_private_key, \u0026ed25519_private_keys);\n                let endpoint_name_length = buffer_to_size(\u0026endpoint_name, \u0026endpoint_name_length);\n                let endpoint_name = buffer_as_pointer(\u0026endpoint_name);\n                let client_identity = handle_as_pointer(client_identity, \u0026v3_onion_service_ids);\n                let client_auth_public_key = handle_as_pointer(client_auth_public_key, \u0026x25519_public_keys);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                gosling_context_start_endpoint_server(context, endpoint_private_key, endpoint_name, endpoint_name_length, client_identity, client_auth_public_key, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            }\n            Function::ContextStopEndpointServer{context, endpoint_private_key, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let endpoint_private_key = handle_as_pointer(endpoint_private_key, \u0026ed25519_private_keys);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                gosling_context_stop_endpoint_server(context, endpoint_private_key, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextBeginIdentityHandshake{context, identity_service_id, endpoint_name, endpoint_name_length, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let identity_service_id = handle_as_pointer(identity_service_id, \u0026v3_onion_service_ids);\n                let endpoint_name_length = buffer_to_size(\u0026endpoint_name, \u0026endpoint_name_length);\n                let endpoint_name = buffer_as_pointer(\u0026endpoint_name);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                let handshake_handle = gosling_context_begin_identity_handshake(context, identity_service_id, endpoint_name, endpoint_name_length, out_error);\n                if handshake_handle != !0usize {\n                    identity_handshakes.push(handshake_handle);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextAbortIdentityClientHandshake{context, handshake_handle, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let handshake_handle = match handshake_handle {\n                    Primitive::Valid(value) =\u003e if !identity_handshakes.is_empty() {\n                        let index = value % identity_handshakes.len();\n                        identity_handshakes[index]\n                    } else {\n                        !0usize\n                    },\n                    Primitive::Invalid(value) =\u003e if !identity_handshakes.contains(\u0026value) {\n                        value\n                    } else {\n                        !0usize\n                    }\n                };\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                gosling_context_abort_identity_client_handshake(context, handshake_handle, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextBeginEndpointHandshake{context, endpoint_service_id, client_auth_private_key, channel_name, channel_name_length, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let endpoint_service_id = handle_as_pointer(endpoint_service_id, \u0026v3_onion_service_ids);\n                let client_auth_private_key = handle_as_pointer(client_auth_private_key, \u0026x25519_private_keys);\n                let channel_name_length = buffer_to_size(\u0026channel_name, \u0026channel_name_length);\n                let channel_name = buffer_as_pointer(\u0026channel_name);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                let handshake_handle = gosling_context_begin_endpoint_handshake(context, endpoint_service_id, client_auth_private_key, channel_name, channel_name_length, out_error);\n                if handshake_handle != !0usize {\n                    endpoint_handshakes.push(handshake_handle);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextAbortEndpointClientHandshake{context, handshake_handle, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let handshake_handle = match handshake_handle {\n                    Primitive::Valid(value) =\u003e if !endpoint_handshakes.is_empty() {\n                        let index = value % endpoint_handshakes.len();\n                        endpoint_handshakes[index]\n                    } else {\n                        !0usize\n                    },\n                    Primitive::Invalid(value) =\u003e if !endpoint_handshakes.contains(\u0026value) {\n                        value\n                    } else {\n                        !0usize\n                    }\n                };\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                gosling_context_abort_endpoint_client_handshake(context, handshake_handle, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextPollEvents{context, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                gosling_context_poll_events(context, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextSetTorBootstrapStatusReceivedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_tor_bootstrap_status_received_callback, bootstrap_status_received);\n            },\n            Function::ContextSetTorBootstrapCompletedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_tor_bootstrap_completed_callback, bootstrap_complete);\n            },\n            Function::ContextSetTorLogReceivedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_tor_log_received_callback, tor_log_received);\n            },\n            Function::ContextSetIdentityClientChallengeResponseSizeCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_client_challenge_response_size_callback, identity_client_handshake_challenge_response_size);\n            },\n            Function::ContextSetIdentityClientBuildChallengeResponseCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_client_build_challenge_response_callback, identity_client_handshake_build_challenge_response);\n            },\n            Function::ContextSetIdentityClientHandshakeCompletedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_client_handshake_completed_callback, identity_client_handshake_completed);\n            },\n            Function::ContextSetIdentityClientHandshakeFailedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_client_handshake_failed_callback, identity_client_handshake_failed);\n            },\n            Function::ContextSetIdentityServerPublishedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_server_published_callback, identity_server_published);\n            },\n            Function::ContextSetIdentityServerHandshakeStartedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_server_handshake_started_callback, identity_server_handshake_started);\n            },\n            Function::ContextSetIdentityServerClientAllowedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_server_client_allowed_callback, identity_server_handshake_client_allowed);\n            },\n            Function::ContextSetIdentityServerEndpointSupportedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_server_endpoint_supported_callback, identity_server_endpoint_supported);\n            },\n            Function::ContextSetIdentityServerChallengeSizeCallack{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_server_challenge_size_callback, identity_server_handshake_challenge_size);\n            },\n            Function::ContextSetIdentityServerBuildChallengeCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_server_build_challenge_callback, identity_server_handshake_build_challenge);\n            },\n            Function::ContextSetIdentityServerVerifyChallengeResponseCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_server_verify_challenge_response_callback, identity_server_handshake_verify_challenge_response);\n            },\n            Function::ContextSetIdentityServerHandshakeCompletedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_server_handshake_completed_callback, identity_server_handshake_completed);\n            },\n            Function::ContextSetIdentityServerHandshakeRejectedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_server_handshake_rejected_callback, identity_server_handshake_rejected);\n            },\n            Function::ContextSetIdentityServerHandshakeFailedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_server_handshake_failed_callback, identity_server_handshake_failed);\n            },\n            Function::ContextSetEndpointClientHandshakeCompletedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_endpoint_client_handshake_completed_callback, endpoint_client_handhsake_completed);\n            },\n            Function::ContextSetEndpointClientHandshakeFailedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_endpoint_client_handshake_failed_callback, endpoint_client_handshake_failed);\n            },\n            Function::ContextSetEndpointServerPublishedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_endpoint_server_published_callback, endpoint_server_published);\n            },\n            Function::ContextSetEndpointServerHandshakeStartedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_endpoint_server_handshake_started_callback, endpoint_server_handshake_started);\n            },\n            Function::ContextSetEndpointServerChannelSupportedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_endpoint_server_channel_supported_callback, endpoint_server_channel_supported);\n            },\n            Function::ContextSetEndpointServerHandshakeCompletedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_endpoint_server_handshake_completed_callback, endpoint_server_handshake_completed);\n            },\n            Function::ContextSetEndpointServerHandshakeRejectedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_endpoint_server_handshake_rejected_callback, endpoint_server_handshake_rejected);\n            },\n            Function::ContextSetEndpointServerHandshakeFailedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_endpoint_server_handshake_failed_callback, endpoint_server_handshake_failed);\n            },\n            Function::ContextGenerateCircuitToken{context, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                let circuit_token = unsafe { gosling_context_generate_circuit_token(context, out_error) };\n                if !error.is_null() {\n                    errors.push(error);\n                } else {\n                    circuit_tokens.push(circuit_token);\n                }\n            },\n            Function::ContextReleaseCircuitToken{context, circuit_token, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                let circuit_token = primitive_to_value(circuit_token, \u0026mut circuit_tokens);\n                unsafe { gosling_context_release_circuit_token(context, circuit_token, out_error) };\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::IpAddressFree{ip_address} =\u003e {\n                let ip_address = handle_to_pointer(ip_address, \u0026mut ip_addresses);\n                gosling_ip_address_free(ip_address);\n            },\n            Function::IpAddressClone{out_ip_address, ip_address, out_error} =\u003e {\n                let mut dest: *mut GoslingIpAddress = ptr::null_mut();\n                let out_ip_address = phandle_to_out_pointer(out_ip_address, \u0026mut dest);\n                let ip_address = handle_as_pointer(ip_address, \u0026ip_addresses);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                unsafe { gosling_ip_address_clone(out_ip_address, ip_address, out_error) };\n                if !dest.is_null() {\n                    ip_addresses.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::IpAddressFromIpv4{out_ip_address, a, b, c, d, out_error} =\u003e {\n                let mut dest: *mut GoslingIpAddress = ptr::null_mut();\n                let out_ip_address = phandle_to_out_pointer(out_ip_address, \u0026mut dest);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                unsafe { gosling_ip_address_from_ipv4(out_ip_address, a, b, c, d, out_error) };\n                if !dest.is_null() {\n                    ip_addresses.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::IpAddressFromIpv6{out_ip_address, a, b, c, d, e, f, g, h, out_error} =\u003e {\n                let mut dest: *mut GoslingIpAddress = ptr::null_mut();\n                let out_ip_address = phandle_to_out_pointer(out_ip_address, \u0026mut dest);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                unsafe { gosling_ip_address_from_ipv6(out_ip_address, a, b, c, d, e, f, g, h, out_error) };\n                if !dest.is_null() {\n                    ip_addresses.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::TargetAddressFree{target_address} =\u003e {\n                let target_address = handle_to_pointer(target_address, \u0026mut target_addresses);\n                gosling_target_address_free(target_address);\n            },\n            Function::TargetAddressClone{out_target_address, target_address, out_error} =\u003e {\n                let mut dest: *mut GoslingTargetAddress = ptr::null_mut();\n                let out_target_address = phandle_to_out_pointer(out_target_address, \u0026mut dest);\n                let target_address = handle_as_pointer(target_address, \u0026target_addresses);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_target_address_clone(out_target_address, target_address, out_error) };\n                if !dest.is_null() {\n                    target_addresses.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::TargetAddressFromIpAddress{out_target_address, ip_address, port, out_error} =\u003e {\n                let mut dest: *mut GoslingTargetAddress = ptr::null_mut();\n                let out_target_address = phandle_to_out_pointer(out_target_address, \u0026mut dest);\n                let ip_address = handle_as_pointer(ip_address, \u0026ip_addresses);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                unsafe { gosling_target_address_from_ip_address(out_target_address, ip_address, port, out_error) };\n                if !dest.is_null() {\n                    target_addresses.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::TargetAddressFromDomain{out_target_address, domain, domain_length, port, out_error} =\u003e {\n                let mut dest: *mut GoslingTargetAddress = ptr::null_mut();\n                let out_target_address = phandle_to_out_pointer(out_target_address, \u0026mut dest);\n                let domain_length = buffer_to_size(\u0026domain, \u0026domain_length);\n                let domain = buffer_as_pointer(\u0026domain);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                unsafe { gosling_target_address_from_domain(out_target_address, domain, domain_length, port, out_error) };\n                if !dest.is_null() {\n                    target_addresses.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::TargetAddressFromV3OnionServiceId{out_target_address, service_id, port, out_error} =\u003e {\n                let mut dest: *mut GoslingTargetAddress = ptr::null_mut();\n                let out_target_address = phandle_to_out_pointer(out_target_address, \u0026mut dest);\n                let service_id = handle_as_pointer(service_id, \u0026v3_onion_service_ids);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                unsafe { gosling_target_address_from_v3_onion_service_id(out_target_address, service_id, port, out_error) };\n                if !dest.is_null() {\n                    target_addresses.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::TargetAddressFromString{out_target_address, target_address, target_address_length, out_error} =\u003e {\n                let mut dest: *mut GoslingTargetAddress = ptr::null_mut();\n                let out_target_address = phandle_to_out_pointer(out_target_address, \u0026mut dest);\n                let target_address_length = buffer_to_size(\u0026target_address, \u0026target_address_length);\n                let target_address = buffer_as_pointer(\u0026target_address);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                unsafe { gosling_target_address_from_string(out_target_address, target_address, target_address_length, out_error) };\n                if !dest.is_null() {\n                    target_addresses.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n        }\n    }\n});\n","traces":[{"line":448,"address":[],"length":0,"stats":{"Line":0}},{"line":449,"address":[],"length":0,"stats":{"Line":0}},{"line":450,"address":[],"length":0,"stats":{"Line":0}},{"line":451,"address":[],"length":0,"stats":{"Line":0}},{"line":452,"address":[],"length":0,"stats":{"Line":0}},{"line":453,"address":[],"length":0,"stats":{"Line":0}},{"line":455,"address":[],"length":0,"stats":{"Line":0}},{"line":457,"address":[],"length":0,"stats":{"Line":0}},{"line":458,"address":[],"length":0,"stats":{"Line":0}},{"line":460,"address":[],"length":0,"stats":{"Line":0}},{"line":463,"address":[],"length":0,"stats":{"Line":0}},{"line":466,"address":[],"length":0,"stats":{"Line":0}},{"line":467,"address":[],"length":0,"stats":{"Line":0}},{"line":468,"address":[],"length":0,"stats":{"Line":0}},{"line":469,"address":[],"length":0,"stats":{"Line":0}},{"line":470,"address":[],"length":0,"stats":{"Line":0}},{"line":471,"address":[],"length":0,"stats":{"Line":0}},{"line":473,"address":[],"length":0,"stats":{"Line":0}},{"line":475,"address":[],"length":0,"stats":{"Line":0}},{"line":476,"address":[],"length":0,"stats":{"Line":0}},{"line":478,"address":[],"length":0,"stats":{"Line":0}},{"line":481,"address":[],"length":0,"stats":{"Line":0}},{"line":484,"address":[],"length":0,"stats":{"Line":0}},{"line":485,"address":[],"length":0,"stats":{"Line":0}},{"line":486,"address":[],"length":0,"stats":{"Line":0}},{"line":487,"address":[],"length":0,"stats":{"Line":0}},{"line":492,"address":[],"length":0,"stats":{"Line":0}},{"line":493,"address":[],"length":0,"stats":{"Line":0}},{"line":494,"address":[],"length":0,"stats":{"Line":0}},{"line":495,"address":[],"length":0,"stats":{"Line":0}},{"line":496,"address":[],"length":0,"stats":{"Line":0}},{"line":498,"address":[],"length":0,"stats":{"Line":0}},{"line":500,"address":[],"length":0,"stats":{"Line":0}},{"line":501,"address":[],"length":0,"stats":{"Line":0}},{"line":503,"address":[],"length":0,"stats":{"Line":0}},{"line":508,"address":[],"length":0,"stats":{"Line":0}},{"line":509,"address":[],"length":0,"stats":{"Line":0}},{"line":510,"address":[],"length":0,"stats":{"Line":0}},{"line":511,"address":[],"length":0,"stats":{"Line":0}},{"line":512,"address":[],"length":0,"stats":{"Line":0}},{"line":513,"address":[],"length":0,"stats":{"Line":0}},{"line":515,"address":[],"length":0,"stats":{"Line":0}},{"line":518,"address":[],"length":0,"stats":{"Line":0}},{"line":519,"address":[],"length":0,"stats":{"Line":0}},{"line":520,"address":[],"length":0,"stats":{"Line":0}},{"line":521,"address":[],"length":0,"stats":{"Line":0}},{"line":523,"address":[],"length":0,"stats":{"Line":0}},{"line":526,"address":[],"length":0,"stats":{"Line":0}},{"line":527,"address":[],"length":0,"stats":{"Line":0}},{"line":528,"address":[],"length":0,"stats":{"Line":0}},{"line":529,"address":[],"length":0,"stats":{"Line":0}},{"line":531,"address":[],"length":0,"stats":{"Line":0}}],"covered":0,"coverable":52},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","src","callbacks.rs"],"content":"// standard\nuse std::os::raw::c_char;\n\n// extern crates\nuse anyhow::bail;\n#[cfg(feature = \"impl-lib\")]\nuse cgosling_proc_macros::*;\n\n// internal crates\nuse crate::context::*;\nuse crate::crypto::*;\nuse crate::error::*;\nuse crate::macros::*;\n\n#[derive(Default, Clone)]\npub(crate) struct EventCallbacks {\n    // tor events\n    pub tor_bootstrap_status_received_callback: GoslingTorBootstrapStatusReceivedCallback,\n    pub tor_bootstrap_completed_callback: GoslingTorBootstrapCompletedCallback,\n    pub tor_log_received_callback: GoslingTorLogReceivedCallback,\n\n    // identity client events\n    pub identity_client_challenge_response_size_callback:\n        GoslingIdentityClientHandshakeChallengeResponseSizeCallback,\n    pub identity_client_build_challenge_response_callback:\n        GoslingIdentityClientHandshakeBuildChallengeResponseCallback,\n    pub identity_client_handshake_completed_callback:\n        GoslingIdentityClientHandshakeCompletedCallback,\n    pub identity_client_handshake_failed_callback: GoslingIdentityClientHandshakeFailedCallback,\n\n    // identity server events\n    pub identity_server_published_callback: GoslingIdentityServerPublishedCallback,\n    pub identity_server_handshake_started_callback: GoslingIdentityServerHandshakeStartedCallback,\n    pub identity_server_client_allowed_callback:\n        GoslingIdentityServerHandshakeClientAllowedCallback,\n    pub identity_server_endpoint_supported_callback: GoslingIdentityServerEndpointSupportedCallback,\n    pub identity_server_challenge_size_callback:\n        GoslingIdentityServerHandshakeChallengeSizeCallback,\n    pub identity_server_build_challenge_callback:\n        GoslingIdentityServerHandshakeBuildChallengeCallback,\n    pub identity_server_verify_challenge_response_callback:\n        GoslingIdentityServerHandshakeVerifyChallengeResponseCallback,\n    pub identity_server_handshake_completed_callback:\n        GoslingIdentityServerHandshakeCompletedCallback,\n    pub identity_server_handshake_rejected_callback: GoslingIdentityServerHandshakeRejectedCallback,\n    pub identity_server_handshake_failed_callback: GoslingIdentityServerHandshakeFailedCallback,\n\n    // endpoint client events\n    pub endpoint_client_handshake_completed_callback:\n        GoslingEndpointClientHandshakeCompletedCallback,\n    pub endpoint_client_handshake_failed_callback: GoslingEndpointClientHandshakeFailedCallback,\n\n    // endpoint server events\n    pub endpoint_server_published_callback: GoslingEndpointServerPublishedCallback,\n    pub endpoint_server_handshake_started_callback: GoslingEndpointServerHandshakeStartedCallback,\n    pub endpoint_server_channel_supported_callback: GoslingEndpointServerChannelSupportedCallback,\n    pub endpoint_server_handshake_completed_callback:\n        GoslingEndpointServerHandshakeCompletedCallback,\n    pub endpoint_server_handshake_rejected_callback: GoslingEndpointServerHandshakeRejectedCallback,\n    pub endpoint_server_handshake_failed_callback: GoslingEndpointServerHandshakeFailedCallback,\n}\n\n/// The function pointer type for the tor bootstrap status received callback. This\n/// callback is called when context's tor daemon's bootstrap status has progressed.\n///\n/// @param context: the context associated with this event\n/// @param progress: an unsigned integer from 0 to 100 indicating the current completion\n///  perentage of the context's bootstrap process\n/// @param tag: the null-terminated short name of the current bootstrap stage\n/// @param tag_length: the number of chrs in tag not including any null-terminator\n/// @param summary: the null-terminated description of the current bootstra stage\n/// @param summary_length: the number of chars in summary not including the null-terminator\npub type GoslingTorBootstrapStatusReceivedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        progress: u32,\n        tag: *const c_char,\n        tag_length: usize,\n        summary: *const c_char,\n        summary_length: usize,\n    ) -\u003e (),\n\u003e;\n\n/// The function pointer type for the tor boootstrap completed callback. This callback\n/// is called when the context's tor daemon's bootstrap process has completed.\n///\n/// @param context: the context associated with this event\npub type GoslingTorBootstrapCompletedCallback =\n    Option\u003cextern \"C\" fn(context: *mut GoslingContext) -\u003e ()\u003e;\n\n/// The function pointer type for the tor log received callback. This callback is called\n/// whenever the context's tor daemon prints new log lines.\n///\n/// @param context: the context associated with this event\n/// @param line: the null-terminated received log line\n/// @param line_length: the number of chars in line not including the null-terminator\npub type GoslingTorLogReceivedCallback = Option\u003c\n    extern \"C\" fn(context: *mut GoslingContext, line: *const c_char, line_length: usize) -\u003e (),\n\u003e;\n\n/// The function pointer type for the client handshake challenge response size\n/// callback. This callback is called when a client needs to know how much memory\n/// to allocate for a challenge response.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: pointer to the client handshake handle this callback\n///  invocation is associated with; null if no client handshake init callback was\n///  provided\n/// @param challenge_buffer: the source buffer containing a BSON document received\n///  from the  identity server to serve as an endpoint request challenge\n/// @param challenge_buffer_size: the number of bytes in challenge_buffer\n/// @return the number of bytes required to store the challenge response object\npub type GoslingIdentityClientHandshakeChallengeResponseSizeCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        challenge_buffer: *const u8,\n        challenge_buffer_size: usize,\n    ) -\u003e usize,\n\u003e;\n\n/// The function pointer type for the identity client handshake build challlenge\n/// response callback. This callback is called when a client is ready to build a\n/// challenge response object.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param challenge_buffer: the source buffer containing a BSON document received\n///  from the  identity server to serve as an endpoint request challenge\n/// @param challenge_buffer_size: the number of bytes in challenge_buffer\n/// @param out_challenge_response_buffer: the destination buffer for the callback\n///  to write a BSON document representing the endpoint request challenge response\n///  object\n/// @param out_challenge_response_buffer_size: the number of bytes allocated in\n///  out_challenge_response_buffer\npub type GoslingIdentityClientHandshakeBuildChallengeResponseCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        challenge_buffer: *const u8,\n        challenge_buffer_size: usize,\n        out_challenge_response_buffer: *mut u8,\n        out_challenge_response_buffer_size: usize,\n    ) -\u003e (),\n\u003e;\n\n/// The function pointer type for the identity client handshake completed callback. This\n/// callback is called whenever the client successfully completes a handshake with an\n/// identity server and is granted access to an endpoint server.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param identity_service_id: the onion service id of the identity server the client\n///  has successfully completed a hadshake with\n/// @param endpoint_service_id: the onion service id of the endpoint server the client\n///  now has access to\n/// @param endpoint_name: the null-terminated name of the provided endpoint server\n/// @param endpoint_name_length: the number of chars in endpoint_name string not including\n///  the null-terminator\n/// @param client_auth_private_key: the client's x25519 private required to connect to\n///  the provided endpoint server\npub type GoslingIdentityClientHandshakeCompletedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        identity_service_id: *const GoslingV3OnionServiceId,\n        endpoint_service_id: *const GoslingV3OnionServiceId,\n        endpoint_name: *const c_char,\n        endpoint_name_length: usize,\n        client_auth_private_key: *const GoslingX25519PrivateKey,\n    ) -\u003e (),\n\u003e;\n\n/// The function pointer type for the identity client handshake handshake failed\n/// callback. This callback is called when a client's identity handshake fails.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param error: error associated with this failure\npub type GoslingIdentityClientHandshakeFailedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        error: *const GoslingError,\n    ) -\u003e (),\n\u003e;\n\n/// The function pointer type for the identity server published callback. This callback\n/// is called whenever the onion service of the identity server associated with the given\n/// context is published and should be reachable by clients.\n///\n/// @param context: the context associated with this event\npub type GoslingIdentityServerPublishedCallback =\n    Option\u003cextern \"C\" fn(context: *mut GoslingContext) -\u003e ()\u003e;\n\n/// The function pointer type of the identity server handshake started callback. This callback\n/// is called whenever the identity server is initially connected to.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\npub type GoslingIdentityServerHandshakeStartedCallback = Option\u003c\n    extern \"C\" fn(context: *mut GoslingContext, handshake_handle: GoslingHandshakeHandle) -\u003e (),\n\u003e;\n\n/// The function pointer type of the identity server handshake client allowed callback.\n/// The result of this callback partially determines if an incoming client handshake\n/// request is possible to complete. For instance an implementation of this function\n//  may reference an allow/block list to determime if identity handshakes can be\n/// completed.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param client_service_id: the v3 onion service id of the connected client\n/// @return true if the server wants to allow the requesting client to connect client may complete the handshake, false otherwise\npub type GoslingIdentityServerHandshakeClientAllowedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        client_service_id: *const GoslingV3OnionServiceId,\n    ) -\u003e bool,\n\u003e;\n\n/// The function pointer type of the identity server endpoint supported callback. This\n/// callback is called when the server needs to determine if the client's requested\n/// endpoint is supported. The result of this callback partially determines if an\n/// incoming client handshake request is possible to complete.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param endpoint_name: a null-terminated ASCII string containing the name of the\n///  endpoint being requested\n/// @param endpoint_name_length: the number of chars in endpoint_name, not\n///  including the null-terminator\n/// @return true if the server can handle requests for the requested endpoint,\n///  false otherwise\npub type GoslingIdentityServerEndpointSupportedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        endpoint_name: *const c_char,\n        endpoint_name_length: usize,\n    ) -\u003e bool,\n\u003e;\n\n/// The function pointer type for the server handshake challenge size callback.\n/// This callback is called when a server needs to know how much memory to allocate\n/// for a challenge.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @return the number of bytes required to store the challenge object\npub type GoslingIdentityServerHandshakeChallengeSizeCallback = Option\u003c\n    extern \"C\" fn(context: *mut GoslingContext, handshake_handle: GoslingHandshakeHandle) -\u003e usize,\n\u003e;\n\n/// The function pointer type for the server handshake build challenge callback.\n/// This callback is called when a server needs to build a challenge object.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param out_challenge_buffer: the destination buffer for the callback\n///  to write a BSON document representing the endpoint request challenge object\n/// @param out_challenge_buffer_size: the number of bytes allocated in\n///  out_challenge_buffer\npub type GoslingIdentityServerHandshakeBuildChallengeCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        out_challenge_buffer: *mut u8,\n        out_challenge_buffer_size: usize,\n    ) -\u003e (),\n\u003e;\n\n/// The function poointer type for the server handshake verify challenge response\n/// callback. This callback is called when a server needs to verify a challenge\n/// response object.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param challenge_response_buffer: a buffer containing the BSON document representing\n///  the endpoint request challenge response object\n/// @param challenge_response_buffer_size: the number of bytes in\n///  challenge_response_buffer\n/// @return the result of the challenge response verification\npub type GoslingIdentityServerHandshakeVerifyChallengeResponseCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        challenge_response_buffer: *const u8,\n        challenge_response_buffer_size: usize,\n    ) -\u003e bool,\n\u003e;\n\n/// The function pointer type for the identity server handshake completed callback. This\n/// callback is called whenever the identity server has successfully completed a\n/// handshake with and granted to a connecting identity client.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param endpoint_private_key: the ed25519 private key of the endpoint server to host\n///  for the client\n/// @param endpoint_name: the null-terminated name of the new endpoint server\n/// @param endpoint_name_length: the length of the endpoint_name string not including\n///  the null-terminator\n/// @param client_service_id: the onion service id of the client we have granted\n///  access to\n/// @param client_auth_public_key: the x25519 public key to use to encrypt the endpoint\n///  server's service descriptor as provided by the connecting client\npub type GoslingIdentityServerHandshakeCompletedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        endpoint_private_key: *const GoslingEd25519PrivateKey,\n        endpoint_name: *const c_char,\n        endpoint_name_length: usize,\n        client_service_id: *const GoslingV3OnionServiceId,\n        client_auth_public_key: *const GoslingX25519PublicKey,\n    ) -\u003e (),\n\u003e;\n\n/// The function pointer type of the identity server handshake rejected callback. This\n/// callback is called whenever the identity server has rejected an identity client's\n/// handshake.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param client_allowed: true if requesting client is allowed, false otherwies\n/// @param client_requested_endpoint_valid: true if requesting client requested a\n///  valid endpoint, false otherwise\n/// @param client_proof_signature_valid: true if the requesting client properly\n///  signed the identity proof, false otherwise\n/// @param client_auth_signature_valid: true if the requesting client properly signed\n///  the authorization proof, false othewise\n/// @param challenge_response_valid: true if the requesting client's challenge\n///  response was accepted by the server, false otherwise\npub type GoslingIdentityServerHandshakeRejectedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        client_allowed: bool,\n        client_requested_endpoint_valid: bool,\n        client_proof_signature_valid: bool,\n        client_auth_signature_valid: bool,\n        challenge_response_valid: bool,\n    ) -\u003e (),\n\u003e;\n\n/// The function pointer type for the identity server handshake handshake failed\n/// callback. This callback is called when a server's identity handshake fails.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param error: error associated with this failure\npub type GoslingIdentityServerHandshakeFailedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        error: *const GoslingError,\n    ) -\u003e (),\n\u003e;\n\n/// The function pointer type for the endpoint client handshake completed callback.\n/// This callback is called when the client successfully connects to an endpoint server.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param endpoint_service_id: the onion service id of the endpoint server the client\n///  has connected to\n/// @param channel_name: the null-terminated name of the channel name requested by the\n///  the client\n/// @param channel_name_length: the number of chars in channel_name not including the\n///  null-terminator\n/// @param stream: os-specific tcp socket handle associated with the connection to the\n///  endpoint server\npub type GoslingEndpointClientHandshakeCompletedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        endpoint_service_id: *const GoslingV3OnionServiceId,\n        channel_name: *const c_char,\n        channel_name_length: usize,\n        stream: GoslingTcpSocket,\n    ),\n\u003e;\n\n/// The function pointer type for the endpoint client handshake handshake failed\n/// callback. This callback is called when a client's endpoint handshake fails.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param error: error associated with this failure\npub type GoslingEndpointClientHandshakeFailedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        error: *const GoslingError,\n    ) -\u003e (),\n\u003e;\n\n/// The function pointer type for the endpoint server published callback. This callbcak\n/// is called whenever the onion service of the indicated endpoint server associted with\n/// the given context is published and should be reachable by clients.\n///\n/// @param context: the context associated with this event\n/// @param endpoint_service_id: the onion service id of the published endpoint server\n/// @param endpoint_name: the null-terminated name of the endpoint server published\n/// @param endpoint_name_length: the number of chars in endpoint_name string not including the\n///  null-terminator\npub type GoslingEndpointServerPublishedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        endpoint_service_id: *const GoslingV3OnionServiceId,\n        endpoint_name: *const c_char,\n        endpoint_name_length: usize,\n    ) -\u003e (),\n\u003e;\n\n/// The function pointer type of the endpoint server handshake started callback. This\n/// callback is called whenever the endpoint server is initially connected to.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\npub type GoslingEndpointServerHandshakeStartedCallback = Option\u003c\n    extern \"C\" fn(context: *mut GoslingContext, handshake_handle: GoslingHandshakeHandle) -\u003e (),\n\u003e;\n\n/// The function pointer type of the endpoint server channel supported callback. This\n/// callback is called when the server needs to determine if the client's requested\n/// channel is supported. The result of this callback partially determines if an\n/// incoming endpoint client handshake request is possible to complete.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param client_service_id: the onion service id of the connected endpoint client\n/// @param channel_name: a null-terminated ASCII string containing the name of the\n///  endpoint being requested\n/// @param channel_name_length: the number of chars in endpoint_name, not\n///  including the null-terminator\n/// @return true if the server can handle requests for the requested channel,\n///  false otherwise\npub type GoslingEndpointServerChannelSupportedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        client_service_id: *const GoslingV3OnionServiceId,\n        channel_name: *const c_char,\n        channel_name_length: usize,\n    ) -\u003e bool,\n\u003e;\n\n/// The function pointer type for the endpoint server handshake completed callback.\n/// This callback is called when an endpoint server completes a handshake with an\n/// endpoint client.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param endpoint_service_id: the onion service id of the endpoint server the\n///  endpoint client has connected to\n/// @param client_service_id: the onion service id of the connected endpoint client\n/// @param channel_name: the null-terminated name of the channel requested by the client\n/// @param channel_name_length: the number of chars in channel_name not including the\n///  null-terminator\n/// @param stream: os-specific tcp socket handle associated with the connection to the\n///  endpoint client\npub type GoslingEndpointServerHandshakeCompletedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        endpoint_service_id: *const GoslingV3OnionServiceId,\n        client_service_id: *const GoslingV3OnionServiceId,\n        channel_name: *const c_char,\n        channel_name_length: usize,\n        stream: GoslingTcpSocket,\n    ),\n\u003e;\n\n/// The function pointer type of the endpoint server handshake rejected callback. This\n/// callback is called whenever the endpoint server has rejected an endpoint client's\n/// handshake.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param client_allowed: true if requesting client is allowed, false otherwies\n/// @param client_requested_channel_valid: true if requesting client requested a\n///  valid endpoint, false otherwise\n/// @param client_proof_signature_valid: true if the requesting client properly\n///  signed the endpoint proof, false otherwise\npub type GoslingEndpointServerHandshakeRejectedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        client_allowed: bool,\n        client_requested_channel_valid: bool,\n        client_proof_signature_valid: bool,\n    ) -\u003e (),\n\u003e;\n\n/// The function pointer type for the endpoint server handshake handshake failed\n/// callback. This callback is called when a server's endpoint handshake fails.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param error: error associated with this failure\npub type GoslingEndpointServerHandshakeFailedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        error: *const GoslingError,\n    ) -\u003e (),\n\u003e;\n\nmacro_rules! impl_callback_setter {\n    ($callback_type:tt, $context:expr, $callback:expr, $error:expr) =\u003e {\n        paste::paste! {\n            translate_failures((), $error, || -\u003e anyhow::Result\u003c()\u003e {\n                let mut context_tuple_registry = get_context_tuple_registry();\n                let context = match context_tuple_registry.get_mut($context as usize) {\n                    Some(context) =\u003e context,\n                    None =\u003e {\n                        bail_invalid_handle!(context);\n                    }\n                };\n                context.1.[\u003c$callback_type\u003e] = $callback;\n                Ok(())\n            })\n        }\n    };\n}\n\n/// Set the tor bootstrap status received callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_tor_bootstrap_status_received_callback(\n    context: *mut GoslingContext,\n    callback: GoslingTorBootstrapStatusReceivedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        tor_bootstrap_status_received_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the tor bootstrap completed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_tor_bootstrap_completed_callback(\n    context: *mut GoslingContext,\n    callback: GoslingTorBootstrapCompletedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(tor_bootstrap_completed_callback, context, callback, error);\n}\n\n/// Sets the tor log received callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_tor_log_received_callback(\n    context: *mut GoslingContext,\n    callback: GoslingTorLogReceivedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(tor_log_received_callback, context, callback, error);\n}\n\n/// Sets the identity challenge challenge response size callback for the specified\n/// context\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_client_challenge_response_size_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityClientHandshakeChallengeResponseSizeCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_client_challenge_response_size_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Sets the identity client build challenge response callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_client_build_challenge_response_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityClientHandshakeBuildChallengeResponseCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_client_build_challenge_response_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the identity client handshake completed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_client_handshake_completed_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityClientHandshakeCompletedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_client_handshake_completed_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the identity client handshake failed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_client_handshake_failed_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityClientHandshakeFailedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_client_handshake_failed_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the identity server published callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_server_published_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityServerPublishedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(identity_server_published_callback, context, callback, error);\n}\n\n/// Set the identity server handshake started callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_server_handshake_started_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityServerHandshakeStartedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_server_handshake_started_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Sets the identity server client allowed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_server_client_allowed_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityServerHandshakeClientAllowedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_server_client_allowed_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Sets the identity server endpoint supported callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_server_endpoint_supported_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityServerEndpointSupportedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_server_endpoint_supported_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Sets the identity server challenge size callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on erro\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_server_challenge_size_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityServerHandshakeChallengeSizeCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_server_challenge_size_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Sets the identity server build challenge callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on erro\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_server_build_challenge_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityServerHandshakeBuildChallengeCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_server_build_challenge_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Sets the identity server verify challenge response callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on erro\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_server_verify_challenge_response_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityServerHandshakeVerifyChallengeResponseCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_server_verify_challenge_response_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the identity server request completed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_server_handshake_completed_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityServerHandshakeCompletedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_server_handshake_completed_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the identity server request rejeced callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_server_handshake_rejected_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityServerHandshakeRejectedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_server_handshake_rejected_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the identity server request failed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_server_handshake_failed_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityServerHandshakeFailedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_server_handshake_failed_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the endpoint client handshake completed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_endpoint_client_handshake_completed_callback(\n    context: *mut GoslingContext,\n    callback: GoslingEndpointClientHandshakeCompletedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        endpoint_client_handshake_completed_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the endpoint client handshake failed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_endpoint_client_handshake_failed_callback(\n    context: *mut GoslingContext,\n    callback: GoslingEndpointClientHandshakeFailedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        endpoint_client_handshake_failed_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the endpoint server published callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_endpoint_server_published_callback(\n    context: *mut GoslingContext,\n    callback: GoslingEndpointServerPublishedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(endpoint_server_published_callback, context, callback, error);\n}\n\n/// Set the endpoint server handshake started callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_endpoint_server_handshake_started_callback(\n    context: *mut GoslingContext,\n    callback: GoslingEndpointServerHandshakeStartedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        endpoint_server_handshake_started_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the endpoint server handshake started callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_endpoint_server_channel_supported_callback(\n    context: *mut GoslingContext,\n    callback: GoslingEndpointServerChannelSupportedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        endpoint_server_channel_supported_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the endpoint server channel request completed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_endpoint_server_handshake_completed_callback(\n    context: *mut GoslingContext,\n    callback: GoslingEndpointServerHandshakeCompletedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        endpoint_server_handshake_completed_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the endpoint server channel request completed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_endpoint_server_handshake_rejected_callback(\n    context: *mut GoslingContext,\n    callback: GoslingEndpointServerHandshakeRejectedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        endpoint_server_handshake_rejected_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the endpoint server channel request completed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_endpoint_server_handshake_failed_callback(\n    context: *mut GoslingContext,\n    callback: GoslingEndpointServerHandshakeFailedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        endpoint_server_handshake_failed_callback,\n        context,\n        callback,\n        error\n    );\n}\n","traces":[{"line":515,"address":[2811866,2810842,2811802,2810650,2810458,2810330,2811162,2810522,2811418,2811290,2810970,2811546,2810394,2811226,2811354,2810906,2811610,2811674,2811034,2810586,2810778,2811098,2811482,2811738,2810714],"length":1,"stats":{"Line":38}},{"line":516,"address":[1632206,1630686,1628254,1628862,1632814,1634030,1631598,1628558,1630990,1627950,1631294,1631902,1629774,1629166,1633422,1633726,1634942,1630382,1629470,1630078,1635246,1634334,1632510,1633118,1634638],"length":1,"stats":{"Line":19}},{"line":517,"address":[1631372,1631676,1628940,1634052,1633804,1631068,1630460,1635324,1628276,1629852,1633140,1632892,1634716,1630404,1634964,1627972,1629796,1632228,1634412,1629548,1629492,1628028,1632284,1632588,1629244,1630708,1631620,1629188,1631980,1632532,1632836,1633196,1630100,1628332,1628580,1633444,1630764,1633500,1631316,1628636,1631924,1634356,1634660,1628884,1630156,1633748,1634108,1635020,1635268,1631012],"length":1,"stats":{"Line":38}},{"line":518,"address":[1629021,1628109,1629325,1629629,1633277,1634189,1632669,1634797,1634493,1628413,1635405,1630541,1628717,1630845,1631757,1630237,1633581,1629933,1631453,1632365,1633885,1635101,1632061,1631149,1632973],"length":1,"stats":{"Line":19}},{"line":523,"address":[1629039,1632991,1633295,1634207,1630255,1632687,1628431,1628127,1628735,1630559,1631471,1631775,1632383,1633599,1633903,1629343,1634511,1635423,1630863,1629951,1629647,1631167,1634815,1635119,1632079],"length":1,"stats":{"Line":19}},{"line":524,"address":[1630262,1633302,1628438,1633910,1628742,1632086,1632694,1631782,1631478,1634214,1635430,1629958,1634518,1629350,1631174,1630870,1632998,1634822,1635126,1630566,1632390,1628134,1629654,1633606,1629046],"length":1,"stats":{"Line":19}},{"line":537,"address":[2810337,2810288],"length":1,"stats":{"Line":0}},{"line":542,"address":[3195644],"length":1,"stats":{"Line":0}},{"line":557,"address":[2810352,2810401],"length":1,"stats":{"Line":1}},{"line":562,"address":[1628423,1628324],"length":1,"stats":{"Line":2}},{"line":572,"address":[2810465,2810416],"length":1,"stats":{"Line":0}},{"line":577,"address":[1628628,1628727],"length":1,"stats":{"Line":0}},{"line":588,"address":[2810529,2810480],"length":1,"stats":{"Line":1}},{"line":593,"address":[1629031],"length":1,"stats":{"Line":1}},{"line":608,"address":[2810544,2810593],"length":1,"stats":{"Line":1}},{"line":613,"address":[1629335],"length":1,"stats":{"Line":1}},{"line":628,"address":[2810608,2810657],"length":1,"stats":{"Line":1}},{"line":633,"address":[1629639],"length":1,"stats":{"Line":1}},{"line":648,"address":[2810672,2810721],"length":1,"stats":{"Line":1}},{"line":653,"address":[1629943],"length":1,"stats":{"Line":1}},{"line":668,"address":[2810736,2810785],"length":1,"stats":{"Line":1}},{"line":673,"address":[1630148,1630247],"length":1,"stats":{"Line":2}},{"line":683,"address":[2810849,2810800],"length":1,"stats":{"Line":0}},{"line":688,"address":[1630551],"length":1,"stats":{"Line":0}},{"line":703,"address":[2810913,2810864],"length":1,"stats":{"Line":1}},{"line":708,"address":[1630855],"length":1,"stats":{"Line":1}},{"line":723,"address":[2810928,2810977],"length":1,"stats":{"Line":1}},{"line":728,"address":[1631060],"length":1,"stats":{"Line":1}},{"line":743,"address":[2811041,2810992],"length":1,"stats":{"Line":1}},{"line":748,"address":[1631463],"length":1,"stats":{"Line":1}},{"line":763,"address":[2811105,2811056],"length":1,"stats":{"Line":1}},{"line":768,"address":[1631668],"length":1,"stats":{"Line":1}},{"line":783,"address":[2811169,2811120],"length":1,"stats":{"Line":1}},{"line":788,"address":[3199907],"length":1,"stats":{"Line":1}},{"line":803,"address":[2811184,2811233],"length":1,"stats":{"Line":1}},{"line":808,"address":[3200124],"length":1,"stats":{"Line":1}},{"line":823,"address":[2811297,2811248],"length":1,"stats":{"Line":0}},{"line":828,"address":[1632679],"length":1,"stats":{"Line":0}},{"line":843,"address":[2811361,2811312],"length":1,"stats":{"Line":1}},{"line":848,"address":[3200867],"length":1,"stats":{"Line":1}},{"line":863,"address":[2811376,2811425],"length":1,"stats":{"Line":1}},{"line":868,"address":[1633287],"length":1,"stats":{"Line":1}},{"line":883,"address":[2811489,2811440],"length":1,"stats":{"Line":1}},{"line":888,"address":[1633492],"length":1,"stats":{"Line":1}},{"line":903,"address":[2811553,2811504],"length":1,"stats":{"Line":1}},{"line":908,"address":[3201724,3201827],"length":1,"stats":{"Line":2}},{"line":918,"address":[2811617,2811568],"length":1,"stats":{"Line":0}},{"line":923,"address":[1634100],"length":1,"stats":{"Line":0}},{"line":938,"address":[2811632,2811681],"length":1,"stats":{"Line":1}},{"line":943,"address":[1634503],"length":1,"stats":{"Line":1}},{"line":958,"address":[2811696,2811745],"length":1,"stats":{"Line":1}},{"line":963,"address":[1634708],"length":1,"stats":{"Line":1}},{"line":978,"address":[2811760,2811809],"length":1,"stats":{"Line":0}},{"line":983,"address":[1635012],"length":1,"stats":{"Line":0}},{"line":998,"address":[2811824,2811873],"length":1,"stats":{"Line":1}},{"line":1003,"address":[1635316],"length":1,"stats":{"Line":1}}],"covered":44,"coverable":56},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","src","context.rs"],"content":"// standard\nuse std::collections::VecDeque;\nuse std::ffi::CString;\nuse std::io::Cursor;\nuse std::os::raw::c_char;\n#[cfg(unix)]\nuse std::os::unix::io::{IntoRawFd, RawFd};\n#[cfg(windows)]\nuse std::os::windows::io::{IntoRawSocket, RawSocket};\nuse std::time::Duration;\n\n// extern crates\nuse anyhow::anyhow;\nuse anyhow::bail;\n#[cfg(feature = \"impl-lib\")]\nuse cgosling_proc_macros::*;\nuse gosling::context::*;\nuse tor_interface::tor_crypto::*;\n\n// internal\nuse crate::callbacks::*;\nuse crate::crypto::*;\nuse crate::error::Error;\nuse crate::error::*;\nuse crate::ffi::*;\nuse crate::macros::*;\nuse crate::tor_provider::*;\n\n// empty bson document layout:\n// {\n//     // document length 5 == 0x00000005\n//     0x05, 0x00, 0x00, 0x00,\n//     // document null-terminator\n//     0x00\n// };\nconst SMALLEST_BSON_DOC_SIZE: usize = 5;\n\n/// A handle for an in-progress identity handhskae\npub type GoslingHandshakeHandle = usize;\n#[cfg(any(target_os = \"linux\", target_os = \"macos\"))]\n/// A native TCP socket handle\npub type GoslingTcpSocket = RawFd;\n#[cfg(any(target_os = \"windows\"))]\n/// A native TCP socket handle\npub type GoslingTcpSocket = RawSocket;\n/// A context object associated with a single peer identity\npub struct GoslingContext;\n/// cbindgen:ignore\ntype ContextTuple = (Context, EventCallbacks, Option\u003cVecDeque\u003cContextEvent\u003e\u003e);\ndefine_registry! {ContextTuple}\n\n/// Frees a gosling_context object\n///\n/// @param in_context: the context object to free\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_free(in_context: *mut GoslingContext) {\n    impl_registry_free!(in_context, ContextTuple);\n}\n\n/// Initialize a gosling context.\n///\n/// @param out_context: returned initialied gosling context\n/// @param in_tor_provider: the tor client implementation to use; this function consumes the tor_provider\n///  and it may not be re-used in subsequent gosling_* calls, and it does not need to be freed\n/// @param identity_port: the tor virtual port the identity server listens on\n/// @param endpoint_port: the tor virtual port endpoint servers listen on\n/// @param identity_private_key: the e25519 private key used to start th identity server's onion service\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_context_init(\n    // out context\n    out_context: *mut *mut GoslingContext,\n    in_tor_provider: *mut GoslingTorProvider,\n    identity_port: u16,\n    endpoint_port: u16,\n    identity_private_key: *const GoslingEd25519PrivateKey,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_context);\n        ensure_not_null!(in_tor_provider);\n        ensure_not_equal!(identity_port, 0);\n        ensure_not_equal!(endpoint_port, 0);\n        ensure_not_null!(identity_private_key);\n\n        // get our tor provider\n        let tor_provider = match get_tor_provider_registry().remove(in_tor_provider as usize) {\n            Some(tor_provider) =\u003e tor_provider,\n            None =\u003e bail_invalid_handle!(tor_provider),\n        };\n\n        // get our identity key\n        let ed25519_private_key_registry = get_ed25519_private_key_registry();\n        let identity_private_key =\n            match ed25519_private_key_registry.get(identity_private_key as usize) {\n                Some(identity_private_key) =\u003e identity_private_key,\n                None =\u003e bail_invalid_handle!(identity_private_key),\n            };\n\n        // construct context\n        let context = Context::new(\n            tor_provider,\n            identity_port,\n            endpoint_port,\n            Duration::from_secs(60),\n            4096,\n            Some(Duration::from_secs(60)),\n            identity_private_key.clone(),\n        )?;\n\n        let handle = get_context_tuple_registry().insert((context, Default::default(), None));\n        *out_context = handle as *mut GoslingContext;\n\n        Ok(())\n    });\n}\n\n/// Connect a gosling_context to the tor network\n///\n/// @param context: the gosling context object to connect to the tor network\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_bootstrap_tor(\n    context: *mut GoslingContext,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(context);\n\n        let mut context_tuple_registry = get_context_tuple_registry();\n        let context = match context_tuple_registry.get_mut(context as usize) {\n            Some(context) =\u003e context,\n            None =\u003e bail_invalid_handle!(context),\n        };\n        Ok(context.0.bootstrap()?)\n    });\n}\n\n/// Start the identity server so that clients may request endpoints\n///\n/// @param context: the gosling context whose identity server to start\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_start_identity_server(\n    context: *mut GoslingContext,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(context);\n\n        let mut context_tuple_registry = get_context_tuple_registry();\n        let context = match context_tuple_registry.get_mut(context as usize) {\n            Some(context) =\u003e context,\n            None =\u003e bail_invalid_handle!(context),\n        };\n        Ok(context.0.identity_server_start()?)\n    });\n}\n\n/// Stop the identity server so clients can no longer request endpoints\n///\n/// @param context: the gosling context whose identity server to stop\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_stop_identity_server(\n    context: *mut GoslingContext,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(context);\n\n        let mut context_tuple_registry = get_context_tuple_registry();\n        let context = match context_tuple_registry.get_mut(context as usize) {\n            Some(context) =\u003e context,\n            None =\u003e bail_invalid_handle!(context),\n        };\n        Ok(context.0.identity_server_stop()?)\n    });\n}\n\n/// Start an endpoint server so the confirmed contact may connect\n///\n/// @param context: the gosling context with the given endpoint to start\n/// @param endpoint_private_key: the ed25519 private key needed to start the endpoint\n///  onion service\n/// @param endpoint_name: the ascii-encoded name of the endpoint server\n/// @param endpoint_name_length: the number of chars in endpoint name not including any null-terminator\n/// @param client_identity: the v3 onion service id of the gosling client associated with this endpoint\n/// @param client_auth_public_key: the x25519 public key used to encrypt the onion service descriptor\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_start_endpoint_server(\n    context: *mut GoslingContext,\n    endpoint_private_key: *const GoslingEd25519PrivateKey,\n    endpoint_name: *const c_char,\n    endpoint_name_length: usize,\n    client_identity: *const GoslingV3OnionServiceId,\n    client_auth_public_key: *const GoslingX25519PublicKey,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(context);\n        ensure_not_null!(endpoint_private_key);\n        ensure_not_null!(endpoint_name);\n        ensure_not_equal!(endpoint_name_length, 0);\n        ensure_not_null!(client_identity);\n        ensure_not_null!(client_auth_public_key);\n\n        let mut context_tuple_registry = get_context_tuple_registry();\n        let context = match context_tuple_registry.get_mut(context as usize) {\n            Some(context) =\u003e context,\n            None =\u003e bail_invalid_handle!(context),\n        };\n\n        let endpoint_name =\n            unsafe { std::slice::from_raw_parts(endpoint_name as *const u8, endpoint_name_length) };\n        let endpoint_name = std::str::from_utf8(endpoint_name)?.to_string();\n        if !endpoint_name.is_ascii() {\n            bail!(\"endpoint_name must be an ascii string\");\n        }\n\n        let ed25519_private_key_registry = get_ed25519_private_key_registry();\n        let endpoint_private_key =\n            match ed25519_private_key_registry.get(endpoint_private_key as usize) {\n                Some(ed25519_private_key) =\u003e ed25519_private_key,\n                None =\u003e bail_invalid_handle!(endpoint_private_key),\n            };\n\n        let v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n        let client_identity = match v3_onion_service_id_registry.get(client_identity as usize) {\n            Some(v3_onion_service_id) =\u003e v3_onion_service_id,\n            None =\u003e bail_invalid_handle!(client_identity),\n        };\n\n        let x25519_public_key_registry = get_x25519_public_key_registry();\n        let client_auth_public_key =\n            match x25519_public_key_registry.get(client_auth_public_key as usize) {\n                Some(x25519_public_key) =\u003e x25519_public_key,\n                None =\u003e bail_invalid_handle!(client_auth_public_key),\n            };\n\n        Ok(context.0.endpoint_server_start(\n            endpoint_private_key.clone(),\n            endpoint_name,\n            client_identity.clone(),\n            client_auth_public_key.clone(),\n        )?)\n    });\n}\n\n/// Stops an endpoint server\n///\n/// @param context: the gosling context associated with the endpoint server\n/// @param endpoint_private_key: the ed25519 private key associated with the endpoint server to stop\n/// @param error: filled on erro\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_stop_endpoint_server(\n    context: *mut GoslingContext,\n    endpoint_private_key: *const GoslingEd25519PrivateKey,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(context);\n        ensure_not_null!(endpoint_private_key);\n\n        let mut context_tuple_registry = get_context_tuple_registry();\n        let context = match context_tuple_registry.get_mut(context as usize) {\n            Some(context) =\u003e context,\n            None =\u003e bail_invalid_handle!(context),\n        };\n\n        let ed25519_private_key_registry = get_ed25519_private_key_registry();\n        let endpoint_private_key =\n            match ed25519_private_key_registry.get(endpoint_private_key as usize) {\n                Some(ed25519_private_key) =\u003e ed25519_private_key,\n                None =\u003e bail_invalid_handle!(endpoint_private_key),\n            };\n\n        let endpoint_identity = V3OnionServiceId::from_private_key(endpoint_private_key);\n        Ok(context.0.endpoint_server_stop(endpoint_identity)?)\n    });\n}\n\n/// Connect to and begin a handshake to request an endpoint from the given identity server\n///\n/// @param context: the context to request an endpoint server for\n/// @param identity_service_id: the service id of the identity server we want to request an endpoint server\n///  from\n/// @param endpoint_name: the name of the endpoint server to request\n/// @param endpoint_name_length: the number of chars in endpoin_name not including any null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_begin_identity_handshake(\n    context: *mut GoslingContext,\n    identity_service_id: *const GoslingV3OnionServiceId,\n    endpoint_name: *const c_char,\n    endpoint_name_length: usize,\n    error: *mut *mut GoslingError,\n) -\u003e GoslingHandshakeHandle {\n    translate_failures(\n        !0usize,\n        error,\n        || -\u003e anyhow::Result\u003cGoslingHandshakeHandle\u003e {\n            ensure_not_null!(context);\n            ensure_not_null!(identity_service_id);\n            ensure_not_null!(endpoint_name);\n            ensure_not_equal!(endpoint_name_length, 0);\n\n            let mut context_tuple_registry = get_context_tuple_registry();\n            let context = match context_tuple_registry.get_mut(context as usize) {\n                Some(context) =\u003e context,\n                None =\u003e bail_invalid_handle!(context),\n            };\n\n            let v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n            let identity_service_id =\n                match v3_onion_service_id_registry.get(identity_service_id as usize) {\n                    Some(v3_onion_service_id) =\u003e v3_onion_service_id,\n                    None =\u003e bail_invalid_handle!(identity_service_id),\n                };\n\n            let endpoint_name = unsafe {\n                std::slice::from_raw_parts(endpoint_name as *const u8, endpoint_name_length)\n            };\n            let endpoint_name = std::str::from_utf8(endpoint_name)?.to_string();\n            if !endpoint_name.is_ascii() {\n                bail!(\"endpoint_name must be an ascii string\")\n            }\n\n            Ok(context\n                .0\n                .identity_client_begin_handshake(identity_service_id.clone(), endpoint_name)?)\n        },\n    )\n}\n\n/// Abort an in-progress identity client handshake\n///\n/// @param context: the context associated with the identity client handshake handle\n/// @param handshake_handle: the handle associated with the identity client handshake\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_abort_identity_client_handshake(\n    context: *mut GoslingContext,\n    handshake_handle: GoslingHandshakeHandle,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(context);\n\n        let mut context_tuple_registry = get_context_tuple_registry();\n        let context = match context_tuple_registry.get_mut(context as usize) {\n            Some(context) =\u003e context,\n            None =\u003e bail_invalid_handle!(context),\n        };\n\n        Ok(context\n            .0\n            .identity_client_abort_handshake(handshake_handle)?)\n    })\n}\n\n/// Connect to and begin a handshake to request a channel from the given endpoint server\n///\n/// @param context: the context which will be opening the channel\n/// @param endpoint_service_id: the endpoint server to open a channel to\n/// @param client_auth_private_key: the x25519 clienth authorization key needed to decrypt the endpoint server's\n///  onion service descriptor\n/// @param channel_name: the ascii-encoded name of the channel to open\n/// @param channel_name_length: the number of chars in channel name not including any null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_begin_endpoint_handshake(\n    context: *mut GoslingContext,\n    endpoint_service_id: *const GoslingV3OnionServiceId,\n    client_auth_private_key: *const GoslingX25519PrivateKey,\n    channel_name: *const c_char,\n    channel_name_length: usize,\n    error: *mut *mut GoslingError,\n) -\u003e GoslingHandshakeHandle {\n    translate_failures(\n        !0usize,\n        error,\n        || -\u003e anyhow::Result\u003cGoslingHandshakeHandle\u003e {\n            ensure_not_null!(context);\n            ensure_not_null!(endpoint_service_id);\n            ensure_not_null!(client_auth_private_key);\n            ensure_not_null!(channel_name);\n            ensure_not_equal!(channel_name_length, 0);\n\n            let mut context_tuple_registry = get_context_tuple_registry();\n            let context = match context_tuple_registry.get_mut(context as usize) {\n                Some(context) =\u003e context,\n                None =\u003e bail_invalid_handle!(context),\n            };\n\n            let v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n            let endpoint_service_id =\n                match v3_onion_service_id_registry.get(endpoint_service_id as usize) {\n                    Some(v3_onion_service_id) =\u003e v3_onion_service_id,\n                    None =\u003e bail_invalid_handle!(endpoint_service_id),\n                };\n\n            let x25519_private_key_registry = get_x25519_private_key_registry();\n            let client_auth_private_key =\n                match x25519_private_key_registry.get(client_auth_private_key as usize) {\n                    Some(x25519_private_key) =\u003e x25519_private_key,\n                    None =\u003e bail_invalid_handle!(client_auth_private_key),\n                };\n\n            let channel_name = unsafe {\n                std::slice::from_raw_parts(channel_name as *const u8, channel_name_length)\n            };\n            let channel_name = std::str::from_utf8(channel_name)?.to_string();\n            if !channel_name.is_ascii() {\n                bail!(\"channel_name must be an ascii string\");\n            }\n\n            Ok(context.0.endpoint_client_begin_handshake(\n                endpoint_service_id.clone(),\n                client_auth_private_key.clone(),\n                channel_name,\n            )?)\n        },\n    )\n}\n\n/// Abort an in-progress endpoint client handshake\n///\n/// @param context: the context associated with the endpoint client handshake handle\n/// @param handshake_handle: the handle associated with the identity client handshake\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_abort_endpoint_client_handshake(\n    context: *mut GoslingContext,\n    handshake_handle: GoslingHandshakeHandle,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(context);\n\n        let mut context_tuple_registry = get_context_tuple_registry();\n        let context = match context_tuple_registry.get_mut(context as usize) {\n            Some(context) =\u003e context,\n            None =\u003e bail_invalid_handle!(context),\n        };\n\n        Ok(context\n            .0\n            .endpoint_client_abort_handshake(handshake_handle)?)\n    })\n}\n\nfn handle_context_event(\n    event: ContextEvent,\n    context: *mut GoslingContext,\n    callbacks: \u0026EventCallbacks,\n) -\u003e anyhow::Result\u003c()\u003e {\n    match event {\n        //\n        // Tor Events\n        //\n        ContextEvent::TorBootstrapStatusReceived {\n            progress,\n            tag,\n            summary,\n        } =\u003e {\n            if let Some(callback) = callbacks.tor_bootstrap_status_received_callback {\n                let tag0 = CString::new(tag.as_str()).expect(\n                    \"bootstrap status tag string should not have an intermediate null byte\",\n                );\n                let summary0 = CString::new(summary.as_str()).expect(\n                    \"bootstrap status summary string should not have an intermediate null byte\",\n                );\n                callback(\n                    context,\n                    progress,\n                    tag0.as_ptr(),\n                    tag.len(),\n                    summary0.as_ptr(),\n                    summary.len(),\n                );\n            }\n        }\n        ContextEvent::TorBootstrapCompleted =\u003e {\n            if let Some(callback) = callbacks.tor_bootstrap_completed_callback {\n                callback(context);\n            }\n        }\n        ContextEvent::TorLogReceived { line } =\u003e {\n            if let Some(callback) = callbacks.tor_log_received_callback {\n                let line0 = CString::new(line.as_str())\n                    .expect(\"tor log line string should not have an intermediate null byte\");\n                callback(context, line0.as_ptr(), line.len());\n            }\n        }\n        //\n        // Identity Client Events\n        //\n        ContextEvent::IdentityClientChallengeReceived {\n            handle,\n            endpoint_challenge,\n        } =\u003e {\n            // construct challenge response\n            let challenge_response = if let (\n                Some(challenge_response_size_callback),\n                Some(build_challenge_response_callback),\n            ) = (\n                callbacks.identity_client_challenge_response_size_callback,\n                callbacks.identity_client_build_challenge_response_callback,\n            ) {\n                let mut endpoint_challenge_buffer: Vec\u003cu8\u003e = Default::default();\n                endpoint_challenge.to_writer(\u0026mut endpoint_challenge_buffer).expect(\"endpoint_challenge should be a valid bson::document::Document and therefore serializable to Vec\u003cu8\u003e\");\n\n                // get the size of challenge response bson blob\n                let challenge_response_size = challenge_response_size_callback(\n                    context,\n                    handle,\n                    endpoint_challenge_buffer.as_ptr(),\n                    endpoint_challenge_buffer.len(),\n                );\n\n                if challenge_response_size \u003c SMALLEST_BSON_DOC_SIZE {\n                    bail!(\"identity_client_challenge_response_size_callback returned an impossibly small size '{}', smallest possible is {}\", challenge_response_size, SMALLEST_BSON_DOC_SIZE);\n                }\n\n                // get the challenge response bson blob\n                let mut challenge_response_buffer: Vec\u003cu8\u003e = vec![0u8; challenge_response_size];\n                build_challenge_response_callback(\n                    context,\n                    handle,\n                    endpoint_challenge_buffer.as_ptr(),\n                    endpoint_challenge_buffer.len(),\n                    challenge_response_buffer.as_mut_ptr(),\n                    challenge_response_buffer.len(),\n                );\n\n                // convert bson blob to bson object\n                match bson::document::Document::from_reader(Cursor::new(challenge_response_buffer))\n                {\n                    Ok(challenge_response) =\u003e challenge_response,\n                    Err(_) =\u003e bail!(\"failed to parse binary provided by identity_client_build_challenge_response_callback as BSON document\")\n                }\n            } else {\n                bail!(\"missing required identity_client_challenge_response_size() and identity_client_build_challenge_response() callbacks\");\n            };\n\n            match get_context_tuple_registry().get_mut(context as usize) {\n                Some(context) =\u003e context\n                    .0\n                    .identity_client_handle_challenge_received(handle, challenge_response)?,\n                None =\u003e bail_invalid_handle!(context),\n            };\n        }\n        ContextEvent::IdentityClientHandshakeCompleted {\n            handle,\n            identity_service_id,\n            endpoint_service_id,\n            endpoint_name,\n            client_auth_private_key,\n        } =\u003e {\n            if let Some(callback) = callbacks.identity_client_handshake_completed_callback {\n                let (identity_service_id, endpoint_service_id) = {\n                    let mut v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n                    let identity_service_id =\n                        v3_onion_service_id_registry.insert(identity_service_id);\n                    let endpoint_service_id =\n                        v3_onion_service_id_registry.insert(endpoint_service_id);\n                    (identity_service_id, endpoint_service_id)\n                };\n\n                let endpoint_name0 = CString::new(endpoint_name.as_str())\n                    .expect(\"endpoint_name should be a valid ASCII string and not have an intermediate null byte\");\n\n                let client_auth_private_key =\n                    get_x25519_private_key_registry().insert(client_auth_private_key);\n\n                callback(\n                    context,\n                    handle,\n                    identity_service_id as *const GoslingV3OnionServiceId,\n                    endpoint_service_id as *const GoslingV3OnionServiceId,\n                    endpoint_name0.as_ptr(),\n                    endpoint_name.len(),\n                    client_auth_private_key as *const GoslingX25519PrivateKey,\n                );\n\n                // cleanup\n                {\n                    let mut v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n                    v3_onion_service_id_registry.remove(identity_service_id);\n                    v3_onion_service_id_registry.remove(endpoint_service_id);\n                }\n                get_x25519_private_key_registry().remove(client_auth_private_key);\n            } else {\n                bail!(\"missing required identity_client_handshake_completed() callback\");\n            }\n        }\n        ContextEvent::IdentityClientHandshakeFailed { handle, reason } =\u003e {\n            if let Some(callback) = callbacks.identity_client_handshake_failed_callback {\n                let key = get_error_registry().insert(Error::new(format!(\"{:?}\", reason).as_str()));\n                callback(context, handle, key as *const GoslingError);\n                get_error_registry().remove(key);\n            }\n        }\n        //\n        // Identity Server Events\n        //\n        ContextEvent::IdentityServerPublished =\u003e {\n            if let Some(callback) = callbacks.identity_server_published_callback {\n                callback(context);\n            }\n        }\n        ContextEvent::IdentityServerHandshakeStarted { handle } =\u003e {\n            if let Some(callback) = callbacks.identity_server_handshake_started_callback {\n                callback(context, handle);\n            }\n        }\n        ContextEvent::IdentityServerEndpointRequestReceived {\n            handle,\n            client_service_id,\n            requested_endpoint,\n        } =\u003e {\n            let client_allowed = match callbacks.identity_server_client_allowed_callback {\n                Some(callback) =\u003e {\n                    let client_service_id =\n                        get_v3_onion_service_id_registry().insert(client_service_id);\n                    callback(\n                        context,\n                        handle,\n                        client_service_id as *const GoslingV3OnionServiceId,\n                    )\n                }\n                None =\u003e bail!(\"missing required identity_server_client_allowed() callback\"),\n            };\n\n            let endpoint_supported = match callbacks.identity_server_endpoint_supported_callback {\n                Some(callback) =\u003e {\n                    let requested_endpoint0 = CString::new(requested_endpoint.as_str()).expect(\n                        \"requested_endpoint should be a valid ASCII string and not have an intermediate null byte\",\n                    );\n                    callback(\n                        context,\n                        handle,\n                        requested_endpoint0.as_ptr(),\n                        requested_endpoint.len(),\n                    )\n                }\n                None =\u003e bail!(\"missing required identity_server_endpoint_supported() callback\"),\n            };\n            let endpoint_challenge = if let (\n                Some(challenge_size_callback),\n                Some(build_challenge_callback),\n            ) = (\n                callbacks.identity_server_challenge_size_callback,\n                callbacks.identity_server_build_challenge_callback,\n            ) {\n                // get the challenge size in bytes\n                let challenge_size = challenge_size_callback(context, handle);\n\n                if challenge_size \u003c SMALLEST_BSON_DOC_SIZE {\n                    bail!(\"identity_server_challenge_size_callback returned an impossibly small size '{}', smallest possible is {}\", challenge_size, SMALLEST_BSON_DOC_SIZE);\n                }\n\n                // construct challenge object into buffer\n                let mut challenge_buffer = vec![0u8; challenge_size];\n                build_challenge_callback(\n                    context,\n                    handle,\n                    challenge_buffer.as_mut_ptr(),\n                    challenge_size,\n                );\n\n                // convert bson blob to bson object\n                match bson::document::Document::from_reader(Cursor::new(challenge_buffer)) {\n                    Ok(challenge) =\u003e challenge,\n                    Err(_) =\u003e bail!(\"failed to parse binary provided by identity_server_build_challenge_callback as BSON document\")\n                }\n            } else {\n                bail!(\"missing required identity_server_challenge_size() and identity_server_build_challenge() callbacks\");\n            };\n\n            match get_context_tuple_registry().get_mut(context as usize) {\n                Some(context) =\u003e context.0.identity_server_handle_endpoint_request_received(\n                    handle,\n                    client_allowed,\n                    endpoint_supported,\n                    endpoint_challenge,\n                )?,\n                None =\u003e bail_invalid_handle!(context),\n            };\n        }\n        ContextEvent::IdentityServerChallengeResponseReceived {\n            handle,\n            challenge_response,\n        } =\u003e {\n            let challenge_response_valid = match callbacks\n                .identity_server_verify_challenge_response_callback\n            {\n                Some(callback) =\u003e {\n                    // get response as bytes\n                    let mut challenge_response_buffer: Vec\u003cu8\u003e = Default::default();\n                    challenge_response\n                            .to_writer(\u0026mut challenge_response_buffer).expect(\"challenge_response should be a valid bson::document::Document and therefore serializable to Vec\u003cu8\u003e\");\n\n                    callback(\n                        context,\n                        handle,\n                        challenge_response_buffer.as_ptr(),\n                        challenge_response_buffer.len(),\n                    )\n                }\n                None =\u003e {\n                    bail!(\"missing required identity_server_verify_challenge_response() callback()\")\n                }\n            };\n\n            match get_context_tuple_registry().get_mut(context as usize) {\n                Some(context) =\u003e context\n                    .0\n                    .identity_server_handle_challenge_response_received(\n                        handle,\n                        challenge_response_valid,\n                    )?,\n                None =\u003e bail_invalid_handle!(context),\n            };\n        }\n        ContextEvent::IdentityServerHandshakeCompleted {\n            handle,\n            endpoint_private_key,\n            endpoint_name,\n            client_service_id,\n            client_auth_public_key,\n        } =\u003e {\n            if let Some(callback) = callbacks.identity_server_handshake_completed_callback {\n                let endpoint_private_key = {\n                    let mut ed25519_private_key_registry = get_ed25519_private_key_registry();\n                    ed25519_private_key_registry.insert(endpoint_private_key)\n                };\n\n                let endpoint_name0 = CString::new(endpoint_name.as_str())\n                    .expect(\"endpoint_name should be a valid ASCII string and not have an intermediate null byte\");\n\n                let client_service_id = {\n                    let mut v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n                    v3_onion_service_id_registry.insert(client_service_id)\n                };\n\n                let client_auth_public_key = {\n                    let mut x25519_public_key_registry = get_x25519_public_key_registry();\n                    x25519_public_key_registry.insert(client_auth_public_key)\n                };\n\n                callback(\n                    context,\n                    handle,\n                    endpoint_private_key as *const GoslingEd25519PrivateKey,\n                    endpoint_name0.as_ptr(),\n                    endpoint_name.len(),\n                    client_service_id as *const GoslingV3OnionServiceId,\n                    client_auth_public_key as *const GoslingX25519PublicKey,\n                );\n\n                // cleanup\n                get_ed25519_private_key_registry().remove(endpoint_private_key);\n                get_v3_onion_service_id_registry().remove(client_service_id);\n                get_x25519_public_key_registry().remove(client_auth_public_key);\n            } else {\n                bail!(\"missing required identity_server_handshake_completed_callback()\");\n            }\n        }\n        ContextEvent::IdentityServerHandshakeRejected {\n            handle,\n            client_allowed,\n            client_requested_endpoint_valid,\n            client_proof_signature_valid,\n            client_auth_signature_valid,\n            challenge_response_valid,\n        } =\u003e {\n            if let Some(callback) = callbacks.identity_server_handshake_rejected_callback {\n                callback(\n                    context,\n                    handle,\n                    client_allowed,\n                    client_requested_endpoint_valid,\n                    client_proof_signature_valid,\n                    client_auth_signature_valid,\n                    challenge_response_valid,\n                );\n            }\n        }\n        ContextEvent::IdentityServerHandshakeFailed { handle, reason } =\u003e {\n            if let Some(callback) = callbacks.identity_server_handshake_failed_callback {\n                let key = get_error_registry().insert(Error::new(format!(\"{:?}\", reason).as_str()));\n                callback(context, handle, key as *const GoslingError);\n                get_error_registry().remove(key);\n            }\n        }\n        //\n        // Endpoint Client Events\n        //\n        ContextEvent::EndpointClientHandshakeCompleted {\n            endpoint_service_id,\n            handle,\n            channel_name,\n            stream,\n        } =\u003e {\n            if let Some(callback) = callbacks.endpoint_client_handshake_completed_callback {\n                let endpoint_service_id = {\n                    let mut v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n                    v3_onion_service_id_registry.insert(endpoint_service_id)\n                };\n                let channel_name0 = CString::new(channel_name.as_str())\n                    .expect(\"channel_name should be a valid ASCII string and not have an intermediate null byte\");\n\n                #[cfg(any(target_os = \"linux\", target_os = \"macos\"))]\n                let stream = stream.into_raw_fd();\n                #[cfg(target_os = \"windows\")]\n                let stream = stream.into_raw_socket();\n\n                callback(\n                    context,\n                    handle,\n                    endpoint_service_id as *const GoslingV3OnionServiceId,\n                    channel_name0.as_ptr(),\n                    channel_name.len(),\n                    stream,\n                );\n\n                // cleanup\n                get_v3_onion_service_id_registry().remove(endpoint_service_id);\n            } else {\n                bail!(\"missing required endpoint_client_handshake_completed() callback\");\n            }\n        }\n        ContextEvent::EndpointClientHandshakeFailed { handle, reason } =\u003e {\n            if let Some(callback) = callbacks.endpoint_client_handshake_failed_callback {\n                let key = get_error_registry().insert(Error::new(format!(\"{:?}\", reason).as_str()));\n                callback(context, handle, key as *const GoslingError);\n                get_error_registry().remove(key);\n            }\n        }\n        //\n        // Endpoint Server Events\n        //\n        ContextEvent::EndpointServerPublished {\n            endpoint_service_id,\n            endpoint_name,\n        } =\u003e {\n            if let Some(callback) = callbacks.endpoint_server_published_callback {\n                let endpoint_service_id = {\n                    let mut v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n                    v3_onion_service_id_registry.insert(endpoint_service_id)\n                };\n                let endpoint_name0 = CString::new(endpoint_name.as_str())\n                    .expect(\"endpoint_name should be a valid ASCII string and not have an intermediate null byte\");\n\n                callback(\n                    context,\n                    endpoint_service_id as *const GoslingV3OnionServiceId,\n                    endpoint_name0.as_ptr(),\n                    endpoint_name.len(),\n                );\n\n                // cleanup\n                get_v3_onion_service_id_registry().remove(endpoint_service_id);\n            }\n        }\n        ContextEvent::EndpointServerHandshakeStarted { handle } =\u003e {\n            if let Some(callback) = callbacks.endpoint_server_handshake_started_callback {\n                callback(context, handle);\n            }\n        }\n        ContextEvent::EndpointServerChannelRequestReceived {\n            handle,\n            client_service_id,\n            requested_channel,\n        } =\u003e {\n            let channel_supported: bool = match callbacks.endpoint_server_channel_supported_callback\n            {\n                Some(callback) =\u003e {\n                    let client_service_id = {\n                        let mut v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n                        v3_onion_service_id_registry.insert(client_service_id)\n                    };\n                    let requested_channel0 = CString::new(requested_channel.as_str()).expect(\"requested_channel should be a valid ASCII string and not have an intermediate null byte\",\n                    );\n                    let channel_supported = callback(\n                        context,\n                        handle,\n                        client_service_id as *const GoslingV3OnionServiceId,\n                        requested_channel0.as_ptr(),\n                        requested_channel.len(),\n                    );\n\n                    // cleanup\n                    get_v3_onion_service_id_registry().remove(client_service_id);\n                    channel_supported\n                }\n                None =\u003e bail!(\"missing required endpoint_server_channel_supported() callback\"),\n            };\n\n            match get_context_tuple_registry().get_mut(context as usize) {\n                Some(context) =\u003e context\n                    .0\n                    .endpoint_server_handle_channel_request_received(handle, channel_supported)?,\n                None =\u003e return Err(anyhow!(\"context is invalid\")),\n            };\n        }\n        ContextEvent::EndpointServerHandshakeCompleted {\n            handle,\n            endpoint_service_id,\n            client_service_id,\n            channel_name,\n            stream,\n        } =\u003e {\n            if let Some(callback) = callbacks.endpoint_server_handshake_completed_callback {\n                let (endpoint_service_id, client_service_id) = {\n                    let mut v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n                    let endpoint_service_id =\n                        v3_onion_service_id_registry.insert(endpoint_service_id);\n                    let client_service_id = v3_onion_service_id_registry.insert(client_service_id);\n                    (endpoint_service_id, client_service_id)\n                };\n\n                let channel_name0 = CString::new(channel_name.as_str())\n                    .expect(\"channel_name should be a valid ASCII string and not have an intermediate null byte\");\n\n                #[cfg(any(target_os = \"linux\", target_os = \"macos\"))]\n                let stream = stream.into_raw_fd();\n                #[cfg(target_os = \"windows\")]\n                let stream = stream.into_raw_socket();\n\n                callback(\n                    context,\n                    handle,\n                    endpoint_service_id as *const GoslingV3OnionServiceId,\n                    client_service_id as *const GoslingV3OnionServiceId,\n                    channel_name0.as_ptr(),\n                    channel_name.len(),\n                    stream,\n                );\n\n                // cleanup\n                {\n                    let mut v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n                    v3_onion_service_id_registry.remove(endpoint_service_id);\n                    v3_onion_service_id_registry.remove(client_service_id);\n                }\n            } else {\n                bail!(\"missing required endpoint_server_handshake_completed() callback\");\n            }\n        }\n        ContextEvent::EndpointServerHandshakeRejected {\n            handle,\n            client_allowed,\n            client_requested_channel_valid,\n            client_proof_signature_valid,\n        } =\u003e {\n            if let Some(callback) = callbacks.endpoint_server_handshake_rejected_callback {\n                callback(\n                    context,\n                    handle,\n                    client_allowed,\n                    client_requested_channel_valid,\n                    client_proof_signature_valid,\n                );\n            }\n        }\n        ContextEvent::EndpointServerHandshakeFailed { handle, reason } =\u003e {\n            if let Some(callback) = callbacks.endpoint_server_handshake_failed_callback {\n                let key = get_error_registry().insert(Error::new(format!(\"{:?}\", reason).as_str()));\n                callback(context, handle, key as *const GoslingError);\n                get_error_registry().remove(key);\n            }\n        }\n    }\n    Ok(())\n}\n\n/// Update the internal gosling context state and process event callbacks\n///\n/// @param context: the context object we are updating\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_poll_events(\n    context: *mut GoslingContext,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        // we need to scope the context registry explicitly here\n        // in case our callbacks want to call any gosling functions\n        // to avoid deadlock (since a mutex is held while the context_tuple_registry\n        // is accesible)\n        let (mut context_events, callbacks) =\n            match get_context_tuple_registry().get_mut(context as usize) {\n                Some(context) =\u003e {\n                    // get our new events\n                    let mut new_events = context.0.update()?;\n                    // get a copy of our callbacks\n                    let callbacks = context.1.clone();\n\n                    // append new_events to any existing events if they exist,\n                    // otherwise just pass through new_events\n                    let context_events = match std::mem::take(\u0026mut context.2) {\n                        Some(mut context_events) =\u003e {\n                            context_events.append(\u0026mut new_events);\n                            context_events\n                        }\n                        None =\u003e {\n                            // no previous events so just pass through the new events\n                            new_events\n                        }\n                    };\n                    (context_events, callbacks)\n                }\n                None =\u003e bail_invalid_handle!(context),\n            };\n\n        // consume the events and trigger any callbacks\n        while let Some(event) = context_events.pop_front() {\n            let result = handle_context_event(event, context, \u0026callbacks);\n            if result.is_err() {\n                // if we have remaining events to consume, save them off on\n                // the context\n                if !context_events.is_empty() {\n                    if let Some(context) = get_context_tuple_registry().get_mut(context as usize) {\n                        context.2 = Some(context_events);\n                    }\n                }\n                // return the error\n                return result;\n            }\n        }\n        Ok(())\n    });\n}\n","traces":[{"line":57,"address":[1638240,1638271],"length":1,"stats":{"Line":0}},{"line":72,"address":[2229535,2229424],"length":1,"stats":{"Line":1}},{"line":81,"address":[1840326,1840438,1837760],"length":1,"stats":{"Line":2}},{"line":82,"address":[1837815],"length":1,"stats":{"Line":1}},{"line":83,"address":[2037407],"length":1,"stats":{"Line":1}},{"line":86,"address":[1838243],"length":1,"stats":{"Line":1}},{"line":89,"address":[1838259,1838443],"length":1,"stats":{"Line":2}},{"line":90,"address":[1838576],"length":1,"stats":{"Line":1}},{"line":95,"address":[1838769],"length":1,"stats":{"Line":1}},{"line":97,"address":[2038428,2038515],"length":1,"stats":{"Line":2}},{"line":98,"address":[1839022],"length":1,"stats":{"Line":1}},{"line":103,"address":[2039036,2039423,2040011,2039143],"length":1,"stats":{"Line":2}},{"line":104,"address":[1839046],"length":1,"stats":{"Line":1}},{"line":105,"address":[1839094,1839102],"length":1,"stats":{"Line":2}},{"line":106,"address":[1839098,1839113],"length":1,"stats":{"Line":2}},{"line":107,"address":[2038746],"length":1,"stats":{"Line":1}},{"line":109,"address":[2038925],"length":1,"stats":{"Line":1}},{"line":110,"address":[1839360],"length":1,"stats":{"Line":1}},{"line":113,"address":[2039507,2039276],"length":1,"stats":{"Line":2}},{"line":114,"address":[1840218,1840292],"length":1,"stats":{"Line":1}},{"line":116,"address":[1840252],"length":1,"stats":{"Line":1}},{"line":126,"address":[1638560,1638597],"length":1,"stats":{"Line":1}},{"line":130,"address":[1841106,1840480],"length":1,"stats":{"Line":2}},{"line":131,"address":[1840492],"length":1,"stats":{"Line":1}},{"line":133,"address":[1840509],"length":1,"stats":{"Line":1}},{"line":134,"address":[1840649,1840531],"length":1,"stats":{"Line":2}},{"line":135,"address":[1840738],"length":1,"stats":{"Line":1}},{"line":138,"address":[1840487,1841086,1840751,1840846,1840897],"length":1,"stats":{"Line":3}},{"line":148,"address":[1638624,1638661],"length":1,"stats":{"Line":1}},{"line":152,"address":[1638654],"length":1,"stats":{"Line":2}},{"line":153,"address":[1841148],"length":1,"stats":{"Line":1}},{"line":155,"address":[2040846],"length":1,"stats":{"Line":1}},{"line":156,"address":[1841305,1841187],"length":1,"stats":{"Line":2}},{"line":157,"address":[1841394],"length":1,"stats":{"Line":1}},{"line":160,"address":[1841143,1841407,1841742,1841502,1841553],"length":1,"stats":{"Line":3}},{"line":170,"address":[1638725,1638688],"length":1,"stats":{"Line":0}},{"line":174,"address":[1842418,1841792],"length":1,"stats":{"Line":0}},{"line":175,"address":[1841804],"length":1,"stats":{"Line":0}},{"line":177,"address":[1841821],"length":1,"stats":{"Line":0}},{"line":178,"address":[1841961,1841843],"length":1,"stats":{"Line":0}},{"line":179,"address":[1842050],"length":1,"stats":{"Line":0}},{"line":182,"address":[1842398,1842158,1842209,1841799,1842063],"length":1,"stats":{"Line":0}},{"line":198,"address":[1638752,1638866],"length":1,"stats":{"Line":1}},{"line":207,"address":[2045540,2042192],"length":1,"stats":{"Line":2}},{"line":208,"address":[1842487],"length":1,"stats":{"Line":1}},{"line":209,"address":[1842510],"length":1,"stats":{"Line":1}},{"line":210,"address":[1842618],"length":1,"stats":{"Line":1}},{"line":212,"address":[1842907],"length":1,"stats":{"Line":1}},{"line":213,"address":[1842949],"length":1,"stats":{"Line":1}},{"line":215,"address":[2042809],"length":1,"stats":{"Line":1}},{"line":216,"address":[2042832,2043006],"length":1,"stats":{"Line":2}},{"line":217,"address":[1843346],"length":1,"stats":{"Line":1}},{"line":222,"address":[1843370,1843500],"length":1,"stats":{"Line":2}},{"line":223,"address":[2043301,2045648],"length":1,"stats":{"Line":1}},{"line":224,"address":[1843701,1843781],"length":1,"stats":{"Line":2}},{"line":225,"address":[1843808,1843864],"length":1,"stats":{"Line":0}},{"line":228,"address":[1843834,1843940],"length":1,"stats":{"Line":2}},{"line":230,"address":[1844036,1843965],"length":1,"stats":{"Line":2}},{"line":231,"address":[1844145],"length":1,"stats":{"Line":1}},{"line":235,"address":[2044067,2043967],"length":1,"stats":{"Line":2}},{"line":236,"address":[1844348,1844283],"length":1,"stats":{"Line":2}},{"line":237,"address":[2044272],"length":1,"stats":{"Line":1}},{"line":241,"address":[1844472,1844564],"length":1,"stats":{"Line":2}},{"line":243,"address":[1844589,1844654],"length":1,"stats":{"Line":2}},{"line":244,"address":[1844762],"length":1,"stats":{"Line":1}},{"line":248,"address":[1845027,1845126,1845317,1845562],"length":1,"stats":{"Line":2}},{"line":249,"address":[1844783,1844887],"length":1,"stats":{"Line":2}},{"line":250,"address":[1844895],"length":1,"stats":{"Line":1}},{"line":251,"address":[1844951],"length":1,"stats":{"Line":1}},{"line":252,"address":[1845012],"length":1,"stats":{"Line":1}},{"line":264,"address":[1638929,1638880],"length":1,"stats":{"Line":0}},{"line":269,"address":[2045664,2046936],"length":1,"stats":{"Line":0}},{"line":270,"address":[1845793],"length":1,"stats":{"Line":0}},{"line":271,"address":[1845810],"length":1,"stats":{"Line":0}},{"line":273,"address":[2045791],"length":1,"stats":{"Line":0}},{"line":274,"address":[1845930,1846066],"length":1,"stats":{"Line":0}},{"line":275,"address":[2046076],"length":1,"stats":{"Line":0}},{"line":279,"address":[2046097,2046191],"length":1,"stats":{"Line":0}},{"line":281,"address":[1846362,1846305],"length":1,"stats":{"Line":0}},{"line":282,"address":[2046389],"length":1,"stats":{"Line":0}},{"line":286,"address":[1846482],"length":1,"stats":{"Line":0}},{"line":287,"address":[1846583,1846941,1845783,1846686],"length":1,"stats":{"Line":0}},{"line":301,"address":[2230040,2229936],"length":1,"stats":{"Line":1}},{"line":311,"address":[2049175,2046960],"length":1,"stats":{"Line":2}},{"line":312,"address":[2046983],"length":1,"stats":{"Line":1}},{"line":313,"address":[1847054],"length":1,"stats":{"Line":1}},{"line":314,"address":[2047130],"length":1,"stats":{"Line":1}},{"line":317,"address":[2047457],"length":1,"stats":{"Line":1}},{"line":318,"address":[2047480,2047591],"length":1,"stats":{"Line":2}},{"line":319,"address":[1847728],"length":1,"stats":{"Line":1}},{"line":323,"address":[2047845,2047724],"length":1,"stats":{"Line":2}},{"line":325,"address":[2047943,2047862],"length":1,"stats":{"Line":2}},{"line":326,"address":[1848066],"length":1,"stats":{"Line":1}},{"line":331,"address":[1848211,1848087],"length":1,"stats":{"Line":2}},{"line":333,"address":[1848227,1849199],"length":1,"stats":{"Line":1}},{"line":334,"address":[1848482,1848414],"length":1,"stats":{"Line":2}},{"line":335,"address":[1848503,1848557],"length":1,"stats":{"Line":0}},{"line":338,"address":[1849088,1848679,1848953],"length":1,"stats":{"Line":1}},{"line":340,"address":[1848825,1848542,1848639],"length":1,"stats":{"Line":2}},{"line":352,"address":[2230064,2230113],"length":1,"stats":{"Line":0}},{"line":357,"address":[1639114],"length":1,"stats":{"Line":0}},{"line":358,"address":[1849249],"length":1,"stats":{"Line":0}},{"line":360,"address":[1849266],"length":1,"stats":{"Line":0}},{"line":361,"address":[1849406,1849288],"length":1,"stats":{"Line":0}},{"line":362,"address":[2049542],"length":1,"stats":{"Line":0}},{"line":366,"address":[2049650,2049271,2049853,2049927,2049563],"length":1,"stats":{"Line":0}},{"line":368,"address":[1849668,1849508],"length":1,"stats":{"Line":0}},{"line":383,"address":[1639255,1639136],"length":1,"stats":{"Line":1}},{"line":394,"address":[1849904,1852621],"length":1,"stats":{"Line":2}},{"line":395,"address":[1849927],"length":1,"stats":{"Line":1}},{"line":396,"address":[1849950],"length":1,"stats":{"Line":1}},{"line":397,"address":[1850070],"length":1,"stats":{"Line":1}},{"line":398,"address":[1850190],"length":1,"stats":{"Line":1}},{"line":401,"address":[1850510],"length":1,"stats":{"Line":1}},{"line":402,"address":[1850541,1850636],"length":1,"stats":{"Line":2}},{"line":403,"address":[1850744],"length":1,"stats":{"Line":1}},{"line":407,"address":[1850768,1850890],"length":1,"stats":{"Line":2}},{"line":409,"address":[1850986,1850915],"length":1,"stats":{"Line":2}},{"line":410,"address":[1851095],"length":1,"stats":{"Line":1}},{"line":414,"address":[1851235,1851119],"length":1,"stats":{"Line":2}},{"line":416,"address":[1851260,1851325],"length":1,"stats":{"Line":2}},{"line":417,"address":[1851436],"length":1,"stats":{"Line":1}},{"line":422,"address":[1851581,1851457],"length":1,"stats":{"Line":2}},{"line":424,"address":[1852675,1851597],"length":1,"stats":{"Line":1}},{"line":425,"address":[1851852,1851784],"length":1,"stats":{"Line":2}},{"line":426,"address":[1851930,1851873],"length":1,"stats":{"Line":0}},{"line":429,"address":[1852549,1852075,1852357],"length":1,"stats":{"Line":1}},{"line":430,"address":[1851915],"length":1,"stats":{"Line":1}},{"line":431,"address":[1852020],"length":1,"stats":{"Line":1}},{"line":432,"address":[1852035],"length":1,"stats":{"Line":1}},{"line":445,"address":[1639329,1639280],"length":1,"stats":{"Line":0}},{"line":450,"address":[2230314],"length":1,"stats":{"Line":0}},{"line":451,"address":[1852721],"length":1,"stats":{"Line":0}},{"line":453,"address":[1852738],"length":1,"stats":{"Line":0}},{"line":454,"address":[2053081,2052948],"length":1,"stats":{"Line":0}},{"line":455,"address":[1852967],"length":1,"stats":{"Line":0}},{"line":459,"address":[2053485,2052903,2053195,2053559,2053282],"length":1,"stats":{"Line":0}},{"line":461,"address":[1853140,1852980],"length":1,"stats":{"Line":0}},{"line":465,"address":[2230336,2233862,2233943],"length":1,"stats":{"Line":1}},{"line":470,"address":[1639421],"length":1,"stats":{"Line":1}},{"line":474,"address":[1639620],"length":1,"stats":{"Line":1}},{"line":479,"address":[1642125,1639656],"length":1,"stats":{"Line":1}},{"line":480,"address":[2233249,2233144],"length":1,"stats":{"Line":0}},{"line":483,"address":[1642366,1642449],"length":1,"stats":{"Line":0}},{"line":489,"address":[2233558,2233641],"length":1,"stats":{"Line":0}},{"line":490,"address":[1642664],"length":1,"stats":{"Line":0}},{"line":491,"address":[1642687],"length":1,"stats":{"Line":0}},{"line":492,"address":[1642749],"length":1,"stats":{"Line":0}},{"line":497,"address":[2233972,2230689],"length":1,"stats":{"Line":2}},{"line":498,"address":[1642984],"length":1,"stats":{"Line":1}},{"line":501,"address":[1639747],"length":1,"stats":{"Line":1}},{"line":502,"address":[2230775,2233996],"length":1,"stats":{"Line":1}},{"line":503,"address":[1643024,1643126],"length":1,"stats":{"Line":0}},{"line":505,"address":[1643318,1643235],"length":1,"stats":{"Line":0}},{"line":511,"address":[2230837],"length":1,"stats":{"Line":1}},{"line":516,"address":[2230914,2234439],"length":1,"stats":{"Line":2}},{"line":517,"address":[1643470],"length":1,"stats":{"Line":1}},{"line":518,"address":[1643494],"length":1,"stats":{"Line":1}},{"line":520,"address":[1639875],"length":1,"stats":{"Line":1}},{"line":521,"address":[2230871],"length":1,"stats":{"Line":1}},{"line":523,"address":[1643518],"length":1,"stats":{"Line":1}},{"line":524,"address":[1643657,1643581],"length":1,"stats":{"Line":2}},{"line":530,"address":[1643699],"length":1,"stats":{"Line":1}},{"line":531,"address":[1643714],"length":1,"stats":{"Line":1}},{"line":534,"address":[1643791],"length":1,"stats":{"Line":1}},{"line":535,"address":[1645972,1645835],"length":1,"stats":{"Line":0}},{"line":539,"address":[2234814,2234958],"length":1,"stats":{"Line":2}},{"line":543,"address":[2234966],"length":1,"stats":{"Line":1}},{"line":544,"address":[1644018],"length":1,"stats":{"Line":1}},{"line":545,"address":[1644045],"length":1,"stats":{"Line":1}},{"line":546,"address":[1644072],"length":1,"stats":{"Line":1}},{"line":550,"address":[1644157],"length":1,"stats":{"Line":1}},{"line":552,"address":[1644286],"length":1,"stats":{"Line":1}},{"line":553,"address":[1645565,1644513],"length":1,"stats":{"Line":0}},{"line":556,"address":[2234445,2237109],"length":1,"stats":{"Line":0}},{"line":559,"address":[2235861,2235663,2235760],"length":1,"stats":{"Line":3}},{"line":560,"address":[2236206,2236098,2235978,2236409,2236478],"length":1,"stats":{"Line":3}},{"line":562,"address":[2235994,2236281],"length":1,"stats":{"Line":1}},{"line":566,"address":[1639995],"length":1,"stats":{"Line":1}},{"line":573,"address":[1646113,1640137],"length":1,"stats":{"Line":2}},{"line":574,"address":[2237545],"length":1,"stats":{"Line":1}},{"line":575,"address":[2237304,2237197],"length":1,"stats":{"Line":2}},{"line":576,"address":[2237405,2237321],"length":1,"stats":{"Line":2}},{"line":578,"address":[2237436],"length":1,"stats":{"Line":1}},{"line":583,"address":[1646489],"length":1,"stats":{"Line":1}},{"line":586,"address":[2237794,2237713],"length":1,"stats":{"Line":2}},{"line":594,"address":[1646929],"length":1,"stats":{"Line":1}},{"line":595,"address":[2238087],"length":1,"stats":{"Line":1}},{"line":601,"address":[2238174],"length":1,"stats":{"Line":1}},{"line":602,"address":[2238323,2238228],"length":1,"stats":{"Line":2}},{"line":603,"address":[1647234],"length":1,"stats":{"Line":1}},{"line":605,"address":[2238407],"length":1,"stats":{"Line":1}},{"line":607,"address":[1647527,1646155],"length":1,"stats":{"Line":0}},{"line":610,"address":[2231171],"length":1,"stats":{"Line":0}},{"line":611,"address":[1640232,1647683],"length":1,"stats":{"Line":0}},{"line":612,"address":[2239255,2238931,2238831,2239126],"length":1,"stats":{"Line":0}},{"line":613,"address":[1648346],"length":1,"stats":{"Line":0}},{"line":614,"address":[1648348],"length":1,"stats":{"Line":0}},{"line":621,"address":[1648585,1640274],"length":1,"stats":{"Line":2}},{"line":622,"address":[1648597],"length":1,"stats":{"Line":1}},{"line":625,"address":[1640324],"length":1,"stats":{"Line":1}},{"line":626,"address":[1640344,1648628],"length":1,"stats":{"Line":1}},{"line":627,"address":[1648640],"length":1,"stats":{"Line":0}},{"line":630,"address":[1640386],"length":1,"stats":{"Line":1}},{"line":635,"address":[2231472],"length":1,"stats":{"Line":1}},{"line":636,"address":[1648681],"length":1,"stats":{"Line":1}},{"line":637,"address":[2239861,2240008],"length":1,"stats":{"Line":2}},{"line":645,"address":[2239935,2239807],"length":1,"stats":{"Line":0}},{"line":648,"address":[2240223],"length":1,"stats":{"Line":1}},{"line":649,"address":[2240282],"length":1,"stats":{"Line":1}},{"line":650,"address":[2240310,2240401],"length":1,"stats":{"Line":2}},{"line":656,"address":[2240597,2240514],"length":1,"stats":{"Line":2}},{"line":657,"address":[1649444],"length":1,"stats":{"Line":1}},{"line":660,"address":[2240248,2240341],"length":1,"stats":{"Line":0}},{"line":662,"address":[2240767,2240796],"length":1,"stats":{"Line":2}},{"line":663,"address":[2240847],"length":1,"stats":{"Line":1}},{"line":664,"address":[2240863],"length":1,"stats":{"Line":1}},{"line":666,"address":[2240720],"length":1,"stats":{"Line":1}},{"line":667,"address":[2240724],"length":1,"stats":{"Line":1}},{"line":670,"address":[2240887],"length":1,"stats":{"Line":1}},{"line":672,"address":[2240897],"length":1,"stats":{"Line":1}},{"line":673,"address":[2242686,2242823],"length":1,"stats":{"Line":0}},{"line":677,"address":[2241052,2240908],"length":1,"stats":{"Line":2}},{"line":681,"address":[2241060],"length":1,"stats":{"Line":1}},{"line":686,"address":[1649994],"length":1,"stats":{"Line":1}},{"line":687,"address":[2241299],"length":1,"stats":{"Line":1}},{"line":688,"address":[1651211,1650224],"length":1,"stats":{"Line":0}},{"line":691,"address":[1651655,1649626],"length":1,"stats":{"Line":0}},{"line":694,"address":[2241433,2241530,2241631],"length":1,"stats":{"Line":3}},{"line":695,"address":[2241762,2242004,2242207,2242276,2241882],"length":1,"stats":{"Line":3}},{"line":699,"address":[2241778],"length":1,"stats":{"Line":1}},{"line":704,"address":[1640542],"length":1,"stats":{"Line":1}},{"line":708,"address":[2231564],"length":1,"stats":{"Line":1}},{"line":711,"address":[1651733],"length":1,"stats":{"Line":1}},{"line":713,"address":[2242977],"length":1,"stats":{"Line":1}},{"line":714,"address":[2243185,2243106],"length":1,"stats":{"Line":2}},{"line":720,"address":[1652003],"length":1,"stats":{"Line":1}},{"line":721,"address":[2243250],"length":1,"stats":{"Line":1}},{"line":725,"address":[2243048,2242923],"length":1,"stats":{"Line":0}},{"line":729,"address":[1652255,1652122],"length":1,"stats":{"Line":2}},{"line":730,"address":[1652738,1652372,1652502,1652681],"length":1,"stats":{"Line":2}},{"line":739,"address":[1640614],"length":1,"stats":{"Line":1}},{"line":746,"address":[2231800,2244023],"length":1,"stats":{"Line":2}},{"line":748,"address":[1652889,1652779],"length":1,"stats":{"Line":2}},{"line":749,"address":[2244238,2244170],"length":1,"stats":{"Line":2}},{"line":752,"address":[2244358],"length":1,"stats":{"Line":1}},{"line":756,"address":[2244502,2244583],"length":1,"stats":{"Line":2}},{"line":757,"address":[2244600,2244684],"length":1,"stats":{"Line":2}},{"line":761,"address":[1653442],"length":1,"stats":{"Line":1}},{"line":762,"address":[1653575,1653504],"length":1,"stats":{"Line":2}},{"line":769,"address":[1653645],"length":1,"stats":{"Line":1}},{"line":770,"address":[2245011],"length":1,"stats":{"Line":1}},{"line":776,"address":[1653794],"length":1,"stats":{"Line":1}},{"line":777,"address":[1653976],"length":1,"stats":{"Line":1}},{"line":778,"address":[2245467],"length":1,"stats":{"Line":1}},{"line":780,"address":[1652801,1654402],"length":1,"stats":{"Line":0}},{"line":783,"address":[1640938],"length":1,"stats":{"Line":0}},{"line":791,"address":[1640978,1654571],"length":1,"stats":{"Line":0}},{"line":803,"address":[2232012],"length":1,"stats":{"Line":0}},{"line":804,"address":[1654640,1641073],"length":1,"stats":{"Line":0}},{"line":805,"address":[1654950,1654763,1654663,1655079],"length":1,"stats":{"Line":0}},{"line":806,"address":[1655306],"length":1,"stats":{"Line":0}},{"line":807,"address":[1655308],"length":1,"stats":{"Line":0}},{"line":813,"address":[1641176],"length":1,"stats":{"Line":1}},{"line":819,"address":[1641230,1655537],"length":1,"stats":{"Line":2}},{"line":821,"address":[2247039,2246932],"length":1,"stats":{"Line":2}},{"line":822,"address":[1655760,1655692],"length":1,"stats":{"Line":2}},{"line":824,"address":[1655814],"length":1,"stats":{"Line":1}},{"line":828,"address":[2247342,2247430],"length":1,"stats":{"Line":2}},{"line":836,"address":[1656065],"length":1,"stats":{"Line":1}},{"line":837,"address":[1656127],"length":1,"stats":{"Line":1}},{"line":842,"address":[2247588],"length":1,"stats":{"Line":1}},{"line":844,"address":[2246954,2247817],"length":1,"stats":{"Line":0}},{"line":847,"address":[1641275],"length":1,"stats":{"Line":0}},{"line":848,"address":[2232320,2247973],"length":1,"stats":{"Line":0}},{"line":849,"address":[2247996,2248420,2248096,2248291],"length":1,"stats":{"Line":0}},{"line":850,"address":[2248655],"length":1,"stats":{"Line":0}},{"line":851,"address":[1657241],"length":1,"stats":{"Line":0}},{"line":857,"address":[2232365],"length":1,"stats":{"Line":1}},{"line":861,"address":[1641447,1657470],"length":1,"stats":{"Line":2}},{"line":863,"address":[2248925,2249025],"length":1,"stats":{"Line":2}},{"line":864,"address":[1657618,1657686],"length":1,"stats":{"Line":2}},{"line":866,"address":[1657740],"length":1,"stats":{"Line":1}},{"line":872,"address":[1657987,1657904],"length":1,"stats":{"Line":2}},{"line":873,"address":[1658010],"length":1,"stats":{"Line":1}},{"line":877,"address":[1658067],"length":1,"stats":{"Line":1}},{"line":880,"address":[2232492],"length":1,"stats":{"Line":1}},{"line":881,"address":[1658276,1641520],"length":1,"stats":{"Line":1}},{"line":882,"address":[2249751],"length":1,"stats":{"Line":0}},{"line":885,"address":[2232577],"length":1,"stats":{"Line":1}},{"line":890,"address":[2232651],"length":1,"stats":{"Line":1}},{"line":892,"address":[1658332],"length":1,"stats":{"Line":1}},{"line":894,"address":[2249962,2249815],"length":1,"stats":{"Line":2}},{"line":895,"address":[2249979,2250066],"length":1,"stats":{"Line":2}},{"line":897,"address":[1658652],"length":1,"stats":{"Line":1}},{"line":903,"address":[2250375,2250292],"length":1,"stats":{"Line":2}},{"line":904,"address":[2250398],"length":1,"stats":{"Line":1}},{"line":908,"address":[1659003],"length":1,"stats":{"Line":1}},{"line":911,"address":[2249758,2249889],"length":1,"stats":{"Line":0}},{"line":914,"address":[2250673,2250814],"length":1,"stats":{"Line":2}},{"line":915,"address":[2251048,2250915,2251312,2230397,2251251],"length":1,"stats":{"Line":3}},{"line":917,"address":[2251123],"length":1,"stats":{"Line":0}},{"line":918,"address":[1659378,1659468],"length":1,"stats":{"Line":0}},{"line":921,"address":[1641724],"length":1,"stats":{"Line":1}},{"line":928,"address":[1659821,1641849],"length":1,"stats":{"Line":2}},{"line":929,"address":[1660176],"length":1,"stats":{"Line":1}},{"line":930,"address":[1659844,1659951],"length":1,"stats":{"Line":2}},{"line":931,"address":[1659976,1660044],"length":1,"stats":{"Line":2}},{"line":933,"address":[2251595],"length":1,"stats":{"Line":1}},{"line":937,"address":[2251728],"length":1,"stats":{"Line":1}},{"line":941,"address":[2251968,2251872],"length":1,"stats":{"Line":2}},{"line":950,"address":[2251999],"length":1,"stats":{"Line":1}},{"line":951,"address":[2252061],"length":1,"stats":{"Line":1}},{"line":957,"address":[1660616],"length":1,"stats":{"Line":1}},{"line":958,"address":[2252297,2252202],"length":1,"stats":{"Line":2}},{"line":959,"address":[2252304],"length":1,"stats":{"Line":1}},{"line":962,"address":[1659866,1660887],"length":1,"stats":{"Line":0}},{"line":965,"address":[1641922],"length":1,"stats":{"Line":0}},{"line":971,"address":[1641982,1661081],"length":1,"stats":{"Line":0}},{"line":981,"address":[2233019],"length":1,"stats":{"Line":0}},{"line":982,"address":[2233072,2252679],"length":1,"stats":{"Line":0}},{"line":983,"address":[1661423,1661151,1661239,1661552],"length":1,"stats":{"Line":0}},{"line":984,"address":[2253304],"length":1,"stats":{"Line":0}},{"line":985,"address":[1661742],"length":1,"stats":{"Line":0}},{"line":989,"address":[1642926],"length":1,"stats":{"Line":1}},{"line":998,"address":[1661936,1661973],"length":1,"stats":{"Line":1}},{"line":1002,"address":[1661966],"length":1,"stats":{"Line":2}},{"line":1007,"address":[2054812],"length":1,"stats":{"Line":1}},{"line":1008,"address":[1853492,1853388],"length":1,"stats":{"Line":2}},{"line":1009,"address":[2053848],"length":1,"stats":{"Line":1}},{"line":1011,"address":[1853617,1853851,1853716,1855585],"length":1,"stats":{"Line":2}},{"line":1013,"address":[2054087],"length":1,"stats":{"Line":1}},{"line":1017,"address":[1854055],"length":1,"stats":{"Line":1}},{"line":1018,"address":[1854186],"length":1,"stats":{"Line":0}},{"line":1019,"address":[1854234],"length":1,"stats":{"Line":0}},{"line":1020,"address":[1854462],"length":1,"stats":{"Line":0}},{"line":1024,"address":[1854112],"length":1,"stats":{"Line":1}},{"line":1027,"address":[2054517],"length":1,"stats":{"Line":1}},{"line":1033,"address":[1854700],"length":1,"stats":{"Line":1}},{"line":1034,"address":[2055063,2055118],"length":1,"stats":{"Line":2}},{"line":1035,"address":[1854904,1854849],"length":1,"stats":{"Line":2}},{"line":1038,"address":[1854936],"length":1,"stats":{"Line":0}},{"line":1039,"address":[1855096,1854957,1855014,1855440],"length":1,"stats":{"Line":0}},{"line":1040,"address":[1855179,1855288],"length":1,"stats":{"Line":0}},{"line":1044,"address":[1854973],"length":1,"stats":{"Line":0}},{"line":1047,"address":[1855493],"length":1,"stats":{"Line":1}}],"covered":250,"coverable":346},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","src","crypto.rs"],"content":"// standard\nuse std::os::raw::c_char;\nuse std::str;\n\n// extern crates\nuse anyhow::bail;\n#[cfg(feature = \"impl-lib\")]\nuse cgosling_proc_macros::*;\nuse tor_interface::tor_crypto::*;\n\n// internal crates\nuse crate::error::*;\nuse crate::ffi::*;\nuse crate::macros::*;\n\n/// An ed25519 private key used to create a v3 onion service\npub struct GoslingEd25519PrivateKey;\ndefine_registry! {Ed25519PrivateKey}\n\n/// An x25519 private key used to decrypt v3 onion service descriptors\npub struct GoslingX25519PrivateKey;\ndefine_registry! {X25519PrivateKey}\n\n/// An x25519 public key used to encrypt v3 onoin service descriptors\npub struct GoslingX25519PublicKey;\ndefine_registry! {X25519PublicKey}\n\n/// A v3 onion service id\npub struct GoslingV3OnionServiceId;\ndefine_registry! {V3OnionServiceId}\n\n//\n// Free Functions\n//\n\n/// Frees a gosling_ed25519_private_key object\n///\n/// @param in_private_key: the private key to free\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_ed25519_private_key_free(in_private_key: *mut GoslingEd25519PrivateKey) {\n    impl_registry_free!(in_private_key, Ed25519PrivateKey);\n}\n\n/// Frees a gosling_x25519_private_key object\n///\n/// @param in_private_key: the private key to free\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_x25519_private_key_free(in_private_key: *mut GoslingX25519PrivateKey) {\n    impl_registry_free!(in_private_key, X25519PrivateKey);\n}\n\n/// Frees a gosling_x25519_public_key object\n///\n/// @param in_public_key: the public key to free\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_x25519_public_key_free(in_public_key: *mut GoslingX25519PublicKey) {\n    impl_registry_free!(in_public_key, X25519PublicKey);\n}\n\n/// Frees a gosling_v3_onion_service_id object\n///\n/// @param in_service_id: the service id object to free\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_v3_onion_service_id_free(in_service_id: *mut GoslingV3OnionServiceId) {\n    impl_registry_free!(in_service_id, V3OnionServiceId);\n}\n\n//\n// Clone Functions\n//\n\n/// Copy method for gosling_ed25519_private_key\n///\n/// @param out_private_key: returned copy\n/// @param private_key: original to copy\n/// @param error: fliled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_ed25519_private_key_clone(\n    out_private_key: *mut *mut GoslingEd25519PrivateKey,\n    private_key: *const GoslingEd25519PrivateKey,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_private_key);\n        ensure_not_null!(private_key);\n\n        let private_key = match get_ed25519_private_key_registry().get(private_key as usize) {\n            Some(private_key) =\u003e private_key.clone(),\n            None =\u003e bail_invalid_handle!(private_key),\n        };\n        let handle = get_ed25519_private_key_registry().insert(private_key);\n        *out_private_key = handle as *mut GoslingEd25519PrivateKey;\n\n        Ok(())\n    })\n}\n\n/// Copy method for gosling_x25519_public_key\n///\n/// @param out_public_key: returned copy\n/// @param public_key: original to copy\n/// @param error: fliled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_x25519_public_key_clone(\n    out_public_key: *mut *mut GoslingX25519PublicKey,\n    public_key: *const GoslingX25519PublicKey,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_public_key);\n        ensure_not_null!(public_key);\n\n        let public_key = match get_x25519_public_key_registry().get(public_key as usize) {\n            Some(public_key) =\u003e public_key.clone(),\n            None =\u003e bail_invalid_handle!(public_key),\n        };\n        let handle = get_x25519_public_key_registry().insert(public_key);\n        *out_public_key = handle as *mut GoslingX25519PublicKey;\n\n        Ok(())\n    })\n}\n\n/// Copy method for gosling_x25519_private_key\n///\n/// @param out_private_key: returned copy\n/// @param private_key: original to copy\n/// @param error: fliled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_x25519_private_key_clone(\n    out_private_key: *mut *mut GoslingX25519PrivateKey,\n    private_key: *const GoslingX25519PrivateKey,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_private_key);\n        ensure_not_null!(private_key);\n\n        let private_key = match get_x25519_private_key_registry().get(private_key as usize) {\n            Some(private_key) =\u003e private_key.clone(),\n            None =\u003e bail_invalid_handle!(private_key),\n        };\n        let handle = get_x25519_private_key_registry().insert(private_key);\n        *out_private_key = handle as *mut GoslingX25519PrivateKey;\n\n        Ok(())\n    })\n}\n\n/// Copy method for gosling_v3_onion_service_id\n///\n/// @param out_service_id: returned copy\n/// @param service_id: original to copy\n/// @param error: fliled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_v3_onion_service_id_clone(\n    out_service_id: *mut *mut GoslingV3OnionServiceId,\n    service_id: *const GoslingV3OnionServiceId,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_service_id);\n        ensure_not_null!(service_id);\n\n        let service_id = match get_v3_onion_service_id_registry().get(service_id as usize) {\n            Some(service_id) =\u003e service_id.clone(),\n            None =\u003e bail_invalid_handle!(service_id),\n        };\n        let handle = get_v3_onion_service_id_registry().insert(service_id);\n        *out_service_id = handle as *mut GoslingV3OnionServiceId;\n\n        Ok(())\n    })\n}\n\n//\n// Ed25519 Privat4e Key Functions\n//\n\n/// Creation method for securely generating a new gosling_ed25510_private_key\n///\n/// @param out_private_key: returned generated ed25519 private key\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_ed25519_private_key_generate(\n    out_private_key: *mut *mut GoslingEd25519PrivateKey,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_private_key);\n\n        let private_key = Ed25519PrivateKey::generate();\n        let handle = get_ed25519_private_key_registry().insert(private_key);\n        *out_private_key = handle as *mut GoslingEd25519PrivateKey;\n\n        Ok(())\n    })\n}\n\n/// Conversion method for converting the KeyBlob string returned by ADD_ONION\n/// command into a gosling_ed25519_private_key\n///\n/// @param out_private_key: returned ed25519 private key\n/// @param key_blob: an ed25519 KeyBlob string in the form\n///  \"ED25519-V3:abcd1234...\"\n/// @param key_blob_length: number of chars in key_blob not including any null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_ed25519_private_key_from_keyblob(\n    out_private_key: *mut *mut GoslingEd25519PrivateKey,\n    key_blob: *const c_char,\n    key_blob_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_private_key);\n        ensure_not_null!(key_blob);\n\n        if key_blob_length != ED25519_PRIVATE_KEY_KEYBLOB_LENGTH {\n            bail!(\"key_blob_length must be exactly ED25519_PRIVATE_KEY_KEYBLOB_LENGTH ({}); received '{}'\", ED25519_PRIVATE_KEY_KEYBLOB_LENGTH, key_blob_length);\n        }\n\n        let key_blob_view = std::slice::from_raw_parts(key_blob as *const u8, key_blob_length);\n        let key_blob_str = std::str::from_utf8(key_blob_view)?;\n        let private_key = Ed25519PrivateKey::from_key_blob(key_blob_str)?;\n\n        let handle = get_ed25519_private_key_registry().insert(private_key);\n        *out_private_key = handle as *mut GoslingEd25519PrivateKey;\n\n        Ok(())\n    })\n}\n\n/// Conversion method for converting an ed25519 private key to a null-\n/// terminated KeyBlob string for use with ADD_ONION command\n///\n/// @param private_key: the private key to encode\n/// @param out_key_blob: buffer to be filled with ed25519 KeyBlob in\n///  the form \"ED25519-V3:abcd1234...\\0\"\n/// @param key_blob_size: size of out_key_blob buffer in bytes, must be at\n///  least 100 characters (99 for string + 1 for null-terminator)\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_ed25519_private_key_to_keyblob(\n    private_key: *const GoslingEd25519PrivateKey,\n    out_key_blob: *mut c_char,\n    key_blob_size: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(private_key);\n        ensure_not_null!(out_key_blob);\n\n        if key_blob_size \u003c ED25519_PRIVATE_KEY_KEYBLOB_SIZE {\n            bail!(\n                \"key_blob_size must be at least ED25519_PRIVATE_KEY_KEYBLOB_SIZE ('{}'), received '{}'\",\n                ED25519_PRIVATE_KEY_KEYBLOB_SIZE,\n                key_blob_size\n            );\n        }\n\n        let registry = get_ed25519_private_key_registry();\n        match registry.get(private_key as usize) {\n            Some(private_key) =\u003e {\n                let private_key_blob = private_key.to_key_blob();\n                unsafe {\n                    // copy keyblob into output buffer\n                    let key_blob_view =\n                        std::slice::from_raw_parts_mut(out_key_blob as *mut u8, key_blob_size);\n                    std::ptr::copy(\n                        private_key_blob.as_ptr(),\n                        key_blob_view.as_mut_ptr(),\n                        ED25519_PRIVATE_KEY_KEYBLOB_LENGTH,\n                    );\n                    // add final null-terminator\n                    key_blob_view[ED25519_PRIVATE_KEY_KEYBLOB_LENGTH] = 0u8;\n                };\n            }\n            None =\u003e {\n                bail_invalid_handle!(private_key);\n            }\n        };\n\n        Ok(())\n    })\n}\n\n//\n// X25519 Private Key Functions\n//\n\n/// Conversion method for converting a base64-encoded string used by the\n/// ONION_CLIENT_AUTH_ADD command into a gosling_x25519_private_key\n///\n/// @param out_private_key: returned x25519 private key\n/// @param base64: an x25519 private key encoded as a base64 string\n/// @param base64_length: the number of chars in base64 not including any null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_x25519_private_key_from_base64(\n    out_private_key: *mut *mut GoslingX25519PrivateKey,\n    base64: *const c_char,\n    base64_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_private_key);\n        ensure_not_null!(base64);\n\n        if base64_length != X25519_PRIVATE_KEY_BASE64_LENGTH {\n            bail!(\"base64_length must be exactly X25519_PRIVATE_KEY_BASE64_LENGTH ({}); received '{}'\", X25519_PRIVATE_KEY_BASE64_LENGTH, base64_length);\n        }\n\n        let base64_view = std::slice::from_raw_parts(base64 as *const u8, base64_length);\n        let base64_str = std::str::from_utf8(base64_view)?;\n        let private_key = X25519PrivateKey::from_base64(base64_str)?;\n\n        let handle = get_x25519_private_key_registry().insert(private_key);\n        *out_private_key = handle as *mut GoslingX25519PrivateKey;\n\n        Ok(())\n    })\n}\n\n/// Conversion method for converting an x25519 private key to a null-\n/// terminated base64 string for use with ONION_CLIENT_AUTH_ADD command\n///\n/// @param private_key: the private key to encode\n/// @param out_base64: buffer to be filled with x25519 key encoded as base64\n/// @param base64_size: size of out_base64 buffer in bytes, must be at\n///  least 45 characters (44 for string + 1 for null-terminator)\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_x25519_private_key_to_base64(\n    private_key: *const GoslingX25519PrivateKey,\n    out_base64: *mut c_char,\n    base64_size: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(private_key);\n        ensure_not_null!(out_base64);\n\n        if base64_size \u003c X25519_PRIVATE_KEY_BASE64_SIZE {\n            bail!(\n                \"base64_size must be at least '{}', received '{}'\",\n                X25519_PRIVATE_KEY_BASE64_SIZE,\n                base64_size\n            );\n        }\n\n        let registry = get_x25519_private_key_registry();\n        match registry.get(private_key as usize) {\n            Some(private_key) =\u003e {\n                let private_key_blob = private_key.to_base64();\n                unsafe {\n                    // copy base64 into output buffer\n                    let base64_view =\n                        std::slice::from_raw_parts_mut(out_base64 as *mut u8, base64_size);\n                    std::ptr::copy(\n                        private_key_blob.as_ptr(),\n                        base64_view.as_mut_ptr(),\n                        X25519_PRIVATE_KEY_BASE64_LENGTH,\n                    );\n                    // add final null-terminator\n                    base64_view[X25519_PRIVATE_KEY_BASE64_LENGTH] = 0u8;\n                };\n            }\n            None =\u003e {\n                bail_invalid_handle!(private_key);\n            }\n        };\n\n        Ok(())\n    })\n}\n\n//\n// X25519 Public Key Functions\n//\n\n/// Conversion method for converting a base32-encoded string used by the\n/// ADD_ONION command into a gosling_x25519_public_key\n///\n/// @param out_public_key: returned x25519 public key\n/// @param base32: an x25519 public key encoded as a base32 string\n/// @param base32_length: the number of chars in base32 not including any null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_x25519_public_key_from_base32(\n    out_public_key: *mut *mut GoslingX25519PublicKey,\n    base32: *const c_char,\n    base32_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_public_key);\n        ensure_not_null!(base32);\n\n        if base32_length != X25519_PUBLIC_KEY_BASE32_LENGTH {\n            bail!(\n                \"base32_length must be exactly X25519_PUBLIC_KEY_BASE32_LENGTH ({}); received '{}'\",\n                X25519_PUBLIC_KEY_BASE32_LENGTH,\n                base32_length\n            );\n        }\n\n        let base32_view = std::slice::from_raw_parts(base32 as *const u8, base32_length);\n        let base32_str = std::str::from_utf8(base32_view)?;\n        let public_key = X25519PublicKey::from_base32(base32_str)?;\n\n        let handle = get_x25519_public_key_registry().insert(public_key);\n        *out_public_key = handle as *mut GoslingX25519PublicKey;\n\n        Ok(())\n    })\n}\n\n/// Conversion method for converting an x25519 public key to a null-\n/// terminated base64 string for use with ADD_ONION command\n///\n/// @param public_key: the public key to encode\n/// @param out_base32: buffer to be filled with x25519 key encoded as base32\n/// @param base32_size: size of out_base32 buffer in bytes, must be at\n///  least 53 characters (52 for string + 1 for null-terminator)\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_x25519_public_key_to_base32(\n    public_key: *const GoslingX25519PublicKey,\n    out_base32: *mut c_char,\n    base32_size: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(public_key);\n        ensure_not_null!(out_base32);\n\n        if base32_size \u003c X25519_PUBLIC_KEY_BASE32_SIZE {\n            bail!(\n                \"base32_size must be at least '{}', received '{}'\",\n                X25519_PUBLIC_KEY_BASE32_SIZE,\n                base32_size\n            );\n        }\n\n        let registry = get_x25519_public_key_registry();\n        match registry.get(public_key as usize) {\n            Some(public_key) =\u003e {\n                let public_base32 = public_key.to_base32();\n                unsafe {\n                    // copy base32 into output buffer\n                    let base32_view =\n                        std::slice::from_raw_parts_mut(out_base32 as *mut u8, base32_size);\n                    std::ptr::copy(\n                        public_base32.as_ptr(),\n                        base32_view.as_mut_ptr(),\n                        X25519_PUBLIC_KEY_BASE32_LENGTH,\n                    );\n                    // add final null-terminator\n                    base32_view[X25519_PUBLIC_KEY_BASE32_LENGTH] = 0u8;\n                };\n            }\n            None =\u003e {\n                bail_invalid_handle!(public_key);\n            }\n        };\n\n        Ok(())\n    })\n}\n\n//\n// V3 Onion Service Id Functions\n//\n\n/// Conversion method for converting a v3 onion service string into a\n/// gosling_v3_onion_service_id object\n///\n/// @param out_service_id: returned service id object\n/// @param service_id_string: a v3 onion service id string\n/// @param service_id_string_length: the number of chars in service_id_string not including any\n///  null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_v3_onion_service_id_from_string(\n    out_service_id: *mut *mut GoslingV3OnionServiceId,\n    service_id_string: *const c_char,\n    service_id_string_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_service_id);\n        ensure_not_null!(service_id_string);\n\n        if service_id_string_length != V3_ONION_SERVICE_ID_STRING_LENGTH {\n            bail!(\"service_id_string_length must be exactly V3_ONION_SERVICE_ID_STRING_LENGTH ({}); received '{}'\", V3_ONION_SERVICE_ID_STRING_LENGTH, service_id_string_length);\n        }\n\n        let service_id_view =\n            std::slice::from_raw_parts(service_id_string as *const u8, service_id_string_length);\n        let service_id_str = std::str::from_utf8(service_id_view)?;\n        let service_id = V3OnionServiceId::from_string(service_id_str)?;\n\n        let handle = get_v3_onion_service_id_registry().insert(service_id);\n        *out_service_id = handle as *mut GoslingV3OnionServiceId;\n\n        Ok(())\n    })\n}\n\n/// Conversion method for converting an ed25519 private key  into a\n/// gosling_v3_onion_service_id object\n///\n/// @param out_service_id: returned service id object\n/// @param ed25519_private_key: an e25519 private key\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_v3_onion_service_id_from_ed25519_private_key(\n    out_service_id: *mut *mut GoslingV3OnionServiceId,\n    ed25519_private_key: *const GoslingEd25519PrivateKey,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_service_id);\n        ensure_not_null!(ed25519_private_key);\n\n        let service_id = {\n            let ed25519_private_key_registry = get_ed25519_private_key_registry();\n            let ed25519_private_key =\n                match ed25519_private_key_registry.get(ed25519_private_key as usize) {\n                    Some(ed25519_private_key) =\u003e ed25519_private_key,\n                    None =\u003e bail_invalid_handle!(ed25519_private_key),\n                };\n            V3OnionServiceId::from_private_key(ed25519_private_key)\n        };\n\n        let handle = get_v3_onion_service_id_registry().insert(service_id);\n        *out_service_id = handle as *mut GoslingV3OnionServiceId;\n\n        Ok(())\n    })\n}\n\n/// Conversion method for converting v3 onion service id to a null-terminated\n/// string\n///\n/// @param service_id: the service id to encode\n/// @param out_service_id_string: buffer to be filled with x25519 key encoded as base32\n/// @param service_id_string_size: size of out_service_id_string buffer in bytes,\n///  must be at least 57 characters (56 for string + 1 for null-terminator)\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_v3_onion_service_id_to_string(\n    service_id: *const GoslingV3OnionServiceId,\n    out_service_id_string: *mut c_char,\n    service_id_string_size: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(service_id);\n        ensure_not_null!(out_service_id_string);\n\n        if service_id_string_size \u003c V3_ONION_SERVICE_ID_STRING_SIZE {\n            bail!(\n                \"service_id_string_size must be at least '{}', received '{}'\",\n                V3_ONION_SERVICE_ID_STRING_SIZE,\n                service_id_string_size\n            );\n        }\n\n        let registry = get_v3_onion_service_id_registry();\n        match registry.get(service_id as usize) {\n            Some(service_id) =\u003e {\n                let service_id_string = service_id.to_string();\n                unsafe {\n                    // copy service_id_string into output buffer\n                    let service_id_string_view = std::slice::from_raw_parts_mut(\n                        out_service_id_string as *mut u8,\n                        service_id_string_size,\n                    );\n                    std::ptr::copy(\n                        service_id_string.as_ptr(),\n                        service_id_string_view.as_mut_ptr(),\n                        V3_ONION_SERVICE_ID_STRING_LENGTH,\n                    );\n                    // add final null-terminator\n                    service_id_string_view[V3_ONION_SERVICE_ID_STRING_LENGTH] = 0u8;\n                };\n            }\n            None =\u003e {\n                bail_invalid_handle!(service_id);\n            }\n        };\n\n        Ok(())\n    })\n}\n\n/// Checks if a service id string is valid per tor rend spec:\n/// https://gitweb.torproject.org/torspec.git/tree/rend-spec-v3.txt\n///\n/// @param service_id_string: string containing the v3 service id to be validated\n/// @param service_id_string_length: the number of chars in service_id_string not including any\n///  null-terminator; must be V3_ONION_SERVICE_ID_STRING_LENGTH (56)\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_string_is_valid_v3_onion_service_id(\n    service_id_string: *const c_char,\n    service_id_string_length: usize,\n    error: *mut *mut GoslingError,\n) -\u003e bool {\n    translate_failures(false, error, || -\u003e anyhow::Result\u003cbool\u003e {\n        ensure_not_null!(service_id_string);\n\n        if service_id_string_length != V3_ONION_SERVICE_ID_STRING_LENGTH {\n            bail!(\n                \"service_id_string_length must be V3_ONION_SERVICE_ID_STRING_LENGTH (56); received '{}'\",\n                service_id_string_length\n            );\n        }\n\n        let service_id_string_slice = unsafe {\n            std::slice::from_raw_parts(service_id_string as *const u8, service_id_string_length)\n        };\n        Ok(V3OnionServiceId::is_valid(str::from_utf8(\n            service_id_string_slice,\n        )?))\n    })\n}\n","traces":[{"line":41,"address":[2867887,2867856],"length":1,"stats":{"Line":0}},{"line":50,"address":[2066077,2066048],"length":1,"stats":{"Line":0}},{"line":59,"address":[2868249,2868224],"length":1,"stats":{"Line":0}},{"line":68,"address":[2868384,2868412],"length":1,"stats":{"Line":0}},{"line":83,"address":[2868560,2868609],"length":1,"stats":{"Line":1}},{"line":88,"address":[2846192,2847025],"length":1,"stats":{"Line":2}},{"line":89,"address":[2071177],"length":1,"stats":{"Line":1}},{"line":90,"address":[2846234],"length":1,"stats":{"Line":1}},{"line":92,"address":[2846469,2846317],"length":1,"stats":{"Line":2}},{"line":93,"address":[2846688,2846573],"length":1,"stats":{"Line":2}},{"line":96,"address":[2846752],"length":1,"stats":{"Line":1}},{"line":97,"address":[2846944,2847004],"length":1,"stats":{"Line":1}},{"line":99,"address":[2846978],"length":1,"stats":{"Line":1}},{"line":110,"address":[2868673,2868624],"length":1,"stats":{"Line":1}},{"line":115,"address":[2847072,2847762],"length":1,"stats":{"Line":2}},{"line":116,"address":[2847089],"length":1,"stats":{"Line":1}},{"line":117,"address":[2847106],"length":1,"stats":{"Line":1}},{"line":119,"address":[2847189,2847341],"length":1,"stats":{"Line":2}},{"line":120,"address":[2847445],"length":1,"stats":{"Line":1}},{"line":123,"address":[2847558],"length":1,"stats":{"Line":1}},{"line":124,"address":[2847689,2847741],"length":1,"stats":{"Line":1}},{"line":126,"address":[2847723],"length":1,"stats":{"Line":1}},{"line":137,"address":[2868688,2868737],"length":1,"stats":{"Line":1}},{"line":142,"address":[2847792,2848615],"length":1,"stats":{"Line":2}},{"line":143,"address":[2847817],"length":1,"stats":{"Line":1}},{"line":144,"address":[2847834],"length":1,"stats":{"Line":1}},{"line":146,"address":[2848069,2847917],"length":1,"stats":{"Line":2}},{"line":147,"address":[2848281,2848173],"length":1,"stats":{"Line":2}},{"line":150,"address":[2848345],"length":1,"stats":{"Line":1}},{"line":151,"address":[2848534,2848594],"length":1,"stats":{"Line":1}},{"line":153,"address":[2073647],"length":1,"stats":{"Line":1}},{"line":164,"address":[2868801,2868752],"length":1,"stats":{"Line":1}},{"line":169,"address":[2073744,2074473],"length":1,"stats":{"Line":2}},{"line":170,"address":[2848673],"length":1,"stats":{"Line":1}},{"line":171,"address":[2848690],"length":1,"stats":{"Line":1}},{"line":173,"address":[2073865,2074027],"length":1,"stats":{"Line":2}},{"line":174,"address":[2849029],"length":1,"stats":{"Line":1}},{"line":177,"address":[2849142],"length":1,"stats":{"Line":1}},{"line":178,"address":[2849328,2849273],"length":1,"stats":{"Line":1}},{"line":180,"address":[2849309],"length":1,"stats":{"Line":1}},{"line":194,"address":[2066848,2066885],"length":1,"stats":{"Line":1}},{"line":198,"address":[2074955,2074496],"length":1,"stats":{"Line":2}},{"line":199,"address":[2074516],"length":1,"stats":{"Line":1}},{"line":201,"address":[2074534],"length":1,"stats":{"Line":1}},{"line":202,"address":[2074556,2074688],"length":1,"stats":{"Line":2}},{"line":203,"address":[2074864,2074921],"length":1,"stats":{"Line":1}},{"line":205,"address":[2074898],"length":1,"stats":{"Line":1}},{"line":219,"address":[2868880,2868959],"length":1,"stats":{"Line":0}},{"line":225,"address":[2851248,2849872],"length":1,"stats":{"Line":0}},{"line":226,"address":[2075028],"length":1,"stats":{"Line":0}},{"line":227,"address":[2075049],"length":1,"stats":{"Line":0}},{"line":229,"address":[2849999],"length":1,"stats":{"Line":0}},{"line":230,"address":[2850381,2850291,2850540],"length":1,"stats":{"Line":0}},{"line":233,"address":[2850084],"length":1,"stats":{"Line":0}},{"line":234,"address":[2850561,2850644,2850123],"length":1,"stats":{"Line":0}},{"line":235,"address":[2075735,2075979,2075882],"length":1,"stats":{"Line":0}},{"line":237,"address":[2850987,2850816],"length":1,"stats":{"Line":0}},{"line":238,"address":[2851214,2851159],"length":1,"stats":{"Line":0}},{"line":240,"address":[2851191],"length":1,"stats":{"Line":0}},{"line":255,"address":[2868976,2869055],"length":1,"stats":{"Line":0}},{"line":261,"address":[2067050],"length":1,"stats":{"Line":0}},{"line":262,"address":[2851308],"length":1,"stats":{"Line":0}},{"line":263,"address":[2851328],"length":1,"stats":{"Line":0}},{"line":265,"address":[2851415],"length":1,"stats":{"Line":0}},{"line":266,"address":[2851649,2851901,2851739],"length":1,"stats":{"Line":0}},{"line":273,"address":[2851491],"length":1,"stats":{"Line":0}},{"line":274,"address":[2076672,2077141],"length":1,"stats":{"Line":0}},{"line":275,"address":[2852077],"length":1,"stats":{"Line":0}},{"line":276,"address":[2852093],"length":1,"stats":{"Line":0}},{"line":280,"address":[2852189,2852278],"length":1,"stats":{"Line":0}},{"line":282,"address":[2852318],"length":1,"stats":{"Line":0}},{"line":287,"address":[2077728,2077685],"length":1,"stats":{"Line":0}},{"line":295,"address":[2852578],"length":1,"stats":{"Line":0}},{"line":312,"address":[2869151,2869072],"length":1,"stats":{"Line":0}},{"line":318,"address":[2077808,2079197],"length":1,"stats":{"Line":0}},{"line":319,"address":[2077828],"length":1,"stats":{"Line":0}},{"line":320,"address":[2077849],"length":1,"stats":{"Line":0}},{"line":322,"address":[2077939],"length":1,"stats":{"Line":0}},{"line":323,"address":[2853059,2853149,2853296],"length":1,"stats":{"Line":0}},{"line":326,"address":[2078026],"length":1,"stats":{"Line":0}},{"line":327,"address":[2078491,2078582,2078065],"length":1,"stats":{"Line":0}},{"line":328,"address":[2853349,2853501,2853592],"length":1,"stats":{"Line":0}},{"line":330,"address":[2853573,2853744],"length":1,"stats":{"Line":0}},{"line":331,"address":[2853916,2853974],"length":1,"stats":{"Line":0}},{"line":333,"address":[2853950],"length":1,"stats":{"Line":0}},{"line":347,"address":[2869168,2869247],"length":1,"stats":{"Line":0}},{"line":353,"address":[2854064,2855341],"length":1,"stats":{"Line":0}},{"line":354,"address":[2079260],"length":1,"stats":{"Line":0}},{"line":355,"address":[2079281],"length":1,"stats":{"Line":0}},{"line":357,"address":[2854183],"length":1,"stats":{"Line":0}},{"line":358,"address":[2854669,2854417,2854507],"length":1,"stats":{"Line":0}},{"line":365,"address":[2079449],"length":1,"stats":{"Line":0}},{"line":366,"address":[2854290,2854743],"length":1,"stats":{"Line":0}},{"line":367,"address":[2854845],"length":1,"stats":{"Line":0}},{"line":368,"address":[2854861],"length":1,"stats":{"Line":0}},{"line":372,"address":[2855046,2854957],"length":1,"stats":{"Line":0}},{"line":374,"address":[2855086],"length":1,"stats":{"Line":0}},{"line":379,"address":[2855289,2855246],"length":1,"stats":{"Line":0}},{"line":387,"address":[2080521],"length":1,"stats":{"Line":0}},{"line":404,"address":[2067375,2067296],"length":1,"stats":{"Line":0}},{"line":410,"address":[2080576,2081793],"length":1,"stats":{"Line":0}},{"line":411,"address":[2855388],"length":1,"stats":{"Line":0}},{"line":412,"address":[2080609],"length":1,"stats":{"Line":0}},{"line":414,"address":[2080699],"length":1,"stats":{"Line":0}},{"line":415,"address":[2855877,2856018,2855787],"length":1,"stats":{"Line":0}},{"line":422,"address":[2855580],"length":1,"stats":{"Line":0}},{"line":423,"address":[2081245,2081336,2080825],"length":1,"stats":{"Line":0}},{"line":424,"address":[2081513,2081277,2081431],"length":1,"stats":{"Line":0}},{"line":426,"address":[2856403,2856255],"length":1,"stats":{"Line":0}},{"line":427,"address":[2856491,2856541],"length":1,"stats":{"Line":0}},{"line":429,"address":[2856525],"length":1,"stats":{"Line":0}},{"line":443,"address":[2869360,2869439],"length":1,"stats":{"Line":0}},{"line":449,"address":[2067434],"length":1,"stats":{"Line":0}},{"line":450,"address":[2856620],"length":1,"stats":{"Line":0}},{"line":451,"address":[2856640],"length":1,"stats":{"Line":0}},{"line":453,"address":[2081947],"length":1,"stats":{"Line":0}},{"line":454,"address":[2082439,2082277,2082187],"length":1,"stats":{"Line":0}},{"line":461,"address":[2082025],"length":1,"stats":{"Line":0}},{"line":462,"address":[2856834,2857287],"length":1,"stats":{"Line":0}},{"line":463,"address":[2857389],"length":1,"stats":{"Line":0}},{"line":464,"address":[2082639],"length":1,"stats":{"Line":0}},{"line":468,"address":[2857501,2857590],"length":1,"stats":{"Line":0}},{"line":470,"address":[2082869],"length":1,"stats":{"Line":0}},{"line":475,"address":[2857833,2857790],"length":1,"stats":{"Line":0}},{"line":483,"address":[2083097],"length":1,"stats":{"Line":0}},{"line":501,"address":[2869456,2869535],"length":1,"stats":{"Line":0}},{"line":507,"address":[2067530],"length":1,"stats":{"Line":0}},{"line":508,"address":[2083164],"length":1,"stats":{"Line":0}},{"line":509,"address":[2083185],"length":1,"stats":{"Line":0}},{"line":511,"address":[2083275],"length":1,"stats":{"Line":0}},{"line":512,"address":[2083659,2083800,2083569],"length":1,"stats":{"Line":0}},{"line":516,"address":[2083362],"length":1,"stats":{"Line":0}},{"line":517,"address":[2858163,2858583,2858673],"length":1,"stats":{"Line":0}},{"line":518,"address":[2858877,2858615,2858767],"length":1,"stats":{"Line":0}},{"line":520,"address":[2084216,2084071],"length":1,"stats":{"Line":0}},{"line":521,"address":[2084317,2084367],"length":1,"stats":{"Line":0}},{"line":523,"address":[2859101],"length":1,"stats":{"Line":0}},{"line":535,"address":[2067584,2067633],"length":1,"stats":{"Line":1}},{"line":540,"address":[2067626],"length":1,"stats":{"Line":2}},{"line":541,"address":[2084449],"length":1,"stats":{"Line":1}},{"line":542,"address":[2859218],"length":1,"stats":{"Line":1}},{"line":545,"address":[2859301],"length":1,"stats":{"Line":1}},{"line":547,"address":[2859332,2859453],"length":1,"stats":{"Line":2}},{"line":548,"address":[2859557],"length":1,"stats":{"Line":1}},{"line":551,"address":[2084839],"length":1,"stats":{"Line":1}},{"line":554,"address":[2859674],"length":1,"stats":{"Line":1}},{"line":555,"address":[2085089,2085144],"length":1,"stats":{"Line":1}},{"line":557,"address":[2859841],"length":1,"stats":{"Line":1}},{"line":571,"address":[2067648,2067727],"length":1,"stats":{"Line":0}},{"line":577,"address":[2085200,2086503],"length":1,"stats":{"Line":0}},{"line":578,"address":[2085212],"length":1,"stats":{"Line":0}},{"line":579,"address":[2859936],"length":1,"stats":{"Line":0}},{"line":581,"address":[2860023],"length":1,"stats":{"Line":0}},{"line":582,"address":[2860347,2860509,2860257],"length":1,"stats":{"Line":0}},{"line":589,"address":[2085401],"length":1,"stats":{"Line":0}},{"line":590,"address":[2860583,2860130],"length":1,"stats":{"Line":0}},{"line":591,"address":[2085999],"length":1,"stats":{"Line":0}},{"line":592,"address":[2860701],"length":1,"stats":{"Line":0}},{"line":595,"address":[2086205,2086130],"length":1,"stats":{"Line":0}},{"line":596,"address":[2860805,2860797],"length":1,"stats":{"Line":0}},{"line":597,"address":[2860808,2860801],"length":1,"stats":{"Line":0}},{"line":600,"address":[2860926],"length":1,"stats":{"Line":0}},{"line":605,"address":[2861131,2861088],"length":1,"stats":{"Line":0}},{"line":613,"address":[2861156],"length":1,"stats":{"Line":0}},{"line":626,"address":[2869765,2869712],"length":1,"stats":{"Line":0}},{"line":631,"address":[2869754],"length":1,"stats":{"Line":0}},{"line":632,"address":[2861243],"length":1,"stats":{"Line":0}},{"line":634,"address":[2861260],"length":1,"stats":{"Line":0}},{"line":635,"address":[2861448,2861539,2861642],"length":1,"stats":{"Line":0}},{"line":642,"address":[2861351],"length":1,"stats":{"Line":0}},{"line":644,"address":[2861766,2861673,2861392],"length":1,"stats":{"Line":0}}],"covered":54,"coverable":171},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","src","error.rs"],"content":"// standard\nuse std::ffi::CString;\nuse std::os::raw::c_char;\n\n// extern crates\nuse anyhow::bail;\n#[cfg(feature = \"impl-lib\")]\nuse cgosling_proc_macros::*;\n\n// internal crates\nuse crate::ffi::*;\nuse crate::macros::*;\n\n/// Error Handling\n#[derive(Clone)]\npub struct Error {\n    message: CString,\n}\n\nimpl Error {\n    pub fn new(message: \u0026str) -\u003e Error {\n        Error {\n            message: CString::new(message).unwrap_or_default(),\n        }\n    }\n\n    pub fn message(\u0026self) -\u003e \u0026CString {\n        \u0026self.message\n    }\n}\n\ndefine_registry! {Error}\n\n/// A wrapper object containing an error message\npub struct GoslingError;\n\n/// Get error message from gosling_error\n///\n/// @param error: the error object to get the message from\n/// @return null-terminated string with error message whose\n///  lifetime is tied to the source\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_error_get_message(error: *const GoslingError) -\u003e *const c_char {\n    if !error.is_null() {\n        let key = error as usize;\n\n        let registry = get_error_registry();\n        if registry.contains_key(key) {\n            if let Some(x) = registry.get(key) {\n                return x.message().as_ptr();\n            }\n        }\n    }\n\n    std::ptr::null()\n}\n\n/// Copy method for gosling_error\n///\n/// @param out_error: returned copy\n/// @param orig_error: original to copy\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_error_clone(\n    out_error: *mut *mut GoslingError,\n    orig_error: *const GoslingError,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_error);\n        ensure_not_null!(orig_error);\n\n        let orig_error = match get_error_registry().get(orig_error as usize) {\n            Some(orig_error) =\u003e orig_error.clone(),\n            None =\u003e bail_invalid_handle!(orig_error),\n        };\n        let handle = get_error_registry().insert(orig_error);\n        *out_error = handle as *mut GoslingError;\n\n        Ok(())\n    })\n}\n\n/// Frees gosling_error and invalidates any message strings\n/// returned by gosling_error_get_message() from the given\n/// error object.\n///\n/// @param error: the error object to free\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_error_free(error: *mut GoslingError) {\n    impl_registry_free!(error, Error);\n}\n\n/// Wrapper around rust code which may panic or return a failing Result to be used at FFI boundaries.\n/// Converts panics or error Results into GoslingErrors if a memory location is provided.\n///\n/// @param default: The default value to return in the event of failure\n/// @param out_error: A pointer to pointer to GoslingError 'struct' for the C FFI\n/// @param closure: The functionality we need to encapsulate behind the error handling logic\n/// @return The result of closure() on success, or the value of default on failure.\npub(crate) fn translate_failures\u003cR, F\u003e(\n    default: R,\n    out_error: *mut *mut GoslingError,\n    closure: F,\n) -\u003e R\nwhere\n    F: FnOnce() -\u003e anyhow::Result\u003cR\u003e + std::panic::UnwindSafe,\n{\n    match std::panic::catch_unwind(closure) {\n        // handle success\n        Ok(Ok(retval)) =\u003e retval,\n        // handle runtime error\n        Ok(Err(err)) =\u003e {\n            if !out_error.is_null() {\n                // populate error with runtime error message\n                let key = get_error_registry().insert(Error::new(format!(\"{:?}\", err).as_str()));\n                unsafe {\n                    *out_error = key as *mut GoslingError;\n                };\n            }\n            default\n        }\n        // handle panic\n        Err(_) =\u003e {\n            if !out_error.is_null() {\n                // populate error with panic message\n                let key = get_error_registry().insert(Error::new(\"panic occurred\"));\n                unsafe {\n                    *out_error = key as *mut GoslingError;\n                };\n            }\n            default\n        }\n    }\n}\n","traces":[{"line":21,"address":[2861840],"length":1,"stats":{"Line":0}},{"line":23,"address":[2861860],"length":1,"stats":{"Line":0}},{"line":27,"address":[2861904],"length":1,"stats":{"Line":0}},{"line":44,"address":[2861920,2861951],"length":1,"stats":{"Line":0}},{"line":45,"address":[2861940,2861964],"length":1,"stats":{"Line":0}},{"line":46,"address":[2861975],"length":1,"stats":{"Line":0}},{"line":48,"address":[2862045,2861991],"length":1,"stats":{"Line":0}},{"line":49,"address":[2862064],"length":1,"stats":{"Line":0}},{"line":50,"address":[2862124],"length":1,"stats":{"Line":0}},{"line":51,"address":[2862216],"length":1,"stats":{"Line":0}},{"line":56,"address":[2862307],"length":1,"stats":{"Line":0}},{"line":66,"address":[2862369,2862320],"length":1,"stats":{"Line":0}},{"line":71,"address":[2862362],"length":1,"stats":{"Line":0}},{"line":72,"address":[1670681],"length":1,"stats":{"Line":0}},{"line":73,"address":[2117739],"length":1,"stats":{"Line":0}},{"line":75,"address":[1670948,1670781],"length":1,"stats":{"Line":0}},{"line":76,"address":[1671052,1671175],"length":1,"stats":{"Line":0}},{"line":79,"address":[1671255],"length":1,"stats":{"Line":0}},{"line":80,"address":[1671486,1671423],"length":1,"stats":{"Line":0}},{"line":82,"address":[1671459],"length":1,"stats":{"Line":0}},{"line":93,"address":[2259008,2259037],"length":1,"stats":{"Line":0}},{"line":104,"address":[1679147,1730576,1727904,1728827,1682240,1745244,1766692,1671552,1692940,1681819,1729248,1672896,1689851,1703259,1731904,1762688,1691616,1688908,1719872,1726540,1725196,1740843,1698336,1695628,1737220,1678220,1708651,1722115,1758672,1768955,1718107,1706364,1759996,1723467,1752883,1695648,1715840,1734576,1684908,1777404,1707307,1735483,1694304,1743916,1747936,1675548,1731483,1719852,1696972,1714059,1680892,1754235,1704608,1680491,1692539,1701004,1700603,1725216,1734155,1766291,1697915,1702352,1699680,1746187,1696571,1711788,1759595,1770704,1721180,1722516,1748859,1683556,1707708,1705015,1688928,1761344,1717164,1772971,1760923,1742187,1676876,1703680,1684507,1719451,1712715,1722544,1731884,1750187,1755563,1769376,1755984,1707728,1710461,1698316,1679568,1767627,1695227,1714480,1705963,1753284,1743936,1757328,1718508,1751968,1772020,1751951,1730155,1744843,1726560,1774736,1754656,1692960,1685835,1768028,1713116,1701931,1706384,1737248,1701024,1758251,1776060,1742588,1682220,1673811,1727483,1739936,1746588,1675568,1736819,1726139,1703660,1687600,1774315,1715408,1732811,1724795,1699259,1739916,1747916,1762668,1710480,1729228,1777003,1776080,1716763,1717184,1772048,1730556,1762267,1727884,1773392,1750588,1679548,1686236,1764955,1691596,1721200,1735884,1753312,1757308,1764032,1674212,1714460,1738592,1723888,1690252,1672475,1751544,1739515,1775659,1743515,1684928,1674240,1764012,1741244,1683584,1761324,1773372,1760016,1755964,1735904,1683155,1738171,1699660,1691195,1738572,1687179,1766720,1718528,1710050,1676896,1734556,1741264,1678240,1711387,1763611,1750608,1769356,1746608,1694284,1709052,1765356,1720779,1688507,1687580,1693883,1680912,1711808,1768048,1702332,1713136,1733212,1771619,1709072,1690272,1754636,1675147,1686256,1715815,1770684,1756907,1747515,1672876,1770283,1705040,1749260,1774716,1723868,1758652,1676475,1696992,1742608,1749280,1733232,1745264,1677819,1765376],"length":1,"stats":{"Line":36}},{"line":112,"address":[],"length":0,"stats":{"Line":72}},{"line":114,"address":[],"length":0,"stats":{"Line":36}},{"line":116,"address":[],"length":0,"stats":{"Line":0}},{"line":117,"address":[],"length":0,"stats":{"Line":0}},{"line":119,"address":[1768596,1722921,1763381,1735124,1689621,1750927,1694681,1761721,1682796,1702658,1752653,1759236,1674601,1700057,1707077,1709433,1678917,1731124,1720420,1673210,1734882,1746969,1673452,1748258,1764409,1752282,1689305,1691993,1697685,1721885,1732581,1740484,1699029,1749957,1767081,1708421,1716404,1732210,1713513,1767397,1740297,1769682,1757892,1769737,1705733,1737812,1717748,1771389,1706706,1751185,1724194,1728226,1728281,1724565,1701330,1745828,1757705,1687961,1750998,1713829,1686820,1775113,1773769,1725538,1766061,1693653,1697369,1698713,1741828,1763252,1709504,1765690,1738914,1734937,1672245,1696212,1755017,1684148,1685289,1690649,1694997,1749641,1689492,1685234,1690965,1729796,1756306,1763010,1764725,1728597,1768409,1682925,1701385,1731253,1703029,1677460,1773714,1711157,1709820,1710786,1733796,1730937,1747156,1760377,1765932,1767268,1675874,1693282,1697556,1756361,1736460,1727124,1704062,1764354,1671929,1692180,1721569,1755204,1763065,1775058,1710841,1729554,1711028,1702713,1741641,1749586,1678601,1708050,1743285,1718850,1696341,1689250,1715049,1739156,1760693,1768354,1762037,1726882,1714791,1719092,1732265,1717506,1737570,1675929,1773956,1760564,1674788,1690594,1700373,1755333,1761908,1712114,1708292,1701572,1692309,1685605,1776773,1705362,1747285,1764596,1741957,1677589,1674917,1700244,1679890,1739285,1700002,1774085,1753689,1721756,1702900,1717877,1686633,1704378,1688148,1742914,1682554,1672116,1687906,1681218,1696025,1677218,1733925,1737625,1680261,1723108,1673265,1705417,1683906,1729609,1697314,1722866,1737941,1740242,1744242,1748629,1752524,1772612,1775429,1776457,1681460,1673581,1678546,1719221,1718905,1770053,1694626,1735253,1753876,1698658,1713458,1716162,1736589,1771018,1685476,1744613,1730882,1680132,1693524,1725593,1760322,1733554,1776402,1753634,1683961,1701701,1720178,1733609,1681589,1756548,1756677,1765745,1676116,1757650,1769924,1679945,1772741,1694868,1726937,1748313,1736273,1744484,1775300,1749828,1706761,1709691,1745641,1671874,1745586,1715178,1684277,1736218,1767026,1761666,1712485,1768725,1676245,1729925,1717561,1705604,1724249,1759365,1725909,1759049,1708105,1712356,1742969,1712169,1674546,1681273,1686578,1771260,1758021,1704249,1725780,1695970,1728468,1706948,1745957,1746914,1754005,1772425,1758994,1741586,1748500,1738969,1776644,1751314,1744297,1720233,1732452,1727253,1714862,1771073,1754962,1720549,1682609,1752337,1686949,1743156,1688277,1690836,1723237,1677273,1698900,1716533,1716217,1721514,1724436,1713700,1772370,1678788,1691938,1740613,1703991,1693337],"length":1,"stats":{"Line":0}},{"line":121,"address":[],"length":0,"stats":{"Line":0}},{"line":124,"address":[],"length":0,"stats":{"Line":0}},{"line":127,"address":[],"length":0,"stats":{"Line":0}},{"line":128,"address":[],"length":0,"stats":{"Line":0}},{"line":130,"address":[],"length":0,"stats":{"Line":0}},{"line":132,"address":[],"length":0,"stats":{"Line":0}},{"line":135,"address":[],"length":0,"stats":{"Line":0}}],"covered":3,"coverable":34},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","src","ffi.rs"],"content":"// standard\nuse std::sync::atomic::{AtomicBool, Ordering};\n\n// extern crates\nuse anyhow::bail;\n#[cfg(feature = \"impl-lib\")]\nuse cgosling_proc_macros::*;\n\n// internal crates\nuse crate::context::*;\nuse crate::crypto::*;\nuse crate::error::*;\nuse crate::macros::*;\nuse crate::tor_provider::*;\nuse crate::utils::*;\n\n// tags used for types we put in ObjectRegistrys\npub(crate) const ERROR_TAG: usize = 0x1;\npub(crate) const ED25519_PRIVATE_KEY_TAG: usize = 0x2;\npub(crate) const X25519_PRIVATE_KEY_TAG: usize = 0x3;\npub(crate) const X25519_PUBLIC_KEY_TAG: usize = 0x4;\npub(crate) const V3_ONION_SERVICE_ID_TAG: usize = 0x5;\npub(crate) const IP_ADDR_TAG: usize = 0x6;\npub(crate) const TARGET_ADDR_TAG: usize = 0x7;\n#[cfg(feature = \"legacy-tor-provider\")]\npub(crate) const PROXY_CONFIG_TAG: usize = 0x8;\n#[cfg(feature = \"legacy-tor-provider\")]\npub(crate) const PLUGGABLE_TRANSPORT_CONFIG_TAG: usize = 0x9;\n#[cfg(feature = \"legacy-tor-provider\")]\npub(crate) const BRIDGE_LINE_TAG: usize = 0xA;\npub(crate) const TOR_PROVIDER_CONFIG_TAG: usize = 0xB;\npub(crate) const TOR_PROVIDER_TAG: usize = 0xC;\npub(crate) const CONTEXT_TUPLE_TAG: usize = 0xD;\n\n/// A handle for the gosling library\npub struct GoslingLibrary;\n\nstatic GOSLING_LIBRARY_INITED: AtomicBool = AtomicBool::new(false);\nconst GOSLING_LIBRARY_HANDLE: usize = {\n    // integer constant in the form 0x6000..5E (GOOOOOSE)\n    (0x60 \u003c\u003c ((std::mem::size_of::\u003cusize\u003e() - 1) * 8)) + 0x5E\n};\n\n/// Initializes the Gosling library. This function must be called before using any of the\n/// other Gosling functions.\n///\n/// @param out_library: returned gosling library handle\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_library_init(\n    out_library: *mut *mut GoslingLibrary,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_library);\n\n        if GOSLING_LIBRARY_INITED.load(Ordering::Relaxed) {\n            // error handling\n            bail!(\"gosling is already initialized\");\n        } else {\n            GOSLING_LIBRARY_INITED.store(true, Ordering::Relaxed);\n            *out_library = GOSLING_LIBRARY_HANDLE as *mut GoslingLibrary;\n        }\n        Ok(())\n    })\n}\n\n/// Frees all resources associated with the Gosling library. No-op if the library\n/// is not initialized or if it has already been freed\n/// @param in_library: gosling library handle to free\n#[no_mangle]\n#[allow(unused_variables)]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_library_free(in_library: *mut GoslingLibrary) {\n    if GOSLING_LIBRARY_INITED.load(Ordering::Relaxed) {\n        clear_error_registry();\n\n        clear_ed25519_private_key_registry();\n        clear_x25519_private_key_registry();\n        clear_x25519_public_key_registry();\n        clear_v3_onion_service_id_registry();\n        clear_ip_addr_registry();\n        clear_target_addr_registry();\n        #[cfg(feature = \"legacy-tor-provider\")]\n        clear_proxy_config_registry();\n        #[cfg(feature = \"legacy-tor-provider\")]\n        clear_pluggable_transport_config_registry();\n        #[cfg(feature = \"legacy-tor-provider\")]\n        clear_bridge_line_registry();\n        clear_tor_provider_registry();\n        clear_tor_provider_config_registry();\n        clear_context_tuple_registry();\n\n        GOSLING_LIBRARY_INITED.store(false, Ordering::Relaxed);\n    }\n}\n","traces":[{"line":51,"address":[2065216,2065253],"length":1,"stats":{"Line":1}},{"line":55,"address":[1627630],"length":1,"stats":{"Line":2}},{"line":56,"address":[2873417],"length":1,"stats":{"Line":1}},{"line":58,"address":[2873434],"length":1,"stats":{"Line":1}},{"line":60,"address":[2873574],"length":1,"stats":{"Line":0}},{"line":62,"address":[2873523],"length":1,"stats":{"Line":1}},{"line":63,"address":[2873646,2873618,2873550],"length":1,"stats":{"Line":2}},{"line":65,"address":[2873631],"length":1,"stats":{"Line":1}},{"line":75,"address":[1627701,1627664],"length":1,"stats":{"Line":1}},{"line":76,"address":[1627714,1627673],"length":1,"stats":{"Line":2}},{"line":77,"address":[1627725],"length":1,"stats":{"Line":1}},{"line":79,"address":[2065348],"length":1,"stats":{"Line":1}},{"line":80,"address":[1627739],"length":1,"stats":{"Line":1}},{"line":81,"address":[1627746],"length":1,"stats":{"Line":1}},{"line":82,"address":[1627753],"length":1,"stats":{"Line":1}},{"line":83,"address":[1627760],"length":1,"stats":{"Line":1}},{"line":84,"address":[1627767],"length":1,"stats":{"Line":1}},{"line":86,"address":[2065390],"length":1,"stats":{"Line":1}},{"line":88,"address":[1627781],"length":1,"stats":{"Line":1}},{"line":90,"address":[1627788],"length":1,"stats":{"Line":1}},{"line":91,"address":[1627795],"length":1,"stats":{"Line":1}},{"line":92,"address":[1627802],"length":1,"stats":{"Line":1}},{"line":93,"address":[1627809],"length":1,"stats":{"Line":1}},{"line":95,"address":[1627816],"length":1,"stats":{"Line":1}}],"covered":23,"coverable":24},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","src","lib.rs"],"content":"// some internal functions take a lot of args but thats ok\n#![allow(clippy::too_many_arguments)]\n// we don't generate Rust docs since this crate should never be used from\n// Rust, only from languages where the c-ffi is the only option; developers\n// should consult the Doxygen generated docs\n#![allow(clippy::missing_safety_doc)]\n\npub mod callbacks;\npub mod context;\npub mod crypto;\npub mod error;\npub mod ffi;\nmod macros;\nmod object_registry;\npub mod tor_provider;\npub mod utils;\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","src","macros.rs"],"content":"// implemeents per-type registry types\nmacro_rules! define_registry {\n    ($type:ty) =\u003e {\n        paste::paste! {\n            // ensure tag fits in 4 bits\n            static_assertions::const_assert!([\u003c$type:snake:upper _TAG\u003e] \u003c= 0b1111);\n\n            static [\u003c$type:snake:upper _REGISTRY\u003e]: std::sync::Mutex\u003ccrate::object_registry::ObjectRegistry\u003c$type, { [\u003c$type:snake:upper _TAG\u003e] }, 4\u003e\u003e = std::sync::Mutex::new(crate::object_registry::ObjectRegistry::new());\n\n            pub(crate) fn [\u003cget_ $type:snake _registry\u003e]\u003c'a\u003e() -\u003e std::sync::MutexGuard\u003c'a, crate::object_registry::ObjectRegistry\u003c$type, { [\u003c$type:snake:upper _TAG\u003e] }, 4\u003e\u003e {\n                match [\u003c$type:snake:upper _REGISTRY\u003e].lock() {\n                    Ok(registry) =\u003e registry,\n                    Err(_) =\u003e unreachable!(\"another thread panicked while holding this registry's mutex\"),\n                }\n            }\n\n            pub(crate) fn [\u003cclear_ $type:snake _registry\u003e]() {\n                match [\u003c$type:snake:upper _REGISTRY\u003e].lock() {\n                    Ok(mut registry) =\u003e *registry = crate::object_registry::ObjectRegistry::new(),\n                    Err(_) =\u003e unreachable!(\"another thread panicked while holding this registry's mutex\"),\n                }\n            }\n        }\n    }\n}\npub(crate) use define_registry;\n\n// macro for defining the implementation of freeing objects\n// owned by an ObjectRegistry\nmacro_rules! impl_registry_free {\n    ($obj:expr, $type:ty) =\u003e {\n        if $obj.is_null() {\n            return;\n        }\n\n        let key = $obj as usize;\n        paste::paste! {\n            [\u003cget_ $type:snake _registry\u003e]().remove(key);\n        }\n    };\n}\npub(crate) use impl_registry_free;\n\n//\n// Argument validation macros\n//\n\n// ensure pointer is not null\nmacro_rules! ensure_not_null {\n    ($ptr:ident) =\u003e {\n        paste::paste! {\n            if $ptr.is_null() {\n                bail!(stringify!([\u003c$ptr\u003e] must not be null));\n            }\n        }\n    };\n}\npub(crate) use ensure_not_null;\n\nmacro_rules! ensure_not_equal {\n    ($value:ident, $constant:literal) =\u003e {\n        if $value == $constant {\n            bail!(stringify!([\u003c$value\u003e must not be \u003c$constant\u003e]));\n        }\n    }\n}\npub(crate) use ensure_not_equal;\n\n// bail because handle invalid\nmacro_rules! bail_invalid_handle {\n    ($handle:ident) =\u003e {\n        paste::paste! {\n            bail!(stringify!([\u003c$handle\u003e] is invalid))\n        }\n    };\n}\npub(crate) use bail_invalid_handle;\n","traces":[{"line":10,"address":[1662184,1662000,1662206],"length":1,"stats":{"Line":7}},{"line":11,"address":[2843687,2844391],"length":1,"stats":{"Line":7}},{"line":12,"address":[2835216,2833104,2834512,2835920,2833808],"length":1,"stats":{"Line":7}},{"line":13,"address":[2253717],"length":1,"stats":{"Line":0}},{"line":17,"address":[2259456,2259925,2259860],"length":1,"stats":{"Line":13}},{"line":18,"address":[2253815],"length":1,"stats":{"Line":13}},{"line":19,"address":[2836152,2834744,2834786,2833336,2834082,2835076,2835490,2836484,2835448,2833668,2834372,2836194,2834040,2835780,2833378],"length":1,"stats":{"Line":13}},{"line":20,"address":[1662615],"length":1,"stats":{"Line":0}},{"line":32,"address":[1638284,1638260],"length":1,"stats":{"Line":0}},{"line":36,"address":[1638295],"length":1,"stats":{"Line":0}},{"line":38,"address":[2868140,2868452,2868110,2868286,2867960,2867927,2868485,2868316],"length":1,"stats":{"Line":0}},{"line":52,"address":[2873425],"length":1,"stats":{"Line":43}},{"line":53,"address":[2040884,2041572,2050050,2052969,2050415,2037891,2042385,2047026,2037426,2037533,2042492,2040196,2042862,2045719,2042274,2042728,2045838,2047149,2047268,2049337,2050296,2050173],"length":1,"stats":{"Line":0}},{"line":62,"address":[1790889,1798618,1790666,1793143,1795931,1794031,1798820,1798401,1801927],"length":1,"stats":{"Line":6}},{"line":63,"address":[1850419,1838156,1838040,1842820,1847403],"length":1,"stats":{"Line":0}},{"line":73,"address":[1633019,1633852,1628763,1628155,1629292,1633323,1628459,1632332,1635372,1629979,1632940,1631803,1631420,1628684,1630283,1630891,1628076,1631195,1631724,1633548,1633931,1633627,1634539,1631499,1632107,1630587,1630812,1632411,1634235,1629596,1634843,1632636,1634764,1629675,1635068,1628380,1635147,1629371,1629067,1634460,1631116,1630508,1632715,1630204,1632028,1635451,1629900,1628988,1634156,1633244],"length":1,"stats":{"Line":0}}],"covered":8,"coverable":16},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","src","object_registry.rs"],"content":"// standard\nuse std::collections::BTreeMap;\nuse std::option::Option;\n\n// An ObjectRegistry\u003cT\u003e maintains ownership of objects and maps them to usize keys\n// which can be safely handed out to external consumers as opaque pointer.\n// Keys are represented as a usize; the high bits are a unique identifier (calculated\n// as the number of keys handed out at the time of key creation, but this is an implementation\n// detail) while the low bits are a user-provided tag used to disambiguate keys from different\n// ObjectRegistry's.\n//\n// T: the type we are storing in the registry\n// TAG: a usize constant which occupy the low bits of returned keys\n// TAG_BITS: the number of bits needed to store the tag (the remainder of the usize bits are used\n//   for the unique id portion of the returne dkeys)\npub struct ObjectRegistry\u003cT, const TAG: usize, const TAG_BITS: u32\u003e {\n    // our internal mapping from handles to Ts\n    map: Option\u003cBTreeMap\u003cusize, T\u003e\u003e,\n    // number of Ts registered to this registry over its lifetime\n    counter: usize,\n}\n\n// Rust only supports 8-bit bytes\nconst BITS_PER_BYTE: u32 = 8;\n\nimpl\u003cT, const TAG: usize, const TAG_BITS: u32\u003e ObjectRegistry\u003cT, TAG, TAG_BITS\u003e {\n    // the number of bits available to the counter portion of an object key\n    const COUNTER_BITS: u32 = std::mem::size_of::\u003cusize\u003e() as u32 * BITS_PER_BYTE - TAG_BITS;\n    // the largest value the counter portion of the key can be without rolling over to 0\n    const COUNTER_MAX: usize = !0usize \u003e\u003e TAG_BITS;\n\n    // return the next key to return on successful insertion\n    fn next_key(\u0026mut self) -\u003e usize {\n        assert!(self.counter \u003c Self::COUNTER_MAX);\n        self.counter += 1;\n        (self.counter \u003c\u003c TAG_BITS) | TAG\n    }\n\n    // returns a new empty ObjectRegisry\n    pub const fn new() -\u003e ObjectRegistry\u003cT, TAG, TAG_BITS\u003e {\n        assert!(TAG_BITS == 0 || (TAG \u003c\u003c Self::COUNTER_BITS) \u003e\u003e Self::COUNTER_BITS == TAG);\n\n        ObjectRegistry {\n            map: None,\n            counter: 0,\n        }\n    }\n\n    // determine if the registry has an object with the specified key\n    pub fn contains_key(\u0026self, key: usize) -\u003e bool {\n        match \u0026self.map {\n            Some(map) =\u003e map.contains_key(\u0026key),\n            None =\u003e false,\n        }\n    }\n\n    // remove and return an object with the specified key\n    pub fn remove(\u0026mut self, key: usize) -\u003e Option\u003cT\u003e {\n        match \u0026mut self.map {\n            Some(map) =\u003e map.remove(\u0026key),\n            None =\u003e None,\n        }\n    }\n\n    // add object into registry and return key to reference it\n    pub fn insert(\u0026mut self, val: T) -\u003e usize {\n        let key = self.next_key();\n        match \u0026mut self.map {\n            Some(map) =\u003e {\n                if map.insert(key, val).is_some() {\n                    panic!();\n                }\n            }\n            None =\u003e {\n                let mut map = BTreeMap::new();\n                map.insert(key, val);\n                self.map = Some(map);\n            }\n        }\n        key\n    }\n\n    // gets a reference to a value by the given key\n    pub fn get(\u0026self, key: usize) -\u003e Option\u003c\u0026T\u003e {\n        match \u0026self.map {\n            Some(map) =\u003e map.get(\u0026key),\n            None =\u003e None,\n        }\n    }\n\n    // gets a mutable reference to a value by the given key\n    pub fn get_mut(\u0026mut self, key: usize) -\u003e Option\u003c\u0026mut T\u003e {\n        match \u0026mut self.map {\n            Some(map) =\u003e map.get_mut(\u0026key),\n            None =\u003e None,\n        }\n    }\n\n    #[cfg(test)]\n    // gets just the tag portion of a key assuming it came from\n    // this registry\n    fn get_tag_from_key(\u0026self, key: usize) -\u003e usize {\n        // zero out the counter bits and return tag\n        (key \u003c\u003c Self::COUNTER_BITS) \u003e\u003e Self::COUNTER_BITS\n    }\n\n    #[cfg(test)]\n    // gets the counter portion of a key assuming it came from\n    // this registry\n    fn get_counter_from_key(\u0026self, key: usize) -\u003e usize {\n        // rotate out the tag bits\n        key \u003e\u003e TAG_BITS\n    }\n\n    #[cfg(test)]\n    // calculate the key given the counter assuming it would be used\n    // by this registry\n    fn get_key_from_counter(\u0026self, counter: usize) -\u003e usize {\n        (counter \u003c\u003c TAG_BITS) | TAG\n    }\n}\n\n#[test]\nfn test_object_registry() -\u003e anyhow::Result\u003c()\u003e {\n    // create a new ObjectRegistry\n    type Int32Registry0_16 = ObjectRegistry\u003ci32, 1234usize, 16\u003e;\n    let mut registry = Int32Registry0_16::new();\n    assert_eq!(\n        Int32Registry0_16::COUNTER_BITS,\n        std::mem::size_of::\u003cusize\u003e() as u32 * BITS_PER_BYTE - 16\n    );\n\n    // add some objects to the registry and get their keys\n    let key1 = registry.insert(10);\n    let key2 = registry.insert(20);\n    let key3 = registry.insert(30);\n\n    // check that the registry contains the keys we just added\n    assert!(registry.contains_key(key1));\n    assert!(registry.contains_key(key2));\n    assert!(registry.contains_key(key3));\n\n    // check that we can get the objects back using their keys\n    assert_eq!(registry.get(key1), Some(\u002610));\n    assert_eq!(registry.get(key2), Some(\u002620));\n    assert_eq!(registry.get(key3), Some(\u002630));\n\n    // check that we can get mutable references to the objects and modify them\n    let obj = registry.get_mut(key1).unwrap();\n    *obj = 100;\n    assert_eq!(registry.get(key1), Some(\u0026100));\n\n    // check that we can remove objects from the registry and they are no longer contained\n    let obj = registry.remove(key2).unwrap();\n    assert_eq!(obj, 20);\n    assert!(!registry.contains_key(key2));\n\n    // check that the tag bits of the keys match the TAG constant we provided\n    assert_eq!(registry.get_tag_from_key(key1), 1234usize);\n    assert_eq!(registry.get_tag_from_key(key2), 1234usize);\n    assert_eq!(registry.get_tag_from_key(key3), 1234usize);\n\n    // check that the counter bits of the keys are unique and increasing\n    let counter1 = registry.get_counter_from_key(key1);\n    let counter2 = registry.get_counter_from_key(key2);\n    let counter3 = registry.get_counter_from_key(key3);\n    assert!(counter1 \u003c counter2 \u0026\u0026 counter2 \u003c counter3);\n\n    // check that we can calculate the key given the counter and it matches the key we got from insert()\n    assert_eq!(registry.get_key_from_counter(1), key1);\n    assert_eq!(registry.get_key_from_counter(2), key2);\n    assert_eq!(registry.get_key_from_counter(3), key3);\n\n    Ok(())\n}\n\n#[test]\nfn test_object_registry_key_collision() -\u003e anyhow::Result\u003c()\u003e {\n    // create two registries with different TAG values\n    let mut registry_a: ObjectRegistry\u003cString, 1usize, 8\u003e = ObjectRegistry::new();\n    let mut registry_b: ObjectRegistry\u003cString, 2usize, 8\u003e = ObjectRegistry::new();\n\n    // insert objects into the registries\n    let key_a_1 = registry_a.insert(\"a1\".to_string());\n    let key_a_2 = registry_a.insert(\"a2\".to_string());\n    let key_b_1 = registry_b.insert(\"b1\".to_string());\n    let key_b_2 = registry_b.insert(\"b2\".to_string());\n\n    // counter portions should be the same\n    assert_eq!(\n        registry_a.get_counter_from_key(key_a_1),\n        registry_b.get_counter_from_key(key_b_1)\n    );\n    assert_eq!(\n        registry_a.get_counter_from_key(key_a_2),\n        registry_b.get_counter_from_key(key_b_2)\n    );\n\n    // ensure the keys do not collide\n    assert!(key_a_1 != key_b_1);\n    assert!(key_a_2 != key_b_2);\n    assert!(key_a_1 != key_b_2);\n    assert!(key_a_2 != key_b_1);\n\n    Ok(())\n}\n#[test]\nfn test_object_registry_empty_tag() -\u003e anyhow::Result\u003c()\u003e {\n    // create a registry with tag 0 and tag bits 0\n    let mut reg = ObjectRegistry::\u003ci32, 0, 0\u003e::new();\n\n    // add some values and check their keys\n    let key1 = reg.insert(1);\n    let key2 = reg.insert(2);\n    assert_eq!(key1, 1);\n    assert_eq!(key2, 2);\n\n    Ok(())\n}\n","traces":[{"line":33,"address":[],"length":0,"stats":{"Line":11}},{"line":34,"address":[2873870,2874638,2875278,2874510,2874894,2875662,2874126,2875534,2875790,2873998,2874382,2874766,2875406,2875022,2873742,2875150,2874254],"length":1,"stats":{"Line":11}},{"line":35,"address":[],"length":0,"stats":{"Line":11}},{"line":36,"address":[],"length":0,"stats":{"Line":11}},{"line":40,"address":[2876704,2876624,2876144,2876064,2877104,2875904,2876544,2876224,2876944,2875984,2876784,2876464,2876384,2876864,2876304,2877024,2877184],"length":1,"stats":{"Line":17}},{"line":41,"address":[],"length":0,"stats":{"Line":16}},{"line":50,"address":[],"length":0,"stats":{"Line":1}},{"line":51,"address":[2877362,2877282],"length":1,"stats":{"Line":1}},{"line":52,"address":[2099011],"length":1,"stats":{"Line":1}},{"line":53,"address":[2877288,2877368],"length":1,"stats":{"Line":0}},{"line":58,"address":[],"length":0,"stats":{"Line":6}},{"line":59,"address":[2099859,2099277,2100157,2100253,2099085,2099469,2099773,2099965,2099373,2099565,2099181,2100061,2099667],"length":1,"stats":{"Line":6}},{"line":60,"address":[2099121,2099881,2100187,2100279,2099605,2099399,2099991,2099689,2100091,2099305,2099207,2099505,2099803],"length":1,"stats":{"Line":6}},{"line":61,"address":[],"length":0,"stats":{"Line":0}},{"line":66,"address":[2889558,2880348,2887200,2890480,2881952,2881184,2882640,2883234,2887975,2890314,2879559,2891762,2891142,2889686,2886267,2883264,2891660,2888930,2888099,2885562,2885648,2879435,2881910,2880384,2882624,2881024,2884123,2883132,2878768,2881152,2879600,2884912,2886379,2887052,2887164,2888818,2888960,2890449,2888128,2891060,2882542,2884746,2881782,2889728,2886416,2885664,2884160,2880236,2884881,2884011,2891168],"length":1,"stats":{"Line":11}},{"line":67,"address":[],"length":0,"stats":{"Line":22}},{"line":68,"address":[2882766,2886536,2884285,2889853,2879720,2891294,2885032,2878888,2883384,2880504,2885784,2889080,2882072,2887320,2890600,2888248,2881304],"length":1,"stats":{"Line":11}},{"line":69,"address":[2101331,2107872,2105536,2106315,2108755,2103117,2109693,2110493,2100480,2107149,2104733,2103899,2102283],"length":1,"stats":{"Line":11}},{"line":70,"address":[2101343,2107161,2101016,2109372,2110165,2100492,2109705,2101972,2107611,2102300,2102797,2105548,2105205,2103596,2104745,2107884,2106332,2108435,2108767,2103129,2110945,2103916,2110505,2106055,2104413,2106829],"length":1,"stats":{"Line":22}},{"line":71,"address":[],"length":0,"stats":{"Line":0}},{"line":74,"address":[],"length":0,"stats":{"Line":0}},{"line":75,"address":[],"length":0,"stats":{"Line":11}},{"line":76,"address":[2100575,2104895,2108895,2109070,2104792,2106527,2105770,2110562,2103990,2107332,2107982,2105631,2109752,2109855,2110669,2102495,2102374,2100714,2104111,2103188,2106406,2101483,2101670,2107220,2103300,2108133],"length":1,"stats":{"Line":20}},{"line":77,"address":[2884494,2886012,2889306,2882287,2888557,2882919,2879174,2890808,2880763,2885301,2883750,2881530,2886791,2891447,2890062,2887714,2879975],"length":1,"stats":{"Line":11}},{"line":80,"address":[],"length":0,"stats":{"Line":0}},{"line":84,"address":[2892592,2892032,2892272,2892192,2892112,2891872,2892352,2892432,2892512,2891792,2892672,2891952],"length":1,"stats":{"Line":6}},{"line":85,"address":[2891810,2891890,2892370,2892130,2892450,2891970,2892530,2892610,2892690,2892210,2892290,2892050],"length":1,"stats":{"Line":6}},{"line":86,"address":[2111799,2111079,2111399,2111639,2111559,2111239,2111319,2111719,2111879,2111159,2111479],"length":1,"stats":{"Line":6}},{"line":87,"address":[],"length":0,"stats":{"Line":0}},{"line":92,"address":[2892912,2892992,2892832,2892752],"length":1,"stats":{"Line":2}},{"line":93,"address":[2892850,2892770,2892930,2893010],"length":1,"stats":{"Line":2}},{"line":94,"address":[2892791,2892951,2892871,2893031],"length":1,"stats":{"Line":2}},{"line":95,"address":[2893016,2892776,2892936,2892856],"length":1,"stats":{"Line":0}},{"line":102,"address":[],"length":0,"stats":{"Line":1}},{"line":104,"address":[],"length":0,"stats":{"Line":1}},{"line":110,"address":[],"length":0,"stats":{"Line":3}},{"line":112,"address":[],"length":0,"stats":{"Line":3}},{"line":118,"address":[],"length":0,"stats":{"Line":1}},{"line":119,"address":[],"length":0,"stats":{"Line":1}}],"covered":32,"coverable":39},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","src","tor_provider.rs"],"content":"// standard\n#[cfg(feature = \"legacy-tor-provider\")]\nuse std::os::raw::c_char;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse std::path::Path;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse std::str::FromStr;\n\n// extern crates\nuse anyhow::bail;\n#[cfg(feature = \"impl-lib\")]\nuse cgosling_proc_macros::*;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse tor_interface::censorship_circumvention::*;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse tor_interface::legacy_tor_client::*;\n#[cfg(feature = \"mock-tor-provider\")]\nuse tor_interface::mock_tor_client::*;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse tor_interface::proxy::*;\nuse tor_interface::*;\n\n// internal crates\nuse crate::error::*;\nuse crate::ffi::*;\nuse crate::macros::*;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse crate::utils::*;\n\n/// Proxy settings object used by tor provider to connect to the tor network\n#[cfg(feature = \"legacy-tor-provider\")]\npub struct GoslingProxyConfig;\n#[cfg(feature = \"legacy-tor-provider\")]\ndefine_registry! {ProxyConfig}\n\n/// Pluggable transports settings object used by tor provider to launch pluggable-transports\n#[cfg(feature = \"legacy-tor-provider\")]\npub struct GoslingPluggableTransportConfig;\n#[cfg(feature = \"legacy-tor-provider\")]\ndefine_registry! {PluggableTransportConfig}\n\n/// Bridge line to use with particular pluggable-transport when connecting to the tor network\n#[cfg(feature = \"legacy-tor-provider\")]\npub struct GoslingBridgeLine;\n#[cfg(feature = \"legacy-tor-provider\")]\ndefine_registry! {BridgeLine}\n\n/// A tor provider config object used to construct a tor provider\npub struct GoslingTorProviderConfig;\npub(crate) enum TorProviderConfig {\n    #[cfg(feature = \"mock-tor-provider\")]\n    MockTorClientConfig,\n    #[cfg(feature = \"legacy-tor-provider\")]\n    LegacyTorClientConfig(tor_interface::legacy_tor_client::LegacyTorClientConfig),\n}\ndefine_registry! {TorProviderConfig}\n\n/// A tor provider object used by a context to connect to the tor network\npub struct GoslingTorProvider;\n/// cbindgen:ignore\ntype TorProvider = Box\u003cdyn tor_provider::TorProvider\u003e;\ndefine_registry! {TorProvider}\n\n//\n// Memory freeing functions\n//\n\n/// Frees a gosling_proxy_config\n///\n/// @param in_proxy_config: the proxy config object to free\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_proxy_config_free(in_proxy_config: *mut GoslingProxyConfig) {\n    impl_registry_free!(in_proxy_config, ProxyConfig);\n}\n\n/// Frees a gosling_pluggable_transport_config\n///\n/// @param in_pluggable_transport_config: the pluggable-transport object to free\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_pluggable_transport_config_free(\n    in_pluggable_transport_config: *mut GoslingPluggableTransportConfig,\n) {\n    impl_registry_free!(in_pluggable_transport_config, PluggableTransportConfig);\n}\n\n/// Frees a gosling_bridge_line\n///\n/// @param in_bridge_line: the bridge line object to free\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_bridge_line_free(in_bridge_line: *mut GoslingBridgeLine) {\n    impl_registry_free!(in_bridge_line, BridgeLine);\n}\n\n/// Frees a gosling_tor_provider_config\n///\n/// @param in_tor_provider_config: the tor provider config object to free\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_tor_provider_config_free(\n    in_tor_provider_config: *mut GoslingTorProviderConfig,\n) {\n    impl_registry_free!(in_tor_provider_config, TorProviderConfig);\n}\n\n/// Frees a gosling_tor_provider object\n///\n/// @param in_tor_provider: the tor provider object to free\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_tor_provider_free(in_tor_provider: *mut GoslingTorProvider) {\n    impl_registry_free!(in_tor_provider, TorProvider);\n}\n\n//\n// Proxy\n//\n\n/// Create a socks4 proxy definition\n///\n/// @param out_proxy_config: returned proxy config object\n/// @param proxy_address: the host address of the proxy, must not be an onion service\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_proxy_config_new_socks4(\n    out_proxy_config: *mut *mut GoslingProxyConfig,\n    proxy_address: *const GoslingTargetAddress,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_proxy_config);\n        ensure_not_null!(proxy_address);\n\n        let proxy_address = match get_target_addr_registry().get(proxy_address as usize) {\n            Some(target_address) =\u003e target_address.clone(),\n            None =\u003e bail_invalid_handle!(proxy_address),\n        };\n        let proxy_config = Socks4ProxyConfig::new(proxy_address)?;\n\n        let handle = get_proxy_config_registry().insert(proxy_config.into());\n        *out_proxy_config = handle as *mut GoslingProxyConfig;\n\n        Ok(())\n    });\n}\n\n/// Create a socks5 proxy definition\n///\n/// @param out_proxy_config: returned proxy config object\n/// @param proxy_address: the host address of the proxy, must not be an onion service\n/// @param username: username to authenticate with socks5 proxy\n/// @param username_length: number of characters in username, not counting any null-\n///  terminator\n/// @param password: password to authenticate with socks5 proxy\n/// @param password_length: number of characters in username, not counting any null-\n///  terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_proxy_config_new_socks5(\n    out_proxy_config: *mut *mut GoslingProxyConfig,\n    proxy_address: *const GoslingTargetAddress,\n    username: *const c_char,\n    username_length: usize,\n    password: *const c_char,\n    password_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_proxy_config);\n        ensure_not_null!(proxy_address);\n\n        let proxy_address = match get_target_addr_registry().get(proxy_address as usize) {\n            Some(target_address) =\u003e target_address.clone(),\n            None =\u003e bail_invalid_handle!(proxy_address),\n        };\n\n        let username = if username.is_null() || username_length == 0 {\n            None\n        } else {\n            let username = std::slice::from_raw_parts(username as *const u8, username_length);\n            let username = std::str::from_utf8(username)?;\n            Some(username.to_string())\n        };\n\n        let password = if password.is_null() || password_length == 0 {\n            None\n        } else {\n            let password = std::slice::from_raw_parts(password as *const u8, password_length);\n            let password = std::str::from_utf8(password)?;\n            Some(password.to_string())\n        };\n\n        let proxy_config = Socks5ProxyConfig::new(proxy_address, username, password)?;\n\n        let handle = get_proxy_config_registry().insert(proxy_config.into());\n        *out_proxy_config = handle as *mut GoslingProxyConfig;\n\n        Ok(())\n    });\n}\n\n/// Create a https proxy definition\n///\n/// @param out_proxy_config: returned proxy config object\n/// @param proxy_address: the host address of the proxy, must not be an onion service\n/// @param username: username to authenticate with https proxy\n/// @param username_length: number of characters in username, not counting any null-\n///  terminator\n/// @param password: password to authenticate with https proxy\n/// @param password_length: number of characters in username, not counting any null-\n///  terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_proxy_config_new_https(\n    out_proxy_config: *mut *mut GoslingProxyConfig,\n    proxy_address: *const GoslingTargetAddress,\n    username: *const c_char,\n    username_length: usize,\n    password: *const c_char,\n    password_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_proxy_config);\n        ensure_not_null!(proxy_address);\n\n        let proxy_address = match get_target_addr_registry().get(proxy_address as usize) {\n            Some(target_address) =\u003e target_address.clone(),\n            None =\u003e bail_invalid_handle!(proxy_address),\n        };\n\n        let username = if username.is_null() || username_length == 0 {\n            None\n        } else {\n            let username = std::slice::from_raw_parts(username as *const u8, username_length);\n            let username = std::str::from_utf8(username)?;\n            Some(username.to_string())\n        };\n\n        let password = if password.is_null() || password_length == 0 {\n            None\n        } else {\n            let password = std::slice::from_raw_parts(password as *const u8, password_length);\n            let password = std::str::from_utf8(password)?;\n            Some(password.to_string())\n        };\n\n        let proxy_config = HttpsProxyConfig::new(proxy_address, username, password)?;\n\n        let handle = get_proxy_config_registry().insert(proxy_config.into());\n        *out_proxy_config = handle as *mut GoslingProxyConfig;\n\n        Ok(())\n    });\n}\n\n//\n// Pluggable Transport\n//\n\n/// Create a new pluggable-transport config object\n///\n/// @param out_pluggable_transport_config: returned pluggable-transport object\n/// @param transports: comma-delimited list of transports this pluggable-transport\n///  supports\n/// @param transports_length: number of characters in transports, not counting any\n///  null-terminator\n/// @param path_to_binary: path to the pluggable-transport binary, either absolute or\n///  relative to the tor daemon process\n/// @param path_to_binary_length: number of characters in path_to_binary, not counting any null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_pluggable_transport_config_new(\n    out_pluggable_transport_config: *mut *mut GoslingPluggableTransportConfig,\n    transports: *const c_char,\n    transports_length: usize,\n    path_to_binary: *const c_char,\n    path_to_binary_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_pluggable_transport_config);\n        ensure_not_null!(transports);\n        ensure_not_equal!(transports_length, 0);\n        ensure_not_null!(path_to_binary);\n        ensure_not_equal!(path_to_binary_length, 0);\n\n        let transports = std::slice::from_raw_parts(transports as *const u8, transports_length);\n        let transports = std::str::from_utf8(transports)?;\n        let transports: Vec\u003cString\u003e = transports.split(',').map(|s| s.to_string()).collect();\n\n        let path_to_binary =\n            std::slice::from_raw_parts(path_to_binary as *const u8, path_to_binary_length);\n        let path_to_binary = std::str::from_utf8(path_to_binary)?;\n        let path_to_binary = Path::new(path_to_binary);\n        path_to_binary.canonicalize()?;\n\n        let pluggable_transport_config =\n            PluggableTransportConfig::new(transports, path_to_binary.into())?;\n        let handle = get_pluggable_transport_config_registry().insert(pluggable_transport_config);\n        *out_pluggable_transport_config = handle as *mut GoslingPluggableTransportConfig;\n\n        Ok(())\n    })\n}\n\n/// Add a command-line option to be used when launching the pluggable-transport\n///\n/// @param pluggable_transport_config: the pluggable-transport ocnfig object to update\n/// @param option: cmd-line option or flag to pass to the pluggable-transport on launch\n/// @param option_length: number of characters in option, not counting any null-\n///  terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_pluggable_transport_config_add_cmdline_option(\n    pluggable_transport_config: *mut GoslingPluggableTransportConfig,\n    option: *const c_char,\n    option_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(pluggable_transport_config);\n        ensure_not_null!(option);\n        ensure_not_equal!(option_length, 0);\n\n        let option = std::slice::from_raw_parts(option as *const u8, option_length);\n        let option = std::str::from_utf8(option)?;\n\n        match get_pluggable_transport_config_registry().get_mut(pluggable_transport_config as usize)\n        {\n            Some(config) =\u003e config.add_option(option.to_string()),\n            None =\u003e bail_invalid_handle!(pluggable_transport_config),\n        }\n\n        Ok(())\n    });\n}\n\n//\n// Bridge Line\n//\n\n/// Construct bridge line from string\n///\n/// @param out_bridge_line: returned bridge line object\n/// @param bridge_line: a bridge address to connect to using a pluggable-transport. For\n///  more information, see: https://tb-manual.torproject.org/bridges/\n/// @param bridge_line_length: number of characters in bridge_line, not counting any\n///  null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_bridge_line_from_string(\n    out_bridge_line: *mut *mut GoslingBridgeLine,\n    bridge_line: *const c_char,\n    bridge_line_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_bridge_line);\n        ensure_not_null!(bridge_line);\n        ensure_not_equal!(bridge_line_length, 0);\n\n        let bridge_line = std::slice::from_raw_parts(bridge_line as *const u8, bridge_line_length);\n        let bridge_line = std::str::from_utf8(bridge_line)?;\n        let bridge_line = BridgeLine::from_str(bridge_line)?;\n\n        let handle = get_bridge_line_registry().insert(bridge_line);\n        *out_bridge_line = handle as *mut GoslingBridgeLine;\n\n        Ok(())\n    });\n}\n\n//\n// Tor Provider Config Construction Functions\n//\n\n/// Create a tor provider config to build a mock no-internet tor provider for testing.\n///\n/// @param out_tor_provider_config: returned tor provider\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"mock-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_tor_provider_config_new_mock_client_config(\n    out_tor_provider_config: *mut *mut GoslingTorProviderConfig,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_tor_provider_config);\n\n        let handle =\n            get_tor_provider_config_registry().insert(TorProviderConfig::MockTorClientConfig);\n        *out_tor_provider_config = handle as *mut GoslingTorProviderConfig;\n\n        Ok(())\n    });\n}\n\n/// Create a tor provider config to build a bundled legacy tor daemon.\n///\n/// @param out_tor_provider_config: returned tor provider config\n/// @param tor_bin_path: the file system path to the tor binary; if this is null the tor executable\n///  found in the system PATH variable is used\n/// @param tor_bin_path_length: the number of chars in tor_bin_path not including any null terminator\n/// @param tor_working_directory: the file system path to store tor's data\n/// @param tor_working_directory_length: the number of chars in tor_working_directory not including any\n///  null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_tor_provider_config_new_bundled_legacy_client_config(\n    out_tor_provider_config: *mut *mut GoslingTorProviderConfig,\n    tor_bin_path: *const c_char,\n    tor_bin_path_length: usize,\n    tor_working_directory: *const c_char,\n    tor_working_directory_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_tor_provider_config);\n        if tor_bin_path.is_null() \u0026\u0026 tor_bin_path_length != 0 {\n            bail!(\"tor_bin_path is null so tor_bin_path_length must be 0\");\n        }\n        if !tor_bin_path.is_null() \u0026\u0026 tor_bin_path_length == 0 {\n            bail!(\"tor_bin_path is not null so tor_bin_path_length must be greater than 0\");\n        }\n        ensure_not_null!(tor_working_directory);\n        ensure_not_equal!(tor_working_directory_length, 0);\n\n        // tor bin\n        let tor_bin_path = if tor_bin_path.is_null() {\n            which::which(format!(\"tor{}\", std::env::consts::EXE_SUFFIX))?\n        } else {\n            let tor_bin_path =\n                std::slice::from_raw_parts(tor_bin_path as *const u8, tor_bin_path_length);\n            let tor_bin_path = std::str::from_utf8(tor_bin_path)?;\n            let tor_bin_path = Path::new(tor_bin_path);\n            tor_bin_path.canonicalize()?\n        };\n\n        // tor working dir\n        let tor_working_directory = std::slice::from_raw_parts(\n            tor_working_directory as *const u8,\n            tor_working_directory_length,\n        );\n        let tor_working_directory = std::str::from_utf8(tor_working_directory)?;\n        let tor_working_directory = Path::new(tor_working_directory).to_path_buf();\n        let tor_config = LegacyTorClientConfig::BundledTor {\n            tor_bin_path: tor_bin_path,\n            data_directory: tor_working_directory,\n            proxy_settings: None,\n            allowed_ports: None,\n            pluggable_transports: None,\n            bridge_lines: None,\n        };\n\n        let handle = get_tor_provider_config_registry()\n            .insert(TorProviderConfig::LegacyTorClientConfig(tor_config));\n        *out_tor_provider_config = handle as *mut GoslingTorProviderConfig;\n\n        Ok(())\n    });\n}\n\n/// Create a tor provider config to build a system legacy tor daemon\n///\n/// @param out_tor_provider_config: returned tor provider config\n/// @param tor_socks_host: tor daemon socks server host\n/// @param tor_socks_port: tor daemon socks server port\n/// @param tor_control_host: tor daemon control host\n/// @param tor_control_port: tor daemon control port\n/// @param tor_control_passwd: authentication password\n/// @param tor_control_passwd_length: the number of chars in tor_control_password not\n///  including any null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_tor_provider_config_new_system_legacy_client_config(\n    out_tor_provider_config: *mut *mut GoslingTorProviderConfig,\n    tor_socks_host: *const GoslingIpAddress,\n    tor_socks_port: u16,\n    tor_control_host: *const GoslingIpAddress,\n    tor_control_port: u16,\n    tor_control_passwd: *const c_char,\n    tor_control_passwd_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_tor_provider_config);\n        ensure_not_null!(tor_socks_host);\n        ensure_not_equal!(tor_socks_port, 0);\n        ensure_not_null!(tor_control_host);\n        ensure_not_equal!(tor_control_port, 0);\n        ensure_not_null!(tor_control_passwd);\n        ensure_not_equal!(tor_control_passwd_length, 0);\n\n        // constructor tor_socks_addr\n        let tor_socks_host = match get_ip_addr_registry().get(tor_socks_host as usize) {\n            Some(tor_socks_host) =\u003e tor_socks_host.clone(),\n            None =\u003e bail_invalid_handle!(tor_socks_host),\n        };\n        let tor_socks_addr = std::net::SocketAddr::new(tor_socks_host, tor_socks_port);\n\n        // construct tor_control_addr\n        let tor_control_host = match get_ip_addr_registry().get(tor_control_host as usize) {\n            Some(tor_control_host) =\u003e tor_control_host.clone(),\n            None =\u003e bail_invalid_handle!(tor_control_host),\n        };\n        let tor_control_addr = std::net::SocketAddr::new(tor_control_host, tor_control_port);\n\n        // construct tor_control_password\n        let tor_control_passwd =\n            std::slice::from_raw_parts(tor_control_passwd as *const u8, tor_control_passwd_length);\n        let tor_control_passwd = std::str::from_utf8(tor_control_passwd)?.to_string();\n\n        let tor_config = LegacyTorClientConfig::SystemTor {\n            tor_socks_addr,\n            tor_control_addr,\n            tor_control_passwd,\n        };\n\n        let handle = get_tor_provider_config_registry()\n            .insert(TorProviderConfig::LegacyTorClientConfig(tor_config));\n        *out_tor_provider_config = handle as *mut GoslingTorProviderConfig;\n\n        Ok(())\n    });\n}\n\n//\n// Tor Provider Config Modification Functions\n//\n\n/// Set a tor provider config's proxy configuration. A tor provider config\n/// does not need to support proxy configuration, so this function may fail\n/// as a result. The currently supported tor provider configs are:\n/// - Legacy Bundled Client\n///\n/// @param tor_provider_config: the tor provider config to update\n/// @param proxy_config: the proxy configuration to use; must not be null\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_tor_provider_config_set_proxy_config(\n    tor_provider_config: *mut GoslingTorProviderConfig,\n    proxy_config: *const GoslingProxyConfig,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(tor_provider_config);\n        ensure_not_null!(proxy_config);\n\n        match get_tor_provider_config_registry().get_mut(tor_provider_config as usize) {\n            Some(tor_provider_config) =\u003e match tor_provider_config {\n                TorProviderConfig::LegacyTorClientConfig(LegacyTorClientConfig::BundledTor {\n                    proxy_settings,\n                    ..\n                }) =\u003e {\n                    *proxy_settings = match get_proxy_config_registry().get(proxy_config as usize) {\n                        Some(proxy_config) =\u003e Some(proxy_config.clone()),\n                        None =\u003e bail_invalid_handle!(proxy_config),\n                    };\n                }\n                _ =\u003e bail!(\"tor_provider_config does not support this operation\"),\n            },\n            None =\u003e bail_invalid_handle!(tor_provider_config),\n        }\n\n        Ok(())\n    })\n}\n\n/// Set a tor provider config's allowed ports list. A tor provider config does\n/// not need to support a port allow-list, so this function may fail as a result.\n/// The currently supported tor provider configs are:\n/// - Legacy Bundled Client\n///\n/// @param tor_provider_config: the tor provider config to update\n/// @param allowed_ports: an array of ports the local system's firewall allows\n///  connections to; must not be null\n/// @param allowed_ports_count: the number of ports in the allowed_ports array; must\n///  not be 0\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_tor_provider_config_set_allowed_ports(\n    tor_provider_config: *mut GoslingTorProviderConfig,\n    allowed_ports: *const u16,\n    allowed_ports_count: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(tor_provider_config);\n        ensure_not_null!(allowed_ports);\n        ensure_not_equal!(allowed_ports_count, 0);\n\n        let allowed_ports_slice =\n            std::slice::from_raw_parts(allowed_ports as *const u16, allowed_ports_count);\n        match get_tor_provider_config_registry().get_mut(tor_provider_config as usize) {\n            Some(tor_provider_config) =\u003e match tor_provider_config {\n                TorProviderConfig::LegacyTorClientConfig(LegacyTorClientConfig::BundledTor {\n                    allowed_ports,\n                    ..\n                }) =\u003e {\n                    *allowed_ports = Some(allowed_ports_slice.into());\n                }\n                _ =\u003e bail!(\"tor_provider_config does not support this operation\"),\n            },\n            None =\u003e bail_invalid_handle!(tor_provider_config),\n        }\n\n        Ok(())\n    })\n}\n/// Add a pluggable-transport config to a tor provider config. A tor provider config\n/// does not need to support pluggable-transport configuration, so this function may\n/// fail as a result. The currently supported tor provider configs are:\n/// - Legacy Bundled Client\n///\n/// This function may be called multiple times allowing a tor provider config to be\n/// configured with multiple pluggable-transports.\n///\n/// @param tor_provider_config: the tor provider config to update\n/// @param pluggable_transport_config: the pluggable-transport config to add to the tor\n///  provider config; must not be null\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_tor_provider_config_add_pluggable_transport_config(\n    tor_provider_config: *mut GoslingTorProviderConfig,\n    pluggable_transport_config: *const GoslingPluggableTransportConfig,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(tor_provider_config);\n        ensure_not_null!(pluggable_transport_config);\n\n        match get_tor_provider_config_registry().get_mut(tor_provider_config as usize) {\n            Some(tor_provider_config) =\u003e match tor_provider_config {\n                TorProviderConfig::LegacyTorClientConfig(LegacyTorClientConfig::BundledTor {\n                    pluggable_transports,\n                    ..\n                }) =\u003e {\n                    let pluggable_transport_config = match get_pluggable_transport_config_registry()\n                        .get(pluggable_transport_config as usize)\n                    {\n                        Some(pluggable_transport_config) =\u003e pluggable_transport_config.clone(),\n                        None =\u003e bail_invalid_handle!(pluggable_transport_config),\n                    };\n\n                    match pluggable_transports {\n                        None =\u003e *pluggable_transports = Some(vec![pluggable_transport_config]),\n                        Some(pluggable_transports) =\u003e {\n                            pluggable_transports.push(pluggable_transport_config)\n                        }\n                    }\n                }\n                _ =\u003e bail!(\"tor_provider_config does not support this operation\"),\n            },\n            None =\u003e bail_invalid_handle!(tor_provider_config),\n        }\n\n        Ok(())\n    })\n}\n\n/// Add a bridge line to a tor provider config. A tor provider config does not need\n/// to support bridge lines, so this function may fail as a result. The currently\n/// supported tor provider configs are:\n/// - Legacy Bundled Client\n///\n/// This function may be called multiple times allowing a tor provider config to be\n/// configured with multiple bridge lines.\n///\n/// @param tor_provider_config: the tor provider config to update\n/// @param bridge_line: the bridge lin to add to the tor provider config\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_tor_provider_config_add_bridge_line(\n    tor_provider_config: *mut GoslingTorProviderConfig,\n    bridge_line: *const GoslingBridgeLine,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(tor_provider_config);\n        ensure_not_null!(bridge_line);\n\n        match get_tor_provider_config_registry().get_mut(tor_provider_config as usize) {\n            Some(tor_provider_config) =\u003e match tor_provider_config {\n                TorProviderConfig::LegacyTorClientConfig(LegacyTorClientConfig::BundledTor {\n                    bridge_lines,\n                    ..\n                }) =\u003e {\n                    let bridge_line = match get_bridge_line_registry().get(bridge_line as usize) {\n                        Some(bridge_line) =\u003e bridge_line.clone(),\n                        None =\u003e bail_invalid_handle!(bridge_line),\n                    };\n\n                    match bridge_lines {\n                        None =\u003e *bridge_lines = Some(vec![bridge_line]),\n                        Some(bridge_lines) =\u003e bridge_lines.push(bridge_line),\n                    }\n                }\n                _ =\u003e bail!(\"tor_provider_config does not support this operation\"),\n            },\n            None =\u003e bail_invalid_handle!(tor_provider_config),\n        }\n\n        Ok(())\n    })\n}\n\n/// Create a tor provider from the provided tor provider config.\n///\n/// @param out_tor_provider: returned tor provider\n/// @param tor_provider_config: tor provider configuration\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(any(feature = \"mock-tor-provider\", feature = \"legacy-tor-provider\"))]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_tor_provider_from_tor_provider_config(\n    out_tor_provider: *mut *mut GoslingTorProvider,\n    tor_provider_config: *const GoslingTorProviderConfig,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_tor_provider);\n        ensure_not_null!(tor_provider_config);\n\n        let tor_provider: Box\u003cdyn tor_provider::TorProvider\u003e =\n            match get_tor_provider_config_registry().get(tor_provider_config as usize) {\n                Some(tor_provider_config) =\u003e match tor_provider_config {\n                    #[cfg(feature = \"mock-tor-provider\")]\n                    TorProviderConfig::MockTorClientConfig =\u003e {\n                        let tor_provider: MockTorClient = Default::default();\n                        Box::new(tor_provider)\n                    },\n                    #[cfg(feature = \"legacy-tor-provider\")]\n                    TorProviderConfig::LegacyTorClientConfig(legacy_tor_config) =\u003e {\n                        let tor_provider: LegacyTorClient =\n                            LegacyTorClient::new(legacy_tor_config.clone())?;\n                        Box::new(tor_provider)\n                    },\n                    _ =\u003e panic!(\"unknown tor_provider_config type\"),\n                },\n                None =\u003e bail_invalid_handle!(tor_provider_config),\n            };\n\n        let handle = get_tor_provider_registry().insert(tor_provider);\n        *out_tor_provider = handle as *mut GoslingTorProvider;\n\n        Ok(())\n    });\n}\n","traces":[{"line":74,"address":[2059008,2059043],"length":1,"stats":{"Line":0}},{"line":84,"address":[2831007,2830976],"length":1,"stats":{"Line":0}},{"line":96,"address":[2059459,2059424],"length":1,"stats":{"Line":0}},{"line":105,"address":[2831360,2831391],"length":1,"stats":{"Line":0}},{"line":116,"address":[2059869,2059840],"length":1,"stats":{"Line":0}},{"line":132,"address":[2831793,2831744],"length":1,"stats":{"Line":0}},{"line":137,"address":[2831786],"length":1,"stats":{"Line":0}},{"line":138,"address":[2386177],"length":1,"stats":{"Line":0}},{"line":139,"address":[1783858],"length":1,"stats":{"Line":0}},{"line":141,"address":[1783941,1784099],"length":1,"stats":{"Line":0}},{"line":142,"address":[2386665,2386557],"length":1,"stats":{"Line":0}},{"line":145,"address":[1784370,1785153,1784674],"length":1,"stats":{"Line":0}},{"line":147,"address":[2387025,2387157],"length":1,"stats":{"Line":0}},{"line":148,"address":[1785015,1785083],"length":1,"stats":{"Line":0}},{"line":150,"address":[1785051],"length":1,"stats":{"Line":0}},{"line":168,"address":[2831808,2831922],"length":1,"stats":{"Line":0}},{"line":177,"address":[2831855],"length":1,"stats":{"Line":0}},{"line":178,"address":[1785255],"length":1,"stats":{"Line":0}},{"line":179,"address":[1785278],"length":1,"stats":{"Line":0}},{"line":181,"address":[1785382,1785566],"length":1,"stats":{"Line":0}},{"line":182,"address":[1785675,1785781],"length":1,"stats":{"Line":0}},{"line":186,"address":[2388267,2388343],"length":1,"stats":{"Line":0}},{"line":187,"address":[1785899],"length":1,"stats":{"Line":0}},{"line":189,"address":[1785938],"length":1,"stats":{"Line":0}},{"line":190,"address":[1786103,1786249,1785999],"length":1,"stats":{"Line":0}},{"line":191,"address":[1786162,1786096],"length":1,"stats":{"Line":0}},{"line":194,"address":[1786329,1786226,1786371],"length":1,"stats":{"Line":0}},{"line":195,"address":[1786353],"length":1,"stats":{"Line":0}},{"line":197,"address":[1786384],"length":1,"stats":{"Line":0}},{"line":198,"address":[1786549,1786445,1786851],"length":1,"stats":{"Line":0}},{"line":199,"address":[1786611,1786542],"length":1,"stats":{"Line":0}},{"line":202,"address":[1786894,1787735,1787188,1786659],"length":1,"stats":{"Line":0}},{"line":204,"address":[1787172,1787300],"length":1,"stats":{"Line":0}},{"line":205,"address":[1787585,1787662],"length":1,"stats":{"Line":0}},{"line":207,"address":[1787619],"length":1,"stats":{"Line":0}},{"line":225,"address":[2832050,2831936],"length":1,"stats":{"Line":0}},{"line":234,"address":[1787856,1790459,1790339],"length":1,"stats":{"Line":0}},{"line":235,"address":[1787895],"length":1,"stats":{"Line":0}},{"line":236,"address":[2390383],"length":1,"stats":{"Line":0}},{"line":238,"address":[1788022,1788206],"length":1,"stats":{"Line":0}},{"line":239,"address":[1788315,1788421],"length":1,"stats":{"Line":0}},{"line":243,"address":[1788493,1788565],"length":1,"stats":{"Line":0}},{"line":244,"address":[1788539],"length":1,"stats":{"Line":0}},{"line":246,"address":[1788578],"length":1,"stats":{"Line":0}},{"line":247,"address":[1788743,1788889,1788639],"length":1,"stats":{"Line":0}},{"line":248,"address":[1788736,1788802],"length":1,"stats":{"Line":0}},{"line":251,"address":[1788969,1789011,1788866],"length":1,"stats":{"Line":0}},{"line":252,"address":[1788993],"length":1,"stats":{"Line":0}},{"line":254,"address":[1789024],"length":1,"stats":{"Line":0}},{"line":255,"address":[2391591,2391695,2392001],"length":1,"stats":{"Line":0}},{"line":256,"address":[2391688,2391761],"length":1,"stats":{"Line":0}},{"line":259,"address":[2391809,2392028,2392342,2392909],"length":1,"stats":{"Line":0}},{"line":261,"address":[1789940,1789812],"length":1,"stats":{"Line":0}},{"line":262,"address":[2392759,2392836],"length":1,"stats":{"Line":0}},{"line":264,"address":[2392793],"length":1,"stats":{"Line":0}},{"line":286,"address":[2832173,2832064],"length":1,"stats":{"Line":0}},{"line":294,"address":[2395359,2395504,2393040],"length":1,"stats":{"Line":0}},{"line":295,"address":[1790535],"length":1,"stats":{"Line":0}},{"line":296,"address":[1790558],"length":1,"stats":{"Line":0}},{"line":298,"address":[1790847],"length":1,"stats":{"Line":0}},{"line":301,"address":[1791073],"length":1,"stats":{"Line":0}},{"line":302,"address":[1791112,1791320],"length":1,"stats":{"Line":0}},{"line":303,"address":[1792997,1791195,1792944],"length":1,"stats":{"Line":0}},{"line":306,"address":[1791471,1791279],"length":1,"stats":{"Line":0}},{"line":307,"address":[1791593,1792863,1791487],"length":1,"stats":{"Line":0}},{"line":308,"address":[1791576,1791665],"length":1,"stats":{"Line":0}},{"line":309,"address":[2395450,2394279],"length":1,"stats":{"Line":0}},{"line":312,"address":[2395395,2394483,2394899,2395423],"length":1,"stats":{"Line":0}},{"line":313,"address":[1792297,1792441],"length":1,"stats":{"Line":0}},{"line":314,"address":[1792736,1792664],"length":1,"stats":{"Line":0}},{"line":316,"address":[1792698],"length":1,"stats":{"Line":0}},{"line":330,"address":[2832271,2832192],"length":1,"stats":{"Line":0}},{"line":336,"address":[1793024,1793867],"length":1,"stats":{"Line":0}},{"line":337,"address":[1793036],"length":1,"stats":{"Line":0}},{"line":338,"address":[1793056],"length":1,"stats":{"Line":0}},{"line":341,"address":[1793285],"length":1,"stats":{"Line":0}},{"line":342,"address":[1793324,1793380,1793465],"length":1,"stats":{"Line":0}},{"line":344,"address":[1793419,1793606],"length":1,"stats":{"Line":0}},{"line":346,"address":[1793718,1793821],"length":1,"stats":{"Line":0}},{"line":350,"address":[1793853],"length":1,"stats":{"Line":0}},{"line":369,"address":[2060592,2060671],"length":1,"stats":{"Line":0}},{"line":375,"address":[2397834,2396512],"length":1,"stats":{"Line":0}},{"line":376,"address":[1793924],"length":1,"stats":{"Line":0}},{"line":377,"address":[1793944],"length":1,"stats":{"Line":0}},{"line":380,"address":[1794173],"length":1,"stats":{"Line":0}},{"line":381,"address":[1794372,1794268,1794212],"length":1,"stats":{"Line":0}},{"line":382,"address":[1794297,1794463,1794714],"length":1,"stats":{"Line":0}},{"line":384,"address":[1794866,1794695],"length":1,"stats":{"Line":0}},{"line":385,"address":[1795179,1795118],"length":1,"stats":{"Line":0}},{"line":387,"address":[1795152],"length":1,"stats":{"Line":0}},{"line":402,"address":[2832421,2832384],"length":1,"stats":{"Line":1}},{"line":406,"address":[2397888,2398201],"length":1,"stats":{"Line":2}},{"line":407,"address":[1795260],"length":1,"stats":{"Line":1}},{"line":410,"address":[1795277,1795380],"length":1,"stats":{"Line":1}},{"line":411,"address":[2398167,2398118],"length":1,"stats":{"Line":1}},{"line":413,"address":[2398152],"length":1,"stats":{"Line":1}},{"line":430,"address":[2060752,2060861],"length":1,"stats":{"Line":1}},{"line":438,"address":[2060804],"length":1,"stats":{"Line":2}},{"line":439,"address":[1795612],"length":1,"stats":{"Line":1}},{"line":440,"address":[1795632,1795760],"length":1,"stats":{"Line":2}},{"line":441,"address":[2398415],"length":1,"stats":{"Line":0}},{"line":443,"address":[1795737,1795827],"length":1,"stats":{"Line":1}},{"line":444,"address":[2398506],"length":1,"stats":{"Line":0}},{"line":446,"address":[2398487],"length":1,"stats":{"Line":1}},{"line":450,"address":[2399538,2399739,2398762],"length":1,"stats":{"Line":2}},{"line":451,"address":[2398986,2399116,2399744,2399635],"length":1,"stats":{"Line":3}},{"line":454,"address":[2398784],"length":1,"stats":{"Line":0}},{"line":455,"address":[2398823,2399204,2399336],"length":1,"stats":{"Line":0}},{"line":456,"address":[1796583],"length":1,"stats":{"Line":0}},{"line":457,"address":[1796885,1796607,1796779],"length":1,"stats":{"Line":0}},{"line":461,"address":[2399598,2399838],"length":1,"stats":{"Line":2}},{"line":462,"address":[2399584,2399592],"length":1,"stats":{"Line":2}},{"line":463,"address":[2399595,2399588],"length":1,"stats":{"Line":2}},{"line":465,"address":[1797303,1798183,1797197],"length":1,"stats":{"Line":1}},{"line":466,"address":[1797286,1797375],"length":1,"stats":{"Line":2}},{"line":467,"address":[1797480],"length":1,"stats":{"Line":1}},{"line":468,"address":[1797394],"length":1,"stats":{"Line":1}},{"line":470,"address":[2400099],"length":1,"stats":{"Line":1}},{"line":471,"address":[1797456],"length":1,"stats":{"Line":1}},{"line":472,"address":[1797464],"length":1,"stats":{"Line":1}},{"line":473,"address":[1797472],"length":1,"stats":{"Line":1}},{"line":476,"address":[2400507,2400441,2400682],"length":1,"stats":{"Line":3}},{"line":477,"address":[2400707,2400548],"length":1,"stats":{"Line":1}},{"line":478,"address":[2400731,2400803],"length":1,"stats":{"Line":1}},{"line":480,"address":[2400765],"length":1,"stats":{"Line":1}},{"line":498,"address":[2832576,2832705],"length":1,"stats":{"Line":0}},{"line":508,"address":[2832628],"length":1,"stats":{"Line":0}},{"line":509,"address":[1798276],"length":1,"stats":{"Line":0}},{"line":510,"address":[2400969],"length":1,"stats":{"Line":0}},{"line":512,"address":[1798579],"length":1,"stats":{"Line":0}},{"line":514,"address":[1798799],"length":1,"stats":{"Line":0}},{"line":518,"address":[2401790,2401689],"length":1,"stats":{"Line":0}},{"line":519,"address":[1799195],"length":1,"stats":{"Line":0}},{"line":522,"address":[2402022],"length":1,"stats":{"Line":0}},{"line":525,"address":[2402080,2402181],"length":1,"stats":{"Line":0}},{"line":526,"address":[1799565],"length":1,"stats":{"Line":0}},{"line":529,"address":[1799681],"length":1,"stats":{"Line":0}},{"line":533,"address":[1799763],"length":1,"stats":{"Line":0}},{"line":534,"address":[1799802,1800033],"length":1,"stats":{"Line":0}},{"line":536,"address":[1799898],"length":1,"stats":{"Line":0}},{"line":542,"address":[2402743,2402910,2403085],"length":1,"stats":{"Line":0}},{"line":543,"address":[2403110,2402951],"length":1,"stats":{"Line":0}},{"line":544,"address":[2403134,2403195],"length":1,"stats":{"Line":0}},{"line":546,"address":[1800424],"length":1,"stats":{"Line":0}},{"line":565,"address":[2832720,2832769],"length":1,"stats":{"Line":0}},{"line":570,"address":[1800528,1801733,1801783],"length":1,"stats":{"Line":0}},{"line":571,"address":[1800545],"length":1,"stats":{"Line":0}},{"line":572,"address":[1800562],"length":1,"stats":{"Line":0}},{"line":574,"address":[2403385,2403553],"length":1,"stats":{"Line":0}},{"line":575,"address":[1800907,1801020],"length":1,"stats":{"Line":0}},{"line":577,"address":[2403834],"length":1,"stats":{"Line":0}},{"line":580,"address":[2404367,2404301,2403842,2403957],"length":1,"stats":{"Line":0}},{"line":581,"address":[1801394,1801294],"length":1,"stats":{"Line":0}},{"line":585,"address":[1801041,1801750],"length":1,"stats":{"Line":0}},{"line":590,"address":[1801711],"length":1,"stats":{"Line":0}},{"line":608,"address":[2061088,2061167],"length":1,"stats":{"Line":0}},{"line":614,"address":[1801808,1802785],"length":1,"stats":{"Line":0}},{"line":615,"address":[2404604],"length":1,"stats":{"Line":0}},{"line":616,"address":[2404625],"length":1,"stats":{"Line":0}},{"line":620,"address":[2404870],"length":1,"stats":{"Line":0}},{"line":621,"address":[1802239,1802133],"length":1,"stats":{"Line":0}},{"line":622,"address":[2405145,2405263],"length":1,"stats":{"Line":0}},{"line":624,"address":[1802519],"length":1,"stats":{"Line":0}},{"line":627,"address":[2405347],"length":1,"stats":{"Line":0}},{"line":629,"address":[1802475,1802750],"length":1,"stats":{"Line":0}},{"line":634,"address":[1802728],"length":1,"stats":{"Line":0}},{"line":652,"address":[2832880,2832929],"length":1,"stats":{"Line":0}},{"line":657,"address":[2405632,2407216,2407266],"length":1,"stats":{"Line":0}},{"line":658,"address":[1802841],"length":1,"stats":{"Line":0}},{"line":659,"address":[2405675],"length":1,"stats":{"Line":0}},{"line":661,"address":[1802947,1803114],"length":1,"stats":{"Line":0}},{"line":662,"address":[2406052,2406170],"length":1,"stats":{"Line":0}},{"line":664,"address":[2406225],"length":1,"stats":{"Line":0}},{"line":667,"address":[1803405,1803520],"length":1,"stats":{"Line":0}},{"line":668,"address":[2406359],"length":1,"stats":{"Line":0}},{"line":670,"address":[1803616,1803721],"length":1,"stats":{"Line":0}},{"line":674,"address":[2406653],"length":1,"stats":{"Line":0}},{"line":675,"address":[1803830,1803961],"length":1,"stats":{"Line":0}},{"line":676,"address":[2406710],"length":1,"stats":{"Line":0}},{"line":677,"address":[1803855,1804307],"length":1,"stats":{"Line":0}},{"line":681,"address":[1804361,1803352],"length":1,"stats":{"Line":0}},{"line":686,"address":[1804296],"length":1,"stats":{"Line":0}},{"line":704,"address":[2832944,2832993],"length":1,"stats":{"Line":0}},{"line":709,"address":[2832986],"length":1,"stats":{"Line":0}},{"line":710,"address":[1804441],"length":1,"stats":{"Line":0}},{"line":711,"address":[1804458],"length":1,"stats":{"Line":0}},{"line":713,"address":[1804714,1804547],"length":1,"stats":{"Line":0}},{"line":714,"address":[1804931,1804818],"length":1,"stats":{"Line":0}},{"line":716,"address":[1804986],"length":1,"stats":{"Line":0}},{"line":719,"address":[1805005,1805112],"length":1,"stats":{"Line":0}},{"line":720,"address":[2408115,2408228],"length":1,"stats":{"Line":0}},{"line":724,"address":[2408301],"length":1,"stats":{"Line":0}},{"line":725,"address":[1805596,1805430],"length":1,"stats":{"Line":0}},{"line":726,"address":[1805450,1805966],"length":1,"stats":{"Line":0}},{"line":729,"address":[1804952,1806020],"length":1,"stats":{"Line":0}},{"line":734,"address":[1805955],"length":1,"stats":{"Line":0}},{"line":746,"address":[2833008,2833057],"length":1,"stats":{"Line":1}},{"line":751,"address":[2833050],"length":1,"stats":{"Line":2}},{"line":752,"address":[1806119],"length":1,"stats":{"Line":1}},{"line":753,"address":[1806139],"length":1,"stats":{"Line":1}},{"line":756,"address":[1806458,1806918,1806247],"length":1,"stats":{"Line":3}},{"line":757,"address":[1806571,1806902],"length":1,"stats":{"Line":2}},{"line":760,"address":[2409628],"length":1,"stats":{"Line":1}},{"line":761,"address":[1806879],"length":1,"stats":{"Line":1}},{"line":764,"address":[1806720],"length":1,"stats":{"Line":1}},{"line":766,"address":[1807292,1806960,1807852,1806736],"length":1,"stats":{"Line":2}},{"line":767,"address":[1807147,1807436],"length":1,"stats":{"Line":2}},{"line":774,"address":[1807513],"length":1,"stats":{"Line":1}},{"line":775,"address":[1807747,1807681],"length":1,"stats":{"Line":1}},{"line":777,"address":[1807720],"length":1,"stats":{"Line":1}}],"covered":43,"coverable":210},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","src","utils.rs"],"content":"// standard\nuse std::convert::TryFrom;\nuse std::net::{IpAddr, Ipv4Addr, Ipv6Addr, SocketAddr, TcpStream};\nuse std::os::raw::c_char;\n#[cfg(unix)]\nuse std::os::unix::io::IntoRawFd;\n#[cfg(windows)]\nuse std::os::windows::io::IntoRawSocket;\nuse std::str::FromStr;\n\n// extern\nuse anyhow::bail;\n#[cfg(feature = \"impl-lib\")]\nuse cgosling_proc_macros::*;\nuse tor_interface::tor_provider::{CircuitToken, DomainAddr, OnionAddr, OnionAddrV3, TargetAddr};\n\n// internal\nuse crate::context::*;\nuse crate::crypto::*;\nuse crate::error::*;\nuse crate::ffi::*;\nuse crate::macros::*;\n\n/// The maximum number of bytes needed to store a target address\n/// in the format domainname:port (including null-terminator)\n/// Maximum length of a human-readbale domain name is 253 bytes (per RFC 1035)\n/// see: https://stackoverflow.com/a/32294443\n/// Maximum length of the :port section is 6 bytes\n/// null-terminator is 1 byte\npub const TARGET_ADDRESS_STRING_SIZE: usize = 260;\n\n/// An internet socket address, either IPv4 or IPv6\npub struct GoslingIpAddress;\ndefine_registry! {IpAddr}\n\n/// An endpoint to connect to over tor\npub struct GoslingTargetAddress;\ndefine_registry! {TargetAddr}\n\n/// A stream isolation token\npub type GoslingCircuitToken = usize;\n\n//\n// Free Functions\n//\n\n/// Frees a gosling_ip_address object\n///\n/// @param in_ip_address: the ip address to free\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_ip_address_free(in_ip_address: *mut GoslingIpAddress) {\n    impl_registry_free!(in_ip_address, IpAddr);\n}\n\n/// Frees a gosling_target_address object\n///\n/// @param in_target_address: the target address to free\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_target_address_free(in_target_address: *mut GoslingTargetAddress) {\n    impl_registry_free!(in_target_address, TargetAddr);\n}\n\n//\n// Clone Functions\n//\n\n/// Copy method for gosling_ip_address\n///\n/// @param out_ip_address: returned copy\n/// @param ip_address: original to copy\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_ip_address_clone(\n    out_ip_address: *mut *mut GoslingIpAddress,\n    ip_address: *const GoslingIpAddress,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_ip_address);\n        ensure_not_null!(ip_address);\n\n        let ip_address = match get_ip_addr_registry().get(ip_address as usize) {\n            Some(ip_address) =\u003e ip_address.clone(),\n            None =\u003e bail_invalid_handle!(ip_address),\n        };\n        let handle = get_ip_addr_registry().insert(ip_address);\n        *out_ip_address = handle as *mut GoslingIpAddress;\n\n        Ok(())\n    })\n}\n\n/// Copy method for gosling_target_address\n///\n/// @param out_target_address: returned copy\n/// @param target_address: original to copy\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_target_address_clone(\n    out_target_address: *mut *mut GoslingTargetAddress,\n    target_address: *const GoslingTargetAddress,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_target_address);\n        ensure_not_null!(target_address);\n\n        let target_address = match get_target_addr_registry().get(target_address as usize) {\n            Some(target_address) =\u003e target_address.clone(),\n            None =\u003e bail_invalid_handle!(target_address),\n        };\n        let handle = get_target_addr_registry().insert(target_address);\n        *out_target_address = handle as *mut GoslingTargetAddress;\n\n        Ok(())\n    })\n}\n\n//\n// Connect Method\n//\n\n/// Connect to a target address using the provided gosling context's tor provider.\n///\n/// @param context: the context to use to connect with\n/// @param out_tcp_socket: returned connected tcp socket\n/// @param target_address: the destination address to connect to\n/// @param circuit_token: the circuit isolation token\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_connect(\n    context: *mut GoslingContext,\n    out_tcp_socket: *mut GoslingTcpSocket,\n    target_address: *const GoslingTargetAddress,\n    circuit_token: GoslingCircuitToken,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(context);\n        ensure_not_null!(out_tcp_socket);\n        ensure_not_null!(target_address);\n\n        let mut context_tuple_registry = get_context_tuple_registry();\n        let context = match context_tuple_registry.get_mut(context as usize) {\n            Some(context) =\u003e context,\n            None =\u003e bail_invalid_handle!(context),\n        };\n\n        let target_address = match get_target_addr_registry().get(target_address as usize) {\n            Some(target_address) =\u003e target_address.clone(),\n            None =\u003e bail_invalid_handle!(target_address),\n        };\n\n        let onion_stream = context.0.connect(target_address, Some(circuit_token))?;\n        let tcp_stream: TcpStream = onion_stream.into();\n\n        #[cfg(any(target_os = \"linux\", target_os = \"macos\"))]\n        let tcp_socket = tcp_stream.into_raw_fd();\n        #[cfg(target_os = \"windows\")]\n        let tcp_socket = tcp_stream.into_raw_socket();\n\n        unsafe {\n            *out_tcp_socket = tcp_socket;\n        }\n        Ok(())\n    })\n}\n\n//\n// Ip Address Methods\n//\n\n/// Create ip address from four ipv4 octets.\n///\n/// @param out_ip_address: returned ip address\n/// @param a: first octet\n/// @param b: second octet\n/// @param c: third octet\n/// @param d: fourth octet\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_ip_address_from_ipv4(\n    out_ip_address: *mut *mut GoslingIpAddress,\n    a: u8,\n    b: u8,\n    c: u8,\n    d: u8,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_ip_address);\n\n        let ip_addr = Ipv4Addr::new(a, b, c, d);\n        let handle = get_ip_addr_registry().insert(ip_addr.into());\n        *out_ip_address = handle as *mut GoslingIpAddress;\n\n        Ok(())\n    })\n}\n\n/// Create target address from eight ipv6 16-bit sgements\n///\n/// @param out_ip_address: returned ip address\n/// @param a: first segment\n/// @param b: second segment\n/// @param c: third segment\n/// @param d: fourth segment\n/// @param e: fifth segment\n/// @param f: sixth segment\n/// @param g: seventh segment\n/// @param h: eigth segment\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_ip_address_from_ipv6(\n    out_ip_address: *mut *mut GoslingIpAddress,\n    a: u16,\n    b: u16,\n    c: u16,\n    d: u16,\n    e: u16,\n    f: u16,\n    g: u16,\n    h: u16,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_ip_address);\n        let ip_addr = Ipv6Addr::new(a, b, c, d, e, f, g, h);\n        let handle = get_ip_addr_registry().insert(ip_addr.into());\n        *out_ip_address = handle as *mut GoslingIpAddress;\n\n        Ok(())\n    })\n}\n\n//\n// Target Address Methods\n//\n\n/// Create target address from an ip address and a port.\n///\n/// @param out_target_address: returned target address\n/// @param ip_address: target ip address\n/// @param port: target port\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_target_address_from_ip_address(\n    out_target_address: *mut *mut GoslingTargetAddress,\n    ip_address: *const GoslingIpAddress,\n    port: u16,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_target_address);\n        ensure_not_null!(ip_address);\n\n        let ip_address = match get_ip_addr_registry().get(ip_address as usize) {\n            Some(ip_address) =\u003e ip_address.clone(),\n            None =\u003e bail_invalid_handle!(ip_address),\n        };\n\n        let target_address = TargetAddr::Socket(SocketAddr::new(ip_address, port));\n\n        let handle = get_target_addr_registry().insert(target_address);\n        *out_target_address = handle as *mut GoslingTargetAddress;\n\n        Ok(())\n    })\n}\n\n/// Create target address from domain and port.\n/// The resulting target address is in the format domain:port\n///\n/// @param out_target_address: returned target address\n/// @param domain: the target domain\n/// @param domain_length: the number of chars in domain not including any null-terminator\n/// @param port: the target port\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_target_address_from_domain(\n    out_target_address: *mut *mut GoslingTargetAddress,\n    domain: *const c_char,\n    domain_length: usize,\n    port: u16,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_target_address);\n        ensure_not_null!(domain);\n        if domain_length == 0 {\n            bail!(\"domain_length must be greater than 0\");\n        }\n\n        let domain_view = std::slice::from_raw_parts(domain as *const u8, domain_length);\n        let domain_str = std::str::from_utf8(domain_view)?;\n\n        let target_address =\n            TargetAddr::Domain(DomainAddr::try_from((domain_str.to_string(), port))?);\n        let handle = get_target_addr_registry().insert(target_address);\n        *out_target_address = handle as *mut GoslingTargetAddress;\n\n        Ok(())\n    })\n}\n\n/// Create target address from onion service id and port.\n///\n/// @param out_target_address: returned target address\n/// @param service_id: the target onion service id\n/// @param port: the target port\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_target_address_from_v3_onion_service_id(\n    out_target_address: *mut *mut GoslingTargetAddress,\n    service_id: *const GoslingV3OnionServiceId,\n    port: u16,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_target_address);\n        ensure_not_null!(service_id);\n\n        let service_id = match get_v3_onion_service_id_registry().get(service_id as usize) {\n            Some(service_id) =\u003e service_id.clone(),\n            None =\u003e bail_invalid_handle!(service_id),\n        };\n\n        let target_address =\n            TargetAddr::OnionService(OnionAddr::V3(OnionAddrV3::new(service_id, port)));\n        let handle = get_target_addr_registry().insert(target_address);\n        *out_target_address = handle as *mut GoslingTargetAddress;\n\n        Ok(())\n    })\n}\n\n/// Create target address from some string representation\n///\n/// @param out_target_address: returned target address\n/// @param target_address: serialised target address\n/// @param target_address_length: the number of chars in string not including any null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_target_address_from_string(\n    out_target_address: *mut *mut GoslingTargetAddress,\n    target_address: *const c_char,\n    target_address_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_target_address);\n        ensure_not_null!(target_address);\n        if target_address_length == 0 {\n            bail!(\"target_address_length must be greater than 0\");\n        }\n\n        let target_address_view =\n            std::slice::from_raw_parts(target_address as *const u8, target_address_length);\n        let target_address_str = std::str::from_utf8(target_address_view)?;\n\n        let target_address = TargetAddr::from_str(target_address_str)?;\n        let handle = get_target_addr_registry().insert(target_address);\n        *out_target_address = handle as *mut GoslingTargetAddress;\n\n        Ok(())\n    })\n}\n\n/// Write target address to null-terminated string\n///\n/// @param target_address: the target address to write\n/// @param out_target_address_string: buffer to be filled with string\n/// @param target_address_string_size: size of the out_string buffer in bytes. The maximum\n///  required size is 262 bytes.\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_target_address_to_string(\n    target_address: *const GoslingTargetAddress,\n    out_target_address_string: *mut c_char,\n    target_address_string_size: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(target_address);\n        ensure_not_null!(out_target_address_string);\n\n        let target_address_string = match get_target_addr_registry().get(target_address as usize) {\n            Some(target_address) =\u003e target_address.to_string(),\n            None =\u003e bail_invalid_handle!(target_address),\n        };\n\n        let target_address_string_len = target_address_string.len();\n        if target_address_string_len \u003e= target_address_string_size {\n            bail!(\n                \"string_size must be at least '{}', received '{}'\",\n                target_address_string_len,\n                target_address_string_size\n            );\n        }\n\n        unsafe {\n            // copy target_address_string into output buffer\n            let target_address_string_view = std::slice::from_raw_parts_mut(\n                out_target_address_string as *mut u8,\n                target_address_string_size,\n            );\n            std::ptr::copy(\n                target_address_string.as_ptr(),\n                target_address_string_view.as_mut_ptr(),\n                target_address_string_len,\n            );\n            // add final null-terminator\n            target_address_string_view[target_address_string_len] = 0u8;\n        }\n\n        Ok(())\n    })\n}\n\n//\n// Circuit Token Methods\n//\n\n/// Generate a circuit token to isolate connect calls\n///\n/// @param context: the context to use to connect with\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_context_generate_circuit_token(\n    context: *mut GoslingContext,\n    error: *mut *mut GoslingError,\n) -\u003e GoslingCircuitToken {\n    translate_failures(!0usize, error, || -\u003e anyhow::Result\u003cCircuitToken\u003e {\n        ensure_not_null!(context);\n\n        let mut context_tuple_registry = get_context_tuple_registry();\n        let token = match context_tuple_registry.get_mut(context as usize) {\n            Some(context) =\u003e context.0.generate_circuit_token(),\n            None =\u003e bail_invalid_handle!(context),\n        };\n        Ok(token)\n    })\n}\n\n/// Release a context's circuit token.\n///\n/// @param context: the context to use to connect with\n/// @param circuit_token: circuit token to destroy\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_context_release_circuit_token(\n    context: *mut GoslingContext,\n    circuit_token: GoslingCircuitToken,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(context);\n\n        let mut context_tuple_registry = get_context_tuple_registry();\n        match context_tuple_registry.get_mut(context as usize) {\n            Some(context) =\u003e context.0.release_circuit_token(circuit_token),\n            None =\u003e bail_invalid_handle!(context),\n        };\n        Ok(())\n    })\n}\n","traces":[{"line":52,"address":[2055949,2055920],"length":1,"stats":{"Line":0}},{"line":61,"address":[2842287,2842256],"length":1,"stats":{"Line":0}},{"line":76,"address":[2842448,2842497],"length":1,"stats":{"Line":0}},{"line":81,"address":[2948560,2949283],"length":1,"stats":{"Line":0}},{"line":82,"address":[2317905],"length":1,"stats":{"Line":0}},{"line":83,"address":[2948594],"length":1,"stats":{"Line":0}},{"line":85,"address":[2318171,2318009],"length":1,"stats":{"Line":0}},{"line":86,"address":[2948933],"length":1,"stats":{"Line":0}},{"line":89,"address":[2949046],"length":1,"stats":{"Line":0}},{"line":90,"address":[2949207,2949262],"length":1,"stats":{"Line":0}},{"line":92,"address":[2949243],"length":1,"stats":{"Line":0}},{"line":103,"address":[2842561,2842512],"length":1,"stats":{"Line":0}},{"line":108,"address":[2318672,2319566],"length":1,"stats":{"Line":0}},{"line":109,"address":[2949337],"length":1,"stats":{"Line":0}},{"line":110,"address":[2949354],"length":1,"stats":{"Line":0}},{"line":112,"address":[2318963,2318801],"length":1,"stats":{"Line":0}},{"line":113,"address":[2319184,2319071],"length":1,"stats":{"Line":0}},{"line":116,"address":[2319252],"length":1,"stats":{"Line":0}},{"line":117,"address":[2950146,2950086],"length":1,"stats":{"Line":0}},{"line":119,"address":[2950120],"length":1,"stats":{"Line":0}},{"line":136,"address":[2056526,2056432],"length":1,"stats":{"Line":0}},{"line":143,"address":[2952246,2950208,2952192],"length":1,"stats":{"Line":0}},{"line":144,"address":[2950236],"length":1,"stats":{"Line":0}},{"line":145,"address":[2950256],"length":1,"stats":{"Line":0}},{"line":146,"address":[2950358],"length":1,"stats":{"Line":0}},{"line":148,"address":[2319874],"length":1,"stats":{"Line":0}},{"line":149,"address":[2950627,2950486],"length":1,"stats":{"Line":0}},{"line":150,"address":[2950729],"length":1,"stats":{"Line":0}},{"line":154,"address":[2950839,2950750,2950926],"length":1,"stats":{"Line":0}},{"line":155,"address":[2951029,2951134],"length":1,"stats":{"Line":0}},{"line":159,"address":[2951208,2951821,2952206],"length":1,"stats":{"Line":0}},{"line":160,"address":[2952024,2951652],"length":1,"stats":{"Line":0}},{"line":163,"address":[2952031],"length":1,"stats":{"Line":0}},{"line":168,"address":[2952058,2952136],"length":1,"stats":{"Line":0}},{"line":170,"address":[2952091],"length":1,"stats":{"Line":0}},{"line":188,"address":[2842688,2842795],"length":1,"stats":{"Line":0}},{"line":196,"address":[2842738],"length":1,"stats":{"Line":0}},{"line":197,"address":[2952284],"length":1,"stats":{"Line":0}},{"line":199,"address":[2952304],"length":1,"stats":{"Line":0}},{"line":200,"address":[2952452,2952349],"length":1,"stats":{"Line":0}},{"line":201,"address":[2952579,2952629],"length":1,"stats":{"Line":0}},{"line":203,"address":[2952613],"length":1,"stats":{"Line":0}},{"line":221,"address":[2842816,2843039],"length":1,"stats":{"Line":0}},{"line":233,"address":[2056789],"length":1,"stats":{"Line":0}},{"line":234,"address":[2952700],"length":1,"stats":{"Line":0}},{"line":235,"address":[2952720],"length":1,"stats":{"Line":0}},{"line":236,"address":[2952906,2952803],"length":1,"stats":{"Line":0}},{"line":237,"address":[2953028,2953078],"length":1,"stats":{"Line":0}},{"line":239,"address":[2953062],"length":1,"stats":{"Line":0}},{"line":255,"address":[2843056,2843138],"length":1,"stats":{"Line":0}},{"line":261,"address":[2056957],"length":1,"stats":{"Line":0}},{"line":262,"address":[2953156],"length":1,"stats":{"Line":0}},{"line":263,"address":[2953176],"length":1,"stats":{"Line":0}},{"line":265,"address":[2322766,2322933],"length":1,"stats":{"Line":0}},{"line":266,"address":[2953518],"length":1,"stats":{"Line":0}},{"line":270,"address":[2953636],"length":1,"stats":{"Line":0}},{"line":272,"address":[2323338,2323272],"length":1,"stats":{"Line":0}},{"line":273,"address":[2954011,2954069],"length":1,"stats":{"Line":0}},{"line":275,"address":[2954043],"length":1,"stats":{"Line":0}},{"line":289,"address":[2843248,2843152],"length":1,"stats":{"Line":0}},{"line":296,"address":[2323680,2324821],"length":1,"stats":{"Line":0}},{"line":297,"address":[2954164],"length":1,"stats":{"Line":0}},{"line":298,"address":[2954184],"length":1,"stats":{"Line":0}},{"line":299,"address":[2954271],"length":1,"stats":{"Line":0}},{"line":300,"address":[2954347],"length":1,"stats":{"Line":0}},{"line":303,"address":[2323937],"length":1,"stats":{"Line":0}},{"line":304,"address":[2954434,2954499,2954671],"length":1,"stats":{"Line":0}},{"line":307,"address":[2954863,2954531,2954765],"length":1,"stats":{"Line":0}},{"line":308,"address":[2954847,2954981],"length":1,"stats":{"Line":0}},{"line":309,"address":[2955185,2955243],"length":1,"stats":{"Line":0}},{"line":311,"address":[2955217],"length":1,"stats":{"Line":0}},{"line":323,"address":[2843346,2843264],"length":1,"stats":{"Line":0}},{"line":329,"address":[2955312,2956336],"length":1,"stats":{"Line":0}},{"line":330,"address":[2955332],"length":1,"stats":{"Line":0}},{"line":331,"address":[2955352],"length":1,"stats":{"Line":0}},{"line":333,"address":[2955434,2955591],"length":1,"stats":{"Line":0}},{"line":334,"address":[2325264],"length":1,"stats":{"Line":0}},{"line":339,"address":[2955812],"length":1,"stats":{"Line":0}},{"line":340,"address":[2956053,2955987],"length":1,"stats":{"Line":0}},{"line":341,"address":[2956257,2956315],"length":1,"stats":{"Line":0}},{"line":343,"address":[2325880],"length":1,"stats":{"Line":0}},{"line":355,"address":[2057295,2057216],"length":1,"stats":{"Line":0}},{"line":361,"address":[2327089,2325968],"length":1,"stats":{"Line":0}},{"line":362,"address":[2325988],"length":1,"stats":{"Line":0}},{"line":363,"address":[2326009],"length":1,"stats":{"Line":0}},{"line":364,"address":[2956511],"length":1,"stats":{"Line":0}},{"line":365,"address":[2956587],"length":1,"stats":{"Line":0}},{"line":369,"address":[2956635],"length":1,"stats":{"Line":0}},{"line":370,"address":[2956674,2956736,2956834],"length":1,"stats":{"Line":0}},{"line":372,"address":[2326358,2326520,2326672],"length":1,"stats":{"Line":0}},{"line":373,"address":[2326656,2326791],"length":1,"stats":{"Line":0}},{"line":374,"address":[2327007,2327068],"length":1,"stats":{"Line":0}},{"line":376,"address":[2327041],"length":1,"stats":{"Line":0}},{"line":389,"address":[2057312,2057391],"length":1,"stats":{"Line":0}},{"line":395,"address":[2958884,2957536],"length":1,"stats":{"Line":0}},{"line":396,"address":[2957548],"length":1,"stats":{"Line":0}},{"line":397,"address":[2327169],"length":1,"stats":{"Line":0}},{"line":399,"address":[2327260,2327442],"length":1,"stats":{"Line":0}},{"line":400,"address":[2957930],"length":1,"stats":{"Line":0}},{"line":404,"address":[2958104],"length":1,"stats":{"Line":0}},{"line":405,"address":[2958134],"length":1,"stats":{"Line":0}},{"line":406,"address":[2958831,2958604,2958694],"length":1,"stats":{"Line":0}},{"line":415,"address":[2958316,2958170],"length":1,"stats":{"Line":0}},{"line":416,"address":[2958164,2958156],"length":1,"stats":{"Line":0}},{"line":417,"address":[2958160,2958167],"length":1,"stats":{"Line":0}},{"line":419,"address":[2958435],"length":1,"stats":{"Line":0}},{"line":420,"address":[2327983],"length":1,"stats":{"Line":0}},{"line":425,"address":[2328198,2328138],"length":1,"stats":{"Line":0}},{"line":428,"address":[2958538],"length":1,"stats":{"Line":0}},{"line":442,"address":[2843552,2843589],"length":1,"stats":{"Line":0}},{"line":446,"address":[2958912,2959321],"length":1,"stats":{"Line":0}},{"line":447,"address":[2328556],"length":1,"stats":{"Line":0}},{"line":449,"address":[2328574],"length":1,"stats":{"Line":0}},{"line":450,"address":[2958963,2959087],"length":1,"stats":{"Line":0}},{"line":451,"address":[2959287,2959176],"length":1,"stats":{"Line":0}},{"line":454,"address":[2959295],"length":1,"stats":{"Line":0}},{"line":465,"address":[2057472,2057521],"length":1,"stats":{"Line":0}},{"line":470,"address":[2329402,2329008],"length":1,"stats":{"Line":0}},{"line":471,"address":[2959361],"length":1,"stats":{"Line":0}},{"line":473,"address":[2959378],"length":1,"stats":{"Line":0}},{"line":474,"address":[2959400,2959512],"length":1,"stats":{"Line":0}},{"line":475,"address":[2959601],"length":1,"stats":{"Line":0}},{"line":478,"address":[2959696],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":123},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","tests","ffi.rs"],"content":"// standard\nuse std::ffi::{CStr, CString};\nuse std::io::{BufRead, BufReader, Write};\nuse std::net::TcpStream;\nuse std::os::raw::c_char;\n#[cfg(unix)]\nuse std::os::unix::io::{FromRawFd, RawFd};\n#[cfg(windows)]\nuse std::os::windows::io::{FromRawSocket, RawSocket};\nuse std::ptr;\nuse std::sync::atomic::{AtomicBool, Ordering};\n\n// external crates\nuse anyhow::bail;\n#[cfg(test)]\nuse serial_test::serial;\n\n// internal crates\nuse cgosling::callbacks::*;\nuse cgosling::context::*;\nuse cgosling::crypto::*;\nuse cgosling::error::*;\nuse cgosling::ffi::*;\nuse cgosling::tor_provider::*;\n\nmacro_rules! require_noerror {\n    ($func:ident($($arg:tt)*)) =\u003e {\n        // println!(\"--- {}{}\", stringify!($func), stringify!(($($arg)*)));\n        unsafe {\n            let mut error: *mut GoslingError = ptr::null_mut();\n            $func($($arg)*, \u0026mut error);\n            if !error.is_null() {\n                let msg = gosling_error_get_message(error);\n                let msg = format!(\"{:?}\", CStr::from_ptr(msg));\n                gosling_error_free(error);\n                anyhow::bail!(msg);\n            }\n        }\n    }\n}\n\n// simple bson document: { msg : \"hello world\" }\nconst CHALLENGE_BSON: [u8; 26] = [\n    0x1a, 0x00, 0x00, 0x00, // document length 26 == 0x0000001a\n    0x02, b'm', b's', b'g', 0x00, // string msg\n    0x0c, 0x00, 0x00, 0x00, // strlen(\"hello world\\x00\") 12 = 0x0000000c\n    b'h', b'e', b'l', b'l', b'o', b' ', b'w', b'o', b'r', b'l', b'd', 0x00, // \"hello world\"\n    0x00, // document null-terminator\n];\n\n// empty bson document: {}\nconst CHALLENGE_RESPONSE_BSON: [u8; 5] = [\n    0x05, 0x00, 0x00, 0x00, // document length 5 == 0x00000005\n    0x00, // document null-terminator\n];\n\nstatic ENDPOINT_NAME: \u0026CStr = unsafe { CStr::from_bytes_with_nul_unchecked(b\"endpoint_name\\0\") };\nstatic CHANNEL_NAME: \u0026CStr = unsafe { CStr::from_bytes_with_nul_unchecked(b\"channel_name\\0\") };\n\nfn create_client_identity_handshake(context: *mut GoslingContext) -\u003e anyhow::Result\u003c()\u003e {\n    extern \"C\" fn challenge_response_size_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        _challenge_buffer: *const u8,\n        challenge_buffer_size: usize,\n    ) -\u003e usize {\n        assert!(!context.is_null());\n        assert_eq!(challenge_buffer_size, CHALLENGE_BSON.len());\n\n        CHALLENGE_RESPONSE_BSON.len()\n    }\n    require_noerror!(\n        gosling_context_set_identity_client_challenge_response_size_callback(\n            context,\n            Some(challenge_response_size_callback)\n        )\n    );\n\n    extern \"C\" fn build_challenge_response_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        challenge_buffer: *const u8,\n        challenge_buffer_size: usize,\n        out_challenge_response_buffer: *mut u8,\n        challenge_response_buffer_size: usize,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!challenge_buffer.is_null());\n        assert_eq!(challenge_buffer_size, CHALLENGE_BSON.len());\n        let challenge_buffer = unsafe {\n            std::slice::from_raw_parts(challenge_buffer as *const u8, challenge_buffer_size)\n        };\n        assert_eq!(challenge_buffer, CHALLENGE_BSON);\n        assert!(!out_challenge_response_buffer.is_null());\n        let out_challenge_response_buffer = unsafe {\n            std::slice::from_raw_parts_mut(\n                out_challenge_response_buffer as *mut u8,\n                challenge_response_buffer_size,\n            )\n        };\n\n        out_challenge_response_buffer.clone_from_slice(\u0026CHALLENGE_RESPONSE_BSON);\n    }\n    require_noerror!(\n        gosling_context_set_identity_client_build_challenge_response_callback(\n            context,\n            Some(build_challenge_response_callback)\n        )\n    );\n\n    Ok(())\n}\n\nfn create_server_identity_handshake(context: *mut GoslingContext) -\u003e anyhow::Result\u003c()\u003e {\n    extern \"C\" fn client_allowed_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        client_service_id: *const GoslingV3OnionServiceId,\n    ) -\u003e bool {\n        assert!(!context.is_null());\n        assert!(!client_service_id.is_null());\n\n        true\n    }\n    require_noerror!(gosling_context_set_identity_server_client_allowed_callback(\n        context,\n        Some(client_allowed_callback)\n    ));\n\n    extern \"C\" fn endpoint_supported_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        endpoint_name: *const c_char,\n        endpoint_name_length: usize,\n    ) -\u003e bool {\n        assert!(!context.is_null());\n        let endpoint_name = unsafe { CStr::from_ptr(endpoint_name) };\n        assert_eq!(endpoint_name.to_bytes().len(), endpoint_name_length);\n        if endpoint_name == ENDPOINT_NAME {\n            return true;\n        }\n        false\n    }\n    require_noerror!(\n        gosling_context_set_identity_server_endpoint_supported_callback(\n            context,\n            Some(endpoint_supported_callback)\n        )\n    );\n\n    extern \"C\" fn challenge_size_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n    ) -\u003e usize {\n        assert!(!context.is_null());\n        CHALLENGE_BSON.len()\n    }\n    require_noerror!(gosling_context_set_identity_server_challenge_size_callback(\n        context,\n        Some(challenge_size_callback)\n    ));\n\n    extern \"C\" fn build_challenge_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        out_challenge_buffer: *mut u8,\n        challenge_buffer_size: usize,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!out_challenge_buffer.is_null());\n        assert_eq!(challenge_buffer_size, CHALLENGE_BSON.len());\n\n        let out_challenge_buffer = unsafe {\n            std::slice::from_raw_parts_mut(out_challenge_buffer as *mut u8, challenge_buffer_size)\n        };\n        out_challenge_buffer.clone_from_slice(\u0026CHALLENGE_BSON);\n    }\n    require_noerror!(\n        gosling_context_set_identity_server_build_challenge_callback(\n            context,\n            Some(build_challenge_callback)\n        )\n    );\n\n    extern \"C\" fn verify_challenge_response_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        challenge_response_buffer: *const u8,\n        challenge_response_buffer_size: usize,\n    ) -\u003e bool {\n        assert!(!context.is_null());\n        assert!(!challenge_response_buffer.is_null());\n        if challenge_response_buffer_size != CHALLENGE_RESPONSE_BSON.len() {\n            return false;\n        }\n\n        let challenge_response_buffer = unsafe {\n            std::slice::from_raw_parts(challenge_response_buffer, challenge_response_buffer_size)\n        };\n        if challenge_response_buffer != CHALLENGE_RESPONSE_BSON {\n            return false;\n        }\n        true\n    }\n    require_noerror!(\n        gosling_context_set_identity_server_verify_challenge_response_callback(\n            context,\n            Some(verify_challenge_response_callback)\n        )\n    );\n\n    Ok(())\n}\n\nfn create_server_endpoint_handshake(context: *mut GoslingContext) -\u003e anyhow::Result\u003c()\u003e {\n    extern \"C\" fn channel_supported_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        client_service_id: *const GoslingV3OnionServiceId,\n        channel_name: *const c_char,\n        channel_name_length: usize,\n    ) -\u003e bool {\n        assert!(!context.is_null());\n        assert!(!channel_name.is_null());\n        assert!(!client_service_id.is_null());\n        let channel_name = unsafe { CStr::from_ptr(channel_name) };\n        assert_eq!(channel_name.to_bytes().len(), channel_name_length);\n        if channel_name == CHANNEL_NAME {\n            return true;\n        }\n        false\n    }\n    require_noerror!(\n        gosling_context_set_endpoint_server_channel_supported_callback(\n            context,\n            Some(channel_supported_callback)\n        )\n    );\n\n    Ok(())\n}\n\n#[test]\n#[serial]\n#[cfg(feature = \"mock-tor-provider\")]\nfn test_gosling_ffi_handshake_mock_client() -\u003e anyhow::Result\u003c()\u003e {\n    let library = test_gosling_ffi_handshake_preamble()?;\n\n    // construct a shared mock config\n    let mut mock_tor_provider_config: *mut GoslingTorProviderConfig = ptr::null_mut();\n    require_noerror!(gosling_tor_provider_config_new_mock_client_config(\n        \u0026mut mock_tor_provider_config\n    ));\n\n    // construct tor providers\n    let mut alice_tor_provider: *mut GoslingTorProvider = ptr::null_mut();\n    require_noerror!(gosling_tor_provider_from_tor_provider_config(\n        \u0026mut alice_tor_provider,\n        mock_tor_provider_config\n    ));\n\n    let mut pat_tor_provider: *mut GoslingTorProvider = ptr::null_mut();\n    require_noerror!(gosling_tor_provider_from_tor_provider_config(\n        \u0026mut pat_tor_provider,\n        mock_tor_provider_config\n    ));\n\n    // do test\n    test_gosling_ffi_handshake_impl(library, alice_tor_provider, pat_tor_provider)\n}\n\n#[test]\n#[serial]\n#[cfg(feature = \"legacy-tor-provider\")]\nfn test_gosling_ffi_handshake_legacy_client() -\u003e anyhow::Result\u003c()\u003e {\n    let library = test_gosling_ffi_handshake_preamble()?;\n\n    // construct tor providers\n\n    let mut alice_working_dir = std::env::temp_dir();\n    alice_working_dir.push(\"cgosling_bundled_test_alice\");\n    let alice_working_dir: CString = CString::new(alice_working_dir.to_str().unwrap())?;\n\n    let mut alice_tor_provider_config: *mut GoslingTorProviderConfig = ptr::null_mut();\n    require_noerror!(\n        gosling_tor_provider_config_new_bundled_legacy_client_config(\n            \u0026mut alice_tor_provider_config,\n            ptr::null(),\n            0usize,\n            alice_working_dir.as_ptr(),\n            alice_working_dir.as_bytes().len()\n        )\n    );\n\n    let mut alice_tor_provider: *mut GoslingTorProvider = ptr::null_mut();\n    require_noerror!(gosling_tor_provider_from_tor_provider_config(\n        \u0026mut alice_tor_provider,\n        alice_tor_provider_config\n    ));\n\n    let mut pat_working_dir = std::env::temp_dir();\n    pat_working_dir.push(\"cgosling_bundled_test_pat\");\n    let pat_working_dir: CString = CString::new(pat_working_dir.to_str().unwrap())?;\n\n    let mut pat_tor_provider_config: *mut GoslingTorProviderConfig = ptr::null_mut();\n    require_noerror!(\n        gosling_tor_provider_config_new_bundled_legacy_client_config(\n            \u0026mut pat_tor_provider_config,\n            ptr::null(),\n            0usize,\n            pat_working_dir.as_ptr(),\n            pat_working_dir.as_bytes().len()\n        )\n    );\n\n    let mut pat_tor_provider: *mut GoslingTorProvider = ptr::null_mut();\n    require_noerror!(gosling_tor_provider_from_tor_provider_config(\n        \u0026mut pat_tor_provider,\n        pat_tor_provider_config\n    ));\n\n    // do test\n    test_gosling_ffi_handshake_impl(library, alice_tor_provider, pat_tor_provider)\n}\n\n// test bundled tor client with pluggable transport\n#[test]\n#[serial]\n#[cfg(feature = \"legacy-tor-provider\")]\nfn test_gosling_ffi_handshake_bundled_pt_client() -\u003e anyhow::Result\u003c()\u003e {\n    let library = test_gosling_ffi_handshake_preamble()?;\n\n    // construct a shared pt config using lyrebird\n    let mut pt_config: *mut GoslingPluggableTransportConfig = ptr::null_mut();\n    let transports: CString = CString::new(\"obfs4\")?;\n\n    let teb_path = std::env::var(\"TEB_PATH\")?;\n    if teb_path.is_empty() {\n        println!(\"TEB_PATH environment variable empty, so skipping test_legacy_pluggable_transport_bootstrap()\");\n        return Ok(());\n    }\n    let mut lyrebird_path = std::path::PathBuf::from(\u0026teb_path);\n    let lyrebird_bin = format!(\"lyrebird{}\", std::env::consts::EXE_SUFFIX);\n    lyrebird_path.push(lyrebird_bin);\n    assert!(std::path::Path::exists(\u0026lyrebird_path));\n    assert!(std::path::Path::is_file(\u0026lyrebird_path));\n    let lyrebird_path: CString = CString::new(lyrebird_path.to_str().unwrap())?;\n\n    require_noerror!(gosling_pluggable_transport_config_new(\n        \u0026mut pt_config,\n        transports.as_ptr(),\n        transports.as_bytes().len(),\n        lyrebird_path.as_ptr(),\n        lyrebird_path.as_bytes().len()\n    ));\n\n    // construct a obfs4 bridge line to use with lyrebird\n    let mut bridge_line: *mut GoslingBridgeLine = ptr::null_mut();\n    let bridge_line_str = \"obfs4 207.172.185.193:22223 F34AC0CDBC06918E54292A474578C99834A58893 cert=MjqosoyVylLQuLo4LH+eQ5hS7Z44s2CaMfQbIjJtn4bGRnvLv8ldSvSED5JpvWSxm09XXg iat-mode=0\";\n    let bridge_line_str = CString::new(bridge_line_str)?;\n\n    require_noerror!(gosling_bridge_line_from_string(\n        \u0026mut bridge_line,\n        bridge_line_str.as_ptr(),\n        bridge_line_str.as_bytes().len()\n    ));\n\n    // construct tor providers\n\n    let mut alice_working_dir = std::env::temp_dir();\n    alice_working_dir.push(\"cgosling_bundled_pt_test_alice\");\n    let alice_working_dir: CString = CString::new(alice_working_dir.to_str().unwrap())?;\n\n    let mut alice_tor_provider_config: *mut GoslingTorProviderConfig = ptr::null_mut();\n    require_noerror!(\n        gosling_tor_provider_config_new_bundled_legacy_client_config(\n            \u0026mut alice_tor_provider_config,\n            ptr::null(),\n            0usize,\n            alice_working_dir.as_ptr(),\n            alice_working_dir.as_bytes().len()\n        )\n    );\n\n    // add pt config\n    require_noerror!(gosling_tor_provider_config_add_pluggable_transport_config(\n        alice_tor_provider_config,\n        pt_config\n    ));\n\n    // add bridge line\n    require_noerror!(gosling_tor_provider_config_add_bridge_line(\n        alice_tor_provider_config,\n        bridge_line\n    ));\n\n    let mut alice_tor_provider: *mut GoslingTorProvider = ptr::null_mut();\n    require_noerror!(gosling_tor_provider_from_tor_provider_config(\n        \u0026mut alice_tor_provider,\n        alice_tor_provider_config\n    ));\n\n    let mut pat_working_dir = std::env::temp_dir();\n    pat_working_dir.push(\"cgosling_bundled_pt_test_pat\");\n    let pat_working_dir: CString = CString::new(pat_working_dir.to_str().unwrap())?;\n\n    let mut pat_tor_provider_config: *mut GoslingTorProviderConfig = ptr::null_mut();\n    require_noerror!(\n        gosling_tor_provider_config_new_bundled_legacy_client_config(\n            \u0026mut pat_tor_provider_config,\n            ptr::null(),\n            0usize,\n            pat_working_dir.as_ptr(),\n            pat_working_dir.as_bytes().len()\n        )\n    );\n\n    let mut pat_tor_provider: *mut GoslingTorProvider = ptr::null_mut();\n    require_noerror!(gosling_tor_provider_from_tor_provider_config(\n        \u0026mut pat_tor_provider,\n        pat_tor_provider_config\n    ));\n\n    // do test\n    test_gosling_ffi_handshake_impl(library, alice_tor_provider, pat_tor_provider)\n}\n\nfn test_gosling_ffi_handshake_preamble() -\u003e anyhow::Result\u003c*mut GoslingLibrary\u003e {\n    // init libary\n\n    println!(\"--- init gosling library\");\n    let mut library: *mut GoslingLibrary = ptr::null_mut();\n    require_noerror!(gosling_library_init(\u0026mut library));\n\n    println!(\"--- library: {:?}\", library);\n\n    Ok(library)\n}\n\nfn test_gosling_ffi_handshake_impl(\n    library: *mut GoslingLibrary,\n    alice_tor_provider: *mut GoslingTorProvider,\n    pat_tor_provider: *mut GoslingTorProvider,\n) -\u003e anyhow::Result\u003c()\u003e {\n    // init alice\n\n    println!(\"--- init alice\");\n    let mut alice_private_key: *mut GoslingEd25519PrivateKey = ptr::null_mut();\n    require_noerror!(gosling_ed25519_private_key_generate(\u0026mut alice_private_key));\n\n    let mut alice_identity: *mut GoslingV3OnionServiceId = ptr::null_mut();\n    require_noerror!(gosling_v3_onion_service_id_from_ed25519_private_key(\n        \u0026mut alice_identity,\n        alice_private_key\n    ));\n\n    let mut alice_context: *mut GoslingContext = ptr::null_mut();\n    require_noerror!(gosling_context_init(\n        \u0026mut alice_context,\n        alice_tor_provider,\n        420,\n        420,\n        alice_private_key\n    ));\n\n    create_server_identity_handshake(alice_context)?;\n    create_server_endpoint_handshake(alice_context)?;\n    // init pat\n\n    println!(\"--- init pat\");\n    let mut pat_private_key: *mut GoslingEd25519PrivateKey = ptr::null_mut();\n    require_noerror!(gosling_ed25519_private_key_generate(\u0026mut pat_private_key));\n\n    let mut pat_identity: *mut GoslingV3OnionServiceId = ptr::null_mut();\n    require_noerror!(gosling_v3_onion_service_id_from_ed25519_private_key(\n        \u0026mut pat_identity,\n        pat_private_key\n    ));\n\n    let mut pat_context: *mut GoslingContext = ptr::null_mut();\n    require_noerror!(gosling_context_init(\n        \u0026mut pat_context,\n        pat_tor_provider,\n        420,\n        420,\n        pat_private_key\n    ));\n\n    create_client_identity_handshake(pat_context)?;\n\n    // bootstrap alice\n\n    static ALICE_BOOTSTRAP_COMPLETE: AtomicBool = AtomicBool::new(false);\n    ALICE_BOOTSTRAP_COMPLETE.store(false, Ordering::Relaxed);\n\n    extern \"C\" fn alice_bootstrap_complete_callback(context: *mut GoslingContext) -\u003e () {\n        assert!(!context.is_null());\n        ALICE_BOOTSTRAP_COMPLETE.store(true, Ordering::Relaxed);\n        println!(\"--- alice bootstraped\");\n    }\n    require_noerror!(gosling_context_set_tor_bootstrap_completed_callback(\n        alice_context,\n        Some(alice_bootstrap_complete_callback)\n    ));\n\n    println!(\"--- begin alice bootstrap\");\n    require_noerror!(gosling_context_bootstrap_tor(alice_context));\n    while !ALICE_BOOTSTRAP_COMPLETE.load(Ordering::Relaxed) {\n        require_noerror!(gosling_context_poll_events(alice_context));\n    }\n\n    // init alice's identity server\n    static ALICE_IDENTITY_SERVER_READY: AtomicBool = AtomicBool::new(false);\n    ALICE_IDENTITY_SERVER_READY.store(false, Ordering::Relaxed);\n\n    extern \"C\" fn alice_identity_server_published_callback(context: *mut GoslingContext) -\u003e () {\n        assert!(!context.is_null());\n        println!(\"--- alice identity server published\");\n\n        ALICE_IDENTITY_SERVER_READY.store(true, Ordering::Relaxed);\n    }\n    require_noerror!(gosling_context_set_identity_server_published_callback(\n        alice_context,\n        Some(alice_identity_server_published_callback)\n    ));\n\n    println!(\"--- start alice identity server\");\n    require_noerror!(gosling_context_start_identity_server(alice_context));\n\n    while !ALICE_IDENTITY_SERVER_READY.load(Ordering::Relaxed) {\n        require_noerror!(gosling_context_poll_events(alice_context));\n    }\n\n    // bootstrap pat\n\n    static PAT_BOOTSTRAP_COMPLETE: AtomicBool = AtomicBool::new(false);\n    PAT_BOOTSTRAP_COMPLETE.store(false, Ordering::Relaxed);\n\n    extern \"C\" fn pat_bootstrap_complete_callback(context: *mut GoslingContext) -\u003e () {\n        assert!(!context.is_null());\n\n        println!(\"--- pat bootstrapped\");\n\n        PAT_BOOTSTRAP_COMPLETE.store(true, Ordering::Relaxed);\n    }\n    require_noerror!(gosling_context_set_tor_bootstrap_completed_callback(\n        pat_context,\n        Some(pat_bootstrap_complete_callback)\n    ));\n\n    println!(\"--- begin pat bootstrap\");\n    require_noerror!(gosling_context_bootstrap_tor(pat_context));\n    while !PAT_BOOTSTRAP_COMPLETE.load(Ordering::Relaxed) {\n        require_noerror!(gosling_context_poll_events(pat_context));\n    }\n\n    // pat requests an endpoint from alice\n\n    static mut PAT_ENDPOINT_REQUEST_COMPLETE: bool = false;\n    static mut ALICE_ENDPOINT_SERVICE_ID: *mut GoslingV3OnionServiceId = ptr::null_mut();\n    static mut PAT_ONION_AUTH_PRIVATE_KEY: *mut GoslingX25519PrivateKey = ptr::null_mut();\n    unsafe {\n        PAT_ENDPOINT_REQUEST_COMPLETE = false;\n        ALICE_ENDPOINT_SERVICE_ID = ptr::null_mut();\n        PAT_ONION_AUTH_PRIVATE_KEY = ptr::null_mut();\n    }\n\n    extern \"C\" fn pat_identity_client_handshake_completed_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        identity_service_id: *const GoslingV3OnionServiceId,\n        endpoint_service_id: *const GoslingV3OnionServiceId,\n        endpoint_name: *const c_char,\n        endpoint_name_length: usize,\n        client_auth_private_key: *const GoslingX25519PrivateKey,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!identity_service_id.is_null());\n        assert!(!endpoint_service_id.is_null());\n        assert!(!endpoint_name.is_null());\n        let endpoint_name = unsafe { CStr::from_ptr(endpoint_name) };\n        assert_eq!(endpoint_name.to_bytes().len(), endpoint_name_length);\n        assert_eq!(endpoint_name, ENDPOINT_NAME);\n        assert!(!client_auth_private_key.is_null());\n\n        let mut error: *mut GoslingError = ptr::null_mut();\n\n        let mut alice_endpoint_service_id: *mut GoslingV3OnionServiceId = ptr::null_mut();\n        unsafe {\n            gosling_v3_onion_service_id_clone(\n                \u0026mut alice_endpoint_service_id,\n                endpoint_service_id,\n                \u0026mut error,\n            );\n        }\n        assert!(error.is_null());\n        assert!(!alice_endpoint_service_id.is_null());\n        unsafe {\n            ALICE_ENDPOINT_SERVICE_ID = alice_endpoint_service_id;\n        }\n\n        let mut pat_onion_auth_private_key: *mut GoslingX25519PrivateKey = ptr::null_mut();\n        unsafe {\n            gosling_x25519_private_key_clone(\n                \u0026mut pat_onion_auth_private_key,\n                client_auth_private_key,\n                \u0026mut error,\n            );\n        }\n        assert!(error.is_null());\n        assert!(!pat_onion_auth_private_key.is_null());\n        unsafe {\n            PAT_ONION_AUTH_PRIVATE_KEY = pat_onion_auth_private_key;\n        }\n\n        println!(\"--- pat identity handshake completed\");\n\n        unsafe {\n            PAT_ENDPOINT_REQUEST_COMPLETE = true;\n        }\n    }\n    require_noerror!(\n        gosling_context_set_identity_client_handshake_completed_callback(\n            pat_context,\n            Some(pat_identity_client_handshake_completed_callback)\n        )\n    );\n\n    extern \"C\" fn pat_identity_client_handshake_failed_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        error: *const GoslingError,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!error.is_null());\n        let error_message = unsafe {\n            CStr::from_ptr(gosling_error_get_message(error))\n                .to_str()\n                .unwrap()\n        };\n\n        panic!(\"--- pat identity handshake failed: {}\", error_message);\n    }\n    require_noerror!(\n        gosling_context_set_identity_client_handshake_failed_callback(\n            pat_context,\n            Some(pat_identity_client_handshake_failed_callback)\n        )\n    );\n\n    static mut ALICE_ENDPOINT_REQUEST_COMPLETE: bool = false;\n    static mut ALICE_ENDPOINT_PRIVATE_KEY: *mut GoslingEd25519PrivateKey = ptr::null_mut();\n    static mut PAT_IDENTITY_SERVICE_ID: *mut GoslingV3OnionServiceId = ptr::null_mut();\n    static mut PAT_ONION_AUTH_PUBLIC_KEY: *mut GoslingX25519PublicKey = ptr::null_mut();\n    unsafe {\n        ALICE_ENDPOINT_REQUEST_COMPLETE = false;\n        ALICE_ENDPOINT_PRIVATE_KEY = ptr::null_mut();\n        PAT_IDENTITY_SERVICE_ID = ptr::null_mut();\n        PAT_ONION_AUTH_PUBLIC_KEY = ptr::null_mut();\n    }\n\n    extern \"C\" fn alice_identity_server_handshake_completed_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        endpoint_private_key: *const GoslingEd25519PrivateKey,\n        endpoint_name: *const c_char,\n        endpoint_name_length: usize,\n        client_service_id: *const GoslingV3OnionServiceId,\n        client_auth_public_key: *const GoslingX25519PublicKey,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!endpoint_private_key.is_null());\n        assert!(!endpoint_name.is_null());\n        let endpoint_name = unsafe { CStr::from_ptr(endpoint_name) };\n        assert_eq!(endpoint_name.to_bytes().len(), endpoint_name_length);\n        assert_eq!(endpoint_name, ENDPOINT_NAME);\n        assert!(!client_service_id.is_null());\n        assert!(!client_auth_public_key.is_null());\n\n        let mut error: *mut GoslingError = ptr::null_mut();\n\n        let mut alice_endpoint_private_key: *mut GoslingEd25519PrivateKey = ptr::null_mut();\n        unsafe {\n            gosling_ed25519_private_key_clone(\n                \u0026mut alice_endpoint_private_key,\n                endpoint_private_key,\n                \u0026mut error,\n            );\n        }\n        assert!(error.is_null());\n        assert!(!alice_endpoint_private_key.is_null());\n        unsafe {\n            ALICE_ENDPOINT_PRIVATE_KEY = alice_endpoint_private_key;\n        }\n\n        let mut pat_identity_service_id: *mut GoslingV3OnionServiceId = ptr::null_mut();\n        unsafe {\n            gosling_v3_onion_service_id_clone(\n                \u0026mut pat_identity_service_id,\n                client_service_id,\n                \u0026mut error,\n            );\n        }\n        assert!(error.is_null());\n        assert!(!pat_identity_service_id.is_null());\n        unsafe {\n            PAT_IDENTITY_SERVICE_ID = pat_identity_service_id;\n        }\n\n        let mut pat_onion_auth_public_key: *mut GoslingX25519PublicKey = ptr::null_mut();\n        unsafe {\n            gosling_x25519_public_key_clone(\n                \u0026mut pat_onion_auth_public_key,\n                client_auth_public_key,\n                \u0026mut error,\n            );\n        }\n        assert!(error.is_null());\n        assert!(!pat_onion_auth_public_key.is_null());\n        unsafe {\n            PAT_ONION_AUTH_PUBLIC_KEY = pat_onion_auth_public_key;\n        }\n\n        println!(\"--- alice identity handshake completed\");\n\n        unsafe {\n            ALICE_ENDPOINT_REQUEST_COMPLETE = true;\n        }\n    }\n    require_noerror!(\n        gosling_context_set_identity_server_handshake_completed_callback(\n            alice_context,\n            Some(alice_identity_server_handshake_completed_callback)\n        )\n    );\n\n    extern \"C\" fn alice_identity_server_handshake_failed_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        error: *const GoslingError,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!error.is_null());\n        let error_message = unsafe {\n            CStr::from_ptr(gosling_error_get_message(error))\n                .to_str()\n                .unwrap()\n        };\n\n        panic!(\"--- alice identity handshake failed: {}\", error_message);\n    }\n    require_noerror!(\n        gosling_context_set_identity_server_handshake_failed_callback(\n            alice_context,\n            Some(alice_identity_server_handshake_failed_callback)\n        )\n    );\n\n    let mut pat_begin_identity_handshake_succeeded = false;\n    for k in 1..=3 {\n        println!(\"--- pat begin identity handshake attempt {}\", k);\n\n        let mut error: *mut GoslingError = ptr::null_mut();\n        gosling_context_begin_identity_handshake(\n            pat_context,\n            alice_identity,\n            ENDPOINT_NAME.as_ptr(),\n            ENDPOINT_NAME.to_bytes().len(),\n            \u0026mut error,\n        );\n\n        if error.is_null() {\n            pat_begin_identity_handshake_succeeded = true;\n            break;\n        } else {\n            let error_message = unsafe {\n                CStr::from_ptr(gosling_error_get_message(error))\n                    .to_str()\n                    .unwrap()\n            };\n            println!(\"--- pat begin identity hanshake failed: {}\", error_message);\n            gosling_error_free(error);\n        }\n    }\n    assert!(pat_begin_identity_handshake_succeeded);\n\n    while unsafe { !ALICE_ENDPOINT_REQUEST_COMPLETE } {\n        require_noerror!(gosling_context_poll_events(alice_context));\n        require_noerror!(gosling_context_poll_events(pat_context));\n    }\n\n    // start alice's enddpoint server\n\n    static mut ALICE_ENDPOINT_PUBLISHED: bool = false;\n    unsafe {\n        ALICE_ENDPOINT_PUBLISHED = false;\n    }\n\n    extern \"C\" fn alice_endpoint_server_published_callback(\n        context: *mut GoslingContext,\n        endpoint_service_id: *const GoslingV3OnionServiceId,\n        endpoint_name: *const c_char,\n        endpoint_name_length: usize,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!endpoint_service_id.is_null());\n        let endpoint_name = unsafe { CStr::from_ptr(endpoint_name) };\n        assert_eq!(endpoint_name.to_bytes().len(), endpoint_name_length);\n        assert_eq!(endpoint_name, ENDPOINT_NAME);\n\n        println!(\"--- alice endpoint server published\");\n        unsafe {\n            ALICE_ENDPOINT_PUBLISHED = true;\n        }\n    }\n    require_noerror!(gosling_context_set_endpoint_server_published_callback(\n        alice_context,\n        Some(alice_endpoint_server_published_callback)\n    ));\n\n    println!(\"--- start init alice endpoint server\");\n    require_noerror!(gosling_context_start_endpoint_server(\n        alice_context,\n        ALICE_ENDPOINT_PRIVATE_KEY,\n        ENDPOINT_NAME.as_ptr(),\n        ENDPOINT_NAME.to_bytes().len(),\n        PAT_IDENTITY_SERVICE_ID,\n        PAT_ONION_AUTH_PUBLIC_KEY\n    ));\n\n    while unsafe { !PAT_ENDPOINT_REQUEST_COMPLETE || !ALICE_ENDPOINT_PUBLISHED } {\n        require_noerror!(gosling_context_poll_events(alice_context));\n        require_noerror!(gosling_context_poll_events(pat_context));\n    }\n\n    #[cfg(target_os = \"windows\")]\n    type TcpSocket = RawSocket;\n    #[cfg(any(target_os = \"linux\", target_os = \"macos\"))]\n    type TcpSocket = RawFd;\n\n    static mut PAT_SOCKET: Option\u003cTcpSocket\u003e = None;\n    static mut ALICE_SOCKET: Option\u003cTcpSocket\u003e = None;\n    unsafe {\n        PAT_SOCKET = None;\n        ALICE_SOCKET = None;\n    }\n\n    extern \"C\" fn pat_enpdoint_client_handshake_completed_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        endpoint_service_id: *const GoslingV3OnionServiceId,\n        channel_name: *const c_char,\n        channel_name_length: usize,\n        stream: TcpSocket,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!endpoint_service_id.is_null());\n        assert!(!channel_name.is_null());\n        let channel_name = unsafe { CStr::from_ptr(channel_name) };\n        assert_eq!(channel_name.to_bytes().len(), channel_name_length);\n        assert_eq!(channel_name, CHANNEL_NAME);\n\n        unsafe {\n            PAT_SOCKET = Some(stream);\n        }\n        println!(\"--- pat endpoint handshake complete\");\n    }\n    require_noerror!(\n        gosling_context_set_endpoint_client_handshake_completed_callback(\n            pat_context,\n            Some(pat_enpdoint_client_handshake_completed_callback)\n        )\n    );\n\n    extern \"C\" fn pat_endpoint_client_handshake_failed_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        error: *const GoslingError,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!error.is_null());\n\n        let error_message = unsafe {\n            CStr::from_ptr(gosling_error_get_message(error))\n                .to_str()\n                .unwrap()\n        };\n        panic!(\"--- pat endpoint handshake failed: {}\", error_message);\n    }\n    require_noerror!(\n        gosling_context_set_endpoint_client_handshake_failed_callback(\n            pat_context,\n            Some(pat_endpoint_client_handshake_failed_callback)\n        )\n    );\n\n    extern \"C\" fn alice_endpoint_server_handshake_completed_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        endpoint_service_id: *const GoslingV3OnionServiceId,\n        client_service_id: *const GoslingV3OnionServiceId,\n        channel_name: *const c_char,\n        channel_name_length: usize,\n        stream: TcpSocket,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!endpoint_service_id.is_null());\n        assert!(!client_service_id.is_null());\n        assert!(!channel_name.is_null());\n        let channel_name = unsafe { CStr::from_ptr(channel_name) };\n        assert_eq!(channel_name.to_bytes().len(), channel_name_length);\n        assert_eq!(channel_name, CHANNEL_NAME);\n\n        unsafe { ALICE_SOCKET = Some(stream) };\n        println!(\"--- alice endpoint hanshake complete\");\n    }\n    require_noerror!(\n        gosling_context_set_endpoint_server_handshake_completed_callback(\n            alice_context,\n            Some(alice_endpoint_server_handshake_completed_callback)\n        )\n    );\n\n    extern \"C\" fn alice_endpoint_server_handshake_failed_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        error: *const GoslingError,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!error.is_null());\n\n        let error_message = unsafe {\n            CStr::from_ptr(gosling_error_get_message(error))\n                .to_str()\n                .unwrap()\n        };\n        panic!(\"--- alice endpoint handshake failed: {}\", error_message);\n    }\n    require_noerror!(\n        gosling_context_set_endpoint_server_handshake_failed_callback(\n            alice_context,\n            Some(alice_endpoint_server_handshake_failed_callback)\n        )\n    );\n\n    let mut pat_begin_endpoint_handshake_succeeded = false;\n    for k in 1..=3 {\n        println!(\"--- pat begin endpoint handshake attempt {}\", k);\n\n        let mut error: *mut GoslingError = ptr::null_mut();\n        unsafe {\n            gosling_context_begin_endpoint_handshake(\n                pat_context,\n                ALICE_ENDPOINT_SERVICE_ID,\n                PAT_ONION_AUTH_PRIVATE_KEY,\n                CHANNEL_NAME.as_ptr(),\n                CHANNEL_NAME.to_bytes().len(),\n                \u0026mut error,\n            );\n        }\n\n        if error.is_null() {\n            pat_begin_endpoint_handshake_succeeded = true;\n            break;\n        } else {\n            let error_message = unsafe {\n                CStr::from_ptr(gosling_error_get_message(error))\n                    .to_str()\n                    .unwrap()\n            };\n            println!(\"--- pat begin endpoint hanshake failed: {}\", error_message);\n            gosling_error_free(error);\n        }\n    }\n    assert!(pat_begin_endpoint_handshake_succeeded);\n\n    while unsafe { PAT_SOCKET.is_none() || ALICE_SOCKET.is_none() } {\n        require_noerror!(gosling_context_poll_events(alice_context));\n        require_noerror!(gosling_context_poll_events(pat_context));\n    }\n\n    #[cfg(unix)]\n    let (mut pat_stream, alice_stream) = unsafe {\n        (\n            TcpStream::from_raw_fd(PAT_SOCKET.unwrap()),\n            TcpStream::from_raw_fd(ALICE_SOCKET.unwrap()),\n        )\n    };\n    #[cfg(windows)]\n    let (mut pat_stream, alice_stream) = unsafe {\n        (\n            TcpStream::from_raw_socket(PAT_SOCKET.unwrap()),\n            TcpStream::from_raw_socket(ALICE_SOCKET.unwrap()),\n        )\n    };\n\n    println!(\"--- pat writes message\");\n\n    static MESSAGE: \u0026str = \"Hello Alice!\\n\";\n\n    pat_stream.write(MESSAGE.as_bytes())?;\n    pat_stream.flush()?;\n\n    println!(\"--- alice waits for message\");\n\n    alice_stream.set_nonblocking(false)?;\n    let mut alice_reader = BufReader::new(alice_stream);\n    let mut alice_read_string: String = Default::default();\n    let mut alice_message_read: bool = false;\n    while !alice_message_read {\n        match alice_reader.read_line(\u0026mut alice_read_string) {\n            Ok(0) =\u003e {\n                println!(\"--- alice reads 0\");\n            }\n            Ok(val) =\u003e {\n                assert_eq!(val, MESSAGE.len());\n                assert_eq!(alice_read_string, MESSAGE);\n                // remove trailing new-line\n                alice_read_string.truncate(alice_read_string.len() - 1);\n\n                println!(\"--- alice received '{}'\", alice_read_string);\n                alice_message_read = true;\n            }\n            Err(err) =\u003e bail!(\"{}\", err),\n        }\n    }\n\n    // we have to free gosling library at the end or else the backing TorProvider will go away\n    // and then pat_stream and alice_stream will no longer be valid\n    println!(\"--- free gosling library\");\n    gosling_library_free(library);\n\n    Ok(())\n}\n","traces":[{"line":29,"address":[1709956,1712084,1716575],"length":1,"stats":{"Line":3}},{"line":30,"address":[1693648,1700057,1703738,1700932,1701668,1689099,1697384,1689772,1688652,1694511,1691430,1704601,1692350,1698640,1702440],"length":1,"stats":{"Line":47}},{"line":31,"address":[1700960,1701696,1703851,1697614,1694531,1689116,1702460,1691567,1704621,1698753,1700194,1692370,1693761,1688661,1689789],"length":1,"stats":{"Line":47}},{"line":32,"address":[1701713,1689811,1702485,1689138,1704646,1688677,1692395,1698778,1700224,1693791,1694556,1697639,1700977,1703881,1691597],"length":1,"stats":{"Line":47}},{"line":33,"address":[1694589,1692434,1698817,1702524,1700263,1690031,1701752,1703914,1701016,1704679,1688733,1691636,1689382,1697678,1693824],"length":1,"stats":{"Line":0}},{"line":34,"address":[1701848,1700291,1701238,1699153,1694617,1701112,1691979,1689410,1697900,1702860,1688941,1693852,1691858,1697706,1698906,1699032,1693908,1704124,1701359,1688850,1702739,1689605,1703942,1698021,1688758,1694930,1700485,1704773,1705020,1698845,1690151,1702613,1692649,1692770,1694155,1694809,1702095,1704245,1700359,1697774,1700606,1692462,1694034,1701974,1690254,1691664,1704707,1694683,1701780,1689502,1692523,1702552,1704899,1701044,1703998,1691732,1690059],"length":1,"stats":{"Line":0}},{"line":35,"address":[1692778,1694163,1691987,1694938,1689613,1698029,1704253,1705028,1699161,1700614,1701367,1702103,1702868,1690262,1688949],"length":1,"stats":{"Line":0}},{"line":36,"address":[1689325,1689990,1690544,1703128,1699178,1701627,1694180,1692795,1702363,1690394,1692264,1698046,1704524,1701384,1693038,1695214,1702885,1689165,1700891,1689630,1694434,1689838,1694955,1700631,1688963,1699438,1704270,1705045,1692004,1698306,1705304,1702120,1690279],"length":1,"stats":{"Line":0}},{"line":60,"address":[1710652,1709936],"length":1,"stats":{"Line":1}},{"line":61,"address":[1711271,1711232],"length":1,"stats":{"Line":1}},{"line":67,"address":[1711284,1711333,1711256],"length":1,"stats":{"Line":2}},{"line":68,"address":[1711290,1711363],"length":1,"stats":{"Line":1}},{"line":72,"address":[1710021],"length":1,"stats":{"Line":1}},{"line":79,"address":[1711522,1711440],"length":1,"stats":{"Line":1}},{"line":87,"address":[1711507,1711535,1711557],"length":1,"stats":{"Line":2}},{"line":88,"address":[1711594,1711546,1711649],"length":1,"stats":{"Line":2}},{"line":89,"address":[1711679,1711600],"length":1,"stats":{"Line":1}},{"line":91,"address":[1711736],"length":1,"stats":{"Line":1}},{"line":93,"address":[1711798],"length":1,"stats":{"Line":1}},{"line":94,"address":[1711915,1711966],"length":1,"stats":{"Line":1}},{"line":102,"address":[1712024],"length":1,"stats":{"Line":1}},{"line":104,"address":[1710409],"length":1,"stats":{"Line":1}},{"line":111,"address":[1711017],"length":1,"stats":{"Line":1}},{"line":114,"address":[1712064,1712846],"length":1,"stats":{"Line":1}},{"line":115,"address":[1715351,1715312],"length":1,"stats":{"Line":1}},{"line":120,"address":[1715336,1715364,1715390],"length":1,"stats":{"Line":2}},{"line":121,"address":[1715442,1715375,1715424],"length":1,"stats":{"Line":2}},{"line":125,"address":[1712197],"length":1,"stats":{"Line":1}},{"line":130,"address":[1715488,1715544],"length":1,"stats":{"Line":1}},{"line":136,"address":[1715557,1715585,1715529],"length":1,"stats":{"Line":2}},{"line":137,"address":[1715568,1715628],"length":1,"stats":{"Line":2}},{"line":138,"address":[1715638],"length":1,"stats":{"Line":1}},{"line":139,"address":[1715760],"length":1,"stats":{"Line":1}},{"line":144,"address":[1712603],"length":1,"stats":{"Line":1}},{"line":151,"address":[1715808,1715837],"length":1,"stats":{"Line":1}},{"line":155,"address":[1715822,1715866,1715850],"length":1,"stats":{"Line":2}},{"line":158,"address":[1713255],"length":1,"stats":{"Line":1}},{"line":163,"address":[1715904,1715954],"length":1,"stats":{"Line":1}},{"line":169,"address":[1715967,1715989,1715939],"length":1,"stats":{"Line":2}},{"line":170,"address":[1716081,1715978,1716026],"length":1,"stats":{"Line":2}},{"line":171,"address":[1716111,1716032],"length":1,"stats":{"Line":1}},{"line":174,"address":[1716168],"length":1,"stats":{"Line":1}},{"line":176,"address":[1716220],"length":1,"stats":{"Line":1}},{"line":178,"address":[1713883],"length":1,"stats":{"Line":1}},{"line":185,"address":[1716321,1716272],"length":1,"stats":{"Line":1}},{"line":191,"address":[1716306,1716356,1716334],"length":1,"stats":{"Line":2}},{"line":192,"address":[1716412,1716345,1716393],"length":1,"stats":{"Line":2}},{"line":193,"address":[1716404],"length":1,"stats":{"Line":1}},{"line":194,"address":[1716473],"length":1,"stats":{"Line":0}},{"line":198,"address":[1716490,1716452],"length":1,"stats":{"Line":2}},{"line":200,"address":[1716500],"length":1,"stats":{"Line":1}},{"line":205,"address":[1714511],"length":1,"stats":{"Line":1}},{"line":212,"address":[1715095],"length":1,"stats":{"Line":1}},{"line":215,"address":[1717161,1716560],"length":1,"stats":{"Line":1}},{"line":216,"address":[1717200,1717269],"length":1,"stats":{"Line":1}},{"line":223,"address":[1717308,1717282,1717254],"length":1,"stats":{"Line":2}},{"line":224,"address":[1717293,1717371,1717345],"length":1,"stats":{"Line":2}},{"line":225,"address":[1717356,1717436,1717408],"length":1,"stats":{"Line":2}},{"line":226,"address":[1717419,1717479],"length":1,"stats":{"Line":2}},{"line":227,"address":[1717489],"length":1,"stats":{"Line":1}},{"line":228,"address":[1717611],"length":1,"stats":{"Line":1}},{"line":233,"address":[1716624],"length":1,"stats":{"Line":1}},{"line":240,"address":[1716968],"length":1,"stats":{"Line":1}},{"line":428,"address":[1717664,1718514],"length":1,"stats":{"Line":1}},{"line":431,"address":[1717671],"length":1,"stats":{"Line":1}},{"line":432,"address":[1717740],"length":1,"stats":{"Line":1}},{"line":435,"address":[1718224],"length":1,"stats":{"Line":1}},{"line":437,"address":[1718299],"length":1,"stats":{"Line":1}},{"line":440,"address":[1718560,1719956],"length":1,"stats":{"Line":1}},{"line":447,"address":[1718645],"length":1,"stats":{"Line":1}},{"line":448,"address":[1719208],"length":1,"stats":{"Line":1}},{"line":451,"address":[1719660],"length":1,"stats":{"Line":1}},{"line":452,"address":[1719708],"length":1,"stats":{"Line":1}},{"line":457,"address":[1720373],"length":1,"stats":{"Line":1}},{"line":458,"address":[1720421],"length":1,"stats":{"Line":1}},{"line":466,"address":[1721358,1721023],"length":1,"stats":{"Line":1}},{"line":467,"address":[1721552,1721295],"length":1,"stats":{"Line":1}},{"line":470,"address":[1721399],"length":1,"stats":{"Line":1}},{"line":471,"address":[1721458],"length":1,"stats":{"Line":1}},{"line":474,"address":[1721953],"length":1,"stats":{"Line":1}},{"line":475,"address":[1722001],"length":1,"stats":{"Line":1}},{"line":480,"address":[1722631],"length":1,"stats":{"Line":1}},{"line":481,"address":[1722679],"length":1,"stats":{"Line":1}},{"line":489,"address":[1723281,1723688],"length":1,"stats":{"Line":1}},{"line":494,"address":[1723553],"length":1,"stats":{"Line":1}},{"line":496,"address":[1744752,1744776],"length":1,"stats":{"Line":1}},{"line":497,"address":[1744761,1744824,1744789],"length":1,"stats":{"Line":2}},{"line":498,"address":[1744795],"length":1,"stats":{"Line":1}},{"line":499,"address":[1744854],"length":1,"stats":{"Line":1}},{"line":501,"address":[1723627],"length":1,"stats":{"Line":1}},{"line":506,"address":[1724065],"length":1,"stats":{"Line":1}},{"line":507,"address":[1724136],"length":1,"stats":{"Line":1}},{"line":508,"address":[1724723],"length":1,"stats":{"Line":1}},{"line":509,"address":[1725005],"length":1,"stats":{"Line":1}},{"line":514,"address":[1725054],"length":1,"stats":{"Line":1}},{"line":516,"address":[1744936,1744912],"length":1,"stats":{"Line":1}},{"line":517,"address":[1744978,1744921,1744949],"length":1,"stats":{"Line":2}},{"line":518,"address":[1744955,1745008],"length":1,"stats":{"Line":2}},{"line":520,"address":[1745024],"length":1,"stats":{"Line":1}},{"line":522,"address":[1725128],"length":1,"stats":{"Line":1}},{"line":527,"address":[1726066],"length":1,"stats":{"Line":1}},{"line":528,"address":[1726137],"length":1,"stats":{"Line":1}},{"line":530,"address":[1726724],"length":1,"stats":{"Line":1}},{"line":531,"address":[1727006],"length":1,"stats":{"Line":1}},{"line":537,"address":[1727055],"length":1,"stats":{"Line":1}},{"line":539,"address":[1745072,1745096],"length":1,"stats":{"Line":1}},{"line":540,"address":[1745081,1745138,1745109],"length":1,"stats":{"Line":2}},{"line":542,"address":[1745115,1745168],"length":1,"stats":{"Line":2}},{"line":544,"address":[1745184],"length":1,"stats":{"Line":1}},{"line":546,"address":[1727129],"length":1,"stats":{"Line":1}},{"line":551,"address":[1728067],"length":1,"stats":{"Line":1}},{"line":552,"address":[1728138],"length":1,"stats":{"Line":1}},{"line":553,"address":[1728725],"length":1,"stats":{"Line":1}},{"line":554,"address":[1729007],"length":1,"stats":{"Line":1}},{"line":563,"address":[1729056],"length":1,"stats":{"Line":1}},{"line":564,"address":[1729087],"length":1,"stats":{"Line":1}},{"line":565,"address":[1729122],"length":1,"stats":{"Line":1}},{"line":568,"address":[1745232,1745327],"length":1,"stats":{"Line":1}},{"line":577,"address":[1745340,1745366,1745312],"length":1,"stats":{"Line":2}},{"line":578,"address":[1745403,1745429,1745351],"length":1,"stats":{"Line":2}},{"line":579,"address":[1745414,1745466,1745492],"length":1,"stats":{"Line":2}},{"line":580,"address":[1745477,1745529,1745557],"length":1,"stats":{"Line":2}},{"line":581,"address":[1745540,1745600],"length":1,"stats":{"Line":2}},{"line":582,"address":[1745610],"length":1,"stats":{"Line":1}},{"line":583,"address":[1745743],"length":1,"stats":{"Line":1}},{"line":584,"address":[1745907,1745856],"length":1,"stats":{"Line":1}},{"line":586,"address":[1745940],"length":1,"stats":{"Line":1}},{"line":588,"address":[1745981],"length":1,"stats":{"Line":1}},{"line":596,"address":[1746018],"length":1,"stats":{"Line":1}},{"line":597,"address":[1746084,1746158],"length":1,"stats":{"Line":1}},{"line":599,"address":[1746117],"length":1,"stats":{"Line":1}},{"line":602,"address":[1746196],"length":1,"stats":{"Line":1}},{"line":610,"address":[1746233],"length":1,"stats":{"Line":1}},{"line":611,"address":[1746299,1746373],"length":1,"stats":{"Line":1}},{"line":613,"address":[1746332],"length":1,"stats":{"Line":1}},{"line":616,"address":[1746347,1746406],"length":1,"stats":{"Line":2}},{"line":619,"address":[1746425],"length":1,"stats":{"Line":1}},{"line":622,"address":[1729177],"length":1,"stats":{"Line":1}},{"line":629,"address":[1746448,1746524],"length":1,"stats":{"Line":0}},{"line":634,"address":[1746563,1746484,1746537],"length":1,"stats":{"Line":0}},{"line":635,"address":[1746640,1746600,1746548],"length":1,"stats":{"Line":0}},{"line":637,"address":[1746683,1746611,1746860],"length":1,"stats":{"Line":0}},{"line":642,"address":[1746971],"length":1,"stats":{"Line":0}},{"line":644,"address":[1730159],"length":1,"stats":{"Line":1}},{"line":656,"address":[1730764],"length":1,"stats":{"Line":1}},{"line":657,"address":[1730795],"length":1,"stats":{"Line":1}},{"line":658,"address":[1730830],"length":1,"stats":{"Line":1}},{"line":659,"address":[1730865],"length":1,"stats":{"Line":1}},{"line":662,"address":[1747056,1747151],"length":1,"stats":{"Line":1}},{"line":671,"address":[1747190,1747136,1747164],"length":1,"stats":{"Line":2}},{"line":672,"address":[1747253,1747227,1747175],"length":1,"stats":{"Line":2}},{"line":673,"address":[1747238,1747318,1747290],"length":1,"stats":{"Line":2}},{"line":674,"address":[1747301,1747361],"length":1,"stats":{"Line":2}},{"line":675,"address":[1747371],"length":1,"stats":{"Line":1}},{"line":676,"address":[1747510],"length":1,"stats":{"Line":1}},{"line":677,"address":[1747623,1747668],"length":1,"stats":{"Line":1}},{"line":678,"address":[1747737,1747705,1747653],"length":1,"stats":{"Line":2}},{"line":680,"address":[1747770],"length":1,"stats":{"Line":1}},{"line":682,"address":[1747811],"length":1,"stats":{"Line":1}},{"line":690,"address":[1747848],"length":1,"stats":{"Line":1}},{"line":691,"address":[1747914,1747988],"length":1,"stats":{"Line":1}},{"line":693,"address":[1747947],"length":1,"stats":{"Line":1}},{"line":696,"address":[1748026],"length":1,"stats":{"Line":1}},{"line":704,"address":[1748063],"length":1,"stats":{"Line":1}},{"line":705,"address":[1748129,1748203],"length":1,"stats":{"Line":1}},{"line":707,"address":[1748162],"length":1,"stats":{"Line":1}},{"line":710,"address":[1748241],"length":1,"stats":{"Line":1}},{"line":718,"address":[1748278],"length":1,"stats":{"Line":1}},{"line":719,"address":[1748344,1748418],"length":1,"stats":{"Line":1}},{"line":721,"address":[1748377],"length":1,"stats":{"Line":1}},{"line":724,"address":[1748392,1748451],"length":1,"stats":{"Line":2}},{"line":727,"address":[1748470],"length":1,"stats":{"Line":1}},{"line":730,"address":[1730912],"length":1,"stats":{"Line":1}},{"line":737,"address":[1748496,1748572],"length":1,"stats":{"Line":0}},{"line":742,"address":[1748611,1748532,1748585],"length":1,"stats":{"Line":0}},{"line":743,"address":[1748596,1748648,1748688],"length":1,"stats":{"Line":0}},{"line":745,"address":[1748731,1748908,1748659],"length":1,"stats":{"Line":0}},{"line":750,"address":[1749019],"length":1,"stats":{"Line":0}},{"line":752,"address":[1731561],"length":1,"stats":{"Line":1}},{"line":759,"address":[1732174],"length":1,"stats":{"Line":1}},{"line":760,"address":[1732182,1732525,1732466],"length":1,"stats":{"Line":3}},{"line":761,"address":[1732649],"length":1,"stats":{"Line":1}},{"line":763,"address":[1732748],"length":1,"stats":{"Line":1}},{"line":765,"address":[1732760],"length":1,"stats":{"Line":1}},{"line":766,"address":[1732776],"length":1,"stats":{"Line":1}},{"line":767,"address":[1732792],"length":1,"stats":{"Line":1}},{"line":768,"address":[1732819],"length":1,"stats":{"Line":1}},{"line":772,"address":[1732879],"length":1,"stats":{"Line":1}},{"line":773,"address":[1733307],"length":1,"stats":{"Line":1}},{"line":777,"address":[1732901,1733087],"length":1,"stats":{"Line":0}},{"line":781,"address":[1733213],"length":1,"stats":{"Line":0}},{"line":782,"address":[1733288],"length":1,"stats":{"Line":0}},{"line":785,"address":[1732506,1733320],"length":1,"stats":{"Line":1}},{"line":787,"address":[1733348],"length":1,"stats":{"Line":1}},{"line":788,"address":[1733508],"length":1,"stats":{"Line":1}},{"line":789,"address":[1743967],"length":1,"stats":{"Line":1}},{"line":796,"address":[1733360],"length":1,"stats":{"Line":1}},{"line":799,"address":[1749104,1749165],"length":1,"stats":{"Line":1}},{"line":805,"address":[1749178,1749204,1749150],"length":1,"stats":{"Line":2}},{"line":806,"address":[1749189,1749241,1749269],"length":1,"stats":{"Line":2}},{"line":807,"address":[1749312,1749252],"length":1,"stats":{"Line":2}},{"line":808,"address":[1749322],"length":1,"stats":{"Line":1}},{"line":809,"address":[1749449],"length":1,"stats":{"Line":1}},{"line":811,"address":[1749557],"length":1,"stats":{"Line":1}},{"line":813,"address":[1749602],"length":1,"stats":{"Line":1}},{"line":816,"address":[1733411],"length":1,"stats":{"Line":1}},{"line":821,"address":[1733893],"length":1,"stats":{"Line":1}},{"line":822,"address":[1734022],"length":1,"stats":{"Line":1}},{"line":831,"address":[1734665,1734888],"length":1,"stats":{"Line":2}},{"line":832,"address":[1735144],"length":1,"stats":{"Line":1}},{"line":833,"address":[1742836],"length":1,"stats":{"Line":1}},{"line":844,"address":[1734929],"length":1,"stats":{"Line":1}},{"line":845,"address":[1734966],"length":1,"stats":{"Line":1}},{"line":848,"address":[1749714,1749632],"length":1,"stats":{"Line":1}},{"line":856,"address":[1749727,1749699,1749753],"length":1,"stats":{"Line":2}},{"line":857,"address":[1749738,1749790,1749816],"length":1,"stats":{"Line":2}},{"line":858,"address":[1749801,1749881,1749853],"length":1,"stats":{"Line":2}},{"line":859,"address":[1749864,1749924],"length":1,"stats":{"Line":2}},{"line":860,"address":[1749934],"length":1,"stats":{"Line":1}},{"line":861,"address":[1750061],"length":1,"stats":{"Line":1}},{"line":864,"address":[1750173],"length":1,"stats":{"Line":1}},{"line":866,"address":[1750217],"length":1,"stats":{"Line":1}},{"line":868,"address":[1735047],"length":1,"stats":{"Line":1}},{"line":875,"address":[1750272,1750348],"length":1,"stats":{"Line":0}},{"line":880,"address":[1750387,1750308,1750361],"length":1,"stats":{"Line":0}},{"line":881,"address":[1750372,1750424,1750464],"length":1,"stats":{"Line":0}},{"line":884,"address":[1750507,1750435,1750684],"length":1,"stats":{"Line":0}},{"line":888,"address":[1750795],"length":1,"stats":{"Line":0}},{"line":890,"address":[1735573],"length":1,"stats":{"Line":1}},{"line":897,"address":[1750880,1750973],"length":1,"stats":{"Line":1}},{"line":906,"address":[1750958,1750986,1751012],"length":1,"stats":{"Line":2}},{"line":907,"address":[1751075,1750997,1751049],"length":1,"stats":{"Line":2}},{"line":908,"address":[1751112,1751138,1751060],"length":1,"stats":{"Line":2}},{"line":909,"address":[1751123,1751175,1751203],"length":1,"stats":{"Line":2}},{"line":910,"address":[1751246,1751186],"length":1,"stats":{"Line":2}},{"line":911,"address":[1751256],"length":1,"stats":{"Line":1}},{"line":912,"address":[1751383],"length":1,"stats":{"Line":1}},{"line":914,"address":[1751495],"length":1,"stats":{"Line":1}},{"line":915,"address":[1751539],"length":1,"stats":{"Line":1}},{"line":917,"address":[1736222],"length":1,"stats":{"Line":1}},{"line":924,"address":[1751600,1751676],"length":1,"stats":{"Line":0}},{"line":929,"address":[1751636,1751689,1751715],"length":1,"stats":{"Line":0}},{"line":930,"address":[1751752,1751700,1751792],"length":1,"stats":{"Line":0}},{"line":933,"address":[1752012,1751763,1751835],"length":1,"stats":{"Line":0}},{"line":937,"address":[1752123],"length":1,"stats":{"Line":0}},{"line":939,"address":[1736863],"length":1,"stats":{"Line":1}},{"line":946,"address":[1737476],"length":1,"stats":{"Line":1}},{"line":947,"address":[1737827,1737768,1737484],"length":1,"stats":{"Line":3}},{"line":948,"address":[1737951],"length":1,"stats":{"Line":1}},{"line":950,"address":[1738050],"length":1,"stats":{"Line":1}},{"line":953,"address":[1738062],"length":1,"stats":{"Line":1}},{"line":954,"address":[1738078],"length":1,"stats":{"Line":1}},{"line":955,"address":[1738093],"length":1,"stats":{"Line":1}},{"line":956,"address":[1738108],"length":1,"stats":{"Line":1}},{"line":957,"address":[1738135],"length":1,"stats":{"Line":1}},{"line":962,"address":[1738203],"length":1,"stats":{"Line":1}},{"line":963,"address":[1738631],"length":1,"stats":{"Line":1}},{"line":967,"address":[1738411,1738225],"length":1,"stats":{"Line":0}},{"line":971,"address":[1738537],"length":1,"stats":{"Line":0}},{"line":972,"address":[1738612],"length":1,"stats":{"Line":0}},{"line":975,"address":[1738644,1737808],"length":1,"stats":{"Line":1}},{"line":977,"address":[1738672],"length":1,"stats":{"Line":1}},{"line":978,"address":[1738935],"length":1,"stats":{"Line":1}},{"line":979,"address":[1741705],"length":1,"stats":{"Line":1}},{"line":985,"address":[1738733,1738802],"length":1,"stats":{"Line":2}},{"line":986,"address":[1738814,1739035],"length":1,"stats":{"Line":2}},{"line":997,"address":[1739085,1739152],"length":1,"stats":{"Line":2}},{"line":1001,"address":[1741220,1739171,1739393],"length":1,"stats":{"Line":1}},{"line":1002,"address":[1739446,1739378,1739536,1741199],"length":1,"stats":{"Line":2}},{"line":1004,"address":[1739510,1739581],"length":1,"stats":{"Line":2}},{"line":1006,"address":[1718621,1741178,1739731,1739600],"length":1,"stats":{"Line":2}},{"line":1007,"address":[1739701],"length":1,"stats":{"Line":1}},{"line":1008,"address":[1739784],"length":1,"stats":{"Line":1}},{"line":1009,"address":[1739831],"length":1,"stats":{"Line":1}},{"line":1010,"address":[1739839],"length":1,"stats":{"Line":1}},{"line":1011,"address":[1739977,1739865],"length":1,"stats":{"Line":2}},{"line":1013,"address":[1740226,1740155],"length":1,"stats":{"Line":0}},{"line":1015,"address":[1740181],"length":1,"stats":{"Line":1}},{"line":1016,"address":[1740197,1740258],"length":1,"stats":{"Line":2}},{"line":1017,"address":[1740394],"length":1,"stats":{"Line":1}},{"line":1019,"address":[1740519],"length":1,"stats":{"Line":1}},{"line":1021,"address":[1740705],"length":1,"stats":{"Line":1}},{"line":1022,"address":[1740774],"length":1,"stats":{"Line":1}},{"line":1024,"address":[1740787,1740024,1740952],"length":1,"stats":{"Line":0}},{"line":1030,"address":[1741061,1739888],"length":1,"stats":{"Line":2}},{"line":1031,"address":[1741088],"length":1,"stats":{"Line":1}},{"line":1033,"address":[1741097],"length":1,"stats":{"Line":1}}],"covered":254,"coverable":287},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling-proc-macros","src","lib.rs"],"content":"use proc_macro::TokenStream;\nuse quote::quote;\nuse syn::{parse_macro_input, ItemFn};\n\n// This macro renames a function call to a _impl variant.\n//\n// Why is this necessary? Basically, cargo  cannot currently be relied\n// on to build cdylibs correctly due to various issues limited to but\n// probably not including:\n// - not setting soname for linux shared libraries\n// - naming import libs incorrectly for mingw windows\n// - not generating correct symlinks based on version and major version for linux and macos\n//\n// The recommended solution is to use the cdylib_link_lines crate to work around\n// some of these problems, but I've run into other fun issues with that crate:\n// - import libs output to wrong directory for mingw windows\n// - import_name being set incorrectly for macos\n// - hasn't been updated in some years and seems abandoned\n//\n// So now dear reader, we come to this monstrosity. This is just one part of\n// the rest of the build system hack to solve all the above problems; namely\n// we will only use rustc to generate a static library, and from there build\n// a shared library using native C tools via CMake which handles all of the\n// above problems.\n//\n// So we need to build our cgosling crate as a static lib twice: first with the\n// ordinary functions names and second with the functions renamed in the form\n// foo() to foo_impl(). The foo_impl() variant will then be linked into a shared\n// library and called through exported functions of the foo() variety using\n// the ordinary toolchain.\n//\n// The cgosling shared library target will call the underlying functions via simple\n// passthrough with the final (logical) call chain being like a so:\n// - shared_library::foo() -\u003e static_library::foo_impl()\n//\n// Static library callers will have the following call chain:\n// - static_library::foo()\n//\n// I'm sorry it had to be this way\n#[proc_macro_attribute]\npub fn rename_impl(_attr: TokenStream, item: TokenStream) -\u003e TokenStream {\n    // parse the input as a function\n    let mut impl_fn: ItemFn = parse_macro_input!(item);\n\n    // append \"_impl\" to the original function name for the _impl function\n    impl_fn.sig.ident = syn::Ident::new(\n        \u0026format!(\"{}_impl\", impl_fn.sig.ident),\n        impl_fn.sig.ident.span(),\n    );\n\n    let expanded = quote! {\n        #impl_fn\n    };\n\n    // Return the combined TokenStream\n    TokenStream::from(expanded)\n}\n","traces":[{"line":41,"address":[260226,259264,260342],"length":1,"stats":{"Line":0}},{"line":43,"address":[260235,259516,259290,259338],"length":1,"stats":{"Line":0}},{"line":46,"address":[259866,259986],"length":1,"stats":{"Line":0}},{"line":47,"address":[259619,259748,259417],"length":1,"stats":{"Line":0}},{"line":48,"address":[259829],"length":1,"stats":{"Line":0}},{"line":51,"address":[260037],"length":1,"stats":{"Line":0}},{"line":56,"address":[260156],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":7},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","fuzz","fuzz_targets","arbitrary_types.rs"],"content":"// extern\nuse bson::Document;\nuse bson::spec::BinarySubtype::Generic;\nuse curve25519_dalek::Scalar;\nuse tor_interface::tor_crypto::*;\n\n// fuzzing\nuse libfuzzer_sys::arbitrary;\nuse libfuzzer_sys::arbitrary::{Arbitrary, Error, Unstructured};\n\n// Generate Arbitray Types\n\n// Ed25519 Private Key\n#[derive(Debug)]\npub(crate) struct ArbitraryEd25519PrivateKey {\n    pub value: Ed25519PrivateKey,\n}\n\nimpl\u003c'a\u003e Arbitrary\u003c'a\u003e for ArbitraryEd25519PrivateKey {\n    fn arbitrary(u: \u0026mut Unstructured\u003c'a\u003e) -\u003e Result\u003cSelf, Error\u003e {\n        // expanded secret key raw bytes\n        let mut raw: [u8; 64] = [0u8; 64];\n\n        // construct a valid Scalar\n        let mut scalar: [u8; 32] = [0u8; 32];\n        u.fill_buffer(\u0026mut scalar)?;\n\n        scalar = curve25519_dalek::scalar::clamp_integer(scalar.clone());\n        scalar = Scalar::from_bytes_mod_order(scalar).to_bytes();\n        raw[00..32].copy_from_slice(\u0026scalar);\n\n        let mut hash: [u8; 32] = [0u8; 32];\n        u.fill_buffer(\u0026mut hash)?;\n\n        raw[32..64].copy_from_slice(\u0026hash);\n\n        let value = Ed25519PrivateKey::from_raw(\u0026raw).unwrap();\n\n        Ok(ArbitraryEd25519PrivateKey{value})\n    }\n}\n\n// Ed25519 Public Key\n#[derive(Debug)]\npub(crate) struct ArbitraryEd25519PublicKey {\n    pub value: Ed25519PublicKey,\n}\n\nimpl\u003c'a\u003e Arbitrary\u003c'a\u003e for ArbitraryEd25519PublicKey {\n    fn arbitrary(u: \u0026mut Unstructured\u003c'a\u003e) -\u003e Result\u003cSelf, Error\u003e {\n        let private = ArbitraryEd25519PrivateKey::arbitrary(u)?;\n        let value = Ed25519PublicKey::from_private_key(\u0026private.value);\n\n        Ok(ArbitraryEd25519PublicKey{value})\n    }\n}\n\n// Ed25519 Signature\n#[derive(Debug)]\npub(crate) struct ArbitraryEd25519Signature {\n    pub value: Ed25519Signature,\n}\n\nimpl\u003c'a\u003e Arbitrary\u003c'a\u003e for ArbitraryEd25519Signature {\n    fn arbitrary(u: \u0026mut Unstructured\u003c'a\u003e) -\u003e Result\u003cSelf, Error\u003e {\n        let mut message: [u8; 32] = [0u8; 32];\n        u.fill_buffer(\u0026mut message)?;\n\n        let private = ArbitraryEd25519PrivateKey::arbitrary(u)?;\n        let value = private.value.sign_message(\u0026message);\n\n        Ok(ArbitraryEd25519Signature{value})\n    }\n}\n\n// V3OnionServicId\n// x25519 Private Key\n#[derive(Debug)]\npub(crate) struct ArbitraryV3OnionServiceId {\n    pub value: V3OnionServiceId,\n}\n\nimpl\u003c'a\u003e Arbitrary\u003c'a\u003e for ArbitraryV3OnionServiceId {\n    fn arbitrary(u: \u0026mut Unstructured\u003c'a\u003e) -\u003e Result\u003cSelf, Error\u003e {\n        let private = ArbitraryEd25519PrivateKey::arbitrary(u)?;\n        let value = V3OnionServiceId::from_private_key(\u0026private.value);\n\n        Ok(ArbitraryV3OnionServiceId{value})\n    }\n}\n\n// x25519 Private Key\n#[derive(Debug)]\npub(crate) struct ArbitraryX25519PrivateKey {\n    pub value: X25519PrivateKey,\n}\n\nimpl\u003c'a\u003e Arbitrary\u003c'a\u003e for ArbitraryX25519PrivateKey {\n    fn arbitrary(u: \u0026mut Unstructured\u003c'a\u003e) -\u003e Result\u003cSelf, Error\u003e {\n        let mut raw: [u8; 32] = [0u8; 32];\n        u.fill_buffer(\u0026mut raw)?;\n\n        raw[0] \u0026= 240;\n        raw[31] \u0026= 127;\n        raw[31] |= 64;\n\n        let value = X25519PrivateKey::from_raw(\u0026raw).unwrap();\n\n        Ok(ArbitraryX25519PrivateKey{value})\n    }\n}\n\n// x25519 Public Key\n#[derive(Debug)]\npub(crate) struct ArbitraryX25519PublicKey {\n    pub value: X25519PublicKey,\n}\n\nimpl\u003c'a\u003e Arbitrary\u003c'a\u003e for ArbitraryX25519PublicKey {\n    fn arbitrary(u: \u0026mut Unstructured\u003c'a\u003e) -\u003e Result\u003cSelf, Error\u003e {\n        let mut raw: [u8; 32] = [0u8; 32];\n        u.fill_buffer(\u0026mut raw)?;\n\n        let value = X25519PublicKey::from_raw(\u0026raw);\n\n        Ok(ArbitraryX25519PublicKey{value})\n    }\n}\n\n// Bson\n#[derive(Debug)]\npub(crate) struct ArbitraryBSON {\n    pub value: bson::Bson,\n}\n\nimpl\u003c'a\u003e Arbitrary\u003c'a\u003e for ArbitraryBSON {\n    fn arbitrary(u: \u0026mut Unstructured\u003c'a\u003e) -\u003e Result\u003cSelf, Error\u003e {\n        #[derive(Arbitrary)]\n        enum BSONType {\n            Null, // 0\n            Boolean, // 1\n            Int32, // 2\n            Int64, // 3\n            Double, // 4\n            String, // 5\n            Binary, // 6\n            Array, // 7\n            Document, // 8\n        }\n\n        let value = match BSONType::arbitrary(u)? {\n            BSONType::Null =\u003e bson::Bson::Null,\n            BSONType::Boolean =\u003e bson::Bson::Boolean(bool::arbitrary(u)?),\n            BSONType::Int32 =\u003e bson::Bson::Int32(i32::arbitrary(u)?),\n            BSONType::Int64 =\u003e bson::Bson::Int64(i64::arbitrary(u)?),\n            BSONType::Double =\u003e bson::Bson::Double(f64::arbitrary(u)?),\n            BSONType::String =\u003e {\n                match std::ffi::CString::arbitrary(u)?.into_string() {\n                    Ok(value) =\u003e bson::Bson::String(value),\n                    Err(_) =\u003e bson::Bson::Null,\n                }\n            },\n            BSONType::Binary =\u003e bson::Bson::Binary(bson::Binary {subtype: Generic, bytes: Vec::\u003cu8\u003e::arbitrary(u)?}),\n            BSONType::Array =\u003e bson::Bson::Array(Vec::\u003cArbitraryBSON\u003e::arbitrary(u)?.drain(..).map(|val| val.value).collect()),\n            BSONType::Document =\u003e bson::Bson::Document(ArbitraryBSONDocument::arbitrary(u)?.value),\n        };\n\n        Ok(ArbitraryBSON{value})\n    }\n}\n\n#[derive(Debug)]\npub(crate) struct ArbitraryBSONDocument {\n    pub value: Document,\n}\n\nimpl\u003c'a\u003e Arbitrary\u003c'a\u003e for ArbitraryBSONDocument {\n    fn arbitrary(u: \u0026mut Unstructured\u003c'a\u003e) -\u003e Result\u003cSelf, Error\u003e {\n        let mut value = Document::new();\n        for key in Vec::\u003cstd::ffi::CString\u003e::arbitrary(u)?.drain(..) {\n            match key.into_string() {\n                Ok(key) =\u003e value.insert(key, ArbitraryBSON::arbitrary(u)?.value),\n                Err(_) =\u003e None,\n            };\n        }\n        Ok(ArbitraryBSONDocument{value})\n    }\n}\n\n// argument for a bson doc\n#[derive(Arbitrary, Debug)]\npub(crate) enum Argument\u003cT\u003e {\n    // no value\n    Missing,\n    // a valid value\n    Valid,\n    // an invalid value of the same type\n    Invalid(T),\n    // an invalid value of an arbitrary type\n    Random(ArbitraryBSON),\n}","traces":[{"line":20,"address":[],"length":0,"stats":{"Line":0}},{"line":22,"address":[],"length":0,"stats":{"Line":0}},{"line":25,"address":[],"length":0,"stats":{"Line":0}},{"line":26,"address":[],"length":0,"stats":{"Line":0}},{"line":28,"address":[],"length":0,"stats":{"Line":0}},{"line":29,"address":[],"length":0,"stats":{"Line":0}},{"line":30,"address":[],"length":0,"stats":{"Line":0}},{"line":32,"address":[],"length":0,"stats":{"Line":0}},{"line":33,"address":[],"length":0,"stats":{"Line":0}},{"line":35,"address":[],"length":0,"stats":{"Line":0}},{"line":37,"address":[],"length":0,"stats":{"Line":0}},{"line":39,"address":[],"length":0,"stats":{"Line":0}},{"line":50,"address":[],"length":0,"stats":{"Line":0}},{"line":51,"address":[],"length":0,"stats":{"Line":0}},{"line":52,"address":[],"length":0,"stats":{"Line":0}},{"line":54,"address":[],"length":0,"stats":{"Line":0}},{"line":65,"address":[],"length":0,"stats":{"Line":0}},{"line":66,"address":[],"length":0,"stats":{"Line":0}},{"line":67,"address":[],"length":0,"stats":{"Line":0}},{"line":69,"address":[],"length":0,"stats":{"Line":0}},{"line":70,"address":[],"length":0,"stats":{"Line":0}},{"line":72,"address":[],"length":0,"stats":{"Line":0}},{"line":84,"address":[],"length":0,"stats":{"Line":0}},{"line":85,"address":[],"length":0,"stats":{"Line":0}},{"line":86,"address":[],"length":0,"stats":{"Line":0}},{"line":88,"address":[],"length":0,"stats":{"Line":0}},{"line":99,"address":[],"length":0,"stats":{"Line":0}},{"line":100,"address":[],"length":0,"stats":{"Line":0}},{"line":101,"address":[],"length":0,"stats":{"Line":0}},{"line":103,"address":[],"length":0,"stats":{"Line":0}},{"line":104,"address":[],"length":0,"stats":{"Line":0}},{"line":105,"address":[],"length":0,"stats":{"Line":0}},{"line":107,"address":[],"length":0,"stats":{"Line":0}},{"line":109,"address":[],"length":0,"stats":{"Line":0}},{"line":120,"address":[],"length":0,"stats":{"Line":0}},{"line":121,"address":[],"length":0,"stats":{"Line":0}},{"line":122,"address":[],"length":0,"stats":{"Line":0}},{"line":124,"address":[],"length":0,"stats":{"Line":0}},{"line":126,"address":[],"length":0,"stats":{"Line":0}},{"line":137,"address":[],"length":0,"stats":{"Line":0}},{"line":151,"address":[],"length":0,"stats":{"Line":0}},{"line":152,"address":[],"length":0,"stats":{"Line":0}},{"line":153,"address":[],"length":0,"stats":{"Line":0}},{"line":154,"address":[],"length":0,"stats":{"Line":0}},{"line":155,"address":[],"length":0,"stats":{"Line":0}},{"line":156,"address":[],"length":0,"stats":{"Line":0}},{"line":157,"address":[],"length":0,"stats":{"Line":0}},{"line":158,"address":[],"length":0,"stats":{"Line":0}},{"line":159,"address":[],"length":0,"stats":{"Line":0}},{"line":160,"address":[],"length":0,"stats":{"Line":0}},{"line":163,"address":[],"length":0,"stats":{"Line":0}},{"line":164,"address":[],"length":0,"stats":{"Line":0}},{"line":165,"address":[],"length":0,"stats":{"Line":0}},{"line":168,"address":[],"length":0,"stats":{"Line":0}},{"line":178,"address":[],"length":0,"stats":{"Line":0}},{"line":179,"address":[],"length":0,"stats":{"Line":0}},{"line":180,"address":[],"length":0,"stats":{"Line":0}},{"line":181,"address":[],"length":0,"stats":{"Line":0}},{"line":182,"address":[],"length":0,"stats":{"Line":0}},{"line":183,"address":[],"length":0,"stats":{"Line":0}},{"line":186,"address":[],"length":0,"stats":{"Line":0}}],"covered":0,"coverable":61},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","fuzz","fuzz_targets","fuzz_endpoint_client.rs"],"content":"#![no_main]\n\n// std\nuse std::io::{Cursor, Write};\nuse std::net::TcpStream;\nuse std::time::Duration;\n\n// gosling\nuse ::gosling::*;\nuse context::*;\n\n// extern\nuse bson::Bson;\nuse bson::Document;\nuse bson::doc;\nuse bson::spec::BinarySubtype;\n\nuse tor_interface::mock_tor_client::*;\nuse tor_interface::tor_crypto::*;\nuse tor_interface::tor_provider::*;\n\n// fuzzing\nuse libfuzzer_sys::fuzz_target;\nuse libfuzzer_sys::arbitrary;\nuse libfuzzer_sys::arbitrary::Arbitrary;\n\nmod arbitrary_types;\nuse crate::arbitrary_types::*;\n\nmod utils;\nuse crate::utils::*;\n\n#[derive(Arbitrary, Debug)]\nstruct ErrorSection {\n    cookie: Argument\u003ci64\u003e,\n    code: Argument\u003ci32\u003e,\n}\n\n#[derive(Arbitrary, Debug)]\nstruct ResponseSection {\n    cookie: Argument\u003ci64\u003e,\n    state: Argument\u003ci32\u003e,\n    result: Argument\u003cArbitraryBSON\u003e,\n}\n\n#[derive(Arbitrary, Debug)]\nenum Response {\n    Noise(Vec\u003cu8\u003e),\n    Document(ArbitraryBSONDocument),\n    HonkRPC {\n        single_message: bool,\n        pending: Option\u003cResponseSection\u003e,\n        complete: Option\u003cResponseSection\u003e,\n        error: Option\u003cErrorSection\u003e,\n    },\n}\n\n\n#[derive(Arbitrary, Debug)]\nstruct HandshakeData {\n    // server data\n    alice_private_ed25519: ArbitraryEd25519PrivateKey,\n    alice_endpoint_ed25519: ArbitraryEd25519PrivateKey,\n    server_cookie: Cookie,\n\n    // client data\n    bob_private_ed25519: ArbitraryEd25519PrivateKey,\n    bob_private_x25519: ArbitraryX25519PrivateKey,\n\n    begin_handshake_response: Response,\n    send_response_response: Response,\n}\n\n// two gosling instance, Alice and Bob\n// Alice is a malicious/broken server, Bob is a valid client\nfuzz_target!(|data: HandshakeData| {\n\n    // Bob client data\n    let bob_private_key = data.bob_private_ed25519.value;\n    let bob_service_id = V3OnionServiceId::from_private_key(\u0026bob_private_key);\n    let bob_service_id_string = bob_service_id.to_string();\n    let bob_private_x25519 = data.bob_private_x25519.value;\n    let bob_public_x25519 = X25519PublicKey::from_private_key(\u0026bob_private_x25519);\n\n    // Alice server data\n    let alice_private_key = data.alice_private_ed25519.value;\n    let alice_onion_service_id = V3OnionServiceId::from_private_key(\u0026alice_private_key);\n    let alice_onion_service_id_string = alice_onion_service_id.to_string();\n    let alice_endpoint_ed25519 = data.alice_endpoint_ed25519.value;\n    let alice_endpoint_onion_service_id = V3OnionServiceId::from_private_key(\u0026alice_endpoint_ed25519);\n    let alice_endpoint_onion_service_id_string = alice_endpoint_onion_service_id.to_string();\n\n    //\n    // Init malicious Alice server and Bob client\n    //\n\n    // init alice\n    let mut alice_tor = MockTorClient::new();\n\n    // bootstrap alice\n    alice_tor.bootstrap().unwrap();\n    let mut bootstrap_complete = false;\n    while !bootstrap_complete {\n        for event in alice_tor.update().unwrap().drain(..) {\n            match event {\n                TorEvent::BootstrapComplete =\u003e {\n                    bootstrap_complete = true;\n                }\n                _ =\u003e ()\n            }\n        }\n    }\n\n\n    let alice_listener = alice_tor.listener(\u0026alice_endpoint_ed25519, 420, Some(\u0026[bob_public_x25519])).unwrap();\n    let mut identity_server_published: bool = false;\n    while !identity_server_published {\n        for event in alice_tor.update().unwrap().drain(..) {\n            match event {\n                TorEvent::OnionServicePublished{service_id} =\u003e {\n                    assert_eq!(service_id, alice_endpoint_onion_service_id);\n                    identity_server_published = true;\n                },\n                _ =\u003e ()\n            }\n        }\n    }\n\n    // init bob\n    let bob_tor = MockTorClient::new();\n\n    // create bob gosling context\n    let mut bob = Context::new(Box::new(bob_tor), 420, 420, std::time::Duration::from_millis(32), IDENTITY_MAX_MESSAGE_SIZE, Some(std::time::Duration::from_millis(32)), bob_private_key).unwrap();\n    bob.bootstrap().unwrap();\n    let mut bootstrap_complete: bool = false;\n    while !bootstrap_complete {\n        for event in bob.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::TorBootstrapStatusReceived{progress: _, tag: _, summary: _} =\u003e (),\n                ContextEvent::TorBootstrapCompleted =\u003e {\n                    bootstrap_complete = true;\n                }\n                ContextEvent::TorLogReceived{line: _} =\u003e (),\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n    //\n    // Bob initiates handshake\n    //\n    let handshake_handle = bob.endpoint_client_begin_handshake(alice_endpoint_onion_service_id.clone(), bob_private_x25519, VALID_CHANNEL.to_string()).unwrap();\n    // first update to queue the HonkRPC call\n    assert_eq!(0, bob.update().unwrap().len());\n    // second upate sends the HonkRPC message\n    assert_eq!(0, bob.update().unwrap().len());\n\n    // alice waits for connect, return OnionStream\n    let mut alice_stream : TcpStream = match alice_listener.accept().unwrap() {\n        Some(stream) =\u003e stream.into(),\n        None =\u003e panic!(\"listener accept failed\"),\n    };\n    alice_stream.set_nonblocking(false).unwrap();\n    alice_stream.set_read_timeout(Some(Duration::from_millis(100u64))).unwrap();\n\n\n    //\n    // Alice receives begin_handshake() and build responses\n    //\n\n    let begin_handshake_cookie = {\n        let honkrpc_msg = bson::document::Document::from_reader(\u0026mut alice_stream).unwrap();\n        assert_eq!(honkrpc_msg.get_i32(\"honk_rpc\").unwrap(), HONK_RPC);\n        let sections = honkrpc_msg.get_array(\"sections\").unwrap();\n        assert_eq!(sections.len(), 1);\n        let honkrpc_request = match \u0026sections[0] {\n            Bson::Document(document) =\u003e document,\n            bson =\u003e panic!(\"unexpected bson in sections array: {}\", bson),\n        };\n        assert_eq!(honkrpc_request.get_i32(\"id\").unwrap(), REQUEST_SECTION);\n        let begin_handshake_cookie = honkrpc_request.get_i64(\"cookie\").unwrap();\n        assert_eq!(honkrpc_request.get_str(\"namespace\").unwrap(), GOSLING_ENDPOINT_NAMESPACE);\n        assert_eq!(honkrpc_request.get_str(\"function\").unwrap(), GOSLING_ENDPOINT_BEGIN_HANDSHAKE_FUNCTION);\n        let arguments = honkrpc_request.get_document(\"arguments\").unwrap();\n        assert_eq!(arguments.get_str(\"client_identity\").unwrap(), bob_service_id_string);\n        assert_eq!(arguments.get_str(\"channel\").unwrap(), VALID_CHANNEL);\n        begin_handshake_cookie\n    };\n\n\n\n    // messages can be built such that multiple errors exist so lets track\n    // all the layers of possible errors\n    let mut expect_timeout: bool = false;\n    let mut expect_bson_parse_failure: bool = false;\n    let mut expect_bson_too_small: bool = false;\n    let mut expect_bson_too_large: bool = false;\n    let mut expect_honkrpc_message_parse_failure: bool = false;\n    let mut expect_gosling_unexpected_response: bool = false;\n    let mut expect_unknown_error_section: bool = false;\n\n    let message: Vec\u003cu8\u003e = match data.begin_handshake_response {\n        Response::Noise(bytes) =\u003e {\n            match bytes.len() {\n                0..=3 =\u003e expect_timeout = true,\n                len =\u003e {\n                    let size: i32 = (bytes[0] as i32)\n                                  | (bytes[1] as i32) \u003c\u003c 8\n                                  | (bytes[2] as i32) \u003c\u003c 16\n                                  | (bytes[3] as i32) \u003c\u003c 24;\n                    if size \u003c= 4 {\n                        expect_bson_too_small = true;\n                    } else if size \u003e ENDPOINT_MAX_MESSAGE_SIZE {\n                        expect_bson_too_large = true;\n                    } else if size as usize \u003e len {\n                        expect_timeout = true;\n                    } else {\n                        match bson::document::Document::from_reader(Cursor::new(bytes.clone())) {\n                            Ok(_) =\u003e expect_honkrpc_message_parse_failure = true,\n                            Err(_) =\u003e expect_bson_parse_failure = true,\n                        }\n                    }\n                }\n            };\n            bytes.clone()\n        },\n        Response::Document(document) =\u003e {\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            document.value.to_writer(\u0026mut bytes).unwrap();\n            if bytes.len() \u003e ENDPOINT_MAX_MESSAGE_SIZE as usize {\n                expect_bson_too_large = true;\n            } else {\n                expect_honkrpc_message_parse_failure = true;\n            }\n            bytes\n        },\n        Response::HonkRPC{single_message, pending, complete, error} =\u003e {\n            let mut sections: Vec\u003cDocument\u003e = Default::default();\n\n            // build our pending section\n            if let Some(pending) = pending {\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(RESPONSE_SECTION));\n\n                let cookie = match pending.cookie {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(begin_handshake_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == begin_handshake_cookie {\n                            Some(Bson::Int64(!cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int64(cookie) = bson.value {\n                            if cookie != begin_handshake_cookie {\n                                expect_gosling_unexpected_response = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n\n                        Some(bson.value)\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let state = match pending.state {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int32(PENDING_REQUEST_STATE)),\n                    Argument::Invalid(state) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if state == PENDING_REQUEST_STATE || state == COMPLETE_REQUEST_STATE {\n                            Some(Bson::Int32(!state))\n                        } else {\n                            Some(Bson::Int32(state))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int32(state) = bson.value {\n                            if state != PENDING_REQUEST_STATE \u0026\u0026 state != COMPLETE_REQUEST_STATE {\n                                expect_honkrpc_message_parse_failure = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n                        Some(bson.value)\n                    }\n                };\n                if let Some(state) = state {\n                    section.insert(\"state\", state);\n                }\n\n                let result = match pending.result {\n                    Argument::Missing =\u003e None,\n                    Argument::Valid =\u003e None,\n                    Argument::Invalid(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        Some(bson.value)\n                    }\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        Some(bson.value)\n                    }\n                };\n                if let Some(result) = result {\n                    section.insert(\"result\", result);\n                }\n\n                sections.push(section);\n            }\n            // build our complete section\n            if let Some(complete) = complete {\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(RESPONSE_SECTION));\n\n                let cookie = match complete.cookie {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(begin_handshake_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == begin_handshake_cookie {\n                            Some(Bson::Int64(!cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int64(cookie) = bson.value {\n                            if cookie != begin_handshake_cookie {\n                                expect_gosling_unexpected_response = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n\n                        Some(bson.value)\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let state = match complete.state {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int32(COMPLETE_REQUEST_STATE)),\n                    Argument::Invalid(state) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if state == PENDING_REQUEST_STATE || state == COMPLETE_REQUEST_STATE {\n                            Some(Bson::Int32(!state))\n                        } else {\n                            Some(Bson::Int32(state))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int32(state) = bson.value {\n                            if state == PENDING_REQUEST_STATE {\n                                expect_timeout = true;\n                            } else if state != COMPLETE_REQUEST_STATE {\n                                expect_honkrpc_message_parse_failure = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n                        Some(bson.value)\n                    }\n                };\n                if let Some(state) = state {\n                    section.insert(\"state\", state);\n                }\n\n                let result = match complete.result {\n                    Argument::Missing =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        None\n                    },\n                    Argument::Valid =\u003e {\n                        let mut result = Document::new();\n                        result.insert(\"server_cookie\", Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: data.server_cookie.to_vec()}));\n                        Some(Bson::Document(result))\n                    },\n                    Argument::Invalid(bson) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        Some(bson.value)\n                    }\n                    Argument::Random(bson) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        Some(bson.value)\n                    }\n                };\n                if let Some(result) = result {\n                    section.insert(\"result\", result);\n                }\n\n                sections.push(section);\n            } else if let Some(error) = error {\n                // build an error section if there's no complete section\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(ERROR_SECTION));\n\n                let cookie = match error.cookie {\n                    Argument::Missing =\u003e {\n                        expect_unknown_error_section = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(begin_handshake_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == begin_handshake_cookie {\n                            Some(Bson::Int64(!begin_handshake_cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if let Bson::Int64(value) = bson.value {\n                            Some(Bson::Null)\n                        } else {\n                            Some(bson.value)\n                        }\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let code = match error.code {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    }\n                    Argument::Valid =\u003e {\n                        // error success\n                        expect_gosling_unexpected_response = true;\n                        Some(Bson::Int32(0i32))\n                    },\n                    Argument::Invalid(code) =\u003e {\n                        // all i32 are somehow valid error codes\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if let Bson::Int32(value) = bson.value {\n                            Some(Bson::Null)\n                        } else {\n                            Some(bson.value)\n                        }\n                    }\n                };\n                if let Some(code) = code {\n                    section.insert(\"code\", code);\n                }\n\n                sections.push(section);\n            } else {\n                expect_timeout = true;\n            }\n\n            // convert sections into honk-rpc messages and serialize to byte vecs\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            if single_message {\n                let mut message = Document::new();\n                message.insert(\"honk_rpc\", HONK_RPC);\n\n                if sections.len() == 0 {\n                    expect_honkrpc_message_parse_failure = true;\n                }\n\n                message.insert(\"sections\", sections);\n\n                message.to_writer(\u0026mut bytes).unwrap();\n                if bytes.len() \u003e ENDPOINT_MAX_MESSAGE_SIZE as usize {\n                    expect_bson_too_large = true;\n                }\n            } else {\n                let mut bytes_written = 0usize;\n                for section in sections.drain(..) {\n                    let mut message = Document::new();\n                    message.insert(\"honk_rpc\", HONK_RPC);\n                    message.insert(\"sections\", vec![section]);\n\n                    message.to_writer(\u0026mut bytes).unwrap();\n\n                    if bytes.len() - bytes_written \u003e ENDPOINT_MAX_MESSAGE_SIZE as usize {\n                        expect_bson_too_large = true;\n                    }\n                    bytes_written = bytes.len();\n                }\n            }\n\n            bytes\n        },\n    };\n    alice_stream.write(message.as_slice()).unwrap();\n\n    //\n    // Bob receives begin_handshake() response and builds reply\n    //\n    for event in bob.update().unwrap().drain(..) {\n        match event {\n            ContextEvent::EndpointClientHandshakeFailed{handle, reason} =\u003e {\n                assert_eq!(handshake_handle, handle);\n                match reason {\n                    context::Error::EndpointClientError(\n                        endpoint_client::Error::HonkRPCFailure(\n                            honk_rpc::honk_rpc::Error::MessageReadTimedOut(_))) =\u003e {\n                        assert!(expect_timeout, \"{:?}\", reason);\n                    }\n                    context::Error::EndpointClientError(\n                        endpoint_client::Error::HonkRPCFailure(\n                            honk_rpc::honk_rpc::Error::BsonDocumentSizeTooSmall(_))) =\u003e {\n                        assert!(expect_bson_too_small, \"{:?}\", reason);\n                    },\n                    context::Error::EndpointClientError(\n                        endpoint_client::Error::HonkRPCFailure(\n                            honk_rpc::honk_rpc::Error::BsonDocumentSizeTooLarge(_, _))) =\u003e {\n                        assert!(expect_bson_too_large, \"{:?}\", reason);\n                    },\n                    context::Error::EndpointClientError(\n                        endpoint_client::Error::HonkRPCFailure(\n                            honk_rpc::honk_rpc::Error::MessageConversionFailed(_))) =\u003e {\n                        assert!(expect_honkrpc_message_parse_failure, \"{:?}\", reason);\n                    },\n                    context::Error::EndpointClientError(\n                        endpoint_client::Error::HonkRPCFailure(\n                            honk_rpc::honk_rpc::Error::UnknownErrorSectionReceived(_))) =\u003e {\n                        assert!(expect_unknown_error_section, \"{:?}\", reason);\n                    },\n                    context::Error::EndpointClientError(\n                        endpoint_client::Error::UnexpectedResponseReceived(_)) =\u003e {\n                        assert!(expect_gosling_unexpected_response, \"{:?}\", reason);\n                    },\n                    error =\u003e panic!(\"unexpected error: {:?}\", error),\n                }\n                // bob should have closed the connection on alice after handshake failure\n                return;\n            }\n            event =\u003e panic!(\"unexpected event: {:?}\", event),\n        }\n    }\n\n    // handle dangling unexpected response\n    for event in bob.update().unwrap().drain(..) {\n        match event {\n            ContextEvent::EndpointClientHandshakeFailed{handle, reason} =\u003e {\n                assert_eq!(handshake_handle, handle);\n                match reason {\n                    context::Error::EndpointClientError(\n                        endpoint_client::Error::UnexpectedResponseReceived(_)) =\u003e {\n                        assert!(expect_gosling_unexpected_response, \"{:?}\", reason);\n                    },\n                    error =\u003e panic!(\"unexpected error: {:?}\", error),\n                }\n                // bob should have closed the connection on alice after handshake failure\n                return;\n            }\n            event =\u003e panic!(\"unexpected event: {:?}\", event),\n        }\n    }\n    assert_eq!(0, bob.update().unwrap().len());\n\n    // give it a chance to timeout if it is mean to\n    while expect_timeout {\n        for event in bob.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::EndpointClientHandshakeFailed{handle, reason} =\u003e {\n                    assert_eq!(handshake_handle, handle);\n                    match reason {\n                        context::Error::EndpointClientError(\n                            endpoint_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageReadTimedOut(_))) =\u003e (),\n                        error =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n                    // bob should have closed the connection on alice after handshake failure\n                    return;\n                }\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n\n    // println!(\"expect_timeout: {}\", expect_timeout);\n\n    // Alice receives send_reponse() and builds response\n    let send_response_cookie = {\n        let honkrpc_msg = bson::document::Document::from_reader(\u0026mut alice_stream).unwrap();\n        assert_eq!(honkrpc_msg.get_i32(\"honk_rpc\").unwrap(), HONK_RPC);\n        let sections = honkrpc_msg.get_array(\"sections\").unwrap();\n        assert_eq!(sections.len(), 1);\n        let honkrpc_request = match \u0026sections[0] {\n            Bson::Document(document) =\u003e document,\n            bson =\u003e panic!(\"unexpected bson in sections array: {}\", bson),\n        };\n        assert_eq!(honkrpc_request.get_i32(\"id\").unwrap(), REQUEST_SECTION);\n        let send_response_cookie = honkrpc_request.get_i64(\"cookie\").unwrap();\n        assert_eq!(honkrpc_request.get_str(\"namespace\").unwrap(), GOSLING_ENDPOINT_NAMESPACE);\n        assert_eq!(honkrpc_request.get_str(\"function\").unwrap(), GOSLING_ENDPOINT_SEND_RESPONSE_FUNCTION);\n        let arguments = honkrpc_request.get_document(\"arguments\").unwrap();\n        let client_cookie = arguments.get_binary_generic(\"client_cookie\").unwrap();\n        let client_identity_proof_signature = arguments.get_binary_generic(\"client_identity_proof_signature\").unwrap();\n\n        send_response_cookie\n    };\n\n    let mut expect_timeout: bool = false;\n    let mut expect_bson_parse_failure: bool = false;\n    let mut expect_bson_too_small: bool = false;\n    let mut expect_bson_too_large: bool = false;\n    let mut expect_honkrpc_message_parse_failure: bool = false;\n    let mut expect_gosling_unexpected_response: bool = false;\n    let mut expect_unknown_error_section: bool = false;\n\n    let message: Vec\u003cu8\u003e = match data.send_response_response {\n        Response::Noise(bytes) =\u003e {\n            match bytes.len() {\n                0..=3 =\u003e expect_timeout = true,\n                len =\u003e {\n                    let size: i32 = (bytes[0] as i32)\n                                  | (bytes[1] as i32) \u003c\u003c 8\n                                  | (bytes[2] as i32) \u003c\u003c 16\n                                  | (bytes[3] as i32) \u003c\u003c 24;\n                    if size \u003c= 4 {\n                        expect_bson_too_small = true;\n                    } else if size \u003e ENDPOINT_MAX_MESSAGE_SIZE {\n                        expect_bson_too_large = true;\n                    } else if size as usize \u003e len {\n                        expect_timeout = true;\n                    } else {\n                        match bson::document::Document::from_reader(Cursor::new(bytes.clone())) {\n                            Ok(_) =\u003e expect_honkrpc_message_parse_failure = true,\n                            Err(_) =\u003e expect_bson_parse_failure = true,\n                        }\n                    }\n                }\n            };\n            bytes.clone()\n        },\n        Response::Document(document) =\u003e {\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            document.value.to_writer(\u0026mut bytes).unwrap();\n            if bytes.len() \u003e ENDPOINT_MAX_MESSAGE_SIZE as usize {\n                expect_bson_too_large = true;\n            } else {\n                expect_honkrpc_message_parse_failure = true;\n            }\n            bytes\n        },\n        Response::HonkRPC{single_message, pending, complete, error} =\u003e {\n            let mut sections: Vec\u003cDocument\u003e = Default::default();\n\n            // build our pending section\n            if let Some(pending) = pending {\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(RESPONSE_SECTION));\n\n                let cookie = match pending.cookie {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(send_response_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == send_response_cookie {\n                            Some(Bson::Int64(!cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int64(cookie) = bson.value {\n                            if cookie != send_response_cookie {\n                                expect_gosling_unexpected_response = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n\n                        Some(bson.value)\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let state = match pending.state {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int32(PENDING_REQUEST_STATE)),\n                    Argument::Invalid(state) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if state == PENDING_REQUEST_STATE || state == COMPLETE_REQUEST_STATE {\n                            Some(Bson::Int32(!state))\n                        } else {\n                            Some(Bson::Int32(state))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int32(state) = bson.value {\n                            if state != PENDING_REQUEST_STATE \u0026\u0026 state != COMPLETE_REQUEST_STATE {\n                                expect_honkrpc_message_parse_failure = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n                        Some(bson.value)\n                    }\n                };\n                if let Some(state) = state {\n                    section.insert(\"state\", state);\n                }\n\n                let result = match pending.result {\n                    Argument::Missing =\u003e None,\n                    Argument::Valid =\u003e None,\n                    Argument::Invalid(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        Some(bson.value)\n                    }\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        Some(bson.value)\n                    }\n                };\n                if let Some(result) = result {\n                    section.insert(\"result\", result);\n                }\n\n                sections.push(section);\n            }\n            // build our complete section\n            if let Some(complete) = complete {\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(RESPONSE_SECTION));\n\n                let cookie = match complete.cookie {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(send_response_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == send_response_cookie {\n                            Some(Bson::Int64(!cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int64(cookie) = bson.value {\n                            if cookie != send_response_cookie {\n                                expect_gosling_unexpected_response = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n\n                        Some(bson.value)\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let state = match complete.state {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int32(COMPLETE_REQUEST_STATE)),\n                    Argument::Invalid(state) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if state == COMPLETE_REQUEST_STATE {\n                            Some(Bson::Int32(!state))\n                        } else {\n                            Some(Bson::Int32(state))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int32(state) = bson.value {\n                            if state == PENDING_REQUEST_STATE {\n                                expect_timeout = true;\n                            } else if state != COMPLETE_REQUEST_STATE {\n                                expect_honkrpc_message_parse_failure = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n                        Some(bson.value)\n                    }\n                };\n                if let Some(state) = state {\n                    section.insert(\"state\", state);\n                }\n\n                let result = match complete.result {\n                    Argument::Missing =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        None\n                    },\n                    Argument::Valid =\u003e {\n                        Some(Bson::Document(doc!{}))\n                    },\n                    Argument::Invalid(bson) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        Some(bson.value)\n                    },\n                    Argument::Random(bson) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        Some(bson.value)\n                    },\n                };\n                if let Some(result) = result {\n                    section.insert(\"result\", result);\n                }\n\n                sections.push(section);\n            } else if let Some(error) = error {\n                // build an error section if there's no complete section\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(ERROR_SECTION));\n\n                let cookie = match error.cookie {\n                    Argument::Missing =\u003e {\n                        expect_unknown_error_section = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(send_response_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == send_response_cookie {\n                            Some(Bson::Int64(!send_response_cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if let Bson::Int64(value) = bson.value {\n                            Some(Bson::Null)\n                        } else {\n                            Some(bson.value)\n                        }\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let code = match error.code {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    }\n                    Argument::Valid =\u003e {\n                        // error success\n                        expect_gosling_unexpected_response = true;\n                        Some(Bson::Int32(0i32))\n                    },\n                    Argument::Invalid(code) =\u003e {\n                        // all i32 are somehow valid error codes\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if let Bson::Int32(value) = bson.value {\n                            Some(Bson::Null)\n                        } else {\n                            Some(bson.value)\n                        }\n                    }\n                };\n                if let Some(code) = code {\n                    section.insert(\"code\", code);\n                }\n\n                sections.push(section);\n            } else {\n                expect_timeout = true;\n            }\n\n            // convert sections into honk-rpc messages and serialize to byte vecs\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            if single_message {\n                let mut message = Document::new();\n                message.insert(\"honk_rpc\", HONK_RPC);\n\n                if sections.len() == 0 {\n                    expect_honkrpc_message_parse_failure = true;\n                }\n\n                message.insert(\"sections\", sections);\n\n                message.to_writer(\u0026mut bytes).unwrap();\n                if bytes.len() \u003e ENDPOINT_MAX_MESSAGE_SIZE as usize {\n                    expect_bson_too_large = true;\n                }\n            } else {\n                let mut bytes_written = 0usize;\n                for section in sections.drain(..) {\n                    let mut message = Document::new();\n                    message.insert(\"honk_rpc\", HONK_RPC);\n                    message.insert(\"sections\", vec![section]);\n\n                    message.to_writer(\u0026mut bytes).unwrap();\n\n                    if bytes.len() - bytes_written \u003e ENDPOINT_MAX_MESSAGE_SIZE as usize {\n                        expect_bson_too_large = true;\n                    }\n                    bytes_written = bytes.len();\n                }\n            }\n\n            bytes\n        },\n    };\n    alice_stream.write(message.as_slice()).unwrap();\n\n    //\n    // Bob receives send_response() response and finishes handshake\n    //\n    let mut send_response_complete: bool = false;\n    while !send_response_complete {\n        for event in bob.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::EndpointClientHandshakeFailed{handle, reason} =\u003e {\n                    assert_eq!(handshake_handle, handle);\n                    match reason {\n                        context::Error::EndpointClientError(\n                            endpoint_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageReadTimedOut(_))) =\u003e {\n                            assert!(expect_timeout, \"{:?}\", reason);\n                        }\n                        context::Error::EndpointClientError(\n                            endpoint_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooSmall(_))) =\u003e {\n                            assert!(expect_bson_too_small, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointClientError(\n                            endpoint_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooLarge(_, _))) =\u003e {\n                            assert!(expect_bson_too_large, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointClientError(\n                            endpoint_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageConversionFailed(_))) =\u003e {\n                            assert!(expect_honkrpc_message_parse_failure, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointClientError(\n                            endpoint_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::UnknownErrorSectionReceived(_))) =\u003e {\n                            assert!(expect_unknown_error_section, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointClientError(\n                            endpoint_client::Error::UnexpectedResponseReceived(_)) =\u003e {\n                            assert!(expect_gosling_unexpected_response, \"{:?}\", reason);\n                        },\n                        error =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n                    // bob should have closed the connection on alice after handshake failure\n                    return;\n                },\n                ContextEvent::EndpointClientHandshakeCompleted{handle, endpoint_service_id, channel_name, stream: _} =\u003e {\n                    assert_eq!(handshake_handle, handle);\n                    assert_eq!(endpoint_service_id, alice_endpoint_onion_service_id);\n                    assert_eq!(channel_name, VALID_CHANNEL);\n                    send_response_complete = true;\n                },\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n});\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","fuzz","fuzz_targets","fuzz_endpoint_server.rs"],"content":"#![no_main]\n\n// std\nuse std::io::{Cursor, Write};\nuse std::time::Duration;\n\n// gosling\nuse ::gosling::*;\nuse context::*;\n\n// extern\nuse bson::Bson;\nuse bson::Document;\nuse bson::doc;\nuse bson::spec::BinarySubtype;\nuse data_encoding::HEXLOWER;\nuse tor_interface::mock_tor_client::*;\nuse tor_interface::tor_crypto::*;\nuse tor_interface::tor_provider::*;\nuse honk_rpc::honk_rpc::{get_message_overhead, get_response_section_size};\n\n// fuzzing\nuse libfuzzer_sys::fuzz_target;\nuse libfuzzer_sys::arbitrary;\nuse libfuzzer_sys::arbitrary::Arbitrary;\n\nmod arbitrary_types;\nuse crate::arbitrary_types::*;\n\nmod utils;\nuse crate::utils::*;\n\n#[derive(Arbitrary, Debug)]\nenum BeginHandshakeMessage {\n    // random bytes\n    Noise(Vec\u003cu8\u003e),\n    /* HonkRpcMessage */\n    /* BSON */\n    // a valid honkrpc request\n    Request{\n        version: Argument\u003cString\u003e,\n        client_identity: Argument\u003cArbitraryV3OnionServiceId\u003e,\n        channel: Argument\u003cString\u003e,\n    },\n}\n\n#[derive(Arbitrary, Debug)]\nenum SendResponseMessage {\n    Noise(Vec\u003cu8\u003e),\n    /* HonkRpcMessage */\n    /* BSON */\n    // a valid honkrpc requst\n    Request{\n        client_cookie: Argument\u003cCookie\u003e,\n        client_identity_proof_signature: Argument\u003cArbitraryEd25519Signature\u003e,\n    },\n}\n\n#[derive(Arbitrary, Debug)]\nstruct HandshakeData {\n    // server data\n    alice_private_ed25519: ArbitraryEd25519PrivateKey,\n    alice_endpoint_ed25519: ArbitraryEd25519PrivateKey,\n    channel_supported: bool,\n    // client data\n    bob_private_ed25519: ArbitraryEd25519PrivateKey,\n    bob_private_x25519: ArbitraryX25519PrivateKey,\n    client_cookie: Cookie,\n    // client messages\n    begin_handshake_cookie: i64,\n    begin_handshake: BeginHandshakeMessage,\n    send_response_cookie: i64,\n    send_response: SendResponseMessage,\n}\n\n// two gosling instance, Alice and Bob\n// Alice is a valid server, Bob connects and sends garbage at certain point in the form of bad data in correctly structured+ordered gosling bison messages or noise\nfuzz_target!(|data: HandshakeData| {\n\n    // alice server data\n    let alice_identity_ed25519 = data.alice_private_ed25519.value;\n    let alice_onion_service_id = V3OnionServiceId::from_private_key(\u0026alice_identity_ed25519);\n    let alice_onion_service_id_string = alice_onion_service_id.to_string();\n    let alice_endpoint_ed25519 = data.alice_endpoint_ed25519.value;\n    let alice_endpoint_onion_service_id = V3OnionServiceId::from_private_key(\u0026alice_endpoint_ed25519);\n    let alice_endpoint_onion_service_id_string = alice_endpoint_onion_service_id.to_string();\n\n\n    // bob client data\n    let bob_private_key = data.bob_private_ed25519.value;\n    let bob_onion_service_id = V3OnionServiceId::from_private_key(\u0026bob_private_key);\n    let bob_onion_service_id_string = bob_onion_service_id.to_string();\n    let bob_private_x25519 = data.bob_private_x25519.value;\n    let bob_public_x25519 = X25519PublicKey::from_private_key(\u0026bob_private_x25519);\n\n    //\n    // Init Alice server and malicious Bob client\n    //\n\n    // init alice\n    let alice_tor = MockTorClient::new();\n\n    // create alice gosling context\n    let mut alice = Context::new(Box::new(alice_tor), 420, 420, std::time::Duration::from_millis(32), ENDPOINT_MAX_MESSAGE_SIZE, Some(std::time::Duration::from_millis(32)), alice_identity_ed25519.clone()).unwrap();\n\n    // bootstrap alice\n    alice.bootstrap().unwrap();\n    let mut endpoint_server_published: bool = false;\n    while !endpoint_server_published {\n        for event in alice.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::TorBootstrapStatusReceived{progress: _, tag: _, summary: _} =\u003e (),\n                ContextEvent::TorBootstrapCompleted =\u003e {\n                    // start alice endpoint server\n                    match alice.endpoint_server_start(alice_endpoint_ed25519.clone(), VALID_ENDPOINT.to_string(), bob_onion_service_id.clone(), bob_public_x25519.clone()) {\n                        Ok(()) =\u003e (),\n                        Err(context::Error::InvalidArgument(_)) =\u003e {\n                            assert_eq!(alice_onion_service_id_string, alice_endpoint_onion_service_id_string);\n                            return;\n                        },\n                        Err(error) =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n                }\n                ContextEvent::TorLogReceived{line: _} =\u003e (),\n                ContextEvent::EndpointServerPublished{endpoint_service_id, endpoint_name} =\u003e {\n                    assert_eq!(endpoint_service_id, alice_endpoint_onion_service_id);\n                    assert_eq!(endpoint_name, VALID_ENDPOINT);\n                    endpoint_server_published = true;\n                }\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n\n\n    // init bob\n    let mut bob_tor = MockTorClient::new();\n\n    // bootstrap bob\n    bob_tor.bootstrap().unwrap();\n    let mut bootstrap_complete = false;\n    while !bootstrap_complete {\n        for event in bob_tor.update().unwrap().drain(..) {\n            match event {\n                TorEvent::BootstrapComplete =\u003e {\n                    bootstrap_complete = true;\n                }\n                _ =\u003e ()\n            }\n        }\n    }\n    bob_tor.add_client_auth(\u0026alice_endpoint_onion_service_id, \u0026bob_private_x25519).unwrap();\n\n    // bob connects to alice\n    let mut bob_stream = bob_tor.connect((alice_endpoint_onion_service_id.clone(), 420).into(), None).unwrap();\n    bob_stream.set_nonblocking(false).unwrap();\n    bob_stream.set_read_timeout(Some(Duration::from_millis(100u64))).unwrap();\n\n\n    //\n    // Alice waits for handshake started\n    //\n    let mut alice_handshake_started: bool = false;\n    let mut alice_handshake_handle: HandshakeHandle = INVALID_HANDSHAKE_HANDLE;\n    while !alice_handshake_started {\n        for event in alice.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::EndpointServerHandshakeStarted{handle} =\u003e {\n                    alice_handshake_started = true;\n                    alice_handshake_handle = handle;\n                }\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n\n    //\n    // Bob sends begin_handshake()\n    //\n    #[derive(PartialEq, Debug)]\n    enum ExpectedBeginHandshakeResponse {\n        // Success Case\n        EndpointRequestReceived,\n        // Error Cases\n        ErrorTimedOut,\n        ErrorBsonParseFailure,\n        ErrorBsonTooSmall,\n        ErrorBsonTooLarge,\n        ErrorMessageParseFailure,\n        ErrorBadGoslingVersion,\n        ErrorInvalidArg,\n        ErrorBadClient,\n    }\n    let mut expected_response = ExpectedBeginHandshakeResponse::EndpointRequestReceived;\n\n    let message = match \u0026data.begin_handshake {\n        BeginHandshakeMessage::Noise(bytes) =\u003e {\n            expected_response = match bytes.len() {\n                0..=3 =\u003e ExpectedBeginHandshakeResponse::ErrorTimedOut,\n                len =\u003e {\n                    let size: i32 = (bytes[0] as i32)\n                                  | (bytes[1] as i32) \u003c\u003c 8\n                                  | (bytes[2] as i32) \u003c\u003c 16\n                                  | (bytes[3] as i32) \u003c\u003c 24;\n                    if size \u003c= 4 {\n                        ExpectedBeginHandshakeResponse::ErrorBsonTooSmall\n                    } else if size \u003e ENDPOINT_MAX_MESSAGE_SIZE {\n                        ExpectedBeginHandshakeResponse::ErrorBsonTooLarge\n                    } else if size as usize \u003e len {\n                        ExpectedBeginHandshakeResponse::ErrorTimedOut\n                    } else {\n                        match bson::document::Document::from_reader(Cursor::new(bytes.clone())) {\n                            Ok(_) =\u003e ExpectedBeginHandshakeResponse::ErrorMessageParseFailure,\n                            Err(_) =\u003e ExpectedBeginHandshakeResponse::ErrorBsonParseFailure,\n                        }\n                    }\n                }\n            };\n            bytes.clone()\n        },\n        BeginHandshakeMessage::Request{\n            version,\n            client_identity,\n            channel} =\u003e {\n            match (\u0026version, \u0026client_identity, \u0026channel) {\n                (Argument::Valid, Argument::Valid | Argument::Invalid(_), Argument::Valid | Argument::Invalid(_)) =\u003e (),\n                (Argument::Missing | Argument::Invalid(_) | Argument::Random(_), _, _) =\u003e  expected_response = ExpectedBeginHandshakeResponse::ErrorBadGoslingVersion,\n                _ =\u003e expected_response = ExpectedBeginHandshakeResponse::ErrorInvalidArg,\n            }\n\n            let mut message = Document::new();\n            message.insert(\"honk_rpc\", Bson::Int32(HONK_RPC));\n\n            let mut section = Document::new();\n            section.insert(\"id\", Bson::Int32(REQUEST_SECTION));\n            section.insert(\"namespace\", Bson::String(\"gosling_endpoint\".to_string()));\n            section.insert(\"function\", Bson::String(\"begin_handshake\".to_string()));\n            section.insert(\"cookie\", Bson::Int64(data.begin_handshake_cookie));\n\n            let mut arguments = Document::new();\n            let version = match version {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e Some(Bson::String(GOSLING_PROTOCOL_VERSION.to_string())),\n                Argument::Invalid(invalid) =\u003e {\n                    if invalid == GOSLING_PROTOCOL_VERSION {\n                        Some(Bson::String(\"invalid_version\".to_string()))\n                    } else {\n                        Some(Bson::String(invalid.clone()))\n                    }\n                },\n                Argument::Random(ArbitraryBSON{value: Bson::String(_)}) =\u003e Some(Bson::Null),\n                Argument::Random(bson) =\u003e Some(bson.value.clone()),\n            };\n            if let Some(version) = version {\n                arguments.insert(\"version\", version);\n            }\n\n            let client_identity = match client_identity {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e Some(Bson::String(bob_onion_service_id_string.clone())),\n                Argument::Invalid(invalid) =\u003e {\n                    let invalid = invalid.value.to_string();\n                    Some(Bson::String(invalid))\n                },\n                Argument::Random(ArbitraryBSON{value: Bson::String(_)}) =\u003e Some(Bson::Null),\n                Argument::Random(bson) =\u003e Some(bson.value.clone()),\n            };\n            if let Some(client_identity) = client_identity {\n                arguments.insert(\"client_identity\", client_identity);\n            }\n\n            let channel = match channel {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e Some(Bson::String(VALID_CHANNEL.to_string())),\n                Argument::Invalid(value) =\u003e {\n                    if value == VALID_CHANNEL {\n                        Some(Bson::String(\"invalid_channel\".to_string()))\n                    } else if value.is_ascii() {\n                        Some(Bson::String(value.clone()))\n                    } else {\n                        Some(Bson::String(Default::default()))\n                    }\n                },\n                Argument::Random(ArbitraryBSON{value: Bson::String(value)}) =\u003e {\n                    if !value.is_ascii() {\n                        Some(Bson::String(value.clone()))\n                    } else {\n                        Some(Bson::Null)\n                    }\n                },\n                Argument::Random(bson) =\u003e Some(bson.value.clone()),\n            };\n            if let Some(channel) = channel {\n                arguments.insert(\"channel\", channel);\n            }\n\n            section.insert(\"arguments\", arguments);\n            message.insert(\"sections\", vec![section]);\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            message.to_writer(\u0026mut bytes).unwrap();\n            if bytes.len() \u003e ENDPOINT_MAX_MESSAGE_SIZE as usize {\n                expected_response = ExpectedBeginHandshakeResponse::ErrorBsonTooLarge;\n            }\n            bytes\n        },\n    };\n    bob_stream.write(message.as_slice()).unwrap();\n\n\n    //\n    // Alice handles begin_handshake()\n    //\n    let mut alice_begin_handshake_handled: bool = false;\n    while !alice_begin_handshake_handled {\n        for event in alice.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::EndpointServerChannelRequestReceived{handle, client_service_id: _, requested_channel} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    assert_eq!(expected_response, ExpectedBeginHandshakeResponse::EndpointRequestReceived);\n                    #[derive(PartialEq, Debug)]\n                    enum ExpectedHandleEndpointRequestReceiveResult {\n                        Success,\n                        // Error Cases\n                        ErrorSectionTooLarge,\n                    }\n\n                    let mut expected_result = ExpectedHandleEndpointRequestReceiveResult::Success;\n\n                    // calculate the expected size of our reponse message\n                    let begin_handshake_complete_message_size = {\n                        let result = doc!{\n                            \"server_cookie\" : bson::Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: [0u8; COOKIE_SIZE].to_vec()}),\n                        };\n                        let response_section_size = get_response_section_size(Some(Bson::Document(result))).unwrap();\n                        get_message_overhead().unwrap() + response_section_size\n                    };\n                    if begin_handshake_complete_message_size \u003e ENDPOINT_MAX_MESSAGE_SIZE as usize {\n                        expected_result = ExpectedHandleEndpointRequestReceiveResult::ErrorSectionTooLarge;\n                    }\n\n                    match alice.endpoint_server_handle_channel_request_received(\n                        alice_handshake_handle,\n                        data.channel_supported \u0026\u0026 requested_channel == VALID_CHANNEL) {\n                        Ok(()) =\u003e assert_eq!(expected_result, ExpectedHandleEndpointRequestReceiveResult::Success),\n                        Err(error) =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n\n                    alice_begin_handshake_handled = true;\n                }\n                ContextEvent::EndpointServerHandshakeFailed{handle, reason} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    match reason {\n                        context::Error::EndpointServerError(\n                            endpoint_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageReadTimedOut(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedBeginHandshakeResponse::ErrorTimedOut, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointServerError(\n                            endpoint_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentParseFailed(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedBeginHandshakeResponse::ErrorBsonParseFailure, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointServerError(\n                            endpoint_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooSmall(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedBeginHandshakeResponse::ErrorBsonTooSmall, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointServerError(\n                            endpoint_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooLarge(_, _))) =\u003e {\n                            assert_eq!(expected_response, ExpectedBeginHandshakeResponse::ErrorBsonTooLarge, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointServerError(\n                            endpoint_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageConversionFailed(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedBeginHandshakeResponse::ErrorMessageParseFailure, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointServerError(endpoint_server::Error::BadClient) =\u003e {\n                            assert!(expected_response == ExpectedBeginHandshakeResponse::ErrorBadClient ||\n                                    expected_response == ExpectedBeginHandshakeResponse::ErrorBadGoslingVersion ||\n                                    expected_response == ExpectedBeginHandshakeResponse::ErrorInvalidArg, \"{:?}\", reason);\n                        },\n                        error =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n                    alice_begin_handshake_handled = true;\n                }\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n        // Alice sends Bob begin_handshake() response (or does nothing)\n    for event in alice.update().unwrap().drain(..) {\n        match event {\n            event =\u003e panic!(\"unexpected event: {:?}\", event),\n        }\n    }\n\n    //\n    // Bob reads begin_handshake() response or error sections\n    //\n\n    // bob receives begin_handshake() pending response\n    let begin_handshake_pending = bson::document::Document::from_reader(\u0026mut bob_stream);\n    match expected_response {\n        ExpectedBeginHandshakeResponse::ErrorTimedOut |\n        ExpectedBeginHandshakeResponse::ErrorBsonTooSmall |\n        ExpectedBeginHandshakeResponse::ErrorBsonTooLarge |\n        ExpectedBeginHandshakeResponse::ErrorBsonParseFailure |\n        ExpectedBeginHandshakeResponse::ErrorMessageParseFailure =\u003e {\n            match begin_handshake_pending {\n                Err(bson::de::Error::Io(_)) =\u003e return,\n                Ok(message) =\u003e panic!(\"unexpected message: {:?}\", message),\n                Err(error) =\u003e panic!(\"unexpected error: {:?}\", error),\n            }\n        },\n        ExpectedBeginHandshakeResponse::ErrorBadGoslingVersion =\u003e {\n            match begin_handshake_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": ERROR_SECTION,\n                                \"cookie\": data.begin_handshake_cookie,\n                                \"code\": ERROR_CODE_BAD_VERSION,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n        ExpectedBeginHandshakeResponse::ErrorInvalidArg =\u003e {\n            match begin_handshake_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": ERROR_SECTION,\n                                \"cookie\": data.begin_handshake_cookie,\n                                \"code\": ERROR_CODE_INVALID_ARG,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n        ExpectedBeginHandshakeResponse::EndpointRequestReceived |\n        ExpectedBeginHandshakeResponse::ErrorBadClient =\u003e {\n            match begin_handshake_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": RESPONSE_SECTION,\n                                \"cookie\": data.begin_handshake_cookie,\n                                \"state\": PENDING_REQUEST_STATE,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        }\n    }\n\n\n    // bob receives begin_handshake() result\n    let begin_handshake_result = bson::document::Document::from_reader(\u0026mut bob_stream);\n    let mut server_cookie: Cookie = Default::default();\n    match expected_response {\n        ExpectedBeginHandshakeResponse::ErrorTimedOut |\n        ExpectedBeginHandshakeResponse::ErrorBsonTooSmall |\n        ExpectedBeginHandshakeResponse::ErrorBsonTooLarge |\n        ExpectedBeginHandshakeResponse::ErrorBsonParseFailure |\n        ExpectedBeginHandshakeResponse::ErrorMessageParseFailure |\n        ExpectedBeginHandshakeResponse::ErrorBadGoslingVersion |\n        ExpectedBeginHandshakeResponse::ErrorInvalidArg =\u003e {\n            match begin_handshake_result {\n                Err(bson::de::Error::Io(_)) =\u003e return,\n                Ok(message) =\u003e panic!(\"unexpected message: {:?}\", message),\n                Err(error) =\u003e panic!(\"unexpected error: {:?}\", error),\n            }\n        },\n        ExpectedBeginHandshakeResponse::ErrorBadClient =\u003e {\n            match begin_handshake_result {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": ERROR_SECTION,\n                                \"cookie\": data.begin_handshake_cookie,\n                                \"code\": ERROR_CODE_FAILURE,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n        ExpectedBeginHandshakeResponse::EndpointRequestReceived =\u003e {\n            match begin_handshake_result {\n                Ok(message) =\u003e {\n                    assert_eq!(message.get_i32(\"honk_rpc\").unwrap(), HONK_RPC);\n                    let sections = message.get_array(\"sections\").unwrap();\n                    assert_eq!(sections.len(), 1);\n                    let section = \u0026sections[0];\n                    match section {\n                        Bson::Document(section) =\u003e {\n                            assert_eq!(section.get_i32(\"id\"), Ok(RESPONSE_SECTION));\n                            let response = section;\n                            assert_eq!(response.get_i64(\"cookie\"), Ok(data.begin_handshake_cookie));\n                            assert_eq!(response.get_i32(\"state\"), Ok(COMPLETE_REQUEST_STATE));\n                            let result = response.get_document(\"result\").unwrap();\n                            server_cookie = result.get_binary_generic(\"server_cookie\").unwrap().clone().try_into().unwrap();\n                        },\n                        bson =\u003e panic!(\"unexpected section: {:?}\", bson),\n                    }\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        }\n    }\n\n    //\n    // Bsob sends send_response()\n    //\n\n    #[derive(PartialEq, Debug)]\n    enum ExpectedSendResponseResponse {\n        // Success Case\n        EmptyDocumentReceived,\n        // Error Cases\n        ErrorTimedOut,\n        ErrorBsonParseFailure,\n        ErrorBsonTooSmall,\n        ErrorBsonTooLarge,\n        ErrorMessageParseFailure,\n        ErrorInvalidArg,\n        ErrorBadClient,\n    }\n    let mut expected_response = match (data.channel_supported, data.begin_handshake) {\n        (true, BeginHandshakeMessage::Request{version: Argument::Valid, client_identity: Argument::Valid, channel: Argument::Valid}) =\u003e ExpectedSendResponseResponse::EmptyDocumentReceived,\n        _ =\u003e ExpectedSendResponseResponse::ErrorBadClient,\n    };\n\n    let message = match data.send_response {\n        SendResponseMessage::Noise(bytes) =\u003e {\n            expected_response = match bytes.len() {\n                0..=3 =\u003e ExpectedSendResponseResponse::ErrorTimedOut,\n                len =\u003e {\n                    let size: i32 = (bytes[0] as i32)\n                                  | (bytes[1] as i32) \u003c\u003c 8\n                                  | (bytes[2] as i32) \u003c\u003c 16\n                                  | (bytes[3] as i32) \u003c\u003c 24;\n                    if size \u003c= 4 {\n                        ExpectedSendResponseResponse::ErrorBsonTooSmall\n                    } else if size \u003e ENDPOINT_MAX_MESSAGE_SIZE {\n                        ExpectedSendResponseResponse::ErrorBsonTooLarge\n                    } else if size as usize \u003e len {\n                        ExpectedSendResponseResponse::ErrorTimedOut\n                    } else {\n                        match bson::document::Document::from_reader(Cursor::new(bytes.clone())) {\n                            Ok(_) =\u003e ExpectedSendResponseResponse::ErrorMessageParseFailure,\n                            Err(_) =\u003e ExpectedSendResponseResponse::ErrorBsonParseFailure,\n                        }\n                    }\n                }\n            };\n            bytes\n        },\n        SendResponseMessage::Request{\n            client_cookie,\n            client_identity_proof_signature} =\u003e {\n            match (\u0026client_cookie, \u0026client_identity_proof_signature) {\n                (Argument::Valid, Argument::Valid) =\u003e (),\n                (Argument::Valid | Argument::Invalid(_),\n                 Argument::Valid | Argument::Invalid(_)) =\u003e expected_response = ExpectedSendResponseResponse::ErrorBadClient,\n                _ =\u003e expected_response = ExpectedSendResponseResponse::ErrorInvalidArg,\n            }\n\n            let mut message = Document::new();\n            message.insert(\"honk_rpc\", Bson::Int32(HONK_RPC));\n\n            let mut section = Document::new();\n            section.insert(\"id\", Bson::Int32(REQUEST_SECTION));\n            section.insert(\"namespace\", Bson::String(\"gosling_endpoint\".to_string()));\n            section.insert(\"function\", Bson::String(\"send_response\".to_string()));\n            section.insert(\"cookie\", Bson::Int64(data.send_response_cookie));\n\n            let mut arguments = Document::new();\n            let client_cookie = match client_cookie {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: data.client_cookie.to_vec()})),\n                Argument::Invalid(value) =\u003e {\n                    // ensure the cookie is actually invalid\n                    if value == data.client_cookie {\n                        Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: value.map(|x| !x).to_vec()}))\n                    } else {\n                        Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: value.to_vec()}))\n                    }\n                }\n                Argument::Random(ArbitraryBSON{value: Bson::Binary(_)}) =\u003e Some(Bson::Null),\n                Argument::Random(bson) =\u003e Some(bson.value),\n            };\n            if let Some(client_cookie) = client_cookie {\n                arguments.insert(\"client_cookie\", client_cookie);\n            }\n\n            let client_identity_proof_signature = match client_identity_proof_signature {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e {\n                    let client_identity_proof = build_client_proof(\"gosling-endpoint\", VALID_CHANNEL, \u0026bob_onion_service_id, \u0026alice_endpoint_onion_service_id, \u0026data.client_cookie, \u0026server_cookie);\n                    let client_identity_proof_signature = bob_private_key.sign_message(\u0026client_identity_proof);\n                    Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_identity_proof_signature.to_bytes().to_vec()}))\n                },\n                Argument::Invalid(invalid) =\u003e {\n                    Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: invalid.value.to_bytes().to_vec()}))\n                }\n                Argument::Random(ArbitraryBSON{value: Bson::Binary(_)}) =\u003e Some(Bson::Null),\n                Argument::Random(bson) =\u003e Some(bson.value),\n            };\n            if let Some(client_identity_proof_signature) = client_identity_proof_signature {\n                arguments.insert(\"client_identity_proof_signature\", client_identity_proof_signature);\n            }\n\n            section.insert(\"arguments\", arguments);\n            message.insert(\"sections\", vec![section]);\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            message.to_writer(\u0026mut bytes).unwrap();\n            if bytes.len() \u003e ENDPOINT_MAX_MESSAGE_SIZE as usize {\n                expected_response = ExpectedSendResponseResponse::ErrorBsonTooLarge;\n            }\n            bytes\n        },\n    };\n    bob_stream.write(message.as_slice()).unwrap();\n\n    //\n    // Alice handles send_response()\n    //\n\n    let mut alice_send_response_handled: bool = false;\n    while !alice_send_response_handled {\n        for event in alice.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::EndpointServerHandshakeFailed{handle, reason} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    match reason {\n                        context::Error::EndpointServerError(\n                            endpoint_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageReadTimedOut(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedSendResponseResponse::ErrorTimedOut, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointServerError(\n                            endpoint_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentParseFailed(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedSendResponseResponse::ErrorBsonParseFailure, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointServerError(\n                            endpoint_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooSmall(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedSendResponseResponse::ErrorBsonTooSmall, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointServerError(\n                            endpoint_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooLarge(_, _))) =\u003e {\n                            assert_eq!(expected_response, ExpectedSendResponseResponse::ErrorBsonTooLarge, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointServerError(\n                            endpoint_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageConversionFailed(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedSendResponseResponse::ErrorMessageParseFailure, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointServerError(endpoint_server::Error::BadClient) =\u003e {\n                            assert!(expected_response == ExpectedSendResponseResponse::ErrorBadClient ||\n                                    expected_response == ExpectedSendResponseResponse::ErrorInvalidArg, \"{:?}\", reason);\n                        },\n                        error =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n                    alice_send_response_handled = true;\n                },\n                ContextEvent::EndpointServerHandshakeCompleted{handle, endpoint_service_id, client_service_id, channel_name, stream: _} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    assert_eq!(endpoint_service_id, alice_endpoint_onion_service_id);\n                    assert_eq!(client_service_id, bob_onion_service_id);\n                    assert_eq!(channel_name, VALID_CHANNEL);\n                    alice_send_response_handled = true;\n                    assert_eq!(expected_response, ExpectedSendResponseResponse::EmptyDocumentReceived);\n                },\n                ContextEvent::EndpointServerHandshakeRejected { handle, client_allowed: _, client_requested_channel_valid: _, client_proof_signature_valid: _} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    alice_send_response_handled = true;\n                },\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n\n    //\n    // Bob reads send_response() response or error sections\n    //\n\n    // first read response (pending) or error section\n    let send_response_pending = bson::document::Document::from_reader(\u0026mut bob_stream);\n    match expected_response {\n        ExpectedSendResponseResponse::ErrorTimedOut |\n        ExpectedSendResponseResponse::ErrorBsonTooSmall |\n        ExpectedSendResponseResponse::ErrorBsonTooLarge |\n        ExpectedSendResponseResponse::ErrorBsonParseFailure |\n        ExpectedSendResponseResponse::ErrorMessageParseFailure =\u003e {\n            match send_response_pending {\n                Err(bson::de::Error::Io(_)) =\u003e return,\n                Ok(message) =\u003e panic!(\"unexpected message: {:?}\", message),\n                Err(error) =\u003e panic!(\"unexpected error: {:?}\", error),\n            }\n        },\n        ExpectedSendResponseResponse::ErrorInvalidArg =\u003e {\n            match send_response_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": ERROR_SECTION,\n                                \"cookie\": data.send_response_cookie,\n                                \"code\": ERROR_CODE_INVALID_ARG,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n        ExpectedSendResponseResponse::ErrorBadClient =\u003e {\n            match send_response_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": ERROR_SECTION,\n                                \"cookie\": data.send_response_cookie,\n                                \"code\": ERROR_CODE_FAILURE,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n        ExpectedSendResponseResponse::EmptyDocumentReceived =\u003e {\n            match send_response_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": RESPONSE_SECTION,\n                                \"cookie\": data.send_response_cookie,\n                                \"state\": COMPLETE_REQUEST_STATE,\n                                \"result\": doc!{},\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        }\n    }\n\n    // success!\n    ()\n});\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","fuzz","fuzz_targets","fuzz_identity_client.rs"],"content":"#![no_main]\n\n// std\nuse std::io::{Cursor, Write};\nuse std::net::TcpStream;\nuse std::time::Duration;\n\n// gosling\nuse ::gosling::*;\nuse context::*;\n\n// extern\nuse bson::Bson;\nuse bson::Document;\nuse bson::doc;\nuse bson::spec::BinarySubtype;\n\nuse tor_interface::mock_tor_client::*;\nuse tor_interface::tor_crypto::*;\nuse tor_interface::tor_provider::*;\n\n// fuzzing\nuse libfuzzer_sys::fuzz_target;\nuse libfuzzer_sys::arbitrary;\nuse libfuzzer_sys::arbitrary::Arbitrary;\n\nmod arbitrary_types;\nuse crate::arbitrary_types::*;\n\nmod utils;\nuse crate::utils::*;\n\n#[derive(Arbitrary, Debug)]\nstruct ErrorSection {\n    cookie: Argument\u003ci64\u003e,\n    code: Argument\u003ci32\u003e,\n}\n\n#[derive(Arbitrary, Debug)]\nstruct ResponseSection {\n    cookie: Argument\u003ci64\u003e,\n    state: Argument\u003ci32\u003e,\n    result: Argument\u003cArbitraryBSON\u003e,\n}\n\n#[derive(Arbitrary, Debug)]\nenum Response {\n    Noise(Vec\u003cu8\u003e),\n    Document(ArbitraryBSONDocument),\n    HonkRPC {\n        single_message: bool,\n        pending: Option\u003cResponseSection\u003e,\n        complete: Option\u003cResponseSection\u003e,\n        error: Option\u003cErrorSection\u003e,\n    },\n}\n\n\n#[derive(Arbitrary, Debug)]\nstruct HandshakeData {\n    // server data\n    alice_private_ed25519: ArbitraryEd25519PrivateKey,\n    server_cookie: Cookie,\n    endpoint_challenge: ArbitraryBSONDocument,\n    endpoint_service_id: ArbitraryV3OnionServiceId,\n\n    // client data\n    bob_private_ed25519: ArbitraryEd25519PrivateKey,\n    endpoint_challenge_response: ArbitraryBSONDocument,\n\n    begin_handshake_response: Response,\n    send_response_response: Response,\n\n}\n\n// two gosling instance, Alice and Bob\n// Alice is a malicious/broken server, Bob is a valid client\nfuzz_target!(|data: HandshakeData| {\n\n    //\n    // Init malicious Alice server and Bon client\n    //\n\n    // init alice\n    let mut alice_tor = MockTorClient::new();\n\n    // bootstrap alice\n    alice_tor.bootstrap().unwrap();\n    let mut bootstrap_complete = false;\n    while !bootstrap_complete {\n        for event in alice_tor.update().unwrap().drain(..) {\n            match event {\n                TorEvent::BootstrapComplete =\u003e {\n                    bootstrap_complete = true;\n                }\n                _ =\u003e ()\n            }\n        }\n    }\n\n    let alice_private_key = data.alice_private_ed25519.value;\n    let alice_onion_service_id = V3OnionServiceId::from_private_key(\u0026alice_private_key);\n    let alice_onion_service_id_string = alice_onion_service_id.to_string();\n    let alice_listener = alice_tor.listener(\u0026alice_private_key, 420, None).unwrap();\n    let mut identity_server_published: bool = false;\n    while !identity_server_published {\n        for event in alice_tor.update().unwrap().drain(..) {\n            match event {\n                TorEvent::OnionServicePublished{service_id} =\u003e {\n                    assert_eq!(service_id, alice_onion_service_id);\n                    identity_server_published = true;\n                },\n                _ =\u003e ()\n            }\n        }\n    }\n\n    // init bob\n    let bob_tor = MockTorClient::new();\n\n    // create bob gosling context\n    let bob_private_key = data.bob_private_ed25519.value;\n    let bob_service_id = V3OnionServiceId::from_private_key(\u0026bob_private_key);\n    let bob_service_id_string = bob_service_id.to_string();\n    let mut bob = Context::new(Box::new(bob_tor), 420, 420, std::time::Duration::from_millis(32), IDENTITY_MAX_MESSAGE_SIZE, None, bob_private_key).unwrap();\n    bob.bootstrap().unwrap();\n    let mut bootstrap_complete: bool = false;\n    while !bootstrap_complete {\n        for event in bob.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::TorBootstrapStatusReceived{progress: _, tag: _, summary: _} =\u003e (),\n                ContextEvent::TorBootstrapCompleted =\u003e {\n                    bootstrap_complete = true;\n                }\n                ContextEvent::TorLogReceived{line: _} =\u003e (),\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n\n    //\n    // Bob initiates handshake\n    //\n    let handshake_handle = bob.identity_client_begin_handshake(alice_onion_service_id.clone(), VALID_ENDPOINT.to_string()).unwrap();\n    // first update to queue the HonkRPC call\n    assert_eq!(0, bob.update().unwrap().len());\n    // second upate sends the HonkRPC message\n    assert_eq!(0, bob.update().unwrap().len());\n\n    // alice waits for connect, return OnionStream\n    let mut alice_stream : TcpStream = match alice_listener.accept().unwrap() {\n        Some(stream) =\u003e stream.into(),\n        None =\u003e panic!(\"listener accept failed\"),\n    };\n    alice_stream.set_nonblocking(false).unwrap();\n    alice_stream.set_read_timeout(Some(Duration::from_millis(100u64))).unwrap();\n\n    //\n    // Alice receives begin_handshake() and build responses\n    //\n\n    let begin_handshake_cookie = {\n        let honkrpc_msg = bson::document::Document::from_reader(\u0026mut alice_stream).unwrap();\n        assert_eq!(honkrpc_msg.get_i32(\"honk_rpc\").unwrap(), HONK_RPC);\n        let sections = honkrpc_msg.get_array(\"sections\").unwrap();\n        assert_eq!(sections.len(), 1);\n        let honkrpc_request = match \u0026sections[0] {\n            Bson::Document(document) =\u003e document,\n            bson =\u003e panic!(\"unexpected bson in sections array: {}\", bson),\n        };\n        assert_eq!(honkrpc_request.get_i32(\"id\").unwrap(), REQUEST_SECTION);\n        let begin_handshake_cookie = honkrpc_request.get_i64(\"cookie\").unwrap();\n        assert_eq!(honkrpc_request.get_str(\"namespace\").unwrap(), GOSLING_IDENTITY_NAMESPACE);\n        assert_eq!(honkrpc_request.get_str(\"function\").unwrap(), GOSLING_IDENTITY_BEGIN_HANDSHAKE_FUNCTION);\n        let arguments = honkrpc_request.get_document(\"arguments\").unwrap();\n        assert_eq!(arguments.get_str(\"client_identity\").unwrap(), bob_service_id_string);\n        assert_eq!(arguments.get_str(\"endpoint\").unwrap(), VALID_ENDPOINT);\n        begin_handshake_cookie\n    };\n\n    // messages can be built such that multiple errors exist so lets track\n    // all the layers of possible errors\n    let mut expect_timeout: bool = false;\n    let mut expect_bson_parse_failure: bool = false;\n    let mut expect_bson_too_small: bool = false;\n    let mut expect_bson_too_large: bool = false;\n    let mut expect_honkrpc_message_parse_failure: bool = false;\n    let mut expect_gosling_unexpected_response: bool = false;\n    let mut expect_unknown_error_section: bool = false;\n\n    let message: Vec\u003cu8\u003e = match data.begin_handshake_response {\n        Response::Noise(bytes) =\u003e {\n            match bytes.len() {\n                0..=3 =\u003e expect_timeout = true,\n                len =\u003e {\n                    let size: i32 = (bytes[0] as i32)\n                                  | (bytes[1] as i32) \u003c\u003c 8\n                                  | (bytes[2] as i32) \u003c\u003c 16\n                                  | (bytes[3] as i32) \u003c\u003c 24;\n                    if size \u003c= 4 {\n                        expect_bson_too_small = true;\n                    } else if size \u003e IDENTITY_MAX_MESSAGE_SIZE {\n                        expect_bson_too_large = true;\n                    } else if size as usize \u003e len {\n                        expect_timeout = true;\n                    } else {\n                        match bson::document::Document::from_reader(Cursor::new(bytes.clone())) {\n                            Ok(_) =\u003e expect_honkrpc_message_parse_failure = true,\n                            Err(_) =\u003e expect_bson_parse_failure = true,\n                        }\n                    }\n                }\n            };\n            bytes.clone()\n        },\n        Response::Document(document) =\u003e {\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            document.value.to_writer(\u0026mut bytes).unwrap();\n            if bytes.len() \u003e IDENTITY_MAX_MESSAGE_SIZE as usize {\n                expect_bson_too_large = true;\n            } else {\n                expect_honkrpc_message_parse_failure = true;\n            }\n            bytes\n        },\n        Response::HonkRPC{single_message, pending, complete, error} =\u003e {\n            let mut sections: Vec\u003cDocument\u003e = Default::default();\n\n            // build our pending section\n            if let Some(pending) = pending {\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(RESPONSE_SECTION));\n\n                let cookie = match pending.cookie {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(begin_handshake_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == begin_handshake_cookie {\n                            Some(Bson::Int64(!cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int64(cookie) = bson.value {\n                            if cookie != begin_handshake_cookie {\n                                expect_gosling_unexpected_response = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n\n                        Some(bson.value)\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let state = match pending.state {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int32(PENDING_REQUEST_STATE)),\n                    Argument::Invalid(state) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if state == PENDING_REQUEST_STATE {\n                            Some(Bson::Int32(!state))\n                        } else {\n                            Some(Bson::Int32(state))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int32(state) = bson.value {\n                            if state != PENDING_REQUEST_STATE {\n                                expect_honkrpc_message_parse_failure = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n                        Some(bson.value)\n                    }\n                };\n                if let Some(state) = state {\n                    section.insert(\"state\", state);\n                }\n\n                let result = match pending.result {\n                    Argument::Missing =\u003e None,\n                    Argument::Valid =\u003e None,\n                    Argument::Invalid(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        Some(bson.value)\n                    }\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        Some(bson.value)\n                    }\n                };\n                if let Some(result) = result {\n                    section.insert(\"result\", result);\n                }\n\n                sections.push(section);\n            }\n            // build our complete section\n            if let Some(complete) = complete {\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(RESPONSE_SECTION));\n\n                let cookie = match complete.cookie {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(begin_handshake_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == begin_handshake_cookie {\n                            Some(Bson::Int64(!cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int64(cookie) = bson.value {\n                            if cookie != begin_handshake_cookie {\n                                expect_gosling_unexpected_response = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n\n                        Some(bson.value)\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let state = match complete.state {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int32(COMPLETE_REQUEST_STATE)),\n                    Argument::Invalid(state) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if state == COMPLETE_REQUEST_STATE {\n                            Some(Bson::Int32(!state))\n                        } else {\n                            Some(Bson::Int32(state))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int32(state) = bson.value {\n                            if state == PENDING_REQUEST_STATE {\n                                expect_timeout = true;\n                            } else if state != COMPLETE_REQUEST_STATE {\n                                expect_honkrpc_message_parse_failure = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n                        Some(bson.value)\n                    }\n                };\n                if let Some(state) = state {\n                    section.insert(\"state\", state);\n                }\n\n                let result = match complete.result {\n                    Argument::Missing =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        None\n                    },\n                    Argument::Valid =\u003e {\n                        let mut result = Document::new();\n                        result.insert(\"server_cookie\", Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: data.server_cookie.to_vec()}));\n                        result.insert(\"endpoint_challenge\", data.endpoint_challenge.value.clone());\n                        Some(Bson::Document(result))\n                    },\n                    Argument::Invalid(bson) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        Some(bson.value)\n                    }\n                    Argument::Random(bson) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        Some(bson.value)\n                    }\n                };\n                if let Some(result) = result {\n                    section.insert(\"result\", result);\n                }\n\n                sections.push(section);\n            } else if let Some(error) = error {\n                // build an error section if there's no complete section\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(ERROR_SECTION));\n\n                let cookie = match error.cookie {\n                    Argument::Missing =\u003e {\n                        expect_unknown_error_section = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(begin_handshake_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == begin_handshake_cookie {\n                            Some(Bson::Int64(!begin_handshake_cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if let Bson::Int64(value) = bson.value {\n                            Some(Bson::Null)\n                        } else {\n                            Some(bson.value)\n                        }\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let code = match error.code {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    }\n                    Argument::Valid =\u003e {\n                        // error success\n                        expect_gosling_unexpected_response = true;\n                        Some(Bson::Int32(0i32))\n                    },\n                    Argument::Invalid(code) =\u003e {\n                        // all i32 are somehow valid error codes\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if let Bson::Int32(value) = bson.value {\n                            Some(Bson::Null)\n                        } else {\n                            Some(bson.value)\n                        }\n                    }\n                };\n                if let Some(code) = code {\n                    section.insert(\"code\", code);\n                }\n\n                sections.push(section);\n            } else {\n                expect_timeout = true;\n            }\n\n            // convert sections into honk-rpc messages and serialize to byte vecs\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            if single_message {\n                let mut message = Document::new();\n                message.insert(\"honk_rpc\", HONK_RPC);\n\n                if sections.len() == 0 {\n                    expect_honkrpc_message_parse_failure = true;\n                }\n\n                message.insert(\"sections\", sections);\n\n                message.to_writer(\u0026mut bytes).unwrap();\n                if bytes.len() \u003e IDENTITY_MAX_MESSAGE_SIZE as usize {\n                    expect_bson_too_large = true;\n                }\n            } else {\n                let mut bytes_written = 0usize;\n                for section in sections.drain(..) {\n                    let mut message = Document::new();\n                    message.insert(\"honk_rpc\", HONK_RPC);\n                    message.insert(\"sections\", vec![section]);\n\n                    message.to_writer(\u0026mut bytes).unwrap();\n\n                    if bytes.len() - bytes_written \u003e IDENTITY_MAX_MESSAGE_SIZE as usize {\n                        expect_bson_too_large = true;\n                    }\n                    bytes_written = bytes.len();\n                }\n            }\n\n            bytes\n        },\n    };\n    alice_stream.write(message.as_slice()).unwrap();\n\n    //\n    // Bob receives begin_handshake() response and builds reply\n    //\n    let mut begin_handshake_complete: bool = false;\n    while !begin_handshake_complete {\n        for event in bob.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::IdentityClientHandshakeFailed{handle, reason} =\u003e {\n                    assert_eq!(handshake_handle, handle);\n                    match reason {\n                        context::Error::IdentityClientError(\n                            identity_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageReadTimedOut(_))) =\u003e {\n                            assert!(expect_timeout, \"{:?}\", reason);\n                        }\n                        context::Error::IdentityClientError(\n                            identity_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooSmall(_))) =\u003e {\n                            assert!(expect_bson_too_small, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityClientError(\n                            identity_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooLarge(_, _))) =\u003e {\n                            assert!(expect_bson_too_large, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityClientError(\n                            identity_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageConversionFailed(_))) =\u003e {\n                            assert!(expect_honkrpc_message_parse_failure, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityClientError(\n                            identity_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::UnknownErrorSectionReceived(_))) =\u003e {\n                            assert!(expect_unknown_error_section, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityClientError(\n                            identity_client::Error::UnexpectedResponseReceived(_)) =\u003e {\n                            assert!(expect_gosling_unexpected_response, \"{:?}\", reason);\n                        },\n                        error =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n                    // bob should have closed the connection on alice after handshake failure\n                    return;\n                }\n                ContextEvent::IdentityClientChallengeReceived{handle, endpoint_challenge} =\u003e {\n                    assert!(!begin_handshake_complete);\n                    assert!(!expect_timeout);\n                    assert!(!expect_bson_too_small);\n                    assert!(!expect_bson_too_large);\n                    assert!(!expect_honkrpc_message_parse_failure);\n                    assert!(!expect_gosling_unexpected_response);\n                    assert_eq!(handshake_handle, handle);\n                    // compare the raw bytes ince an arbitrary bson doc may have Double(NaN) which fails equality test\n                    assert_eq!({\n                        let mut bytes: Vec\u003cu8\u003e = Default::default();\n                        endpoint_challenge.to_writer(\u0026mut bytes).unwrap();\n                        bytes\n                    },{\n                        let mut bytes: Vec\u003cu8\u003e = Default::default();\n                        data.endpoint_challenge.value.to_writer(\u0026mut bytes).unwrap();\n                        bytes\n                    });\n\n                    // just reply with an empty challenge response\n                    match bob.identity_client_handle_challenge_received(handle, data.endpoint_challenge_response.value.clone()) {\n                        Ok(()) =\u003e begin_handshake_complete = true,\n                        // there is a limit to how large a response can be based on the honk-rpc max message size\n                        Err(context::Error::IdentityClientError(identity_client::Error::EndpointChallengeResponseTooLarge(_,_))) =\u003e return,\n                        Err(error) =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n                }\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n    // first update to queue the HonkRPC call\n    assert_eq!(0, bob.update().unwrap().len());\n    // second upate sends the HonkRPC message\n    assert_eq!(0, bob.update().unwrap().len());\n\n\n    // Alice receives send_reponse() and builds response\n    let send_response_cookie = {\n        let honkrpc_msg = bson::document::Document::from_reader(\u0026mut alice_stream).unwrap();\n        assert_eq!(honkrpc_msg.get_i32(\"honk_rpc\").unwrap(), HONK_RPC);\n        let sections = honkrpc_msg.get_array(\"sections\").unwrap();\n        assert_eq!(sections.len(), 1);\n        let honkrpc_request = match \u0026sections[0] {\n            Bson::Document(document) =\u003e document,\n            bson =\u003e panic!(\"unexpected bson in sections array: {}\", bson),\n        };\n        assert_eq!(honkrpc_request.get_i32(\"id\").unwrap(), REQUEST_SECTION);\n        let send_response_cookie = honkrpc_request.get_i64(\"cookie\").unwrap();\n        assert_eq!(honkrpc_request.get_str(\"namespace\").unwrap(), GOSLING_IDENTITY_NAMESPACE);\n        assert_eq!(honkrpc_request.get_str(\"function\").unwrap(), GOSLING_IDENTITY_SEND_RESPONSE_FUNCTION);\n        let arguments = honkrpc_request.get_document(\"arguments\").unwrap();\n        let client_cookie = arguments.get_binary_generic(\"client_cookie\").unwrap();\n        let client_identity_proof_signature = arguments.get_binary_generic(\"client_identity_proof_signature\").unwrap();\n        let client_authorization_key = arguments.get_binary_generic(\"client_authorization_key\").unwrap();\n        let client_authorization_key_signbit = arguments.get_bool(\"client_authorization_key_signbit\").unwrap();\n        let client_authorization_signature = arguments.get_binary_generic(\"client_authorization_signature\").unwrap();\n        let challenge_response = arguments.get_document(\"challenge_response\").unwrap();\n\n        send_response_cookie\n    };\n\n    let mut expect_timeout: bool = false;\n    let mut expect_bson_parse_failure: bool = false;\n    let mut expect_bson_too_small: bool = false;\n    let mut expect_bson_too_large: bool = false;\n    let mut expect_honkrpc_message_parse_failure: bool = false;\n    let mut expect_gosling_unexpected_response: bool = false;\n    let mut expect_unknown_error_section: bool = false;\n\n    let message: Vec\u003cu8\u003e = match data.send_response_response {\n        Response::Noise(bytes) =\u003e {\n            match bytes.len() {\n                0..=3 =\u003e expect_timeout = true,\n                len =\u003e {\n                    let size: i32 = (bytes[0] as i32)\n                                  | (bytes[1] as i32) \u003c\u003c 8\n                                  | (bytes[2] as i32) \u003c\u003c 16\n                                  | (bytes[3] as i32) \u003c\u003c 24;\n                    if size \u003c= 4 {\n                        expect_bson_too_small = true;\n                    } else if size \u003e IDENTITY_MAX_MESSAGE_SIZE {\n                        expect_bson_too_large = true;\n                    } else if size as usize \u003e len {\n                        expect_timeout = true;\n                    } else {\n                        match bson::document::Document::from_reader(Cursor::new(bytes.clone())) {\n                            Ok(_) =\u003e expect_honkrpc_message_parse_failure = true,\n                            Err(_) =\u003e expect_bson_parse_failure = true,\n                        }\n                    }\n                }\n            };\n            bytes.clone()\n        },\n        Response::Document(document) =\u003e {\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            document.value.to_writer(\u0026mut bytes).unwrap();\n            if bytes.len() \u003e IDENTITY_MAX_MESSAGE_SIZE as usize {\n                expect_bson_too_large = true;\n            } else {\n                expect_honkrpc_message_parse_failure = true;\n            }\n            bytes\n        },\n        Response::HonkRPC{single_message, pending, complete, error} =\u003e {\n            let mut sections: Vec\u003cDocument\u003e = Default::default();\n\n            // build our pending section\n            if let Some(pending) = pending {\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(RESPONSE_SECTION));\n\n                let cookie = match pending.cookie {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(send_response_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == send_response_cookie {\n                            Some(Bson::Int64(!cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int64(cookie) = bson.value {\n                            if cookie != send_response_cookie {\n                                expect_gosling_unexpected_response = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n\n                        Some(bson.value)\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let state = match pending.state {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int32(PENDING_REQUEST_STATE)),\n                    Argument::Invalid(state) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if state == PENDING_REQUEST_STATE {\n                            Some(Bson::Int32(!state))\n                        } else {\n                            Some(Bson::Int32(state))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int32(state) = bson.value {\n                            if state != PENDING_REQUEST_STATE {\n                                expect_honkrpc_message_parse_failure = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n                        Some(bson.value)\n                    }\n                };\n                if let Some(state) = state {\n                    section.insert(\"state\", state);\n                }\n\n                let result = match pending.result {\n                    Argument::Missing =\u003e None,\n                    Argument::Valid =\u003e None,\n                    Argument::Invalid(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        Some(bson.value)\n                    }\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        Some(bson.value)\n                    }\n                };\n                if let Some(result) = result {\n                    section.insert(\"result\", result);\n                }\n\n                sections.push(section);\n            }\n            // build our complete section\n            if let Some(complete) = complete {\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(RESPONSE_SECTION));\n\n                let cookie = match complete.cookie {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(send_response_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == send_response_cookie {\n                            Some(Bson::Int64(!cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int64(cookie) = bson.value {\n                            if cookie != send_response_cookie {\n                                expect_gosling_unexpected_response = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n\n                        Some(bson.value)\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let state = match complete.state {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int32(COMPLETE_REQUEST_STATE)),\n                    Argument::Invalid(state) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if state == COMPLETE_REQUEST_STATE {\n                            Some(Bson::Int32(!state))\n                        } else {\n                            Some(Bson::Int32(state))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int32(state) = bson.value {\n                            if state == PENDING_REQUEST_STATE {\n                                expect_timeout = true;\n                            } else if state != COMPLETE_REQUEST_STATE {\n                                expect_honkrpc_message_parse_failure = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n                        Some(bson.value)\n                    }\n                };\n                if let Some(state) = state {\n                    section.insert(\"state\", state);\n                }\n\n                let result = match complete.result {\n                    Argument::Missing =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        None\n                    },\n                    Argument::Valid =\u003e {\n                        Some(Bson::String(data.endpoint_service_id.value.to_string()))\n                    },\n                    Argument::Invalid(bson) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        Some(bson.value)\n                    },\n                    Argument::Random(bson) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        Some(bson.value)\n                    },\n                };\n                if let Some(result) = result {\n                    section.insert(\"result\", result);\n                }\n\n                sections.push(section);\n            } else if let Some(error) = error {\n                // build an error section if there's no complete section\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(ERROR_SECTION));\n\n                let cookie = match error.cookie {\n                    Argument::Missing =\u003e {\n                        expect_unknown_error_section = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(send_response_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == send_response_cookie {\n                            Some(Bson::Int64(!send_response_cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if let Bson::Int64(value) = bson.value {\n                            Some(Bson::Null)\n                        } else {\n                            Some(bson.value)\n                        }\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let code = match error.code {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    }\n                    Argument::Valid =\u003e {\n                        // error success\n                        expect_gosling_unexpected_response = true;\n                        Some(Bson::Int32(0i32))\n                    },\n                    Argument::Invalid(code) =\u003e {\n                        // all i32 are somehow valid error codes\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if let Bson::Int32(value) = bson.value {\n                            Some(Bson::Null)\n                        } else {\n                            Some(bson.value)\n                        }\n                    }\n                };\n                if let Some(code) = code {\n                    section.insert(\"code\", code);\n                }\n\n                sections.push(section);\n            } else {\n                expect_timeout = true;\n            }\n\n            // convert sections into honk-rpc messages and serialize to byte vecs\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            if single_message {\n                let mut message = Document::new();\n                message.insert(\"honk_rpc\", HONK_RPC);\n\n                if sections.len() == 0 {\n                    expect_honkrpc_message_parse_failure = true;\n                }\n\n                message.insert(\"sections\", sections);\n\n                message.to_writer(\u0026mut bytes).unwrap();\n                if bytes.len() \u003e IDENTITY_MAX_MESSAGE_SIZE as usize {\n                    expect_bson_too_large = true;\n                }\n            } else {\n                let mut bytes_written = 0usize;\n                for section in sections.drain(..) {\n                    let mut message = Document::new();\n                    message.insert(\"honk_rpc\", HONK_RPC);\n                    message.insert(\"sections\", vec![section]);\n\n                    message.to_writer(\u0026mut bytes).unwrap();\n\n                    if bytes.len() - bytes_written \u003e IDENTITY_MAX_MESSAGE_SIZE as usize {\n                        expect_bson_too_large = true;\n                    }\n                    bytes_written = bytes.len();\n                }\n            }\n\n            bytes\n        },\n    };\n    alice_stream.write(message.as_slice()).unwrap();\n\n    //\n    // Bob receives send_response() response and finishes handshake\n    //\n    let mut send_response_complete: bool = false;\n    while !send_response_complete {\n        for event in bob.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::IdentityClientHandshakeFailed{handle, reason} =\u003e {\n                    assert_eq!(handshake_handle, handle);\n                    match reason {\n                        context::Error::IdentityClientError(\n                            identity_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageReadTimedOut(_))) =\u003e {\n                            assert!(expect_timeout, \"{:?}\", reason);\n                        }\n                        context::Error::IdentityClientError(\n                            identity_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooSmall(_))) =\u003e {\n                            assert!(expect_bson_too_small, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityClientError(\n                            identity_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooLarge(_, _))) =\u003e {\n                            assert!(expect_bson_too_large, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityClientError(\n                            identity_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageConversionFailed(_))) =\u003e {\n                            assert!(expect_honkrpc_message_parse_failure, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityClientError(\n                            identity_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::UnknownErrorSectionReceived(_))) =\u003e {\n                            assert!(expect_unknown_error_section, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityClientError(\n                            identity_client::Error::UnexpectedResponseReceived(_)) =\u003e {\n                            assert!(expect_gosling_unexpected_response, \"{:?}\", reason);\n                        },\n                        error =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n                    // bob should have closed the connection on alice after handshake failure\n                    return;\n                },\n                ContextEvent::IdentityClientHandshakeCompleted{handle, identity_service_id, endpoint_service_id, endpoint_name, client_auth_private_key} =\u003e {\n                    assert_eq!(handshake_handle, handle);\n                    assert_eq!(identity_service_id, alice_onion_service_id);\n                    assert_eq!(endpoint_service_id, data.endpoint_service_id.value);\n                    assert_eq!(endpoint_name, VALID_ENDPOINT);\n                    send_response_complete = true;\n                },\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n});\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","fuzz","fuzz_targets","fuzz_identity_server.rs"],"content":"#![no_main]\n\n// std\nuse std::io::{Cursor, Write};\nuse std::time::Duration;\n\n// gosling\nuse ::gosling::*;\nuse context::*;\n\n// extern\nuse bson::Bson;\nuse bson::Document;\nuse bson::doc;\nuse bson::spec::BinarySubtype;\nuse data_encoding::HEXLOWER;\nuse tor_interface::mock_tor_client::*;\nuse tor_interface::tor_crypto::*;\nuse tor_interface::tor_provider::*;\nuse honk_rpc::honk_rpc::{get_message_overhead, get_response_section_size};\n\n// fuzzing\nuse libfuzzer_sys::fuzz_target;\nuse libfuzzer_sys::arbitrary;\nuse libfuzzer_sys::arbitrary::Arbitrary;\n\nmod arbitrary_types;\nuse crate::arbitrary_types::*;\n\nmod utils;\nuse crate::utils::*;\n\n#[derive(Arbitrary, Debug)]\nenum BeginHandshakeMessage {\n    // random bytes\n    Noise(Vec\u003cu8\u003e),\n    /* HonkRpcMessage */\n    /* BSON */\n    // a valid honkrpc request\n    Request{\n        version: Argument\u003cString\u003e,\n        client_identity: Argument\u003cArbitraryV3OnionServiceId\u003e,\n        endpoint: Argument\u003cString\u003e,\n    },\n}\n\n#[derive(Arbitrary, Debug)]\nenum SendResponseMessage {\n    Noise(Vec\u003cu8\u003e),\n    /* HonkRpcMessage */\n    /* BSON */\n    // a valid honkrpc requst\n    Request{\n        client_cookie: Argument\u003cCookie\u003e,\n        client_identity_proof_signature: Argument\u003cArbitraryEd25519Signature\u003e,\n        client_authorization_key: Argument\u003cArbitraryX25519PrivateKey\u003e,\n        client_authorization_key_signbit: Argument\u003cbool\u003e,\n        client_authorization_signature: Argument\u003cArbitraryEd25519Signature\u003e,\n        challenge_response: Argument\u003cArbitraryBSONDocument\u003e,\n    },\n}\n\n#[derive(Arbitrary, Debug)]\nstruct HandshakeData {\n    // server data\n    alice_private_ed25519: ArbitraryEd25519PrivateKey,\n    client_allowed: bool,\n    endpoint_supported: bool,\n    endpoint_challenge: ArbitraryBSONDocument,\n    // client data\n    bob_private_ed25519: ArbitraryEd25519PrivateKey,\n    bob_private_x25519: ArbitraryX25519PrivateKey,\n    client_cookie: Cookie,\n    // client messages\n    begin_handshake_cookie: i64,\n    begin_handshake: BeginHandshakeMessage,\n    send_response_cookie: i64,\n    send_response: SendResponseMessage,\n}\n\n// two gosling instance, Alice and Bob\n// Alice is a valid server, Bob connects and sends garbage at certain point in the form of bad data in correctly structured+ordered gosling bison messages or noise\nfuzz_target!(|data: HandshakeData| {\n\n    //\n    // Init Alice server and malicious Bob client\n    //\n\n    // init alice\n    let alice_tor = MockTorClient::new();\n\n    // create alice gosling context\n    let alice_private_key = data.alice_private_ed25519.value;\n    let alice_onion_service_id = V3OnionServiceId::from_private_key(\u0026alice_private_key);\n    let mut alice = Context::new(Box::new(alice_tor), 420, 420, std::time::Duration::from_millis(32), IDENTITY_MAX_MESSAGE_SIZE, None, alice_private_key).unwrap();\n\n    // bootstrap alice\n    alice.bootstrap().unwrap();\n    let mut identity_server_published: bool = false;\n    while !identity_server_published {\n        for event in alice.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::TorBootstrapStatusReceived{progress: _, tag: _, summary: _} =\u003e (),\n                ContextEvent::TorBootstrapCompleted =\u003e {\n                    // start alice identity server\n                    alice.identity_server_start().unwrap();\n                }\n                ContextEvent::TorLogReceived{line: _} =\u003e (),\n                ContextEvent::IdentityServerPublished =\u003e {\n                    identity_server_published = true;\n                }\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n\n    // init bob\n    let mut bob_tor = MockTorClient::new();\n\n    // bootstrap bob\n    bob_tor.bootstrap().unwrap();\n    let mut bootstrap_complete = false;\n    while !bootstrap_complete {\n        for event in bob_tor.update().unwrap().drain(..) {\n            match event {\n                TorEvent::BootstrapComplete =\u003e {\n                    bootstrap_complete = true;\n                }\n                _ =\u003e ()\n            }\n        }\n    }\n\n    let bob_private_key = data.bob_private_ed25519.value;\n    let bob_onion_service_id = V3OnionServiceId::from_private_key(\u0026bob_private_key);\n    let bob_onion_service_id_string = bob_onion_service_id.to_string();\n\n    // bob connects to alice\n    let mut bob_stream = bob_tor.connect((alice_onion_service_id.clone(), 420).into(), None).unwrap();\n    bob_stream.set_nonblocking(false).unwrap();\n    bob_stream.set_read_timeout(Some(Duration::from_millis(100u64))).unwrap();\n\n    //\n    // Alice waits for handshake started\n    //\n    let mut alice_handshake_started: bool = false;\n    let mut alice_handshake_handle: HandshakeHandle = INVALID_HANDSHAKE_HANDLE;\n    while !alice_handshake_started {\n        for event in alice.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::IdentityServerHandshakeStarted{handle} =\u003e {\n                    alice_handshake_started = true;\n                    alice_handshake_handle = handle;\n                }\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n\n    //\n    // Bob sends begin_handshake()\n    //\n    #[derive(PartialEq, Debug)]\n    enum ExpectedBeginHandshakeResponse {\n        // Success Case\n        EndpointRequestReceived,\n        // Error Cases\n        ErrorTimedOut,\n        ErrorBsonParseFailure,\n        ErrorBsonTooSmall,\n        ErrorBsonTooLarge,\n        ErrorMessageParseFailure,\n        ErrorBadGoslingVersion,\n        ErrorInvalidArg,\n        ErrorBadClient,\n    }\n    let mut expected_response = ExpectedBeginHandshakeResponse::EndpointRequestReceived;\n\n    let message = match \u0026data.begin_handshake {\n        BeginHandshakeMessage::Noise(bytes) =\u003e {\n            expected_response = match bytes.len() {\n                0..=3 =\u003e ExpectedBeginHandshakeResponse::ErrorTimedOut,\n                len =\u003e {\n                    let size: i32 = (bytes[0] as i32)\n                                  | (bytes[1] as i32) \u003c\u003c 8\n                                  | (bytes[2] as i32) \u003c\u003c 16\n                                  | (bytes[3] as i32) \u003c\u003c 24;\n                    if size \u003c= 4 {\n                        ExpectedBeginHandshakeResponse::ErrorBsonTooSmall\n                    } else if size \u003e IDENTITY_MAX_MESSAGE_SIZE {\n                        ExpectedBeginHandshakeResponse::ErrorBsonTooLarge\n                    } else if size as usize \u003e len {\n                        ExpectedBeginHandshakeResponse::ErrorTimedOut\n                    } else {\n                        match bson::document::Document::from_reader(Cursor::new(bytes.clone())) {\n                            Ok(_) =\u003e ExpectedBeginHandshakeResponse::ErrorMessageParseFailure,\n                            Err(_) =\u003e ExpectedBeginHandshakeResponse::ErrorBsonParseFailure,\n                        }\n                    }\n                }\n            };\n            bytes.clone()\n        },\n        BeginHandshakeMessage::Request{\n            version,\n            client_identity,\n            endpoint} =\u003e {\n            match (\u0026version, \u0026client_identity, \u0026endpoint) {\n                (Argument::Valid, Argument::Valid | Argument::Invalid(_), Argument::Valid | Argument::Invalid(_)) =\u003e (),\n                (Argument::Missing | Argument::Invalid(_) | Argument::Random(_), _, _) =\u003e  expected_response = ExpectedBeginHandshakeResponse::ErrorBadGoslingVersion,\n                _ =\u003e expected_response = ExpectedBeginHandshakeResponse::ErrorInvalidArg,\n            }\n\n            let mut message = Document::new();\n            message.insert(\"honk_rpc\", Bson::Int32(HONK_RPC));\n\n            let mut section = Document::new();\n            section.insert(\"id\", Bson::Int32(REQUEST_SECTION));\n            section.insert(\"namespace\", Bson::String(\"gosling_identity\".to_string()));\n            section.insert(\"function\", Bson::String(\"begin_handshake\".to_string()));\n            section.insert(\"cookie\", Bson::Int64(data.begin_handshake_cookie));\n\n            let mut arguments = Document::new();\n            let version = match version {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e Some(Bson::String(GOSLING_PROTOCOL_VERSION.to_string())),\n                Argument::Invalid(invalid) =\u003e {\n                    if invalid == GOSLING_PROTOCOL_VERSION {\n                        Some(Bson::String(\"invalid_version\".to_string()))\n                    } else {\n                        Some(Bson::String(invalid.clone()))\n                    }\n                },\n                Argument::Random(ArbitraryBSON{value: Bson::String(_)}) =\u003e Some(Bson::Null),\n                Argument::Random(bson) =\u003e Some(bson.value.clone()),\n            };\n            if let Some(version) = version {\n                arguments.insert(\"version\", version);\n            }\n\n            let client_identity = match client_identity {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e Some(Bson::String(bob_onion_service_id_string.clone())),\n                Argument::Invalid(invalid) =\u003e {\n                    let invalid = invalid.value.to_string();\n                    Some(Bson::String(invalid))\n                },\n                Argument::Random(ArbitraryBSON{value: Bson::String(_)}) =\u003e Some(Bson::Null),\n                Argument::Random(bson) =\u003e Some(bson.value.clone()),\n            };\n            if let Some(client_identity) = client_identity {\n                arguments.insert(\"client_identity\", client_identity);\n            }\n\n            let endpoint = match endpoint {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e Some(Bson::String(VALID_ENDPOINT.to_string())),\n                Argument::Invalid(value) =\u003e {\n                    if value == VALID_ENDPOINT {\n                        Some(Bson::String(\"invalid_endpoint\".to_string()))\n                    } else if value.is_ascii() {\n                        Some(Bson::String(value.clone()))\n                    } else {\n                        Some(Bson::String(Default::default()))\n                    }\n                },\n                Argument::Random(ArbitraryBSON{value: Bson::String(value)}) =\u003e {\n                    if !value.is_ascii() {\n                        Some(Bson::String(value.clone()))\n                    } else {\n                        Some(Bson::Null)\n                    }\n                },\n                Argument::Random(bson) =\u003e Some(bson.value.clone()),\n            };\n            if let Some(endpoint) = endpoint {\n                arguments.insert(\"endpoint\", endpoint);\n            }\n\n            section.insert(\"arguments\", arguments);\n            message.insert(\"sections\", vec![section]);\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            message.to_writer(\u0026mut bytes).unwrap();\n            if bytes.len() \u003e IDENTITY_MAX_MESSAGE_SIZE as usize {\n                expected_response = ExpectedBeginHandshakeResponse::ErrorBsonTooLarge;\n            }\n            bytes\n        },\n    };\n    bob_stream.write(message.as_slice()).unwrap();\n\n    //\n    // Alice handles begin_handshake()\n    //\n    let mut alice_begin_handshake_handled: bool = false;\n    while !alice_begin_handshake_handled {\n        for event in alice.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::IdentityServerEndpointRequestReceived{handle, client_service_id: _, requested_endpoint} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    assert_eq!(expected_response, ExpectedBeginHandshakeResponse::EndpointRequestReceived);\n                    #[derive(PartialEq, Debug)]\n                    enum ExpectedHandleEndpointRequestReceiveResult {\n                        Success,\n                        // Error Cases\n                        ErrorSectionTooLarge,\n                    }\n\n                    let mut expected_result = ExpectedHandleEndpointRequestReceiveResult::Success;\n\n                    // calculate the expected size of our reponse message\n                    let begin_handshake_complete_message_size = {\n                        let result = doc!{\n                            \"server_cookie\" : bson::Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: [0u8; COOKIE_SIZE].to_vec()}),\n                            \"endpoint_challenge\" : data.endpoint_challenge.value.clone(),\n                        };\n                        let response_section_size = get_response_section_size(Some(Bson::Document(result))).unwrap();\n                        get_message_overhead().unwrap() + response_section_size\n                    };\n                    if begin_handshake_complete_message_size \u003e IDENTITY_MAX_MESSAGE_SIZE as usize {\n                        expected_result = ExpectedHandleEndpointRequestReceiveResult::ErrorSectionTooLarge;\n                    }\n\n                    match alice.identity_server_handle_endpoint_request_received(\n                        alice_handshake_handle,\n                        data.client_allowed,\n                        data.endpoint_supported \u0026\u0026 requested_endpoint == VALID_ENDPOINT,\n                        data.endpoint_challenge.value.clone()) {\n                        Err(context::Error::IdentityServerError(identity_server::Error::EndpointChallengeTooLarge(_,_))) =\u003e {\n                            assert_eq!(expected_result, ExpectedHandleEndpointRequestReceiveResult::ErrorSectionTooLarge);\n                            return;\n                        },\n                        Ok(()) =\u003e {\n                            assert_eq!(expected_result, ExpectedHandleEndpointRequestReceiveResult::Success);\n                        }\n                        result =\u003e panic!(\"unexpected result: {:?}\", result)\n                    }\n\n                    alice_begin_handshake_handled = true;\n                }\n                ContextEvent::IdentityServerHandshakeFailed{handle, reason} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    match reason {\n                        context::Error::IdentityServerError(\n                            identity_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageReadTimedOut(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedBeginHandshakeResponse::ErrorTimedOut, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityServerError(\n                            identity_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentParseFailed(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedBeginHandshakeResponse::ErrorBsonParseFailure, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityServerError(\n                            identity_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooSmall(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedBeginHandshakeResponse::ErrorBsonTooSmall, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityServerError(\n                            identity_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooLarge(_, _))) =\u003e {\n                            assert_eq!(expected_response, ExpectedBeginHandshakeResponse::ErrorBsonTooLarge, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityServerError(\n                            identity_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageConversionFailed(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedBeginHandshakeResponse::ErrorMessageParseFailure, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityServerError(identity_server::Error::BadClient) =\u003e {\n                            assert!(expected_response == ExpectedBeginHandshakeResponse::ErrorBadClient ||\n                                    expected_response == ExpectedBeginHandshakeResponse::ErrorBadGoslingVersion ||\n                                    expected_response == ExpectedBeginHandshakeResponse::ErrorInvalidArg, \"{:?}\", reason);\n                        },\n                        error =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n                    alice_begin_handshake_handled = true;\n                }\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n        // Alice sends Bob begin_handshake() response (or does nothing)\n    for event in alice.update().unwrap().drain(..) {\n        match event {\n            event =\u003e panic!(\"unexpected event: {:?}\", event),\n        }\n    }\n\n    //\n    // Bob reads begin_handshake() response or error sections\n    //\n\n    // bob receives begin_handshake() pending response\n    let begin_handshake_pending = bson::document::Document::from_reader(\u0026mut bob_stream);\n    match expected_response {\n        ExpectedBeginHandshakeResponse::ErrorTimedOut |\n        ExpectedBeginHandshakeResponse::ErrorBsonTooSmall |\n        ExpectedBeginHandshakeResponse::ErrorBsonTooLarge |\n        ExpectedBeginHandshakeResponse::ErrorBsonParseFailure |\n        ExpectedBeginHandshakeResponse::ErrorMessageParseFailure =\u003e {\n            match begin_handshake_pending {\n                Err(bson::de::Error::Io(_)) =\u003e return,\n                Ok(message) =\u003e panic!(\"unexpected message: {:?}\", message),\n                Err(error) =\u003e panic!(\"unexpected error: {:?}\", error),\n            }\n        },\n        ExpectedBeginHandshakeResponse::ErrorBadGoslingVersion =\u003e {\n            match begin_handshake_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": ERROR_SECTION,\n                                \"cookie\": data.begin_handshake_cookie,\n                                \"code\": ERROR_CODE_BAD_VERSION,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n        ExpectedBeginHandshakeResponse::ErrorInvalidArg =\u003e {\n            match begin_handshake_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": ERROR_SECTION,\n                                \"cookie\": data.begin_handshake_cookie,\n                                \"code\": ERROR_CODE_INVALID_ARG,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n        ExpectedBeginHandshakeResponse::EndpointRequestReceived |\n        ExpectedBeginHandshakeResponse::ErrorBadClient =\u003e {\n            match begin_handshake_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": RESPONSE_SECTION,\n                                \"cookie\": data.begin_handshake_cookie,\n                                \"state\": PENDING_REQUEST_STATE,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        }\n    }\n\n    // bob receives begin_handshake() result\n    let begin_handshake_result = bson::document::Document::from_reader(\u0026mut bob_stream);\n    let mut server_cookie: Cookie = Default::default();\n    match expected_response {\n        ExpectedBeginHandshakeResponse::ErrorTimedOut |\n        ExpectedBeginHandshakeResponse::ErrorBsonTooSmall |\n        ExpectedBeginHandshakeResponse::ErrorBsonTooLarge |\n        ExpectedBeginHandshakeResponse::ErrorBsonParseFailure |\n        ExpectedBeginHandshakeResponse::ErrorMessageParseFailure |\n        ExpectedBeginHandshakeResponse::ErrorBadGoslingVersion |\n        ExpectedBeginHandshakeResponse::ErrorInvalidArg =\u003e {\n            match begin_handshake_result {\n                Err(bson::de::Error::Io(_)) =\u003e return,\n                Ok(message) =\u003e panic!(\"unexpected message: {:?}\", message),\n                Err(error) =\u003e panic!(\"unexpected error: {:?}\", error),\n            }\n        },\n        ExpectedBeginHandshakeResponse::ErrorBadClient =\u003e {\n            match begin_handshake_result {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": ERROR_SECTION,\n                                \"cookie\": data.begin_handshake_cookie,\n                                \"code\": ERROR_CODE_FAILURE,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n        ExpectedBeginHandshakeResponse::EndpointRequestReceived =\u003e {\n            match begin_handshake_result {\n                Ok(message) =\u003e {\n                    assert_eq!(message.get_i32(\"honk_rpc\").unwrap(), HONK_RPC);\n                    let sections = message.get_array(\"sections\").unwrap();\n                    assert_eq!(sections.len(), 1);\n                    let section = \u0026sections[0];\n                    match section {\n                        Bson::Document(section) =\u003e {\n                            assert_eq!(section.get_i32(\"id\"), Ok(RESPONSE_SECTION));\n                            let response = section;\n                            assert_eq!(response.get_i64(\"cookie\"), Ok(data.begin_handshake_cookie));\n                            assert_eq!(response.get_i32(\"state\"), Ok(COMPLETE_REQUEST_STATE));\n                            let result = response.get_document(\"result\").unwrap();\n                            server_cookie = result.get_binary_generic(\"server_cookie\").unwrap().clone().try_into().unwrap();\n                            let endpoint_challenge = result.get_document(\"endpoint_challenge\").unwrap();\n                            // compare the raw bytes ince an arbitrary bson doc may have Double(NaN) which fails equality test\n                            assert_eq!({\n                                let mut bytes: Vec\u003cu8\u003e = Default::default();\n                                endpoint_challenge.to_writer(\u0026mut bytes).unwrap();\n                                bytes\n                            },{\n                                let mut bytes: Vec\u003cu8\u003e = Default::default();\n                                data.endpoint_challenge.value.to_writer(\u0026mut bytes).unwrap();\n                                bytes\n                            });\n                        },\n                        bson =\u003e panic!(\"unexpected section: {:?}\", bson),\n                    }\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        }\n\n    }\n\n    //\n    // Bsob sends send_response()\n    //\n\n    #[derive(PartialEq, Debug)]\n    enum ExpectedSendResponseResponse {\n        // Success Case\n        EndpointOnionServiceIdReceived,\n        // Error Cases\n        ErrorTimedOut,\n        ErrorBsonParseFailure,\n        ErrorBsonTooSmall,\n        ErrorBsonTooLarge,\n        ErrorMessageParseFailure,\n        ErrorInvalidArg,\n        ErrorBadClient,\n    }\n    let mut expected_response = match (data.client_allowed \u0026\u0026 data.endpoint_supported, data.begin_handshake) {\n        (true, BeginHandshakeMessage::Request{version: Argument::Valid, client_identity: Argument::Valid, endpoint: Argument::Valid}) =\u003e ExpectedSendResponseResponse::EndpointOnionServiceIdReceived,\n        _ =\u003e ExpectedSendResponseResponse::ErrorBadClient,\n    };\n\n    let message = match data.send_response {\n        SendResponseMessage::Noise(bytes) =\u003e {\n            expected_response = match bytes.len() {\n                0..=3 =\u003e ExpectedSendResponseResponse::ErrorTimedOut,\n                len =\u003e {\n                    let size: i32 = (bytes[0] as i32)\n                                  | (bytes[1] as i32) \u003c\u003c 8\n                                  | (bytes[2] as i32) \u003c\u003c 16\n                                  | (bytes[3] as i32) \u003c\u003c 24;\n                    if size \u003c= 4 {\n                        ExpectedSendResponseResponse::ErrorBsonTooSmall\n                    } else if size \u003e IDENTITY_MAX_MESSAGE_SIZE {\n                        ExpectedSendResponseResponse::ErrorBsonTooLarge\n                    } else if size as usize \u003e len {\n                        ExpectedSendResponseResponse::ErrorTimedOut\n                    } else {\n                        match bson::document::Document::from_reader(Cursor::new(bytes.clone())) {\n                            Ok(_) =\u003e ExpectedSendResponseResponse::ErrorMessageParseFailure,\n                            Err(_) =\u003e ExpectedSendResponseResponse::ErrorBsonParseFailure,\n                        }\n                    }\n                }\n            };\n            bytes\n        },\n        SendResponseMessage::Request{\n            client_cookie,\n            client_identity_proof_signature,\n            client_authorization_key,\n            client_authorization_key_signbit,\n            client_authorization_signature,\n            challenge_response} =\u003e {\n            match (\u0026client_cookie, \u0026client_identity_proof_signature, \u0026client_authorization_key, \u0026client_authorization_key_signbit, \u0026client_authorization_signature, \u0026challenge_response) {\n                (Argument::Valid, Argument::Valid, Argument::Valid, Argument::Valid, Argument::Valid, Argument::Valid) =\u003e (),\n                (Argument::Valid | Argument::Invalid(_),\n                 Argument::Valid | Argument::Invalid(_),\n                 Argument::Valid | Argument::Invalid(_),\n                 Argument::Valid | Argument::Invalid(_),\n                 Argument::Valid | Argument::Invalid(_),\n                 Argument::Valid | Argument::Invalid(_)) =\u003e expected_response = ExpectedSendResponseResponse::ErrorBadClient,\n                _ =\u003e expected_response = ExpectedSendResponseResponse::ErrorInvalidArg,\n            }\n\n            let mut message = Document::new();\n            message.insert(\"honk_rpc\", Bson::Int32(HONK_RPC));\n\n            let mut section = Document::new();\n            section.insert(\"id\", Bson::Int32(REQUEST_SECTION));\n            section.insert(\"namespace\", Bson::String(\"gosling_identity\".to_string()));\n            section.insert(\"function\", Bson::String(\"send_response\".to_string()));\n            section.insert(\"cookie\", Bson::Int64(data.send_response_cookie));\n\n            let mut arguments = Document::new();\n            let client_cookie = match client_cookie {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: data.client_cookie.to_vec()})),\n                Argument::Invalid(value) =\u003e {\n                    // ensure the cookie is actually invalid\n                    if value == data.client_cookie {\n                        Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: value.map(|x| !x).to_vec()}))\n                    } else {\n                        Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: value.to_vec()}))\n                    }\n                }\n                Argument::Random(ArbitraryBSON{value: Bson::Binary(_)}) =\u003e Some(Bson::Null),\n                Argument::Random(bson) =\u003e Some(bson.value),\n            };\n            if let Some(client_cookie) = client_cookie {\n                arguments.insert(\"client_cookie\", client_cookie);\n            }\n\n            let client_identity_proof_signature = match client_identity_proof_signature {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e {\n                    let client_identity_proof = build_client_proof(\"gosling-identity\", VALID_ENDPOINT, \u0026bob_onion_service_id, \u0026alice_onion_service_id, \u0026data.client_cookie, \u0026server_cookie);\n                    let client_identity_proof_signature = bob_private_key.sign_message(\u0026client_identity_proof);\n                    Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_identity_proof_signature.to_bytes().to_vec()}))\n                },\n                Argument::Invalid(invalid) =\u003e {\n                    Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: invalid.value.to_bytes().to_vec()}))\n                }\n                Argument::Random(ArbitraryBSON{value: Bson::Binary(_)}) =\u003e Some(Bson::Null),\n                Argument::Random(bson) =\u003e Some(bson.value),\n            };\n            if let Some(client_identity_proof_signature) = client_identity_proof_signature {\n                arguments.insert(\"client_identity_proof_signature\", client_identity_proof_signature);\n            }\n\n            let client_authorization_key = match client_authorization_key {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e {\n                    let client_authorization_key = X25519PublicKey::from_private_key(\u0026data.bob_private_x25519.value);\n                    Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_authorization_key.as_bytes().to_vec()}))\n                },\n                Argument::Invalid(invalid) =\u003e {\n                    let client_authorization_key = X25519PublicKey::from_private_key(\u0026invalid.value);\n                    Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_authorization_key.as_bytes().to_vec()}))\n                },\n                Argument::Random(bson) =\u003e Some(bson.value),\n            };\n            if let Some(client_authorization_key) = client_authorization_key {\n                arguments.insert(\"client_authorization_key\", client_authorization_key);\n            }\n\n            let client_authorization_signing_key_private = Ed25519PrivateKey::from_private_x25519(\u0026data.bob_private_x25519.value).unwrap();\n            let client_authorization_key_signbit = match client_authorization_key_signbit {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e {\n                    let signbit = client_authorization_signing_key_private.1;\n                    Some(Bson::Boolean(bool::from(signbit)))\n                },\n                Argument::Invalid(_) =\u003e {\n                    let signbit = client_authorization_signing_key_private.1;\n                    Some(Bson::Boolean(!bool::from(signbit)))\n                },\n                Argument::Random(ArbitraryBSON{value: Bson::Boolean(_)}) =\u003e Some(Bson::Null),\n                Argument::Random(bson) =\u003e Some(bson.value),\n            };\n            if let Some(client_authorization_key_signbit) = client_authorization_key_signbit {\n                arguments.insert(\"client_authorization_key_signbit\", client_authorization_key_signbit);\n            }\n\n            let client_authorization_signature = match client_authorization_signature {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e {\n                    let client_authorization_signature = client_authorization_signing_key_private.0.sign_message(bob_onion_service_id_string.as_bytes());\n                    Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_authorization_signature.to_bytes().to_vec()}))\n                },\n                Argument::Invalid(invalid) =\u003e {\n                    Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: invalid.value.to_bytes().to_vec()}))\n                },\n                Argument::Random(bson) =\u003e Some(bson.value),\n            };\n            if let Some(client_authorization_signature) = client_authorization_signature {\n                arguments.insert(\"client_authorization_signature\", client_authorization_signature);\n            }\n\n            let challenge_response = match challenge_response {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e Some(Bson::Document(Document::new())),\n                Argument::Invalid(ArbitraryBSONDocument{value}) =\u003e {\n                    // server is expecting an empty response so to be invalid\n                    // it must contain *some* member\n                    if value == Document::new() {\n                        Some(Bson::Document(doc!{\"foo\": Bson::Null}))\n                    } else {\n                        Some(Bson::Document(value))\n                    }\n                },\n                Argument::Random(ArbitraryBSON{value: Bson::Document(_)}) =\u003e Some(Bson::Null),\n                Argument::Random(bson) =\u003e Some(bson.value),\n            };\n            if let Some(challenge_response) = challenge_response {\n                arguments.insert(\"challenge_response\", challenge_response);\n            }\n\n            section.insert(\"arguments\", arguments);\n            message.insert(\"sections\", vec![section]);\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            message.to_writer(\u0026mut bytes).unwrap();\n            if bytes.len() \u003e IDENTITY_MAX_MESSAGE_SIZE as usize {\n                expected_response = ExpectedSendResponseResponse::ErrorBsonTooLarge;\n            }\n            bytes\n        },\n    };\n    bob_stream.write(message.as_slice()).unwrap();\n\n\n    //\n    // Alice handles send_response()\n    //\n\n    let mut alice_send_response_handled: bool = false;\n    while !alice_send_response_handled {\n        for event in alice.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::IdentityServerHandshakeFailed{handle, reason} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    match reason {\n                        context::Error::IdentityServerError(\n                            identity_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageReadTimedOut(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedSendResponseResponse::ErrorTimedOut, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityServerError(\n                            identity_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentParseFailed(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedSendResponseResponse::ErrorBsonParseFailure, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityServerError(\n                            identity_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooSmall(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedSendResponseResponse::ErrorBsonTooSmall, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityServerError(\n                            identity_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooLarge(_, _))) =\u003e {\n                            assert_eq!(expected_response, ExpectedSendResponseResponse::ErrorBsonTooLarge, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityServerError(\n                            identity_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageConversionFailed(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedSendResponseResponse::ErrorMessageParseFailure, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityServerError(identity_server::Error::BadClient) =\u003e {\n                            assert!(expected_response == ExpectedSendResponseResponse::ErrorBadClient ||\n                                    expected_response == ExpectedSendResponseResponse::ErrorInvalidArg, \"{:?}\", reason);\n                        },\n                        error =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n                    alice_send_response_handled = true;\n                },\n                ContextEvent::IdentityServerChallengeResponseReceived{handle, challenge_response} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    alice.identity_server_handle_challenge_response_received(handle, challenge_response == Document::new()).unwrap();\n                },\n                ContextEvent::IdentityServerHandshakeCompleted{handle, endpoint_private_key: _, endpoint_name, client_service_id: _, client_auth_public_key: _} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    assert_eq!(endpoint_name, VALID_ENDPOINT);\n                    alice_send_response_handled = true;\n                    assert_eq!(expected_response, ExpectedSendResponseResponse::EndpointOnionServiceIdReceived);\n                },\n                ContextEvent::IdentityServerHandshakeRejected { handle, client_allowed: _, client_requested_endpoint_valid: _, client_proof_signature_valid: _, client_auth_signature_valid: _, challenge_response_valid: _} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    alice_send_response_handled = true;\n                },\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n\n    //\n    // Bob reads send_response() response or error sections\n    //\n\n    // first read response (pending) or error section\n    let send_response_pending = bson::document::Document::from_reader(\u0026mut bob_stream);\n    match expected_response {\n        ExpectedSendResponseResponse::ErrorTimedOut |\n        ExpectedSendResponseResponse::ErrorBsonTooSmall |\n        ExpectedSendResponseResponse::ErrorBsonTooLarge |\n        ExpectedSendResponseResponse::ErrorBsonParseFailure |\n        ExpectedSendResponseResponse::ErrorMessageParseFailure =\u003e {\n            match send_response_pending {\n                Err(bson::de::Error::Io(_)) =\u003e return,\n                Ok(message) =\u003e panic!(\"unexpected message: {:?}\", message),\n                Err(error) =\u003e panic!(\"unexpected error: {:?}\", error),\n            }\n        },\n        ExpectedSendResponseResponse::ErrorInvalidArg =\u003e {\n            match send_response_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": ERROR_SECTION,\n                                \"cookie\": data.send_response_cookie,\n                                \"code\": ERROR_CODE_INVALID_ARG,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n        ExpectedSendResponseResponse::EndpointOnionServiceIdReceived |\n        ExpectedSendResponseResponse::ErrorBadClient =\u003e {\n            match send_response_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": RESPONSE_SECTION,\n                                \"cookie\": data.send_response_cookie,\n                                \"state\": PENDING_REQUEST_STATE,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        }\n    }\n\n    // next read response (result) or error section\n    let send_response_result = bson::document::Document::from_reader(\u0026mut bob_stream);\n    match expected_response {\n        ExpectedSendResponseResponse::ErrorTimedOut |\n        ExpectedSendResponseResponse::ErrorBsonTooSmall |\n        ExpectedSendResponseResponse::ErrorBsonTooLarge |\n        ExpectedSendResponseResponse::ErrorBsonParseFailure |\n        ExpectedSendResponseResponse::ErrorMessageParseFailure |\n        ExpectedSendResponseResponse::ErrorInvalidArg =\u003e {\n            match send_response_result {\n                Err(bson::de::Error::Io(_)) =\u003e return,\n                Ok(message) =\u003e panic!(\"unexpected message: {:?}\", message),\n                Err(error) =\u003e panic!(\"unexpected error: {:?}\", error),\n            }\n        },\n        ExpectedSendResponseResponse::ErrorBadClient =\u003e {\n            match send_response_result {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": ERROR_SECTION,\n                                \"cookie\": data.send_response_cookie,\n                                \"code\": ERROR_CODE_FAILURE,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n        ExpectedSendResponseResponse::EndpointOnionServiceIdReceived =\u003e {\n            match send_response_result {\n                Ok(message) =\u003e {\n                    assert_eq!(message.get_i32(\"honk_rpc\").unwrap(), HONK_RPC);\n                    let sections = message.get_array(\"sections\").unwrap();\n                    assert_eq!(sections.len(), 1);\n                    let response = \u0026sections[0];\n                    match response {\n                        Bson::Document(response) =\u003e {\n                            assert_eq!(response.get_i32(\"id\").unwrap(), RESPONSE_SECTION, \"{:?}\", message);\n                            assert_eq!(response.get_i64(\"cookie\").unwrap(), data.send_response_cookie, \"{:?}\", message);\n                            assert_eq!(response.get_i32(\"state\").unwrap(), COMPLETE_REQUEST_STATE, \"{:?}\", message);\n                            match response.get(\"result\") {\n                                Some(Bson::String(serviceid)) =\u003e {\n                                    // ensure returned valueis a valid service id\n                                    V3OnionServiceId::from_string(serviceid).unwrap();\n                                },\n                                Some(bson) =\u003e panic!(\"unexpected result: {:?}\", bson),\n                                None =\u003e panic!(\"unexpected send_response result message: {:?}\", message),\n                            }\n                        },\n                        bson =\u003e panic!(\"unexpected section: {:?}\", bson),\n                    }\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n    }\n\n    // success!\n    ()\n});\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","fuzz","fuzz_targets","utils.rs"],"content":"// extern\nuse data_encoding::HEXLOWER;\nuse tor_interface::tor_crypto::*;\n\n\n// honk-rpc constants\npub(crate) const HONK_RPC: i32 = 0x00000100; // semver 0.1.0\npub(crate) const ERROR_SECTION: i32 = 0;\npub(crate) const ERROR_CODE_BAD_VERSION: i32 = 0;\npub(crate) const ERROR_CODE_REQUEST_COOKIE_REQUIRED: i32 = 1;\npub(crate) const ERROR_CODE_INVALID_ARG: i32 = 2;\npub(crate) const ERROR_CODE_FAILURE: i32 = 3;\npub(crate) const REQUEST_SECTION: i32 = 1;\npub(crate) const RESPONSE_SECTION: i32 = 2;\npub(crate) const PENDING_REQUEST_STATE: i32 = 0;\npub(crate) const COMPLETE_REQUEST_STATE: i32 = 1;\n\n// gosling constants\npub(crate) const INVALID_HANDSHAKE_HANDLE: gosling::context::HandshakeHandle = !0usize;\npub(crate) const GOSLING_PROTOCOL_VERSION: \u0026str = \"0.1.0\";\npub(crate) const GOSLING_IDENTITY_NAMESPACE: \u0026str = \"gosling_identity\";\npub(crate) const GOSLING_IDENTITY_BEGIN_HANDSHAKE_FUNCTION: \u0026str = \"begin_handshake\";\npub(crate) const GOSLING_IDENTITY_SEND_RESPONSE_FUNCTION: \u0026str = \"send_response\";\npub(crate) const GOSLING_ENDPOINT_NAMESPACE: \u0026str = \"gosling_endpoint\";\npub(crate) const GOSLING_ENDPOINT_BEGIN_HANDSHAKE_FUNCTION: \u0026str = \"begin_handshake\";\npub(crate) const GOSLING_ENDPOINT_SEND_RESPONSE_FUNCTION: \u0026str = \"send_response\";\npub(crate) const VALID_ENDPOINT: \u0026str = \"valid_endpoint\";\npub(crate) const VALID_CHANNEL: \u0026str = \"valid_channel\";\npub(crate) const IDENTITY_MAX_MESSAGE_SIZE: i32 = 1024;\npub(crate) const ENDPOINT_MAX_MESSAGE_SIZE: i32 = 384;\npub(crate) const COOKIE_SIZE: usize = 32usize;\npub(crate) type Cookie = [u8; COOKIE_SIZE];\n\n\npub(crate) fn build_client_proof(\n    domain_separator: \u0026str,\n    request: \u0026str,\n    client_service_id: \u0026V3OnionServiceId,\n    server_service_id: \u0026V3OnionServiceId,\n    client_cookie: \u0026Cookie,\n    server_cookie: \u0026Cookie,\n) -\u003e Vec\u003cu8\u003e {\n    let mut client_proof: Vec\u003cu8\u003e= Default::default();\n\n    client_proof.extend_from_slice(domain_separator.as_bytes());\n    client_proof.push(0u8);\n    client_proof.extend_from_slice(request.as_bytes());\n    client_proof.push(0u8);\n    client_proof.extend_from_slice(client_service_id.to_string().as_bytes());\n    client_proof.push(0u8);\n    client_proof.extend_from_slice(server_service_id.to_string().as_bytes());\n    client_proof.push(0u8);\n    client_proof.extend_from_slice(HEXLOWER.encode(client_cookie).as_bytes());\n    client_proof.push(0u8);\n    client_proof.extend_from_slice(HEXLOWER.encode(server_cookie).as_bytes());\n\n    client_proof\n}","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","src","ascii_string.rs"],"content":"#[cfg(test)]\nuse anyhow::bail;\nuse std::ops::Deref;\n\n#[derive(thiserror::Error, Debug)]\npub(crate) enum Error {\n    #[error(\"input string is not ASCII: {0}\")]\n    InvalidAscii(String),\n}\n\n/// An immutable wrapper around a String guaranteed to be ASCII encoded\n#[derive(Clone, PartialEq)]\npub(crate) struct AsciiString {\n    value: String,\n}\n\nimpl AsciiString {\n    pub fn new(value: String) -\u003e Result\u003cAsciiString, Error\u003e {\n        if value.is_ascii() {\n            Ok(Self { value })\n        } else {\n            Err(Error::InvalidAscii(value))\n        }\n    }\n}\n\nimpl Deref for AsciiString {\n    type Target = String;\n\n    fn deref(\u0026self) -\u003e \u0026Self::Target {\n        \u0026self.value\n    }\n}\n\nimpl std::fmt::Debug for AsciiString {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        self.value.fmt(f)\n    }\n}\n\nimpl std::fmt::Display for AsciiString {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        self.value.fmt(f)\n    }\n}\n\n#[test]\nfn test_ascii_string() -\u003e anyhow::Result\u003c()\u003e {\n    let valid_ascii: [String; 8] = [\n        \"\".to_string(),\n        \" !\\\"#$%\u0026'()*+,-./\".to_string(),\n        \"0123456789\".to_string(),\n        \":\u003c=\u003e?@\".to_string(),\n        \"ABCDEFGHIJKLMNOPQRSTUVWXYZ\".to_string(),\n        \"[\\\\]^_`\".to_string(),\n        \"abcdefghijklmnopqstuvwxyz\".to_string(),\n        \"{|}~\".to_string(),\n    ];\n\n    for string in valid_ascii {\n        match AsciiString::new(string) {\n            Ok(string) =\u003e println!(\"ascii: '{}'\", string),\n            Err(err) =\u003e bail!(\"unexpected error: {}\", err),\n        }\n    }\n\n    let utf8: [String; 2] = [\"❤\".to_string(), \"heart ❤\".to_string()];\n\n    for string in utf8 {\n        match AsciiString::new(string) {\n            Ok(string) =\u003e bail!(\"this is not ascii: {}\", string),\n            Err(_) =\u003e (),\n        }\n    }\n\n    Ok(())\n}\n","traces":[{"line":18,"address":[4406848,4407200],"length":1,"stats":{"Line":2}},{"line":19,"address":[1993982,1994050,1994189],"length":1,"stats":{"Line":5}},{"line":20,"address":[1994201],"length":1,"stats":{"Line":2}},{"line":22,"address":[1994081],"length":1,"stats":{"Line":1}},{"line":30,"address":[1994336],"length":1,"stats":{"Line":2}},{"line":36,"address":[1994352],"length":1,"stats":{"Line":0}},{"line":37,"address":[4367518],"length":1,"stats":{"Line":0}},{"line":42,"address":[1994384],"length":1,"stats":{"Line":2}},{"line":43,"address":[1994398],"length":1,"stats":{"Line":2}}],"covered":7,"coverable":9},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","src","context.rs"],"content":"// standard\nuse std::clone::Clone;\nuse std::collections::{BTreeMap, HashMap, VecDeque};\nuse std::net::TcpStream;\nuse std::time::Duration;\n\n// extern crates\nuse honk_rpc::honk_rpc::*;\nuse tor_interface::tor_crypto::*;\nuse tor_interface::tor_provider::*;\n\n// internal crates\nuse crate::ascii_string::*;\nuse crate::endpoint_client;\nuse crate::endpoint_client::*;\nuse crate::endpoint_server;\nuse crate::endpoint_server::*;\nuse crate::identity_client;\nuse crate::identity_client::*;\nuse crate::identity_server;\nuse crate::identity_server::*;\n\n/// A handle to an in-progres identity or endpoint handshake\npub type HandshakeHandle = usize;\nconst DEFAULT_ENDPOINT_TIMEOUT: Duration = Duration::from_secs(60);\nconst DEFAULT_ENDPOINT_MAX_MESSAGE_SIZE: i32 = 384;\n\n/// The error type for the [`Context`] type.\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    /// An invalid argument was provided to a function\n    #[error(\"invalid argument: {0}\")]\n    InvalidArgument(String),\n\n    /// Function requiring tor connectivity called before bootstrap\n    #[error(\n        \"context is not connected, must call bootstrap() and wait for TorBootstrapCompleted event\"\n    )]\n    TorNotConnected(),\n\n    /// Provided handle does not map to an in-flight handshake\n    #[error(\"handshake handle {0} not found\")]\n    HandshakeHandleNotFound(HandshakeHandle),\n\n    /// Requesting an invalid operation\n    #[error(\"incorrect usage: {0}\")]\n    IncorrectUsage(String),\n\n    /// An underlying `std::io::Error`\n    #[error(transparent)]\n    Io(#[from] std::io::Error),\n\n    /// An underlying `honk_rpc::honk_rpc::Error`\n    #[error(transparent)]\n    HonkRpc(#[from] honk_rpc::honk_rpc::Error),\n\n    /// An underlying `tor_interface::tor_crypto::Error`\n    #[error(transparent)]\n    TorCrypto(#[from] tor_interface::tor_crypto::Error),\n\n    /// An underlying `tor_interface::tor_provider::Error`\n    #[error(transparent)]\n    TorProvider(#[from] tor_interface::tor_provider::Error),\n\n    /// Failure ocurred in outgoing identity handshake\n    #[error(transparent)]\n    IdentityClientError(#[from] identity_client::Error),\n\n    /// Failure ocurred in incoming identity handshake\n    #[error(transparent)]\n    IdentityServerError(#[from] identity_server::Error),\n\n    /// Failure ocurred in outgoing endpoint handshake\n    #[error(transparent)]\n    EndpointClientError(#[from] endpoint_client::Error),\n\n    /// Failure ocurred in incoming endpoint handshake\n    #[error(transparent)]\n    EndpointServerError(#[from] endpoint_server::Error),\n}\n\n/// The gosling protocol implementation.\n///\n/// The `Context` object provides various methods for starting and progressing identity and endpoint handshakes. The general usage pattern developers will follow is to construct a `Context` object, connect to the Tor Network using [`Context::bootstrap()`], optionally start an identity or endpoint servers, and listen for and handle incoming identity and endpoint clients using [`Context::update()`] and the various associated methods. Depending on the application's requirements, the developer can also initiate identity and endpoint handshakes as necessary.\n///\n/// The Gosling Protocol specification can be found here:\n/// - [https://gosling.technology/gosling-spec.xhtml](https://gosling.technology/gosling-spec.xhtml)\npub struct Context {\n    // our tor instance\n    tor_provider: Box\u003cdyn TorProvider\u003e,\n    bootstrap_complete: bool,\n    identity_port: u16,\n    endpoint_port: u16,\n    identity_timeout: Duration,\n    identity_max_message_size: i32,\n    endpoint_timeout: Duration,\n\n    //\n    // Servers and Clients for in-process handshakes\n    //\n    next_handshake_handle: HandshakeHandle,\n    identity_clients: BTreeMap\u003cHandshakeHandle, IdentityClient\u003e,\n    identity_servers: BTreeMap\u003cHandshakeHandle, IdentityServer\u003e,\n    endpoint_clients: BTreeMap\u003cHandshakeHandle, EndpointClient\u003e,\n    endpoint_servers: BTreeMap\u003cHandshakeHandle, EndpointServer\u003e,\n\n    //\n    // Listeners for incoming connections\n    //\n    identity_listener: Option\u003cOnionListener\u003e,\n    identity_server_published: bool,\n    // maps the endpoint service id to the (enpdoint name, alowed client, onion listener tuple, published)\n    endpoint_listeners: HashMap\u003cV3OnionServiceId, (String, V3OnionServiceId, OnionListener, bool)\u003e,\n\n    //\n    // Server Config Data\n    //\n\n    // Private key behind the identity onion service\n    identity_private_key: Ed25519PrivateKey,\n    // Identity server's service id\n    identity_service_id: V3OnionServiceId,\n}\n\n/// Events to signal completion of asynchronous [`Context`] operations\n#[derive(Debug)]\npub enum ContextEvent {\n    //\n    // Tor Events\n    //\n\n    /// Tor bootstrap progress\n    TorBootstrapStatusReceived {\n        /// Bootstrap percent compeletion\n        progress: u32,\n        /// A short string indicating the completed bootstrap step\n        tag: String,\n        /// A longer human-readable summary of the bootstrap progress\n        summary: String,\n    },\n\n    /// Tor bootstrap completed\n    TorBootstrapCompleted,\n\n    /// Human-readable logs from the [`Context`]'s [`TorProvider`]\n    TorLogReceived {\n        /// Human-readable debug log\n        line: String,\n    },\n\n    //\n    // Identity Client Events\n    //\n\n    /// An identity client has received a challenge request from an identy server\n    ///\n    /// To continue the handshake, the client must call [`Context::identity_client_handle_challenge_received()`]\n    IdentityClientChallengeReceived {\n        /// The handle of the in-progress handshake\n        handle: HandshakeHandle,\n        /// An application specific challenge object used by the identity client to create a challenge response object\n        endpoint_challenge: bson::document::Document,\n    },\n\n    /// An identity client has successfully completed an identity handshake and may now access the requested endpoint server.\n    IdentityClientHandshakeCompleted {\n        /// The handle of the completed handshake\n        handle: HandshakeHandle,\n        /// The onion-service service-id of the identity server the client has completed an identity handshake with\n        identity_service_id: V3OnionServiceId,\n        /// The onion-service service-id of the requested endpoint server\n        endpoint_service_id: V3OnionServiceId,\n        /// The ASCII-encoded name of the requested endpoint server\n        endpoint_name: String,\n        /// The private x25519 client-auth key required to access the requested endpoint server\n        client_auth_private_key: X25519PrivateKey,\n    },\n\n    /// An incoming identit handshake has failed\n    IdentityClientHandshakeFailed {\n        /// The handle of the failed handshake\n        handle: HandshakeHandle,\n        /// The failure reason\n        reason: Error,\n    },\n\n    /// The identity server's onion-service has been published and may be reachable by identity clients\n    IdentityServerPublished,\n\n    /// An identity server has received an incoming connection and the handshake is ready to begin\n    IdentityServerHandshakeStarted {\n        /// The handle of the new handshake\n        handle: HandshakeHandle,\n    },\n\n    /// An identity server has received a request for an endpoint from an identity client.\n    ///\n    /// To continue the handshake, the server must call [`Context::identity_server_handle_endpoint_request_received()`]\n    IdentityServerEndpointRequestReceived {\n        /// The handle of the in-progress handshake\n        handle: HandshakeHandle,\n        /// The alleged onion-service service-id of the connecting client\n        client_service_id: V3OnionServiceId,\n        /// The ASCII-encoded name of the requested endpoint server\n        requested_endpoint: String,\n    },\n\n    /// An identity server has received a challenge response from an identity client.\n    ///\n    /// To continue the handshake, the server must call [`Context::identity_server_handle_challenge_response_received()`]\n    IdentityServerChallengeResponseReceived {\n        /// The handle of the in-progress handshake\n        handle: HandshakeHandle,\n        /// An application specific challenge response object created by the identity client in response to the identity server's challenge object\n        challenge_response: bson::document::Document,\n    },\n\n    /// An identity server's handshake has completed.\n    IdentityServerHandshakeCompleted {\n        /// The handle of the completed handshake\n        handle: HandshakeHandle,\n        /// The ed25519 private key of requested endpoint server\n        endpoint_private_key: Ed25519PrivateKey,\n        /// The ASCII-encoded name of the requested endpoint server\n        endpoint_name: String,\n        /// The onion-service service-id of the authenticated client\n        client_service_id: V3OnionServiceId,\n        /// The public x25519 client-auth key used to encrypt the endpoint server's onion-service descriptor\n        client_auth_public_key: X25519PublicKey,\n    },\n\n    /// An identity server has rejected an identity client's endpoint-request.\n    ///\n    /// There are multiple potential reasons why a handshake may be rejected and this event provides a breakdown on which part(s) failed specifically.\n    IdentityServerHandshakeRejected {\n        /// The handle of the rejected handshake\n        handle: HandshakeHandle,\n        /// `false` if the client was rejected based on their onion-service service-id\n        client_allowed: bool,\n        /// `false` if the requested endpoint name was not understood by the server\n        client_requested_endpoint_valid: bool,\n        /// `false` if the client failed its authentication proof (i.e. potential attempt at identity client impersonation)\n        client_proof_signature_valid: bool,\n        /// `false` if the client fails its x25519 key-ownership proof (i.e. potential attempt at use an x25519 public key not owned by the client)\n        client_auth_signature_valid: bool,\n        /// `false` if the client's challenge response was not suitable\n        challenge_response_valid: bool,\n    },\n\n    /// An incoming identity handshake has failed.\n    IdentityServerHandshakeFailed {\n        /// The handle of the failed handshake\n        handle: HandshakeHandle,\n        /// The failure reason\n        reason: Error,\n    },\n\n    //\n    // Endpoint Client Events\n    //\n\n    /// An endpoint client has successfully completed an endpoint handshake and may now communicate freely with the endpoint server.\n    EndpointClientHandshakeCompleted {\n        /// The handle of the completed handshake\n        handle: HandshakeHandle,\n        /// The onion-service service-id of the endpoint server the client has connected to\n        endpoint_service_id: V3OnionServiceId,\n        /// The ASCII-encoded name of the requested channel on the endpoint server\n        channel_name: String,\n        /// The resulting TCP connection to the endpoint server\n        stream: TcpStream,\n    },\n\n    /// An outgoing endpoint handshake has failed.\n    EndpointClientHandshakeFailed {\n        /// The handle of the failed handshake\n        handle: HandshakeHandle,\n        /// The failure reason\n        reason: Error,\n    },\n\n    //\n    // Endpint Server Events\n    //\n\n    /// The endpoint server’s onion-service has been published and may be reachable by endpoint clients.\n    EndpointServerPublished {\n        /// The onion-service service-id of the published endpoint server\n        endpoint_service_id: V3OnionServiceId,\n        /// The name of the published endpoint server\n        endpoint_name: String,\n    },\n\n    /// An endpoint server has received an incoming connection and the handshake is ready to begin.\n    EndpointServerHandshakeStarted {\n        /// The handle of the new handshake\n        handle: HandshakeHandle,\n    },\n\n    /// An endpoint server has received a request for a channel from an endpoint client.\n    ///\n    /// To continue the handshake, the server must call [`Context::endpoint_server_handle_channel_request_received()`]\n    EndpointServerChannelRequestReceived {\n        /// The handle of the in-progress handshake\n        handle: HandshakeHandle,\n        /// The alleged onion-service service-id of the connecting client\n        client_service_id: V3OnionServiceId,\n        /// The ASCII-encoded name of the requested channel\n        requested_channel: String,\n    },\n\n    /// An endpoint server's handshake has completed\n    EndpointServerHandshakeCompleted {\n        /// The handle of the completed handshake\n        handle: HandshakeHandle,\n        /// The onion-service service-id of the endpoint server which an endpoint client has connected to\n        endpoint_service_id: V3OnionServiceId,\n        /// The onion-service service-id of the connected client\n        client_service_id: V3OnionServiceId,\n        /// The ASCII-encoded name of the client's requested channel\n        channel_name: String,\n        /// The resulting TCP connection to tohe endpoint clientt\n        stream: TcpStream,\n    },\n\n    /// An endpoint server has rejected an endpoint client's channel request.\n    ///\n    /// There are multiple potential reasons why a handshake may be rejected and this event provides a breakdown on which part(s) failed specifically.\n    EndpointServerHandshakeRejected {\n        /// The handle of the rejected handshake\n        handle: HandshakeHandle,\n        /// `false` if the client was rejected based on their onion-service service-id\n        client_allowed: bool,\n        /// `false` if the requested channel name was not understood by the server\n        client_requested_channel_valid: bool,\n        /// `false` if the client failed its authentication proof (i.e. potential attempt at endpoint client impersonation)\n        client_proof_signature_valid: bool,\n    },\n\n    /// An incoming endpoint handshake has failed.\n    EndpointServerHandshakeFailed {\n        /// The handle of the failed handshake\n        handle: HandshakeHandle,\n        /// The failure reason\n        reason: Error,\n    },\n}\n\nimpl Context {\n    /// Construct a new `Context` object.\n    ///\n    /// # Parameters\n    /// - `tor_provider`: an implementation of the [`TorProvider`] trait which provides our Tor Network connectivity\n    /// - `identity_port`: the virt-port this `Context`'s identity server's onion-service will listen on for new identity handshakes.\n    /// - `endpoint_port`: the virt-port this `Context`'s endpoint servers' onion-services will listen on for new endpoint handshakes.\n    /// - `identity_timeout`: the maximum amount of time this `Context`' will allow an identity handshake to delay between steps before rejecting the request.\n    /// - `identity_max_message_size`: the maximum size of the underlying Honk-RPC BSON message this `Context`'s identity handshake will send and accept.\n    /// - `endpoint_timeout`: the maximum amount of time this `Context`' will allow an endpoint handshake to delay between steps before rejecting the request.\n    /// - `identity_private_key`: the ed25519 private key used to start this `Context`'s identity server's onion-service\n    /// # Returns\n    /// A newly constructed `Context`.\n    pub fn new(\n        tor_provider: Box\u003cdyn TorProvider\u003e,\n        identity_port: u16,\n        endpoint_port: u16,\n        identity_timeout: Duration,\n        identity_max_message_size: i32,\n        endpoint_timeout: Option\u003cDuration\u003e,\n        identity_private_key: Ed25519PrivateKey,\n    ) -\u003e Result\u003cSelf, Error\u003e {\n        let identity_service_id = V3OnionServiceId::from_private_key(\u0026identity_private_key);\n\n        Ok(Self {\n            tor_provider,\n            bootstrap_complete: false,\n            identity_port,\n            identity_max_message_size,\n            endpoint_port,\n            identity_timeout,\n            endpoint_timeout: match endpoint_timeout {\n                Some(timeout) =\u003e timeout,\n                None =\u003e DEFAULT_ENDPOINT_TIMEOUT,\n            },\n\n            next_handshake_handle: Default::default(),\n            identity_clients: Default::default(),\n            identity_servers: Default::default(),\n            endpoint_clients: Default::default(),\n            endpoint_servers: Default::default(),\n\n            identity_listener: None,\n            identity_server_published: false,\n            endpoint_listeners: Default::default(),\n\n            identity_private_key,\n            identity_service_id,\n        })\n    }\n\n    /// Initiate bootstrap of the `Context`'s owned [`TorProvider`]. Bootstrap status is communicated through [`ContextEvent`]s returned from the [`Context::update()`] method.\n    pub fn bootstrap(\u0026mut self) -\u003e Result\u003c(), Error\u003e {\n        self.tor_provider.bootstrap()?;\n        Ok(())\n    }\n\n    /// Initiate an identity handshake with an identity server. Handshake progression is communicated through  [`ContextEvent`]s returned from the [`Context::update()`] method.\n    ///\n    /// # Parameters\n    /// - `identitity_server_id`: the long term identity onion-service service-id of a remote peer\n    /// - `endpoint`: the ASCII-encoded requested endpoint\n    /// # Returns\n    /// A `HandshakeHandle` used to refer to this particular identity handshake.\n    pub fn identity_client_begin_handshake(\n        \u0026mut self,\n        identity_server_id: V3OnionServiceId,\n        endpoint: String,\n    ) -\u003e Result\u003cHandshakeHandle, Error\u003e {\n        let endpoint = match AsciiString::new(endpoint) {\n            Ok(endpoint) =\u003e endpoint,\n            Err(_) =\u003e {\n                return Err(Error::InvalidArgument(\n                    \"endpoint must be an ASCII string\".to_string(),\n                ))\n            }\n        };\n\n        if !self.bootstrap_complete {\n            return Err(Error::TorNotConnected());\n        }\n\n        // open tcp stream to remove ident server\n        let stream: TcpStream = self\n            .tor_provider\n            .connect(\n                (identity_server_id.clone(), self.identity_port).into(),\n                None,\n            )?\n            .into();\n        stream.set_nonblocking(true)?;\n        let mut client_rpc = Session::new(stream);\n        client_rpc.set_max_wait_time(self.identity_timeout);\n        client_rpc.set_max_message_size(self.identity_max_message_size)?;\n\n        let ident_client = IdentityClient::new(\n            client_rpc,\n            identity_server_id,\n            endpoint,\n            self.identity_private_key.clone(),\n            X25519PrivateKey::generate(),\n        )?;\n\n        let handshake_handle = self.next_handshake_handle;\n        self.next_handshake_handle += 1;\n        self.identity_clients.insert(handshake_handle, ident_client);\n\n        Ok(handshake_handle)\n    }\n\n    /// Abort an in-process outgoing identity handshake.\n    ///\n    /// # Parameters\n    /// - `handle`: the handle of the in-progress outoing identity handshake to abort\n    pub fn identity_client_abort_handshake(\n        \u0026mut self,\n        handle: HandshakeHandle,\n    ) -\u003e Result\u003c(), Error\u003e {\n        if let Some(_identity_client) = self.identity_clients.remove(\u0026handle) {\n            Ok(())\n        } else {\n            Err(Error::HandshakeHandleNotFound(handle))\n        }\n    }\n\n    /// Handle an identity server's endpoint challenge. Callers must construct an identity client's endpoint challenge-response. The particulars of creating and verifying the challenge-response BSON documents are undefined and application-specific.\n    ///\n    /// # Parameters\n    /// - `handle`: the handle of the in-progress outgoing identity handshake\n    /// - `challenge_response`: an application-specific BSON document which somehow responds to an identity server's challenge.\n    pub fn identity_client_handle_challenge_received(\n        \u0026mut self,\n        handle: HandshakeHandle,\n        challenge_response: bson::document::Document,\n    ) -\u003e Result\u003c(), Error\u003e {\n        if let Some(identity_client) = self.identity_clients.get_mut(\u0026handle) {\n            identity_client.send_response(challenge_response)?;\n            Ok(())\n        } else {\n            Err(Error::HandshakeHandleNotFound(handle))\n        }\n    }\n\n    /// Start this `Context`'s identity server. Publish status is communicated through [`ContextEvent`]s returned from the [`Context::update()`] method.\n    pub fn identity_server_start(\u0026mut self) -\u003e Result\u003c(), Error\u003e {\n        if !self.bootstrap_complete {\n            return Err(Error::TorNotConnected());\n        }\n        if self.identity_listener.is_some() {\n            return Err(Error::IncorrectUsage(\n                \"identity server already started\".to_string(),\n            ));\n        }\n\n        let identity_listener =\n            self.tor_provider\n                .listener(\u0026self.identity_private_key, self.identity_port, None)?;\n        identity_listener.set_nonblocking(true)?;\n\n        self.identity_listener = Some(identity_listener);\n        Ok(())\n    }\n\n    /// Stops this `Context`'s identity server and ends any in-progress incoming identity handshakes.\n    pub fn identity_server_stop(\u0026mut self) -\u003e Result\u003c(), Error\u003e {\n        if self.identity_listener.is_none() {\n            return Err(Error::IncorrectUsage(\n                \"identity server is not started\".to_string(),\n            ));\n        }\n\n        // clear out current identity listener\n        self.identity_listener = None;\n        // clear out published flag\n        self.identity_server_published = false;\n        // clear out any in-process identity handshakes\n        self.identity_servers = Default::default();\n        Ok(())\n    }\n\n    /// Handle an identity client's incoming endpoint request. Callers must determine whether the connected identity client is allowed to access the requested endpoint, decide whether the requested endpoint is supported by this `Context`, and build an endpoint challenge for the identity client. The particulars of creating the endpoint challenge is undefined and application-specific.\n    ///\n    /// # Parameters\n    /// - `handle`: the handle of the in-progress incoming identity handshake\n    /// - `client_allowed`: whether the connected identity client is allowed to access the requested endpoint\n    /// - `endpoint_supported`: whether the requested endpoint is supported\n    /// - `endpoint_challenge`: an application-specific BSON document which the connected identity client must respond to\n    pub fn identity_server_handle_endpoint_request_received(\n        \u0026mut self,\n        handle: HandshakeHandle,\n        client_allowed: bool,\n        endpoint_supported: bool,\n        endpoint_challenge: bson::document::Document,\n    ) -\u003e Result\u003c(), Error\u003e {\n        if let Some(identity_server) = self.identity_servers.get_mut(\u0026handle) {\n            Ok(identity_server.handle_endpoint_request_received(\n                client_allowed,\n                endpoint_supported,\n                endpoint_challenge,\n            )?)\n        } else {\n            Err(Error::HandshakeHandleNotFound(handle))\n        }\n    }\n\n    // confirm that a received endpoint challenge response is valid\n\n    /// Handle an identity client's incoming endpoint challenge-response. Callers must determine whether the connected identity client's challenge-response is valid. The particulars of verifying the challenge-response is undefined and application-specific.\n    ///\n    /// # Parameters\n    /// - `handle`: the handle of the in-progress incoming identity handshake\n    /// - `challenge_response_valid`: whether the received challenge-response is valid\n    pub fn identity_server_handle_challenge_response_received(\n        \u0026mut self,\n        handle: HandshakeHandle,\n        challenge_response_valid: bool,\n    ) -\u003e Result\u003c(), Error\u003e {\n        if let Some(identity_server) = self.identity_servers.get_mut(\u0026handle) {\n            Ok(identity_server.handle_challenge_response_received(challenge_response_valid)?)\n        } else {\n            Err(Error::HandshakeHandleNotFound(handle))\n        }\n    }\n\n    /// Initiate an endpoint handshake with an identity server. An endpoint client acquires the `endpoint_server_id` and `client_auth_key` by completing an identity handshake or through some other side-channnel. Handshake progression is communicated through [`ContextEvent`]s returned from the [`Context::update()`] method.\n    ///\n    /// # Parameters\n    /// - `endpoint_server_id`: the endpoint onion-service service-id of a remote peer\n    /// - `client_uath_key`: the x25519 private-key required to decrypt the endpoint server's onion-service descriptor\n    /// - `channel`: the ASCII-encoded requested channel\n    pub fn endpoint_client_begin_handshake(\n        \u0026mut self,\n        endpoint_server_id: V3OnionServiceId,\n        client_auth_key: X25519PrivateKey,\n        channel: String,\n    ) -\u003e Result\u003cHandshakeHandle, Error\u003e {\n        let channel = match AsciiString::new(channel) {\n            Ok(channel) =\u003e channel,\n            Err(_) =\u003e {\n                return Err(Error::InvalidArgument(\n                    \"channel must be an ASCII string\".to_string(),\n                ))\n            }\n        };\n\n        if !self.bootstrap_complete {\n            return Err(Error::TorNotConnected());\n        }\n\n        self.tor_provider\n            .add_client_auth(\u0026endpoint_server_id, \u0026client_auth_key)?;\n        let stream: TcpStream = self\n            .tor_provider\n            .connect(\n                (endpoint_server_id.clone(), self.endpoint_port).into(),\n                None,\n            )?\n            .into();\n        stream.set_nonblocking(true)?;\n\n        let mut session = Session::new(stream);\n        session.set_max_wait_time(self.endpoint_timeout);\n        session.set_max_message_size(DEFAULT_ENDPOINT_MAX_MESSAGE_SIZE)?;\n\n        let endpoint_client = EndpointClient::new(\n            session,\n            endpoint_server_id,\n            channel,\n            self.identity_private_key.clone(),\n        );\n\n        let handshake_handle = self.next_handshake_handle;\n        self.next_handshake_handle += 1;\n        self.endpoint_clients\n            .insert(handshake_handle, endpoint_client);\n        Ok(handshake_handle)\n    }\n\n    /// Abort an in-process outgoing endpoint handshake\n    ///\n    /// # Parameters\n    /// - `handle`: the handle of the in-progress outoing identity handshake to abort\n    pub fn endpoint_client_abort_handshake(\n        \u0026mut self,\n        handle: HandshakeHandle,\n    ) -\u003e Result\u003c(), Error\u003e {\n        if let Some(_endpoint_client) = self.endpoint_clients.remove(\u0026handle) {\n            Ok(())\n        } else {\n            Err(Error::HandshakeHandleNotFound(handle))\n        }\n    }\n\n    /// Start one of this `Context`'s endpoint servers. Publish status is communicated through [`ContextEvent`]s returned from the [`Context::update()`] method.\n    ///\n    /// # Parameters\n    /// - `endpoint_private_key`: the ed25519 private key used to start this endpoint server's onion-service\n    /// - `endpoint_name`: the ASCII-encoded endpoint name\n    /// - `client_identity`: the onion-service service-id of the client which will be connecting to this endpoint server\n    /// - `client_auth`: the x25519 public-key used to encrypt the endpoint server's onion-service descriptor\n    pub fn endpoint_server_start(\n        \u0026mut self,\n        endpoint_private_key: Ed25519PrivateKey,\n        endpoint_name: String,\n        client_identity: V3OnionServiceId,\n        client_auth: X25519PublicKey,\n    ) -\u003e Result\u003c(), Error\u003e {\n        if !self.bootstrap_complete {\n            return Err(Error::TorNotConnected());\n        }\n\n        let endpoint_public_key = Ed25519PublicKey::from_private_key(\u0026endpoint_private_key);\n        let endpoint_service_id = V3OnionServiceId::from_public_key(\u0026endpoint_public_key);\n\n        if endpoint_service_id == self.identity_service_id {\n            return Err(Error::InvalidArgument(\n                \"endpoint server must be different from identity server\".to_string(),\n            ));\n        }\n\n        if self.endpoint_listeners.contains_key(\u0026endpoint_service_id) {\n            return Err(Error::IncorrectUsage(\n                \"endpoint server already started\".to_string(),\n            ));\n        }\n\n        let endpoint_listener = self.tor_provider.listener(\n            \u0026endpoint_private_key,\n            self.endpoint_port,\n            Some(\u0026[client_auth]),\n        )?;\n        endpoint_listener.set_nonblocking(true)?;\n\n        self.endpoint_listeners.insert(\n            endpoint_service_id,\n            (endpoint_name, client_identity, endpoint_listener, false),\n        );\n        Ok(())\n    }\n\n    /// Handle an endpoint client's incoming channel request. Callers must determine whether the requested channel is supported by this `Context`. The particulars of making this determination is undefined and application-specific.\n    ///\n    /// # Parameters\n    /// - `handle`: the handle of the in-progress incoming endpoint handshake\n    /// - `channel_supported`: whether the requested channel is supported\n    pub fn endpoint_server_handle_channel_request_received(\n        \u0026mut self,\n        handle: HandshakeHandle,\n        channel_supported: bool,\n    ) -\u003e Result\u003c(), Error\u003e {\n        if let Some(endpoint_server) = self.endpoint_servers.get_mut(\u0026handle) {\n            Ok(endpoint_server.handle_channel_request_received(channel_supported)?)\n        } else {\n            Err(Error::HandshakeHandleNotFound(handle))\n        }\n    }\n\n    /// Stop one of this `Context`'s endpoint servers and ends any of its in-progress incoming endpoint handshakes.\n    ///\n    /// # Parameters\n    /// - `endpoint_identity`: the onion-service service-id of the enpdoint server to stop\n    pub fn endpoint_server_stop(\n        \u0026mut self,\n        endpoint_identity: V3OnionServiceId,\n    ) -\u003e Result\u003c(), Error\u003e {\n        if !self.bootstrap_complete {\n            return Err(Error::TorNotConnected());\n        }\n\n        if let Some(_listener) = self.endpoint_listeners.remove(\u0026endpoint_identity) {\n            Ok(())\n        } else {\n            Err(Error::InvalidArgument(format!(\n                \"endpoint server with service id {} not found\",\n                endpoint_identity\n            )))\n        }\n    }\n\n    fn identity_server_handle_accept(\n        identity_listener: \u0026OnionListener,\n        identity_timeout: Duration,\n        identity_max_message_size: i32,\n        identity_private_key: \u0026Ed25519PrivateKey,\n    ) -\u003e Result\u003cOption\u003cIdentityServer\u003e, Error\u003e {\n        if let Some(stream) = identity_listener.accept()? {\n            let stream: TcpStream = stream.into();\n            if stream.set_nonblocking(true).is_err() {\n                return Ok(None);\n            }\n\n            let mut server_rpc = Session::new(stream);\n            server_rpc.set_max_wait_time(identity_timeout);\n            server_rpc.set_max_message_size(identity_max_message_size)?;\n            let service_id = V3OnionServiceId::from_private_key(identity_private_key);\n            let identity_server = IdentityServer::new(server_rpc, service_id);\n\n            Ok(Some(identity_server))\n        } else {\n            Ok(None)\n        }\n    }\n\n    fn endpoint_server_handle_accept(\n        endpoint_listener: \u0026OnionListener,\n        endpoint_timeout: Duration,\n        client_service_id: \u0026V3OnionServiceId,\n        endpoint_service_id: \u0026V3OnionServiceId,\n    ) -\u003e Result\u003cOption\u003cEndpointServer\u003e, Error\u003e {\n        if let Some(stream) = endpoint_listener.accept()? {\n            let stream: TcpStream = stream.into();\n            if stream.set_nonblocking(true).is_err() {\n                return Ok(None);\n            }\n\n            let mut server_rpc = Session::new(stream);\n            server_rpc.set_max_wait_time(endpoint_timeout);\n            server_rpc.set_max_message_size(DEFAULT_ENDPOINT_MAX_MESSAGE_SIZE)?;\n\n            let endpoint_server = EndpointServer::new(\n                server_rpc,\n                client_service_id.clone(),\n                endpoint_service_id.clone(),\n            );\n\n            Ok(Some(endpoint_server))\n        } else {\n            Ok(None)\n        }\n    }\n\n    /// A direct pass-through to the underlying [`TorProvider`]'s [`TorProvider::connect()`] method.\n    pub fn connect(\n        \u0026mut self,\n        target_addr: TargetAddr,\n        circuit_token: Option\u003cCircuitToken\u003e,\n    ) -\u003e Result\u003cOnionStream, Error\u003e {\n        Ok(self.tor_provider.connect(target_addr, circuit_token)?)\n    }\n\n    /// A direct pass-through to the underlying [`TorProvider`]'s [`TorProvider::generate_token()`] method.\n    pub fn generate_circuit_token(\u0026mut self) -\u003e CircuitToken {\n        self.tor_provider.generate_token()\n    }\n\n    /// A direct pass-through to the underlying [`TorProvider`]'s [`TorProvider::release_token()`] method.\n    pub fn release_circuit_token(\u0026mut self, circuit_token: CircuitToken) {\n        self.tor_provider.release_token(circuit_token)\n    }\n\n    /// This function updates the `Context`'s underlying [`TorProvider`], handles new handshakes requests, and updates in-progress handshakes. This function needs to be regularly called to process the returned [`ContextEvent`]s.\n    pub fn update(\u0026mut self) -\u003e Result\u003cVecDeque\u003cContextEvent\u003e, Error\u003e {\n        // events to return\n        let mut events: VecDeque\u003cContextEvent\u003e = Default::default();\n\n        // first handle new identity connections\n        if let Some(identity_listener) = \u0026self.identity_listener {\n            match Self::identity_server_handle_accept(\n                identity_listener,\n                self.identity_timeout,\n                self.identity_max_message_size,\n                \u0026self.identity_private_key,\n            ) {\n                Ok(Some(identity_server)) =\u003e {\n                    let handle = self.next_handshake_handle;\n                    self.next_handshake_handle += 1;\n                    self.identity_servers.insert(handle, identity_server);\n                    events.push_back(ContextEvent::IdentityServerHandshakeStarted { handle });\n                }\n                Ok(None) =\u003e {}\n                // identity listener failed, remove it\n                // TODO: signal caller identity listener is down\n                Err(_) =\u003e self.identity_listener = None,\n            }\n        }\n\n        // next handle new endpoint connections\n        self.endpoint_listeners.retain(\n            |endpoint_service_id, (_endpoint_name, allowed_client, listener, _published)| -\u003e bool {\n                match Self::endpoint_server_handle_accept(\n                    listener,\n                    self.endpoint_timeout,\n                    allowed_client,\n                    endpoint_service_id,\n                ) {\n                    Ok(Some(endpoint_server)) =\u003e {\n                        let handle = self.next_handshake_handle;\n                        self.next_handshake_handle += 1;\n                        self.endpoint_servers.insert(handle, endpoint_server);\n                        events.push_back(ContextEvent::EndpointServerHandshakeStarted { handle });\n                        true\n                    }\n                    Ok(None) =\u003e true,\n                    // endpoint listener failed, remove it\n                    // TODO: signal caller endpoint listener is down\n                    Err(_) =\u003e false,\n                }\n            },\n        );\n\n        // consume tor events\n        // TODO: so curently the only failure mode of this function is a result of the\n        // LegacyTorClient failing; we should probably consider a LegacyTorClient failure fatal, since\n        // reading the LegacyTorClient::update() function it seems the only failure modes are a\n        // failure to DEL_ONION (which realistically speaking could only be due to a logic\n        // error on our part by deleting an onion that doesn't exist, or a parse error of\n        // the response) and a failure to read async events which is either again a parsing\n        // bug on our end or a malformed/buggy tor daemon which we also cannot recover\n        // from.\n        for event in self.tor_provider.update()?.drain(..) {\n            match event {\n                TorEvent::BootstrapStatus {\n                    progress,\n                    tag,\n                    summary,\n                } =\u003e {\n                    events.push_back(ContextEvent::TorBootstrapStatusReceived {\n                        progress,\n                        tag,\n                        summary,\n                    });\n                }\n                TorEvent::BootstrapComplete =\u003e {\n                    events.push_back(ContextEvent::TorBootstrapCompleted);\n                    self.bootstrap_complete = true;\n                }\n                TorEvent::LogReceived { line } =\u003e {\n                    events.push_back(ContextEvent::TorLogReceived { line });\n                }\n                TorEvent::OnionServicePublished { service_id } =\u003e {\n                    if service_id == self.identity_service_id {\n                        if !self.identity_server_published {\n                            events.push_back(ContextEvent::IdentityServerPublished);\n                            self.identity_server_published = true;\n                        }\n                    } else if let Some((endpoint_name, _, _, published)) =\n                        self.endpoint_listeners.get_mut(\u0026service_id)\n                    {\n                        // ingore duplicate publish events\n                        if !*published {\n                            events.push_back(ContextEvent::EndpointServerPublished {\n                                endpoint_service_id: service_id,\n                                endpoint_name: endpoint_name.clone(),\n                            });\n                            *published = true;\n                        }\n                    }\n                }\n            }\n        }\n\n        // update the ident client handshakes\n        self.identity_clients\n            .retain(|handle, identity_client| -\u003e bool {\n                let handle = *handle;\n                match identity_client.update() {\n                    Ok(Some(IdentityClientEvent::ChallengeReceived { endpoint_challenge })) =\u003e {\n                        events.push_back(ContextEvent::IdentityClientChallengeReceived {\n                            handle,\n                            endpoint_challenge,\n                        });\n                        true\n                    }\n                    Ok(Some(IdentityClientEvent::HandshakeCompleted {\n                        identity_service_id,\n                        endpoint_service_id,\n                        endpoint_name,\n                        client_auth_private_key,\n                    })) =\u003e {\n                        events.push_back(ContextEvent::IdentityClientHandshakeCompleted {\n                            handle,\n                            identity_service_id,\n                            endpoint_service_id,\n                            endpoint_name,\n                            client_auth_private_key,\n                        });\n                        false\n                    }\n                    Err(err) =\u003e {\n                        events.push_back(ContextEvent::IdentityClientHandshakeFailed {\n                            handle,\n                            reason: err.into(),\n                        });\n                        false\n                    }\n                    Ok(None) =\u003e true,\n                }\n            });\n\n        // update the ident server handshakes\n        self.identity_servers\n            .retain(|handle, identity_server| -\u003e bool {\n                let handle = *handle;\n                match identity_server.update() {\n                    Ok(Some(IdentityServerEvent::EndpointRequestReceived {\n                        client_service_id,\n                        requested_endpoint,\n                    })) =\u003e {\n                        events.push_back(ContextEvent::IdentityServerEndpointRequestReceived {\n                            handle,\n                            client_service_id,\n                            requested_endpoint: requested_endpoint.to_string(),\n                        });\n                        true\n                    }\n                    Ok(Some(IdentityServerEvent::ChallengeResponseReceived {\n                        challenge_response,\n                    })) =\u003e {\n                        events.push_back(ContextEvent::IdentityServerChallengeResponseReceived {\n                            handle,\n                            challenge_response,\n                        });\n                        true\n                    }\n                    Ok(Some(IdentityServerEvent::HandshakeCompleted {\n                        endpoint_private_key,\n                        endpoint_name,\n                        client_service_id,\n                        client_auth_public_key,\n                    })) =\u003e {\n                        events.push_back(ContextEvent::IdentityServerHandshakeCompleted {\n                            handle,\n                            endpoint_private_key,\n                            endpoint_name: endpoint_name.to_string(),\n                            client_service_id,\n                            client_auth_public_key,\n                        });\n                        false\n                    }\n                    Ok(Some(IdentityServerEvent::HandshakeRejected {\n                        client_allowed,\n                        client_requested_endpoint_valid,\n                        client_proof_signature_valid,\n                        client_auth_signature_valid,\n                        challenge_response_valid,\n                    })) =\u003e {\n                        events.push_back(ContextEvent::IdentityServerHandshakeRejected {\n                            handle,\n                            client_allowed,\n                            client_requested_endpoint_valid,\n                            client_proof_signature_valid,\n                            client_auth_signature_valid,\n                            challenge_response_valid,\n                        });\n                        false\n                    }\n                    Err(err) =\u003e {\n                        events.push_back(ContextEvent::IdentityServerHandshakeFailed {\n                            handle,\n                            reason: err.into(),\n                        });\n                        false\n                    }\n                    Ok(None) =\u003e true,\n                }\n            });\n\n        // update the endpoint client handshakes\n        self.endpoint_clients\n            .retain(|handle, endpoint_client| -\u003e bool {\n                let handle = *handle;\n                match endpoint_client.update() {\n                    Ok(Some(EndpointClientEvent::HandshakeCompleted { stream })) =\u003e {\n                        events.push_back(ContextEvent::EndpointClientHandshakeCompleted {\n                            handle,\n                            endpoint_service_id: endpoint_client.server_service_id.clone(),\n                            channel_name: endpoint_client.requested_channel.to_string(),\n                            stream,\n                        });\n                        false\n                    }\n                    Err(err) =\u003e {\n                        events.push_back(ContextEvent::EndpointClientHandshakeFailed {\n                            handle,\n                            reason: err.into(),\n                        });\n                        false\n                    }\n                    Ok(None) =\u003e true,\n                }\n            });\n\n        // update the endpoint server handshakes\n        self.endpoint_servers\n            .retain(|handle, endpoint_server| -\u003e bool {\n                let handle = *handle;\n                match endpoint_server.update() {\n                    Ok(Some(EndpointServerEvent::ChannelRequestReceived {\n                        requested_channel,\n                        client_service_id,\n                    })) =\u003e {\n                        events.push_back(ContextEvent::EndpointServerChannelRequestReceived {\n                            handle,\n                            client_service_id,\n                            requested_channel: requested_channel.to_string(),\n                        });\n                        true\n                    }\n                    Ok(Some(EndpointServerEvent::HandshakeCompleted {\n                        client_service_id,\n                        channel_name,\n                        stream,\n                    })) =\u003e {\n                        events.push_back(ContextEvent::EndpointServerHandshakeCompleted {\n                            handle,\n                            endpoint_service_id: endpoint_server.server_identity.clone(),\n                            client_service_id,\n                            channel_name: channel_name.to_string(),\n                            stream,\n                        });\n                        false\n                    }\n                    Ok(Some(EndpointServerEvent::HandshakeRejected {\n                        client_allowed,\n                        client_requested_channel_valid,\n                        client_proof_signature_valid,\n                    })) =\u003e {\n                        events.push_back(ContextEvent::EndpointServerHandshakeRejected {\n                            handle,\n                            client_allowed,\n                            client_requested_channel_valid,\n                            client_proof_signature_valid,\n                        });\n                        false\n                    }\n                    Err(err) =\u003e {\n                        events.push_back(ContextEvent::EndpointServerHandshakeFailed {\n                            handle,\n                            reason: err.into(),\n                        });\n                        false\n                    }\n                    Ok(None) =\u003e true,\n                }\n            });\n\n        Ok(events)\n    }\n}\n","traces":[{"line":362,"address":[3906464,3907695,3907654],"length":1,"stats":{"Line":1}},{"line":371,"address":[1902451],"length":1,"stats":{"Line":1}},{"line":373,"address":[1903012],"length":1,"stats":{"Line":1}},{"line":374,"address":[3906684],"length":1,"stats":{"Line":1}},{"line":380,"address":[3906718],"length":1,"stats":{"Line":1}},{"line":381,"address":[2623104],"length":1,"stats":{"Line":1}},{"line":382,"address":[1902583],"length":1,"stats":{"Line":0}},{"line":386,"address":[3906853],"length":1,"stats":{"Line":1}},{"line":387,"address":[3946616],"length":1,"stats":{"Line":1}},{"line":388,"address":[2623260],"length":1,"stats":{"Line":1}},{"line":389,"address":[1902832],"length":1,"stats":{"Line":1}},{"line":391,"address":[3907052],"length":1,"stats":{"Line":1}},{"line":393,"address":[3907063],"length":1,"stats":{"Line":1}},{"line":395,"address":[1902971],"length":1,"stats":{"Line":1}},{"line":401,"address":[1903568],"length":1,"stats":{"Line":1}},{"line":402,"address":[3947492,3947578],"length":1,"stats":{"Line":1}},{"line":403,"address":[3947569],"length":1,"stats":{"Line":1}},{"line":413,"address":[1903744,1906164,1906423],"length":1,"stats":{"Line":1}},{"line":418,"address":[3947726],"length":1,"stats":{"Line":1}},{"line":419,"address":[1903902],"length":1,"stats":{"Line":1}},{"line":421,"address":[3910658],"length":1,"stats":{"Line":0}},{"line":422,"address":[1904019],"length":1,"stats":{"Line":0}},{"line":427,"address":[2624502],"length":1,"stats":{"Line":1}},{"line":428,"address":[3908290],"length":1,"stats":{"Line":0}},{"line":432,"address":[1906392,1904672,1904172,1904364],"length":1,"stats":{"Line":2}},{"line":435,"address":[3948102,3948133],"length":1,"stats":{"Line":2}},{"line":436,"address":[2624792],"length":1,"stats":{"Line":1}},{"line":439,"address":[3909052,3908880,3908955,3910496],"length":1,"stats":{"Line":2}},{"line":440,"address":[3948757,3948838],"length":1,"stats":{"Line":2}},{"line":441,"address":[2625362],"length":1,"stats":{"Line":1}},{"line":442,"address":[3909173,3910431,3909405,3907974],"length":1,"stats":{"Line":2}},{"line":445,"address":[2625524],"length":1,"stats":{"Line":1}},{"line":447,"address":[2625575],"length":1,"stats":{"Line":1}},{"line":448,"address":[3949331,3949115],"length":1,"stats":{"Line":2}},{"line":449,"address":[2625843],"length":1,"stats":{"Line":1}},{"line":452,"address":[3909870],"length":1,"stats":{"Line":1}},{"line":453,"address":[3949631,3949814,3949904],"length":1,"stats":{"Line":2}},{"line":454,"address":[1905914,1906057],"length":1,"stats":{"Line":2}},{"line":456,"address":[2626478],"length":1,"stats":{"Line":1}},{"line":463,"address":[1906640],"length":1,"stats":{"Line":0}},{"line":467,"address":[2627038],"length":1,"stats":{"Line":0}},{"line":468,"address":[3910925],"length":1,"stats":{"Line":0}},{"line":470,"address":[3910953],"length":1,"stats":{"Line":0}},{"line":479,"address":[2627280,2627873,2627845],"length":1,"stats":{"Line":1}},{"line":484,"address":[2627327,2627608,2627677,2627410],"length":1,"stats":{"Line":3}},{"line":485,"address":[2627314,2627458,2627626,2627684,2627818],"length":1,"stats":{"Line":3}},{"line":486,"address":[2627670],"length":1,"stats":{"Line":1}},{"line":488,"address":[3911361],"length":1,"stats":{"Line":0}},{"line":493,"address":[2627888,2629035,2629067],"length":1,"stats":{"Line":1}},{"line":494,"address":[3951470],"length":1,"stats":{"Line":1}},{"line":495,"address":[2627940],"length":1,"stats":{"Line":0}},{"line":497,"address":[3911779],"length":1,"stats":{"Line":1}},{"line":498,"address":[3951716],"length":1,"stats":{"Line":0}},{"line":499,"address":[2628132],"length":1,"stats":{"Line":0}},{"line":503,"address":[2628011,2628509,2628048,2628245],"length":1,"stats":{"Line":3}},{"line":505,"address":[2628019,2628474],"length":1,"stats":{"Line":1}},{"line":506,"address":[3911718,3912255,3912391,3912681],"length":1,"stats":{"Line":3}},{"line":508,"address":[2628647,2628901],"length":1,"stats":{"Line":1}},{"line":509,"address":[3952551],"length":1,"stats":{"Line":1}},{"line":513,"address":[1908736,1909263],"length":1,"stats":{"Line":0}},{"line":514,"address":[1908772],"length":1,"stats":{"Line":0}},{"line":515,"address":[2629202],"length":1,"stats":{"Line":0}},{"line":516,"address":[3912985],"length":1,"stats":{"Line":0}},{"line":521,"address":[3913087,3912953],"length":1,"stats":{"Line":0}},{"line":523,"address":[3952977],"length":1,"stats":{"Line":0}},{"line":525,"address":[1909080],"length":1,"stats":{"Line":0}},{"line":526,"address":[1909243],"length":1,"stats":{"Line":0}},{"line":536,"address":[3953184,3953824,3953853],"length":1,"stats":{"Line":1}},{"line":543,"address":[1909445,1909358,1909668,1909741],"length":1,"stats":{"Line":3}},{"line":544,"address":[3913486,3913833,3914014,3914052,3913745],"length":1,"stats":{"Line":3}},{"line":547,"address":[2629838],"length":1,"stats":{"Line":1}},{"line":550,"address":[3913785],"length":1,"stats":{"Line":0}},{"line":561,"address":[1909968],"length":1,"stats":{"Line":1}},{"line":566,"address":[3914370,3914184,3914384],"length":1,"stats":{"Line":2}},{"line":567,"address":[2630544,2630322,2630409,2630535],"length":1,"stats":{"Line":3}},{"line":569,"address":[3914327],"length":1,"stats":{"Line":0}},{"line":579,"address":[3914448,3916738,3917157],"length":1,"stats":{"Line":1}},{"line":585,"address":[3954364,3954260],"length":1,"stats":{"Line":2}},{"line":586,"address":[1910471],"length":1,"stats":{"Line":1}},{"line":588,"address":[3917020],"length":1,"stats":{"Line":0}},{"line":589,"address":[1910588],"length":1,"stats":{"Line":0}},{"line":594,"address":[3954527],"length":1,"stats":{"Line":1}},{"line":595,"address":[3914859],"length":1,"stats":{"Line":0}},{"line":598,"address":[3954650,3956666,3954854,3954696],"length":1,"stats":{"Line":2}},{"line":599,"address":[2631210],"length":1,"stats":{"Line":0}},{"line":600,"address":[3956664,3954768,3955331,3955023],"length":1,"stats":{"Line":2}},{"line":603,"address":[3954794,3954888],"length":1,"stats":{"Line":2}},{"line":604,"address":[3915267],"length":1,"stats":{"Line":1}},{"line":607,"address":[2632944,2631838,2631763,2631931],"length":1,"stats":{"Line":2}},{"line":609,"address":[3955593,3955512],"length":1,"stats":{"Line":2}},{"line":610,"address":[3915857],"length":1,"stats":{"Line":1}},{"line":611,"address":[1911995,1910348,1911764],"length":1,"stats":{"Line":2}},{"line":614,"address":[1911862],"length":1,"stats":{"Line":1}},{"line":616,"address":[1911913],"length":1,"stats":{"Line":1}},{"line":617,"address":[3916121],"length":1,"stats":{"Line":1}},{"line":620,"address":[2632534],"length":1,"stats":{"Line":1}},{"line":621,"address":[3956187,3956307],"length":1,"stats":{"Line":1}},{"line":622,"address":[2632583,2632660],"length":1,"stats":{"Line":2}},{"line":623,"address":[3916486,3916620],"length":1,"stats":{"Line":2}},{"line":624,"address":[1912494],"length":1,"stats":{"Line":1}},{"line":631,"address":[3956928],"length":1,"stats":{"Line":0}},{"line":635,"address":[2633278],"length":1,"stats":{"Line":0}},{"line":636,"address":[1913152],"length":1,"stats":{"Line":0}},{"line":638,"address":[2633402],"length":1,"stats":{"Line":0}},{"line":649,"address":[3917456,3918940,3919197],"length":1,"stats":{"Line":1}},{"line":656,"address":[3917506],"length":1,"stats":{"Line":1}},{"line":657,"address":[1913384],"length":1,"stats":{"Line":0}},{"line":660,"address":[3917575],"length":1,"stats":{"Line":1}},{"line":661,"address":[1913494],"length":1,"stats":{"Line":1}},{"line":663,"address":[3917686],"length":1,"stats":{"Line":1}},{"line":664,"address":[3958788],"length":1,"stats":{"Line":0}},{"line":665,"address":[2633814],"length":1,"stats":{"Line":0}},{"line":669,"address":[3957471,3957532],"length":1,"stats":{"Line":2}},{"line":670,"address":[1914796],"length":1,"stats":{"Line":0}},{"line":671,"address":[1913747],"length":1,"stats":{"Line":0}},{"line":675,"address":[1914789,1913777,1914115,1913715,1913649],"length":1,"stats":{"Line":3}},{"line":678,"address":[3917824],"length":1,"stats":{"Line":1}},{"line":680,"address":[2634837,2634249,2634402,2633562],"length":1,"stats":{"Line":3}},{"line":682,"address":[3918427,3918749],"length":1,"stats":{"Line":2}},{"line":684,"address":[1914271],"length":1,"stats":{"Line":1}},{"line":686,"address":[3918852],"length":1,"stats":{"Line":1}},{"line":694,"address":[1915056],"length":1,"stats":{"Line":1}},{"line":699,"address":[3919472,3919272,3919458],"length":1,"stats":{"Line":2}},{"line":700,"address":[2635520,2635511,2635385,2635298],"length":1,"stats":{"Line":3}},{"line":702,"address":[3919415],"length":1,"stats":{"Line":0}},{"line":710,"address":[1916112,1915376,1916080],"length":1,"stats":{"Line":0}},{"line":714,"address":[3959315],"length":1,"stats":{"Line":0}},{"line":715,"address":[3919593],"length":1,"stats":{"Line":0}},{"line":718,"address":[3919629,3919705],"length":1,"stats":{"Line":0}},{"line":719,"address":[1915598],"length":1,"stats":{"Line":0}},{"line":721,"address":[3959852,3959726],"length":1,"stats":{"Line":0}},{"line":728,"address":[1917526,1917444,1916128],"length":1,"stats":{"Line":1}},{"line":734,"address":[2636410,2636847],"length":1,"stats":{"Line":2}},{"line":735,"address":[2636748],"length":1,"stats":{"Line":1}},{"line":736,"address":[3920872,3920757],"length":1,"stats":{"Line":2}},{"line":737,"address":[2637616],"length":1,"stats":{"Line":0}},{"line":740,"address":[1916835],"length":1,"stats":{"Line":1}},{"line":741,"address":[2637072],"length":1,"stats":{"Line":1}},{"line":742,"address":[3960975,3960854,3960083],"length":1,"stats":{"Line":2}},{"line":743,"address":[1917044],"length":1,"stats":{"Line":1}},{"line":744,"address":[1917212],"length":1,"stats":{"Line":1}},{"line":746,"address":[2637449],"length":1,"stats":{"Line":1}},{"line":748,"address":[2636817],"length":1,"stats":{"Line":1}},{"line":752,"address":[1917616,1919117,1918974],"length":1,"stats":{"Line":1}},{"line":758,"address":[1918142,1917691],"length":1,"stats":{"Line":2}},{"line":759,"address":[2638197],"length":1,"stats":{"Line":1}},{"line":760,"address":[3922238,3922353],"length":1,"stats":{"Line":2}},{"line":761,"address":[2639171],"length":1,"stats":{"Line":0}},{"line":764,"address":[1918316],"length":1,"stats":{"Line":1}},{"line":765,"address":[1918367],"length":1,"stats":{"Line":1}},{"line":766,"address":[2637812,2638733,2638590],"length":1,"stats":{"Line":2}},{"line":769,"address":[3922681],"length":1,"stats":{"Line":1}},{"line":770,"address":[1918580],"length":1,"stats":{"Line":1}},{"line":771,"address":[3922950],"length":1,"stats":{"Line":1}},{"line":774,"address":[2638986],"length":1,"stats":{"Line":1}},{"line":776,"address":[2638266],"length":1,"stats":{"Line":1}},{"line":781,"address":[2639328],"length":1,"stats":{"Line":0}},{"line":786,"address":[2639493,2639371],"length":1,"stats":{"Line":0}},{"line":790,"address":[1919440],"length":1,"stats":{"Line":0}},{"line":791,"address":[3923608],"length":1,"stats":{"Line":0}},{"line":795,"address":[2639600],"length":1,"stats":{"Line":0}},{"line":796,"address":[1919489],"length":1,"stats":{"Line":0}},{"line":800,"address":[1919520,1920315,1922182],"length":1,"stats":{"Line":1}},{"line":802,"address":[2639693],"length":1,"stats":{"Line":1}},{"line":805,"address":[3924594,3923749],"length":1,"stats":{"Line":2}},{"line":806,"address":[3925448,3923976,3923834],"length":1,"stats":{"Line":2}},{"line":808,"address":[3923805],"length":1,"stats":{"Line":1}},{"line":809,"address":[3963556],"length":1,"stats":{"Line":1}},{"line":810,"address":[2639786],"length":1,"stats":{"Line":1}},{"line":812,"address":[3924102],"length":1,"stats":{"Line":1}},{"line":813,"address":[1919981],"length":1,"stats":{"Line":1}},{"line":814,"address":[3924158,3924276],"length":1,"stats":{"Line":1}},{"line":815,"address":[3964078,3963934],"length":1,"stats":{"Line":2}},{"line":816,"address":[2640302],"length":1,"stats":{"Line":1}},{"line":821,"address":[1919875,1920329],"length":1,"stats":{"Line":0}},{"line":826,"address":[3963593,3963657],"length":1,"stats":{"Line":2}},{"line":827,"address":[2815735,2816279,2815696],"length":1,"stats":{"Line":3}},{"line":828,"address":[3869709],"length":1,"stats":{"Line":1}},{"line":830,"address":[3909444],"length":1,"stats":{"Line":1}},{"line":834,"address":[1896085],"length":1,"stats":{"Line":1}},{"line":835,"address":[3909561],"length":1,"stats":{"Line":1}},{"line":836,"address":[3909581,3909652,3909745],"length":1,"stats":{"Line":2}},{"line":837,"address":[1896219,1896363],"length":1,"stats":{"Line":2}},{"line":838,"address":[3870088],"length":1,"stats":{"Line":1}},{"line":839,"address":[1896441],"length":1,"stats":{"Line":1}},{"line":841,"address":[3869774],"length":1,"stats":{"Line":1}},{"line":844,"address":[3869767],"length":1,"stats":{"Line":0}},{"line":858,"address":[3964673,3964370,3964841,3964797],"length":1,"stats":{"Line":4}},{"line":859,"address":[3925161],"length":1,"stats":{"Line":1}},{"line":860,"address":[2641348],"length":1,"stats":{"Line":1}},{"line":865,"address":[2641412,2641762],"length":1,"stats":{"Line":2}},{"line":871,"address":[1921747],"length":1,"stats":{"Line":1}},{"line":872,"address":[2641534],"length":1,"stats":{"Line":1}},{"line":873,"address":[3925900],"length":1,"stats":{"Line":1}},{"line":875,"address":[3925689],"length":1,"stats":{"Line":1}},{"line":876,"address":[2641597,2641784],"length":1,"stats":{"Line":2}},{"line":878,"address":[3965544],"length":1,"stats":{"Line":1}},{"line":879,"address":[1921704,1921761],"length":1,"stats":{"Line":2}},{"line":880,"address":[2641833,2642181],"length":1,"stats":{"Line":2}},{"line":881,"address":[3926277],"length":1,"stats":{"Line":1}},{"line":882,"address":[3966058],"length":1,"stats":{"Line":1}},{"line":884,"address":[3925988,3925932],"length":1,"stats":{"Line":2}},{"line":888,"address":[3926080,3926262],"length":1,"stats":{"Line":2}},{"line":889,"address":[3926116],"length":1,"stats":{"Line":1}},{"line":891,"address":[3926097],"length":1,"stats":{"Line":1}},{"line":893,"address":[3926259],"length":1,"stats":{"Line":1}},{"line":901,"address":[1921059],"length":1,"stats":{"Line":1}},{"line":902,"address":[3910016],"length":1,"stats":{"Line":1}},{"line":903,"address":[3870321],"length":1,"stats":{"Line":1}},{"line":904,"address":[1896649,1896903],"length":1,"stats":{"Line":2}},{"line":905,"address":[1896981],"length":1,"stats":{"Line":1}},{"line":906,"address":[3910458],"length":1,"stats":{"Line":1}},{"line":910,"address":[2816874],"length":1,"stats":{"Line":1}},{"line":913,"address":[3910551],"length":1,"stats":{"Line":1}},{"line":914,"address":[3870834],"length":1,"stats":{"Line":1}},{"line":915,"address":[3870871],"length":1,"stats":{"Line":1}},{"line":916,"address":[3910654],"length":1,"stats":{"Line":1}},{"line":918,"address":[1897278],"length":1,"stats":{"Line":1}},{"line":925,"address":[3871197],"length":1,"stats":{"Line":1}},{"line":927,"address":[1896740],"length":1,"stats":{"Line":0}},{"line":928,"address":[3870468,3870510],"length":1,"stats":{"Line":0}},{"line":930,"address":[1896780],"length":1,"stats":{"Line":0}},{"line":932,"address":[3870585],"length":1,"stats":{"Line":0}},{"line":934,"address":[3870592],"length":1,"stats":{"Line":1}},{"line":939,"address":[2641140],"length":1,"stats":{"Line":1}},{"line":940,"address":[2817376,2818696],"length":1,"stats":{"Line":1}},{"line":941,"address":[3871345],"length":1,"stats":{"Line":1}},{"line":942,"address":[2817449,2817701,2817802],"length":1,"stats":{"Line":2}},{"line":944,"address":[1898035],"length":1,"stats":{"Line":1}},{"line":945,"address":[3871795],"length":1,"stats":{"Line":1}},{"line":947,"address":[2817899,2818536],"length":1,"stats":{"Line":2}},{"line":950,"address":[3911573],"length":1,"stats":{"Line":1}},{"line":952,"address":[2818673],"length":1,"stats":{"Line":1}},{"line":955,"address":[2817933],"length":1,"stats":{"Line":1}},{"line":957,"address":[2817970],"length":1,"stats":{"Line":1}},{"line":961,"address":[1898283],"length":1,"stats":{"Line":1}},{"line":964,"address":[1898293],"length":1,"stats":{"Line":1}},{"line":965,"address":[1898353],"length":1,"stats":{"Line":1}},{"line":966,"address":[3911819],"length":1,"stats":{"Line":1}},{"line":967,"address":[1898443],"length":1,"stats":{"Line":1}},{"line":969,"address":[3911915,3912452],"length":1,"stats":{"Line":2}},{"line":971,"address":[2818260],"length":1,"stats":{"Line":1}},{"line":972,"address":[3872189],"length":1,"stats":{"Line":1}},{"line":976,"address":[3912686],"length":1,"stats":{"Line":1}},{"line":979,"address":[3911973],"length":1,"stats":{"Line":0}},{"line":980,"address":[1898550],"length":1,"stats":{"Line":0}},{"line":981,"address":[3912007],"length":1,"stats":{"Line":0}},{"line":982,"address":[1898582],"length":1,"stats":{"Line":0}},{"line":983,"address":[3912037],"length":1,"stats":{"Line":0}},{"line":985,"address":[3912056],"length":1,"stats":{"Line":0}},{"line":993,"address":[3872408],"length":1,"stats":{"Line":0}},{"line":995,"address":[1897764],"length":1,"stats":{"Line":0}},{"line":996,"address":[3911236,3911278],"length":1,"stats":{"Line":0}},{"line":998,"address":[3871500],"length":1,"stats":{"Line":0}},{"line":1000,"address":[3911353],"length":1,"stats":{"Line":0}},{"line":1002,"address":[3871616],"length":1,"stats":{"Line":1}},{"line":1007,"address":[3965013],"length":1,"stats":{"Line":1}},{"line":1008,"address":[2819815,2819783,2819104],"length":1,"stats":{"Line":1}},{"line":1009,"address":[3912854],"length":1,"stats":{"Line":1}},{"line":1010,"address":[3873142],"length":1,"stats":{"Line":1}},{"line":1011,"address":[3913136],"length":1,"stats":{"Line":1}},{"line":1012,"address":[3913323,3913155],"length":1,"stats":{"Line":2}},{"line":1014,"address":[1899723],"length":1,"stats":{"Line":1}},{"line":1015,"address":[2819574],"length":1,"stats":{"Line":1}},{"line":1016,"address":[3913308],"length":1,"stats":{"Line":1}},{"line":1018,"address":[3873727],"length":1,"stats":{"Line":1}},{"line":1020,"address":[1899527],"length":1,"stats":{"Line":0}},{"line":1021,"address":[1899555,1899597],"length":1,"stats":{"Line":0}},{"line":1023,"address":[3873259],"length":1,"stats":{"Line":0}},{"line":1025,"address":[1899672],"length":1,"stats":{"Line":0}},{"line":1027,"address":[1899679],"length":1,"stats":{"Line":1}},{"line":1032,"address":[3925297],"length":1,"stats":{"Line":1}},{"line":1033,"address":[3913616,3914705],"length":1,"stats":{"Line":1}},{"line":1034,"address":[1900230],"length":1,"stats":{"Line":1}},{"line":1035,"address":[3874317,3873958,3874208],"length":1,"stats":{"Line":2}},{"line":1037,"address":[3914068],"length":1,"stats":{"Line":1}},{"line":1038,"address":[2820380],"length":1,"stats":{"Line":1}},{"line":1040,"address":[3914155,3914540],"length":1,"stats":{"Line":2}},{"line":1043,"address":[1900723],"length":1,"stats":{"Line":1}},{"line":1045,"address":[3914681],"length":1,"stats":{"Line":1}},{"line":1048,"address":[2820485],"length":1,"stats":{"Line":1}},{"line":1049,"address":[1900824],"length":1,"stats":{"Line":1}},{"line":1050,"address":[3874546],"length":1,"stats":{"Line":1}},{"line":1052,"address":[2821088,2820594],"length":1,"stats":{"Line":2}},{"line":1054,"address":[2820602],"length":1,"stats":{"Line":1}},{"line":1056,"address":[1901328],"length":1,"stats":{"Line":1}},{"line":1057,"address":[3914805],"length":1,"stats":{"Line":1}},{"line":1059,"address":[1901592],"length":1,"stats":{"Line":1}},{"line":1062,"address":[1900915],"length":1,"stats":{"Line":0}},{"line":1063,"address":[1900930],"length":1,"stats":{"Line":0}},{"line":1064,"address":[2820667],"length":1,"stats":{"Line":0}},{"line":1066,"address":[3914404],"length":1,"stats":{"Line":0}},{"line":1072,"address":[3914476],"length":1,"stats":{"Line":0}},{"line":1074,"address":[2820081],"length":1,"stats":{"Line":0}},{"line":1075,"address":[3874077,3874119],"length":1,"stats":{"Line":0}},{"line":1077,"address":[3874085],"length":1,"stats":{"Line":0}},{"line":1079,"address":[3874194],"length":1,"stats":{"Line":0}},{"line":1081,"address":[1900505],"length":1,"stats":{"Line":1}},{"line":1085,"address":[1921165],"length":1,"stats":{"Line":1}}],"covered":219,"coverable":299},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","src","endpoint_client.rs"],"content":"// standard\nuse std::clone::Clone;\nuse std::convert::TryInto;\nuse std::net::TcpStream;\n\n// extern crates\nuse bson::doc;\nuse bson::spec::BinarySubtype;\nuse bson::{Binary, Bson};\nuse honk_rpc::honk_rpc::{RequestCookie, Response, Session};\nuse rand::rngs::OsRng;\nuse rand::RngCore;\nuse tor_interface::tor_crypto::*;\n\n// internal crates\nuse crate::ascii_string::*;\nuse crate::gosling::*;\n\n//\n// Endpoint Client\n//\n\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"HonkRPC method failed: {0}\")]\n    HonkRPCFailure(#[from] honk_rpc::honk_rpc::Error),\n\n    #[error(\"client received unexpected response: {0}\")]\n    UnexpectedResponseReceived(String),\n\n    #[error(\"client is in invalid state: {0}\")]\n    InvalidState(String),\n\n    #[error(\"incorrect usage: {0}\")]\n    IncorrectUsage(String),\n}\n\npub(crate) enum EndpointClientEvent {\n    HandshakeCompleted { stream: TcpStream },\n}\n\n#[derive(Debug, PartialEq)]\nenum EndpointClientState {\n    BeginHandshake,\n    WaitingForServerCookie,\n    WaitingForProofVerification,\n    HandshakeComplete,\n}\n\npub(crate) struct EndpointClient {\n    // session data\n    rpc: Option\u003cSession\u003cTcpStream\u003e\u003e,\n    pub server_service_id: V3OnionServiceId,\n    pub requested_channel: AsciiString,\n    client_service_id: V3OnionServiceId,\n    client_ed25519_private: Ed25519PrivateKey,\n\n    // state machine data\n    state: EndpointClientState,\n    begin_handshake_request_cookie: Option\u003cRequestCookie\u003e,\n    send_response_request_cookie: Option\u003cRequestCookie\u003e,\n}\n\nimpl EndpointClient {\n    fn get_state(\u0026self) -\u003e String {\n        format!(\"{{ state: {:?}, begin_handshake_request_cookie: {:?}, send_response_request_cookie: {:?} }}\", self.state, self.begin_handshake_request_cookie, self.send_response_request_cookie)\n    }\n\n    pub fn new(\n        rpc: Session\u003cTcpStream\u003e,\n        server_service_id: V3OnionServiceId,\n        requested_channel: AsciiString,\n        client_ed25519_private: Ed25519PrivateKey,\n    ) -\u003e Self {\n        Self {\n            rpc: Some(rpc),\n            server_service_id,\n            requested_channel,\n            client_service_id: V3OnionServiceId::from_private_key(\u0026client_ed25519_private),\n            client_ed25519_private,\n\n            state: EndpointClientState::BeginHandshake,\n            begin_handshake_request_cookie: None,\n            send_response_request_cookie: None,\n        }\n    }\n\n    pub fn update(\u0026mut self) -\u003e Result\u003cOption\u003cEndpointClientEvent\u003e, Error\u003e {\n        if self.state == EndpointClientState::HandshakeComplete {\n            return Err(Error::IncorrectUsage(\"update() may not be called after HandshakeComplete has been returned from previous update() call\".to_string()));\n        }\n\n        // update our rpc session\n        if let Some(rpc) = self.rpc.as_mut() {\n            rpc.update(None)?;\n\n            // client state machine\n            match (\n                \u0026self.state,\n                self.begin_handshake_request_cookie,\n                self.send_response_request_cookie,\n            ) {\n                (\u0026EndpointClientState::BeginHandshake, None, None) =\u003e {\n                    self.begin_handshake_request_cookie = Some(rpc.client_call(\n                        \"gosling_endpoint\",\n                        \"begin_handshake\",\n                        0,\n                        doc! {\n                            \"version\" : bson::Bson::String(GOSLING_PROTOCOL_VERSION.to_string()),\n                            \"client_identity\" : bson::Bson::String(self.client_service_id.to_string()),\n                            \"channel\" : bson::Bson::String(self.requested_channel.to_string()),\n                        },\n                    ).unwrap());\n                    self.state = EndpointClientState::WaitingForServerCookie;\n                    Ok(None)\n                }\n                (\n                    \u0026EndpointClientState::WaitingForServerCookie,\n                    Some(begin_handshake_request_cookie),\n                    None, // send_response_request_cookie\n                ) =\u003e {\n                    if let Some(response) = rpc.client_next_response() {\n                        let result = match response {\n                            Response::Pending { cookie } =\u003e {\n                                if cookie == begin_handshake_request_cookie {\n                                    return Ok(None);\n                                } else {\n                                    return Err(Error::UnexpectedResponseReceived(\n                                        \"received unexpected pending response\".to_string(),\n                                    ));\n                                }\n                            }\n                            Response::Error { cookie, error_code } =\u003e {\n                                if cookie != begin_handshake_request_cookie {\n                                    return Err(Error::UnexpectedResponseReceived(format!(\n                                        \"received unexpected error response; rpc error_code: {}\",\n                                        error_code\n                                    )));\n                                }\n                                return Err(Error::UnexpectedResponseReceived(format!(\n                                    \"received unexpected rpc error_code: {}\",\n                                    error_code\n                                )));\n                            }\n                            Response::Success { cookie, result } =\u003e {\n                                if cookie == begin_handshake_request_cookie {\n                                    result\n                                } else {\n                                    return Err(Error::UnexpectedResponseReceived(\n                                        \"received unexpected success response\".to_string(),\n                                    ));\n                                }\n                            }\n                        };\n\n                        if let Some(bson::Bson::Document(result)) = result {\n                            if let Some(Bson::Binary(Binary {\n                                subtype: BinarySubtype::Generic,\n                                bytes: server_cookie,\n                            })) = result.get(\"server_cookie\")\n                            {\n                                // build arguments for send_response()\n\n                                // client_cookie\n                                let mut client_cookie: ClientCookie = Default::default();\n                                OsRng.fill_bytes(\u0026mut client_cookie);\n\n                                // client_identity_proof_signature\n                                let server_cookie: ServerCookie =\n                                    match server_cookie.clone().try_into() {\n                                        Ok(server_cookie) =\u003e server_cookie,\n                                        Err(_) =\u003e {\n                                            return Err(Error::UnexpectedResponseReceived(format!(\n                                                \"unable to convert '{:?}' to server cookie\",\n                                                server_cookie\n                                            )))\n                                        }\n                                    };\n                                let client_identity_proof = build_client_proof(\n                                    DomainSeparator::GoslingEndpoint,\n                                    \u0026self.requested_channel,\n                                    \u0026self.client_service_id,\n                                    \u0026self.server_service_id,\n                                    \u0026client_cookie,\n                                    \u0026server_cookie,\n                                );\n                                let client_identity_proof_signature = self\n                                    .client_ed25519_private\n                                    .sign_message(\u0026client_identity_proof);\n\n                                // build our args object for rpc call\n                                let args = doc! {\n                                    \"client_cookie\" : Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_cookie.to_vec()}),\n                                    \"client_identity_proof_signature\" : Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_identity_proof_signature.to_bytes().to_vec()}),\n                                };\n\n                                // make rpc call\n                                self.send_response_request_cookie = Some(\n                                    rpc.client_call(\"gosling_endpoint\", \"send_response\", 0, args)\n                                        .unwrap(),\n                                );\n\n                                self.state = EndpointClientState::WaitingForProofVerification;\n                            } else {\n                                return Err(Error::UnexpectedResponseReceived(format!(\n                                    \"begin_handshake() returned unexpected value: {}\",\n                                    result\n                                )));\n                            }\n                        } else {\n                            return Err(Error::UnexpectedResponseReceived(format!(\n                                \"begin_handshake() returned unexpected value: {:?}\",\n                                result\n                            )));\n                        }\n                    }\n                    Ok(None)\n                }\n                (\n                    \u0026EndpointClientState::WaitingForProofVerification,\n                    Some(_begin_handshake_request_cookie),\n                    Some(send_response_request_cookie),\n                ) =\u003e {\n                    if let Some(response) = rpc.client_next_response() {\n                        let result = match response {\n                            Response::Pending { cookie } =\u003e {\n                                if cookie == send_response_request_cookie {\n                                    return Ok(None);\n                                } else {\n                                    return Err(Error::UnexpectedResponseReceived(\n                                        \"received unexpected pending response\".to_string(),\n                                    ));\n                                }\n                            }\n                            Response::Error { cookie, error_code } =\u003e {\n                                if cookie == send_response_request_cookie {\n                                    return Err(Error::UnexpectedResponseReceived(format!(\n                                        \"received unexpected error response; rpc error_code: {}\",\n                                        error_code\n                                    )));\n                                }\n                                return Err(Error::UnexpectedResponseReceived(format!(\n                                    \"received unexpected rpc error_code: {}\",\n                                    error_code\n                                )));\n                            }\n                            Response::Success { cookie, result } =\u003e {\n                                if cookie == send_response_request_cookie {\n                                    result\n                                } else {\n                                    return Err(Error::UnexpectedResponseReceived(\n                                        \"received unexpected success response\".to_string(),\n                                    ));\n                                }\n                            }\n                        };\n\n                        if let Some(Bson::Document(result)) = result {\n                            if result.is_empty() {\n                                self.state = EndpointClientState::HandshakeComplete;\n                                let stream = std::mem::take(\u0026mut self.rpc).unwrap().into_stream();\n                                return Ok(Some(EndpointClientEvent::HandshakeCompleted {\n                                    stream,\n                                }));\n                            } else {\n                                return Err(Error::UnexpectedResponseReceived(format!(\n                                    \"received unexpected data from send_response(): {:?}\",\n                                    result\n                                )));\n                            }\n                        } else {\n                            return Err(Error::UnexpectedResponseReceived(format!(\n                                \"received unexpected data from send_response(): {:?}\",\n                                result\n                            )));\n                        }\n                    }\n                    Ok(None)\n                }\n                _ =\u003e Err(Error::InvalidState(self.get_state())),\n            }\n        } else {\n            Err(Error::InvalidState(self.get_state()))\n        }\n    }\n}\n","traces":[{"line":65,"address":[4413040],"length":1,"stats":{"Line":0}},{"line":66,"address":[2122381,2122471,2122200],"length":1,"stats":{"Line":0}},{"line":69,"address":[4373760,4374196,4374237],"length":1,"stats":{"Line":2}},{"line":76,"address":[4373809],"length":1,"stats":{"Line":2}},{"line":79,"address":[2122724],"length":1,"stats":{"Line":2}},{"line":88,"address":[4374256,4376275],"length":1,"stats":{"Line":2}},{"line":89,"address":[1995920],"length":1,"stats":{"Line":2}},{"line":90,"address":[4414187],"length":1,"stats":{"Line":0}},{"line":94,"address":[1996390,1996149,1995975],"length":1,"stats":{"Line":4}},{"line":95,"address":[1996511,1995912,1996173],"length":1,"stats":{"Line":4}},{"line":98,"address":[4374844,4375156,4374989,4376305,4381528],"length":1,"stats":{"Line":10}},{"line":99,"address":[2123697],"length":1,"stats":{"Line":2}},{"line":100,"address":[4414573],"length":1,"stats":{"Line":2}},{"line":101,"address":[2123714],"length":1,"stats":{"Line":2}},{"line":104,"address":[4376161,4375811],"length":1,"stats":{"Line":4}},{"line":108,"address":[2124186,2124048,2124092,2124370,2124550],"length":1,"stats":{"Line":8}},{"line":109,"address":[2124065,2124136],"length":1,"stats":{"Line":4}},{"line":110,"address":[4415161],"length":1,"stats":{"Line":2}},{"line":111,"address":[4375601],"length":1,"stats":{"Line":2}},{"line":114,"address":[4376204],"length":1,"stats":{"Line":2}},{"line":115,"address":[1997809],"length":1,"stats":{"Line":2}},{"line":117,"address":[4376328],"length":1,"stats":{"Line":2}},{"line":122,"address":[2128596,2125224],"length":1,"stats":{"Line":4}},{"line":123,"address":[4416293],"length":1,"stats":{"Line":2}},{"line":124,"address":[4416412],"length":1,"stats":{"Line":2}},{"line":125,"address":[1998268],"length":1,"stats":{"Line":2}},{"line":126,"address":[2125836],"length":1,"stats":{"Line":2}},{"line":128,"address":[1998455],"length":1,"stats":{"Line":0}},{"line":129,"address":[1998422],"length":1,"stats":{"Line":0}},{"line":133,"address":[4376780],"length":1,"stats":{"Line":0}},{"line":134,"address":[1998408],"length":1,"stats":{"Line":0}},{"line":135,"address":[2130225,2130087],"length":1,"stats":{"Line":0}},{"line":140,"address":[4380883,4381021],"length":1,"stats":{"Line":0}},{"line":145,"address":[2125569],"length":1,"stats":{"Line":2}},{"line":146,"address":[4416502],"length":1,"stats":{"Line":2}},{"line":147,"address":[2125918],"length":1,"stats":{"Line":2}},{"line":149,"address":[2126048],"length":1,"stats":{"Line":0}},{"line":150,"address":[1998604],"length":1,"stats":{"Line":0}},{"line":156,"address":[2126151,2126306,2125952],"length":1,"stats":{"Line":6}},{"line":157,"address":[4417399,4417575,4417442],"length":1,"stats":{"Line":7}},{"line":159,"address":[2126712],"length":1,"stats":{"Line":2}},{"line":165,"address":[2126732],"length":1,"stats":{"Line":2}},{"line":166,"address":[1999464],"length":1,"stats":{"Line":2}},{"line":169,"address":[4417656],"length":1,"stats":{"Line":2}},{"line":171,"address":[4417728],"length":1,"stats":{"Line":2}},{"line":173,"address":[4379794,4379923],"length":1,"stats":{"Line":0}},{"line":180,"address":[2127061],"length":1,"stats":{"Line":2}},{"line":181,"address":[4378198],"length":1,"stats":{"Line":2}},{"line":182,"address":[1999792],"length":1,"stats":{"Line":2}},{"line":183,"address":[1999802],"length":1,"stats":{"Line":2}},{"line":187,"address":[1999984,1999865],"length":1,"stats":{"Line":4}},{"line":189,"address":[4418036],"length":1,"stats":{"Line":2}},{"line":192,"address":[4418376,4418653,4418163,4418222],"length":1,"stats":{"Line":6}},{"line":193,"address":[4418182,4418266],"length":1,"stats":{"Line":4}},{"line":194,"address":[4378732],"length":1,"stats":{"Line":2}},{"line":198,"address":[4379477],"length":1,"stats":{"Line":2}},{"line":199,"address":[2000697],"length":1,"stats":{"Line":2}},{"line":203,"address":[4419265],"length":1,"stats":{"Line":2}},{"line":205,"address":[2001681,2001810],"length":1,"stats":{"Line":0}},{"line":211,"address":[2001943,2002072],"length":1,"stats":{"Line":0}},{"line":217,"address":[4381473],"length":1,"stats":{"Line":2}},{"line":219,"address":[4381551],"length":1,"stats":{"Line":2}},{"line":224,"address":[4381588],"length":1,"stats":{"Line":2}},{"line":225,"address":[2130635],"length":1,"stats":{"Line":2}},{"line":226,"address":[2130767],"length":1,"stats":{"Line":0}},{"line":227,"address":[2130783],"length":1,"stats":{"Line":0}},{"line":228,"address":[2131058],"length":1,"stats":{"Line":0}},{"line":230,"address":[4382099],"length":1,"stats":{"Line":0}},{"line":231,"address":[2003650],"length":1,"stats":{"Line":0}},{"line":235,"address":[2003592],"length":1,"stats":{"Line":1}},{"line":236,"address":[2130917],"length":1,"stats":{"Line":1}},{"line":237,"address":[2006086,2005948],"length":1,"stats":{"Line":2}},{"line":242,"address":[2005611,2005749],"length":1,"stats":{"Line":0}},{"line":247,"address":[4381932],"length":1,"stats":{"Line":2}},{"line":248,"address":[2130854],"length":1,"stats":{"Line":2}},{"line":249,"address":[4382267],"length":1,"stats":{"Line":2}},{"line":251,"address":[2003981],"length":1,"stats":{"Line":0}},{"line":252,"address":[2003824],"length":1,"stats":{"Line":0}},{"line":258,"address":[2131520,2131166,2131365],"length":1,"stats":{"Line":6}},{"line":259,"address":[4422574,4422503],"length":1,"stats":{"Line":4}},{"line":260,"address":[2131821],"length":1,"stats":{"Line":2}},{"line":261,"address":[2004886,2004561],"length":1,"stats":{"Line":4}},{"line":262,"address":[2132201],"length":1,"stats":{"Line":2}},{"line":266,"address":[2004587,2004716],"length":1,"stats":{"Line":0}},{"line":272,"address":[4383503,4383632],"length":1,"stats":{"Line":0}},{"line":278,"address":[4381858],"length":1,"stats":{"Line":2}},{"line":280,"address":[1996630],"length":1,"stats":{"Line":0}},{"line":283,"address":[1996285],"length":1,"stats":{"Line":0}}],"covered":62,"coverable":88},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","src","endpoint_server.rs"],"content":"// standard\nuse std::clone::Clone;\nuse std::convert::TryInto;\nuse std::net::TcpStream;\n\n// extern crates\nuse bson::doc;\nuse bson::spec::BinarySubtype;\nuse bson::{Binary, Bson};\nuse honk_rpc::honk_rpc::{ApiSet, ErrorCode, RequestCookie, Session};\nuse rand::rngs::OsRng;\nuse rand::RngCore;\nuse tor_interface::tor_crypto::*;\n\n// internal crates\nuse crate::ascii_string::*;\nuse crate::gosling::*;\n\n//\n// Endpoint Server\n//\n\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"HonkRPC method failed: {0}\")]\n    HonkRPCFailure(#[from] honk_rpc::honk_rpc::Error),\n\n    #[error(\"server is in invalid state: {0}\")]\n    InvalidState(String),\n\n    #[error(\"incorrect usage: {0}\")]\n    IncorrectUsage(String),\n\n    #[error(\"client sent invalid request\")]\n    BadClient,\n}\n\npub(crate) enum EndpointServerEvent {\n    ChannelRequestReceived {\n        client_service_id: V3OnionServiceId,\n        requested_channel: AsciiString,\n    },\n    // endpoint server has acepted incoming channel request from identity client\n    HandshakeCompleted {\n        client_service_id: V3OnionServiceId,\n        channel_name: AsciiString,\n        stream: TcpStream,\n    },\n    // endpoint server has reject an incoming channel request\n    HandshakeRejected {\n        client_allowed: bool,\n        client_requested_channel_valid: bool,\n        client_proof_signature_valid: bool,\n    },\n}\n\n#[derive(Debug, PartialEq)]\nenum EndpointServerState {\n    // valid/expected states\n    WaitingForBeginHandshake,\n    ValidatingChannelRequest,\n    ChannelRequestValidated,\n    WaitingForSendResponse,\n    HandledSendResponse,\n    HandshakeComplete,\n    // failure state\n    HandshakeFailed,\n}\n\npub(crate) struct EndpointServer {\n    // Session Data\n    rpc: Option\u003cSession\u003cTcpStream\u003e\u003e,\n    pub server_identity: V3OnionServiceId,\n    allowed_client_identity: V3OnionServiceId,\n\n    // State Machine Data\n    state: EndpointServerState,\n    begin_handshake_request_cookie: Option\u003cRequestCookie\u003e,\n    client_identity: Option\u003cV3OnionServiceId\u003e,\n    requested_channel: Option\u003cAsciiString\u003e,\n    server_cookie: Option\u003cServerCookie\u003e,\n    handshake_succeeded: Option\u003cbool\u003e,\n\n    // Verification flags\n\n    // Client not on the block-list\n    client_allowed: bool,\n    // The requested endpoint is valid\n    client_requested_channel_valid: bool,\n    // The client proof is valid and signed with client's public key\n    client_proof_signature_valid: bool,\n}\n\nimpl EndpointServer {\n    fn get_state(\u0026self) -\u003e String {\n        format!(\"{{ state: {:?}, begin_handshake_request_cookie: {:?}, client_identity: {:?}, requested_channel: {:?}, server_cookie: {:?}, handshake_succeeded:{:?} }}\", self.state, self.begin_handshake_request_cookie, self.client_identity, self.requested_channel, self.server_cookie, self.handshake_succeeded)\n    }\n\n    pub fn new(\n        rpc: Session\u003cTcpStream\u003e,\n        client_identity: V3OnionServiceId,\n        server_identity: V3OnionServiceId,\n    ) -\u003e Self {\n        // generate server cookie\n        let mut server_cookie: ServerCookie = Default::default();\n        OsRng.fill_bytes(\u0026mut server_cookie);\n\n        EndpointServer {\n            rpc: Some(rpc),\n            server_identity,\n            allowed_client_identity: client_identity,\n            state: EndpointServerState::WaitingForBeginHandshake,\n            begin_handshake_request_cookie: None,\n            requested_channel: None,\n            client_identity: None,\n            server_cookie: None,\n            handshake_succeeded: None,\n            client_allowed: false,\n            // TODO: hookup this to event and callback\n            client_requested_channel_valid: true,\n            client_proof_signature_valid: false,\n        }\n    }\n\n    pub fn update(\u0026mut self) -\u003e Result\u003cOption\u003cEndpointServerEvent\u003e, Error\u003e {\n        if let Some(mut rpc) = std::mem::take(\u0026mut self.rpc) {\n            match rpc.update(Some(\u0026mut [self])) {\n                Ok(()) =\u003e {\n                    self.rpc = Some(rpc);\n                }\n                Err(err) =\u003e {\n                    self.rpc = Some(rpc);\n                    return Err(err.into());\n                }\n            }\n        }\n\n        match(\u0026self.state,\n              self.begin_handshake_request_cookie,\n              self.client_identity.as_ref(),\n              self.requested_channel.as_ref(),\n              self.server_cookie.as_ref(),\n              self.handshake_succeeded) {\n            (\u0026EndpointServerState::WaitingForBeginHandshake,\n             None, // begin_handshake_request_cookie\n             None, // client_identity\n             None, // requested_channel\n             None, // server_cookie\n             None) // handshake_succeeded\n            =\u003e {},\n            (\u0026EndpointServerState::WaitingForBeginHandshake,\n             Some(_begin_handshake_request_cookie),\n             Some(client_identity),\n             Some(requested_channel),\n             None, // server_cookie\n             None) // handshake_succeeded\n            =\u003e {\n                self.state = EndpointServerState::ValidatingChannelRequest;\n                return Ok(\n                        Some(\n                            EndpointServerEvent::ChannelRequestReceived\n                            {\n                                client_service_id: client_identity.clone(),\n                                requested_channel: requested_channel.clone()\n                            }));\n            },\n            (\u0026EndpointServerState::ValidatingChannelRequest,\n             Some(_begin_handshake_request_cookie),\n             Some(_client_identity),\n             Some(_requested_channel),\n             None, // server_cookie\n             None) // handshake_succeeded\n            =\u003e {},\n            (\u0026EndpointServerState::ChannelRequestValidated,\n             Some(_begin_handshake_request_cookie),\n             Some(_client_identity),\n             Some(_requested_channel),\n             Some(_server_cookie),\n             None) // handshake_succeeded\n            =\u003e {},\n            (\u0026EndpointServerState::WaitingForSendResponse,\n             Some(_begin_handshake_request_cookie),\n             Some(_client_identity),\n             Some(_requested_channel),\n             Some(_server_cookie),\n             None) // handshake_succeeded\n            =\u003e {},\n            (\u0026EndpointServerState::HandledSendResponse,\n             Some(_begin_handshake_request_cookie),\n             Some(client_identity),\n             Some(requested_channel),\n             Some(_server_cookie),\n             Some(handshake_succeeded))\n            =\u003e {\n                self.state = EndpointServerState::HandshakeComplete;\n                if handshake_succeeded {\n                    let stream = std::mem::take(\u0026mut self.rpc).unwrap().into_stream();\n                    return Ok(Some(EndpointServerEvent::HandshakeCompleted{\n                        client_service_id: client_identity.clone(),\n                        channel_name: requested_channel.clone(),\n                        stream}));\n                } else {\n                    return Ok(Some(EndpointServerEvent::HandshakeRejected{\n                        client_allowed: self.client_allowed,\n                        client_requested_channel_valid: self.client_requested_channel_valid,\n                        client_proof_signature_valid: self.client_proof_signature_valid}));\n                }\n            },\n            _ =\u003e {\n                if self.state == EndpointServerState::HandshakeFailed {\n                    return Err(Error::BadClient);\n                } else {\n                    return Err(Error::InvalidState(self.get_state()));\n                }\n            }\n        }\n\n        Ok(None)\n    }\n\n    pub fn handle_channel_request_received(\n        \u0026mut self,\n        client_requested_channel_valid: bool,\n    ) -\u003e Result\u003c(), Error\u003e {\n        match(\u0026self.state,\n              self.begin_handshake_request_cookie,\n              self.client_identity.as_ref(),\n              self.requested_channel.as_ref(),\n              self.server_cookie.as_ref(),\n              self.handshake_succeeded) {\n            (\u0026EndpointServerState::ValidatingChannelRequest,\n             Some(_begin_handshake_request_cookie),\n             Some(client_identity),\n             Some(_requested_channel),\n             None, // server_cookie\n             None) // handshake_succeeded\n            =\u003e {\n                let mut server_cookie: ServerCookie = Default::default();\n                OsRng.fill_bytes(\u0026mut server_cookie);\n                self.server_cookie = Some(server_cookie);\n                self.client_allowed = *client_identity == self.allowed_client_identity;\n                self.client_requested_channel_valid = client_requested_channel_valid;\n                self.state = EndpointServerState::ChannelRequestValidated;\n                Ok(())\n            },\n            _ =\u003e Err(Error::IncorrectUsage(\"handle_channel_request_received() may only be called after ChannelRequestReceived has been returned from update(), and it may only be called once\".to_string()))\n        }\n    }\n}\n\nimpl ApiSet for EndpointServer {\n    fn namespace(\u0026self) -\u003e \u0026str {\n        \"gosling_endpoint\"\n    }\n\n    fn exec_function(\n        \u0026mut self,\n        name: \u0026str,\n        version: i32,\n        mut args: bson::document::Document,\n        request_cookie: Option\u003cRequestCookie\u003e,\n    ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n        let request_cookie = match request_cookie {\n            Some(request_cookie) =\u003e request_cookie,\n            None =\u003e {\n                return Some(Err(ErrorCode::Runtime(\n                    RpcError::RequestCookieRequired as i32,\n                )))\n            }\n        };\n\n        match\n            (name, version,\n             \u0026self.state,\n             self.client_identity.as_ref(),\n             self.requested_channel.as_ref(),\n             self.server_cookie.as_ref()) {\n            // handle begin_handshake call\n            (\"begin_handshake\", 0,\n            \u0026EndpointServerState::WaitingForBeginHandshake,\n            None, // client_identity\n            None, // requested_channel\n            None) // server_cookie\n            =\u003e {\n                let valid_version = match args.remove(\"version\") {\n                    Some(Bson::String(value)) =\u003e value == GOSLING_PROTOCOL_VERSION,\n                    _ =\u003e false,\n                };\n                if !valid_version {\n                    self.state = EndpointServerState::HandshakeFailed;\n                    return Some(Err(ErrorCode::Runtime(RpcError::BadVersion as i32)));\n                }\n\n                if let (\n                    Some(Bson::String(client_identity)),\n                    Some(Bson::String(channel_name))\n                ) = (\n                    args.remove(\"client_identity\"),\n                    args.remove(\"channel\")\n                ) {\n                    // client_identiity\n                    self.client_identity = match V3OnionServiceId::from_string(\u0026client_identity) {\n                        Ok(client_identity) =\u003e Some(client_identity),\n                        Err(_) =\u003e {\n                            self.state = EndpointServerState::HandshakeFailed;\n                            return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                        }\n                    };\n\n                    let channel_name = match AsciiString::new(channel_name) {\n                        Ok(channel_name) =\u003e channel_name,\n                        Err(_) =\u003e {\n                            self.state = EndpointServerState::HandshakeFailed;\n                            return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                        }\n                    };\n\n                    // save cookie\n                    self.begin_handshake_request_cookie = Some(request_cookie);\n\n                    // save channel name\n                    self.requested_channel = Some(channel_name);\n\n                    None\n                } else {\n                    self.state = EndpointServerState::HandshakeFailed;\n                    Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)))\n                }\n            },\n            (\"send_response\", 0,\n            \u0026EndpointServerState::WaitingForSendResponse,\n            Some(client_identity),\n            Some(requested_channel),\n            Some(server_cookie))\n            =\u003e {\n                if let (Some(Bson::Binary(Binary{subtype: BinarySubtype::Generic, bytes: client_cookie})),\n                        Some(Bson::Binary(Binary{subtype: BinarySubtype::Generic, bytes: client_identity_proof_signature}))) =\n                       (args.remove(\"client_cookie\"),\n                        args.remove(\"client_identity_proof_signature\")) {\n                    // client_cookie\n                    let client_cookie : ClientCookie = match client_cookie.try_into() {\n                        Ok(client_cookie) =\u003e client_cookie,\n                        Err(_) =\u003e {\n                            self.state = EndpointServerState::HandshakeFailed;\n                            return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                        }\n                    };\n\n                    // client_identity_proof_signature\n                    let client_identity_proof_signature : [u8; ED25519_SIGNATURE_SIZE] = match client_identity_proof_signature.try_into() {\n                        Ok(client_identity_proof_signature) =\u003e client_identity_proof_signature,\n                        Err(_) =\u003e {\n                            self.state = EndpointServerState::HandshakeFailed;\n                            return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                        }\n                    };\n                    let client_identity_proof_signature = match Ed25519Signature::from_raw(\u0026client_identity_proof_signature) {\n                        Ok(client_identity_proof_signature) =\u003e client_identity_proof_signature,\n                        Err(_) =\u003e {\n                            self.state = EndpointServerState::HandshakeFailed;\n                            return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                        }\n                    };\n\n                    // convert client_identity to client's public ed25519 key\n                    let client_identity_key = match Ed25519PublicKey::from_service_id(client_identity) {\n                        Ok(client_identity_key) =\u003e client_identity_key,\n                        Err(_) =\u003e {\n                            self.state = EndpointServerState::HandshakeFailed;\n                            return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                        }\n                    };\n\n                    // construct + verify client proof\n                    let client_proof = build_client_proof(\n                        DomainSeparator::GoslingEndpoint,\n                        requested_channel,\n                        client_identity,\n                        \u0026self.server_identity,\n                        \u0026client_cookie,\n                        server_cookie,\n                    );\n                    self.client_proof_signature_valid =\n                        client_identity_proof_signature.verify(\u0026client_proof, \u0026client_identity_key);\n\n                    if self.client_allowed\n                        \u0026\u0026 self.client_requested_channel_valid\n                        \u0026\u0026 self.client_proof_signature_valid\n                    {\n                        self.handshake_succeeded = Some(true);\n                        self.state = EndpointServerState::HandledSendResponse;\n                        // success, return empty doc\n                        Some(Ok(Some(Bson::Document(doc! {}))))\n                    } else {\n                        self.handshake_succeeded = Some(false);\n                        self.state = EndpointServerState::HandledSendResponse;\n                        Some(Err(ErrorCode::Runtime(RpcError::Failure as i32)))\n                    }\n                } else {\n                    self.state = EndpointServerState::HandshakeFailed;\n                    Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)))\n                }\n            },\n            _ =\u003e {\n                self.state = EndpointServerState::HandshakeFailed;\n                Some(Err(ErrorCode::Runtime(RpcError::Failure as i32)))\n            }\n        }\n    }\n\n    fn next_result(\u0026mut self) -\u003e Option\u003c(RequestCookie, Result\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e)\u003e {\n        match (\n            \u0026self.state,\n            self.begin_handshake_request_cookie,\n            self.server_cookie.as_ref(),\n        ) {\n            (\n                \u0026EndpointServerState::ChannelRequestValidated,\n                Some(begin_handshake_request_cookie),\n                Some(server_cookie),\n            ) =\u003e {\n                self.state = EndpointServerState::WaitingForSendResponse;\n                Some((\n                    begin_handshake_request_cookie,\n                    Ok(Some(Bson::Document(doc! {\n                        \"server_cookie\" : Bson::Binary(Binary{subtype: BinarySubtype::Generic, bytes: server_cookie.to_vec()}),\n                    }))),\n                ))\n            }\n            _ =\u003e None,\n        }\n    }\n}\n","traces":[{"line":95,"address":[4381808],"length":1,"stats":{"Line":0}},{"line":96,"address":[2102857,2103038,2103228,2103133,2103323,2103416],"length":1,"stats":{"Line":0}},{"line":99,"address":[1973118,1972624],"length":1,"stats":{"Line":2}},{"line":105,"address":[2103712],"length":1,"stats":{"Line":2}},{"line":106,"address":[2103765],"length":1,"stats":{"Line":2}},{"line":109,"address":[1972744],"length":1,"stats":{"Line":2}},{"line":125,"address":[1974360,1973152],"length":1,"stats":{"Line":2}},{"line":126,"address":[1973203],"length":1,"stats":{"Line":2}},{"line":127,"address":[4343641,4343803],"length":1,"stats":{"Line":4}},{"line":129,"address":[2104585,2104925],"length":1,"stats":{"Line":2}},{"line":131,"address":[4343954],"length":1,"stats":{"Line":0}},{"line":132,"address":[1973998,1973786],"length":1,"stats":{"Line":0}},{"line":133,"address":[4344369,4344568],"length":1,"stats":{"Line":0}},{"line":138,"address":[2106449,2106063,2105450,2106630,2105741,2106827,2107024,2105585],"length":1,"stats":{"Line":12}},{"line":139,"address":[4384477],"length":1,"stats":{"Line":2}},{"line":140,"address":[4384494],"length":1,"stats":{"Line":2}},{"line":141,"address":[2105506],"length":1,"stats":{"Line":2}},{"line":142,"address":[2105531],"length":1,"stats":{"Line":2}},{"line":143,"address":[2105579],"length":1,"stats":{"Line":2}},{"line":151,"address":[4345480],"length":1,"stats":{"Line":2}},{"line":158,"address":[4345501],"length":1,"stats":{"Line":2}},{"line":159,"address":[1975395],"length":1,"stats":{"Line":2}},{"line":160,"address":[4385393],"length":1,"stats":{"Line":2}},{"line":161,"address":[2106271],"length":1,"stats":{"Line":2}},{"line":163,"address":[1975234],"length":1,"stats":{"Line":2}},{"line":164,"address":[2106258],"length":1,"stats":{"Line":2}},{"line":167,"address":[2106609],"length":1,"stats":{"Line":0}},{"line":173,"address":[4345907],"length":1,"stats":{"Line":0}},{"line":174,"address":[4346088],"length":1,"stats":{"Line":0}},{"line":180,"address":[4346104],"length":1,"stats":{"Line":0}},{"line":181,"address":[2106971],"length":1,"stats":{"Line":2}},{"line":187,"address":[2107019],"length":1,"stats":{"Line":2}},{"line":188,"address":[2107176],"length":1,"stats":{"Line":2}},{"line":195,"address":[4386279],"length":1,"stats":{"Line":2}},{"line":196,"address":[1976268],"length":1,"stats":{"Line":2}},{"line":197,"address":[4386471,4386563],"length":1,"stats":{"Line":4}},{"line":198,"address":[2107643],"length":1,"stats":{"Line":2}},{"line":199,"address":[4386592],"length":1,"stats":{"Line":2}},{"line":200,"address":[4346912],"length":1,"stats":{"Line":2}},{"line":201,"address":[1976631],"length":1,"stats":{"Line":2}},{"line":203,"address":[2107308],"length":1,"stats":{"Line":1}},{"line":204,"address":[1976284],"length":1,"stats":{"Line":1}},{"line":205,"address":[1976290],"length":1,"stats":{"Line":1}},{"line":206,"address":[4346584],"length":1,"stats":{"Line":1}},{"line":210,"address":[1974703],"length":1,"stats":{"Line":0}},{"line":211,"address":[1976939],"length":1,"stats":{"Line":0}},{"line":213,"address":[4347109],"length":1,"stats":{"Line":0}},{"line":218,"address":[2105997],"length":1,"stats":{"Line":2}},{"line":221,"address":[2107984],"length":1,"stats":{"Line":2}},{"line":225,"address":[4387388,4387077,4387207],"length":1,"stats":{"Line":6}},{"line":226,"address":[4347348],"length":1,"stats":{"Line":2}},{"line":227,"address":[1977077],"length":1,"stats":{"Line":2}},{"line":228,"address":[1977100],"length":1,"stats":{"Line":2}},{"line":229,"address":[2108113],"length":1,"stats":{"Line":2}},{"line":230,"address":[4347457],"length":1,"stats":{"Line":2}},{"line":231,"address":[2108498],"length":1,"stats":{"Line":2}},{"line":238,"address":[4347810],"length":1,"stats":{"Line":2}},{"line":239,"address":[4387568],"length":1,"stats":{"Line":2}},{"line":240,"address":[1977568],"length":1,"stats":{"Line":2}},{"line":241,"address":[4387771],"length":1,"stats":{"Line":2}},{"line":242,"address":[2108768],"length":1,"stats":{"Line":2}},{"line":243,"address":[1977788],"length":1,"stats":{"Line":2}},{"line":244,"address":[2108798],"length":1,"stats":{"Line":2}},{"line":246,"address":[1977237],"length":1,"stats":{"Line":0}},{"line":252,"address":[4348128],"length":1,"stats":{"Line":2}},{"line":256,"address":[1986621,1977872,1981675],"length":1,"stats":{"Line":2}},{"line":263,"address":[2109006],"length":1,"stats":{"Line":2}},{"line":264,"address":[4388225],"length":1,"stats":{"Line":2}},{"line":266,"address":[4348385],"length":1,"stats":{"Line":0}},{"line":272,"address":[4353153,4349078,4353120,4353186,4353087,4349144,4349111,4348862,4349020,4349045],"length":1,"stats":{"Line":20}},{"line":273,"address":[4349055,4349121,4353097,4353130,4348719,4353076,4349088,4349034,4353163],"length":1,"stats":{"Line":18}},{"line":274,"address":[4348502],"length":1,"stats":{"Line":2}},{"line":275,"address":[4348519],"length":1,"stats":{"Line":2}},{"line":276,"address":[1978328],"length":1,"stats":{"Line":2}},{"line":277,"address":[4388391],"length":1,"stats":{"Line":2}},{"line":279,"address":[4348774],"length":1,"stats":{"Line":2}},{"line":285,"address":[1982916],"length":1,"stats":{"Line":2}},{"line":286,"address":[4393075],"length":1,"stats":{"Line":2}},{"line":287,"address":[1983030],"length":1,"stats":{"Line":0}},{"line":289,"address":[2114357],"length":1,"stats":{"Line":2}},{"line":290,"address":[1983479],"length":1,"stats":{"Line":0}},{"line":291,"address":[4353788],"length":1,"stats":{"Line":0}},{"line":294,"address":[4394014,4393846,4394097,4393881,4394053],"length":1,"stats":{"Line":8}},{"line":295,"address":[4354363],"length":1,"stats":{"Line":2}},{"line":296,"address":[2115067],"length":1,"stats":{"Line":2}},{"line":298,"address":[2114559],"length":1,"stats":{"Line":2}},{"line":299,"address":[1983638],"length":1,"stats":{"Line":2}},{"line":302,"address":[2115191,2115123,2115376],"length":1,"stats":{"Line":6}},{"line":303,"address":[2115240],"length":1,"stats":{"Line":2}},{"line":305,"address":[1984522],"length":1,"stats":{"Line":0}},{"line":306,"address":[4394575],"length":1,"stats":{"Line":0}},{"line":310,"address":[4394688],"length":1,"stats":{"Line":2}},{"line":311,"address":[2115682],"length":1,"stats":{"Line":2}},{"line":313,"address":[2115822],"length":1,"stats":{"Line":0}},{"line":314,"address":[4355179],"length":1,"stats":{"Line":0}},{"line":319,"address":[2115962],"length":1,"stats":{"Line":2}},{"line":322,"address":[1985053,1985217],"length":1,"stats":{"Line":2}},{"line":324,"address":[1985342],"length":1,"stats":{"Line":2}},{"line":326,"address":[2114827],"length":1,"stats":{"Line":0}},{"line":327,"address":[1983896],"length":1,"stats":{"Line":0}},{"line":330,"address":[2109854],"length":1,"stats":{"Line":3}},{"line":336,"address":[1979439,1979421,1979359,1979320,1979187,1979403,1979152],"length":1,"stats":{"Line":13}},{"line":339,"address":[2109952],"length":1,"stats":{"Line":2}},{"line":341,"address":[2110509,2110577],"length":1,"stats":{"Line":4}},{"line":342,"address":[2110595],"length":1,"stats":{"Line":2}},{"line":344,"address":[4350013],"length":1,"stats":{"Line":0}},{"line":345,"address":[2110718],"length":1,"stats":{"Line":0}},{"line":350,"address":[1979919],"length":1,"stats":{"Line":2}},{"line":351,"address":[4350296],"length":1,"stats":{"Line":2}},{"line":353,"address":[4390206],"length":1,"stats":{"Line":0}},{"line":354,"address":[2111167],"length":1,"stats":{"Line":0}},{"line":357,"address":[4350656],"length":1,"stats":{"Line":2}},{"line":358,"address":[4350705],"length":1,"stats":{"Line":2}},{"line":360,"address":[4390615],"length":1,"stats":{"Line":0}},{"line":361,"address":[2111572],"length":1,"stats":{"Line":0}},{"line":366,"address":[4351010],"length":1,"stats":{"Line":2}},{"line":367,"address":[1980752],"length":1,"stats":{"Line":2}},{"line":369,"address":[1980860],"length":1,"stats":{"Line":0}},{"line":370,"address":[4390913],"length":1,"stats":{"Line":0}},{"line":376,"address":[4351298],"length":1,"stats":{"Line":2}},{"line":379,"address":[1981018],"length":1,"stats":{"Line":2}},{"line":383,"address":[2112159],"length":1,"stats":{"Line":2}},{"line":384,"address":[4351436,4351353],"length":1,"stats":{"Line":4}},{"line":386,"address":[1981200,1981618,1981357],"length":1,"stats":{"Line":5}},{"line":387,"address":[4391399],"length":1,"stats":{"Line":2}},{"line":388,"address":[4351676],"length":1,"stats":{"Line":2}},{"line":390,"address":[2112377],"length":1,"stats":{"Line":2}},{"line":391,"address":[2112398],"length":1,"stats":{"Line":2}},{"line":393,"address":[2112460,2112419],"length":1,"stats":{"Line":4}},{"line":395,"address":[2112197],"length":1,"stats":{"Line":1}},{"line":396,"address":[1981250],"length":1,"stats":{"Line":1}},{"line":397,"address":[1981271],"length":1,"stats":{"Line":1}},{"line":400,"address":[2110185],"length":1,"stats":{"Line":0}},{"line":401,"address":[2110206],"length":1,"stats":{"Line":0}},{"line":405,"address":[1978620],"length":1,"stats":{"Line":0}},{"line":406,"address":[2109621],"length":1,"stats":{"Line":0}},{"line":411,"address":[1987388,1986640],"length":1,"stats":{"Line":2}},{"line":412,"address":[4357026,4357092],"length":1,"stats":{"Line":4}},{"line":413,"address":[2117622],"length":1,"stats":{"Line":2}},{"line":414,"address":[4396725],"length":1,"stats":{"Line":2}},{"line":415,"address":[4356998],"length":1,"stats":{"Line":2}},{"line":417,"address":[1986835],"length":1,"stats":{"Line":2}},{"line":422,"address":[1986870],"length":1,"stats":{"Line":2}},{"line":423,"address":[1987323],"length":1,"stats":{"Line":2}},{"line":425,"address":[1986885,1986939,1987093],"length":1,"stats":{"Line":4}},{"line":426,"address":[1986907,1986983],"length":1,"stats":{"Line":4}},{"line":430,"address":[1986785],"length":1,"stats":{"Line":2}}],"covered":112,"coverable":147},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","src","gosling.rs"],"content":"// standard\n#[cfg(test)]\nuse std::net::{SocketAddr, TcpListener, TcpStream};\n\n// extern crates\n#[cfg(test)]\nuse bson::doc;\nuse data_encoding::HEXLOWER;\n#[cfg(test)]\nuse honk_rpc::honk_rpc::Session;\nuse num_enum::TryFromPrimitive;\nuse tor_interface::tor_crypto::*;\n\n// internal crates\nuse crate::ascii_string::*;\n#[cfg(test)]\nuse crate::endpoint_client::*;\n#[cfg(test)]\nuse crate::endpoint_server::*;\n#[cfg(test)]\nuse crate::identity_client::*;\n#[cfg(test)]\nuse crate::identity_server::*;\n\n#[derive(Debug, Eq, PartialEq, TryFromPrimitive)]\n#[repr(i32)]\n/// cbindgen:ignore\npub(crate) enum RpcError {\n    // bad gosling version\n    BadVersion,\n    // cookie required\n    RequestCookieRequired,\n    // invalid or missing arguments\n    InvalidArg,\n    // generic runtime error\n    Failure,\n}\n\npub(crate) const GOSLING_PROTOCOL_VERSION: \u0026str = \"0.1.0\";\n\npub(crate) const CLIENT_COOKIE_SIZE: usize = 32usize;\npub(crate) const SERVER_COOKIE_SIZE: usize = 32usize;\n\npub(crate) type ClientCookie = [u8; CLIENT_COOKIE_SIZE];\npub(crate) type ServerCookie = [u8; SERVER_COOKIE_SIZE];\npub(crate) type ClientProof = Vec\u003cu8\u003e;\n\npub(crate) enum DomainSeparator {\n    GoslingIdentity,\n    GoslingEndpoint,\n}\n\nimpl From\u003cDomainSeparator\u003e for \u0026[u8] {\n    fn from(sep: DomainSeparator) -\u003e \u0026'static [u8] {\n        match sep {\n            DomainSeparator::GoslingIdentity =\u003e b\"gosling-identity\",\n            DomainSeparator::GoslingEndpoint =\u003e b\"gosling-endpoint\",\n        }\n    }\n}\n\npub(crate) fn build_client_proof(\n    domain_separator: DomainSeparator,\n    request: \u0026AsciiString,\n    client_service_id: \u0026V3OnionServiceId,\n    server_service_id: \u0026V3OnionServiceId,\n    client_cookie: \u0026ClientCookie,\n    server_cookie: \u0026ServerCookie,\n) -\u003e ClientProof {\n    let mut client_proof: ClientProof = Default::default();\n\n    client_proof.extend_from_slice(domain_separator.into());\n    client_proof.push(0u8);\n    client_proof.extend_from_slice(request.as_bytes());\n    client_proof.push(0u8);\n    client_proof.extend_from_slice(client_service_id.to_string().as_bytes());\n    client_proof.push(0u8);\n    client_proof.extend_from_slice(server_service_id.to_string().as_bytes());\n    client_proof.push(0u8);\n    client_proof.extend_from_slice(HEXLOWER.encode(client_cookie).as_bytes());\n    client_proof.push(0u8);\n    client_proof.extend_from_slice(HEXLOWER.encode(server_cookie).as_bytes());\n\n    client_proof\n}\n\n//\n// Tests\n//\n\n#[cfg(test)]\nfn identity_test(\n    client_blocked: bool,\n    client_requested_endpoint: \u0026str,\n    client_requested_endpoint_valid: bool,\n    server_challenge: bson::document::Document,\n    client_response: bson::document::Document,\n    server_expected_response: bson::document::Document,\n    should_fail: bool,\n) -\u003e anyhow::Result\u003c()\u003e {\n    // test sockets\n    let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n    let listener = TcpListener::bind(socket_addr)?;\n    let socket_addr = listener.local_addr()?;\n\n    let stream1 = TcpStream::connect(socket_addr)?;\n    stream1.set_nonblocking(true)?;\n    let (stream2, _socket_addr) = listener.accept()?;\n    stream2.set_nonblocking(true)?;\n\n    // client setup\n    let client_ed25519_private = Ed25519PrivateKey::generate();\n\n    // server setup\n    let server_ed25519_private = Ed25519PrivateKey::generate();\n    let server_ed25519_public = Ed25519PublicKey::from_private_key(\u0026server_ed25519_private);\n    let server_service_id = V3OnionServiceId::from_public_key(\u0026server_ed25519_public);\n\n    let client_requested_endpoint = match AsciiString::new(client_requested_endpoint.to_string()) {\n        Ok(ascii) =\u003e ascii,\n        Err(_) =\u003e {\n            assert!(should_fail);\n            return Ok(());\n        }\n    };\n\n    // rpc setup\n    let client_rpc = Session::new(stream1);\n    let mut ident_client = IdentityClient::new(\n        client_rpc,\n        server_service_id.clone(),\n        client_requested_endpoint.clone(),\n        client_ed25519_private,\n        X25519PrivateKey::generate(),\n    )\n    .unwrap();\n\n    let server_rpc = Session::new(stream2);\n    let mut ident_server = IdentityServer::new(server_rpc, server_service_id.clone());\n\n    let mut failure_ocurred = false;\n    let mut server_complete = false;\n    let mut client_complete = false;\n    while !server_complete \u0026\u0026 !client_complete {\n        if !server_complete {\n            match ident_server.update() {\n                Ok(Some(IdentityServerEvent::EndpointRequestReceived {\n                    client_service_id,\n                    requested_endpoint,\n                })) =\u003e {\n                    println!(\n                        \"server challenge send: client_service_id {}, requested_endpoint: {}\",\n                        client_service_id.to_string(),\n                        requested_endpoint\n                    );\n                    let client_allowed = !client_blocked;\n                    ident_server.handle_endpoint_request_received(\n                        client_allowed,\n                        client_requested_endpoint_valid,\n                        server_challenge.clone(),\n                    )?;\n                }\n                Ok(Some(IdentityServerEvent::ChallengeResponseReceived { challenge_response })) =\u003e {\n                    println!(\"server challenge repsonse received\");\n                    ident_server.handle_challenge_response_received(\n                        challenge_response == server_expected_response,\n                    )?;\n                }\n                Ok(Some(IdentityServerEvent::HandshakeCompleted {\n                    endpoint_private_key: _,\n                    endpoint_name,\n                    client_service_id,\n                    client_auth_public_key: _,\n                })) =\u003e {\n                    assert!(endpoint_name == client_requested_endpoint);\n                    println!(\n                        \"server complete! client_service_id : {}\",\n                        client_service_id.to_string()\n                    );\n                    server_complete = true;\n                }\n                Ok(Some(IdentityServerEvent::HandshakeRejected {\n                    client_allowed,\n                    client_requested_endpoint_valid,\n                    client_proof_signature_valid,\n                    client_auth_signature_valid,\n                    challenge_response_valid,\n                })) =\u003e {\n                    println!(\"server complete! client request rejected\");\n                    println!(\" client_allowed: {}\", client_allowed);\n                    println!(\n                        \" client_requested_endpoint_valid: {}\",\n                        client_requested_endpoint_valid\n                    );\n                    println!(\n                        \" client_proof_signature_valid: {}\",\n                        client_proof_signature_valid\n                    );\n                    println!(\n                        \" client_auth_signature_valid: {}\",\n                        client_auth_signature_valid\n                    );\n                    println!(\" client_response_valid: {}\", challenge_response_valid);\n                    server_complete = true;\n                    failure_ocurred = true;\n                }\n                Ok(None) =\u003e {}\n                Err(err) =\u003e {\n                    println!(\"server failure: {:?}\", err);\n                    server_complete = true;\n                    failure_ocurred = true;\n                }\n            }\n        }\n\n        if !client_complete {\n            match ident_client.update() {\n                Ok(Some(IdentityClientEvent::ChallengeReceived { endpoint_challenge })) =\u003e {\n                    println!(\n                        \"client challenge request received: endpoint_challenge: {}\",\n                        endpoint_challenge\n                    );\n                    ident_client.send_response(client_response.clone())?;\n                }\n                Ok(Some(IdentityClientEvent::HandshakeCompleted {\n                    identity_service_id,\n                    endpoint_service_id,\n                    endpoint_name,\n                    client_auth_private_key: _,\n                })) =\u003e {\n                    assert!(identity_service_id == server_service_id);\n                    assert!(endpoint_name == client_requested_endpoint.clone().to_string());\n                    println!(\n                        \"client complete! endpoint_server : {}\",\n                        endpoint_service_id.to_string()\n                    );\n                    client_complete = true;\n                }\n                Ok(None) =\u003e {}\n                Err(err) =\u003e {\n                    println!(\"client failure: {:?}\", err);\n                    client_complete = true;\n                    failure_ocurred = true;\n                }\n            }\n        }\n    }\n\n    assert!(failure_ocurred == should_fail);\n    Ok(())\n}\n\n#[test]\nfn test_identity_handshake() -\u003e anyhow::Result\u003c()\u003e {\n    println!(\"Sucessful ---\");\n    {\n        let client_blocked: bool = false;\n        let client_requested_endpoint: \u0026str = \"endpoint\";\n        let client_requested_endpoint_valid: bool = true;\n        let server_challenge: bson::document::Document = doc!(\"msg\": \"Speak friend and enter\");\n        let client_response: bson::document::Document = doc!(\"msg\": \"Mellon\");\n        let server_expected_response: bson::document::Document = doc!(\"msg\": \"Mellon\");\n        let should_fail: bool = false;\n        identity_test(\n            client_blocked,\n            client_requested_endpoint,\n            client_requested_endpoint_valid,\n            server_challenge,\n            client_response,\n            server_expected_response,\n            should_fail,\n        )?;\n    }\n    println!(\"Bad Endpoint ---\");\n    {\n        let client_blocked: bool = false;\n        let client_requested_endpoint: \u0026str = \"endpoint\";\n        let client_requested_endpoint_valid: bool = false;\n        let server_challenge: bson::document::Document = doc!(\"msg\": \"Speak friend and enter\");\n        let client_response: bson::document::Document = doc!(\"msg\": \"Mellon\");\n        let server_expected_response: bson::document::Document = doc!(\"msg\": \"Mellon\");\n        let should_fail: bool = true;\n        identity_test(\n            client_blocked,\n            client_requested_endpoint,\n            client_requested_endpoint_valid,\n            server_challenge,\n            client_response,\n            server_expected_response,\n            should_fail,\n        )?;\n    }\n    println!(\"Bad Challenge Response ---\");\n    {\n        let client_blocked: bool = false;\n        let client_requested_endpoint: \u0026str = \"endpoint\";\n        let client_requested_endpoint_valid: bool = true;\n        let server_challenge: bson::document::Document = doc!(\"msg\": \"Speak friend and enter\");\n        let client_response: bson::document::Document = doc!(\"msg\": \"Friend?\");\n        let server_expected_response: bson::document::Document = doc!(\"msg\": \"Mellon\");\n        let should_fail: bool = true;\n        identity_test(\n            client_blocked,\n            client_requested_endpoint,\n            client_requested_endpoint_valid,\n            server_challenge,\n            client_response,\n            server_expected_response,\n            should_fail,\n        )?;\n    }\n    println!(\"Blocked Client ---\");\n    {\n        let client_blocked: bool = true;\n        let client_requested_endpoint: \u0026str = \"endpoint\";\n        let client_requested_endpoint_valid: bool = true;\n        let server_challenge: bson::document::Document = doc!(\"msg\": \"Speak friend and enter\");\n        let client_response: bson::document::Document = doc!(\"msg\": \"Mellon\");\n        let server_expected_response: bson::document::Document = doc!(\"msg\": \"Mellon\");\n        let should_fail: bool = true;\n        identity_test(\n            client_blocked,\n            client_requested_endpoint,\n            client_requested_endpoint_valid,\n            server_challenge,\n            client_response,\n            server_expected_response,\n            should_fail,\n        )?;\n    }\n    println!(\"Non-ASCII endpoint ---\");\n    {\n        let client_blocked: bool = false;\n        let client_requested_endpoint: \u0026str = \"𝕦𝕥𝕗𝟠\";\n        let client_requested_endpoint_valid: bool = true;\n        let server_challenge: bson::document::Document = doc!(\"msg\": \"Speak friend and enter\");\n        let client_response: bson::document::Document = doc!(\"msg\": \"Mellon\");\n        let server_expected_response: bson::document::Document = doc!(\"msg\": \"Mellon\");\n        let should_fail: bool = true;\n        identity_test(\n            client_blocked,\n            client_requested_endpoint,\n            client_requested_endpoint_valid,\n            server_challenge,\n            client_response,\n            server_expected_response,\n            should_fail,\n        )?;\n    }\n    Ok(())\n}\n\n#[cfg(test)]\nfn endpoint_test(\n    should_fail: bool,\n    client_allowed: bool,\n    channel: \u0026str,\n    channel_allowed: bool,\n) -\u003e anyhow::Result\u003c()\u003e {\n    // test sockets\n    let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n    let listener = TcpListener::bind(socket_addr)?;\n    let socket_addr = listener.local_addr()?;\n\n    let stream1 = TcpStream::connect(socket_addr)?;\n    stream1.set_nonblocking(true)?;\n    let (stream2, _socket_addr) = listener.accept()?;\n    stream2.set_nonblocking(true)?;\n\n    // server+client setup\n    let server_ed25519_private = Ed25519PrivateKey::generate();\n    let server_ed25519_public = Ed25519PublicKey::from_private_key(\u0026server_ed25519_private);\n    let server_service_id = V3OnionServiceId::from_public_key(\u0026server_ed25519_public);\n\n    let client_ed25519_private = Ed25519PrivateKey::generate();\n    let client_ed25519_public = Ed25519PublicKey::from_private_key(\u0026client_ed25519_private);\n    let client_service_id = V3OnionServiceId::from_public_key(\u0026client_ed25519_public);\n\n    // ensure our client is in the allow list\n    let allowed_client = if client_allowed {\n        client_service_id.clone()\n    } else {\n        let ed25519_private = Ed25519PrivateKey::generate();\n        let ed25519_public = Ed25519PublicKey::from_private_key(\u0026ed25519_private);\n        V3OnionServiceId::from_public_key(\u0026ed25519_public)\n    };\n\n    let server_rpc = Session::new(stream1);\n\n    let mut endpoint_server = EndpointServer::new(\n        server_rpc,\n        allowed_client.clone(),\n        server_service_id.clone(),\n    );\n\n    let client_rpc = Session::new(stream2);\n\n    let channel = match AsciiString::new(channel.to_string()) {\n        Ok(channel) =\u003e channel,\n        Err(_) =\u003e {\n            assert!(should_fail);\n            return Ok(());\n        }\n    };\n\n    let mut endpoint_client = EndpointClient::new(\n        client_rpc,\n        server_service_id.clone(),\n        channel.clone(),\n        client_ed25519_private,\n    );\n\n    let mut failure_ocurred = false;\n    let mut server_complete = false;\n    let mut client_complete = false;\n    while !server_complete \u0026\u0026 !client_complete {\n        if !server_complete {\n            match endpoint_server.update() {\n                Ok(Some(EndpointServerEvent::ChannelRequestReceived {\n                    client_service_id: ret_client_service_id,\n                    requested_channel,\n                })) =\u003e {\n                    assert_eq!(ret_client_service_id, client_service_id);\n                    assert!(requested_channel == channel);\n                    endpoint_server.handle_channel_request_received(channel_allowed)?;\n                }\n                Ok(Some(EndpointServerEvent::HandshakeCompleted {\n                    client_service_id: ret_client_service_id,\n                    channel_name: ret_channel,\n                    stream: _,\n                })) =\u003e {\n                    assert!(ret_client_service_id == client_service_id);\n                    assert!(ret_channel == channel);\n                    server_complete = true;\n                }\n                Ok(Some(EndpointServerEvent::HandshakeRejected {\n                    client_allowed,\n                    client_requested_channel_valid,\n                    client_proof_signature_valid,\n                })) =\u003e {\n                    println!(\"handshake rejected: client_allowed: {}, client_requested_channel_valid: {}, client_proof_signature_valid: {}\", client_allowed, client_requested_channel_valid, client_proof_signature_valid);\n                    server_complete = true;\n                    failure_ocurred = true;\n                }\n                Ok(None) =\u003e {}\n                Err(err) =\u003e {\n                    println!(\"server failure: {:?}\", err);\n                    server_complete = true;\n                    failure_ocurred = true;\n                }\n            }\n        }\n\n        if !client_complete {\n            match endpoint_client.update() {\n                Ok(Some(EndpointClientEvent::HandshakeCompleted { stream: _ })) =\u003e {\n                    client_complete = true;\n                }\n                Ok(None) =\u003e {}\n                Err(err) =\u003e {\n                    println!(\"client failure: {:?}\", err);\n                    client_complete = true;\n                    failure_ocurred = true;\n                }\n            }\n        }\n    }\n\n    println!(\"server_complete: {}\", server_complete);\n    println!(\"client_complete: {}\", client_complete);\n\n    assert!(should_fail == failure_ocurred);\n\n    Ok(())\n}\n\n#[test]\nfn test_endpoint_handshake() -\u003e anyhow::Result\u003c()\u003e {\n    println!(\"Success ---\");\n    {\n        let should_fail = false;\n        let client_allowed = true;\n        let channel = \"channel\";\n        let channel_allowed = true;\n        endpoint_test(should_fail, client_allowed, channel, channel_allowed)?;\n    }\n    println!(\"Client Not Allowed ---\");\n    {\n        let should_fail = true;\n        let client_allowed = false;\n        let channel = \"channel\";\n        let channel_allowed = true;\n        endpoint_test(should_fail, client_allowed, channel, channel_allowed)?;\n    }\n    println!(\"Channel Not Allowed ---\");\n    {\n        let should_fail = true;\n        let client_allowed = true;\n        let channel = \"channel\";\n        let channel_allowed = false;\n        endpoint_test(should_fail, client_allowed, channel, channel_allowed)?;\n    }\n    println!(\"Client and Channel Not Allowed ---\");\n    {\n        let should_fail = true;\n        let client_allowed = false;\n        let channel = \"channel\";\n        let channel_allowed = false;\n        endpoint_test(should_fail, client_allowed, channel, channel_allowed)?;\n    }\n    println!(\"Non-Ascii Channel ---\");\n    {\n        let should_fail = true;\n        let client_allowed = true;\n        let channel = \"𝕦𝕥𝕗𝟠\";\n        let channel_allowed = true;\n        endpoint_test(should_fail, client_allowed, channel, channel_allowed)?;\n    }\n\n    Ok(())\n}\n","traces":[{"line":54,"address":[4434048],"length":1,"stats":{"Line":2}},{"line":55,"address":[2008052,2007993],"length":1,"stats":{"Line":4}},{"line":56,"address":[2058456],"length":1,"stats":{"Line":2}},{"line":57,"address":[2058479],"length":1,"stats":{"Line":2}},{"line":62,"address":[2059766,2058512],"length":1,"stats":{"Line":2}},{"line":70,"address":[4394494],"length":1,"stats":{"Line":2}},{"line":72,"address":[2058742,2058646],"length":1,"stats":{"Line":4}},{"line":73,"address":[2058761],"length":1,"stats":{"Line":2}},{"line":74,"address":[4394663],"length":1,"stats":{"Line":2}},{"line":75,"address":[4394730],"length":1,"stats":{"Line":2}},{"line":76,"address":[4434500],"length":1,"stats":{"Line":2}},{"line":77,"address":[4394892],"length":1,"stats":{"Line":2}},{"line":78,"address":[4394918],"length":1,"stats":{"Line":2}},{"line":79,"address":[4395054],"length":1,"stats":{"Line":2}},{"line":80,"address":[4395080],"length":1,"stats":{"Line":2}},{"line":81,"address":[4435063],"length":1,"stats":{"Line":2}},{"line":82,"address":[2009028],"length":1,"stats":{"Line":2}},{"line":84,"address":[2059723],"length":1,"stats":{"Line":2}},{"line":92,"address":[2059792,2070226,2064486],"length":1,"stats":{"Line":1}},{"line":102,"address":[2059953],"length":1,"stats":{"Line":1}},{"line":103,"address":[2060213,2070178,2063136,2060356],"length":1,"stats":{"Line":1}},{"line":104,"address":[2060329,2060441,2070141,2060585],"length":1,"stats":{"Line":2}},{"line":106,"address":[2060626,2070104,2060526,2060727],"length":1,"stats":{"Line":2}},{"line":107,"address":[2060817,2070035,2060695,2060908],"length":1,"stats":{"Line":2}},{"line":108,"address":[2060881,2060965,2061118,2070017],"length":1,"stats":{"Line":2}},{"line":109,"address":[2061279,2069939,2061202,2061089],"length":1,"stats":{"Line":2}},{"line":112,"address":[2061260],"length":1,"stats":{"Line":1}},{"line":115,"address":[2061317],"length":1,"stats":{"Line":1}},{"line":116,"address":[2061385],"length":1,"stats":{"Line":1}},{"line":117,"address":[2061453],"length":1,"stats":{"Line":1}},{"line":119,"address":[2061504],"length":1,"stats":{"Line":1}},{"line":120,"address":[2061545],"length":1,"stats":{"Line":1}},{"line":122,"address":[2061661,2069724],"length":1,"stats":{"Line":1}},{"line":123,"address":[2069757],"length":1,"stats":{"Line":1}},{"line":128,"address":[2061674],"length":1,"stats":{"Line":1}},{"line":130,"address":[2061779],"length":1,"stats":{"Line":1}},{"line":131,"address":[2061833],"length":1,"stats":{"Line":1}},{"line":132,"address":[2061897],"length":1,"stats":{"Line":1}},{"line":133,"address":[2061912],"length":1,"stats":{"Line":1}},{"line":134,"address":[2061958],"length":1,"stats":{"Line":1}},{"line":138,"address":[2062409],"length":1,"stats":{"Line":1}},{"line":139,"address":[2069644,2062479],"length":1,"stats":{"Line":1}},{"line":141,"address":[2062625],"length":1,"stats":{"Line":1}},{"line":142,"address":[2062633],"length":1,"stats":{"Line":1}},{"line":143,"address":[2062641],"length":1,"stats":{"Line":1}},{"line":144,"address":[2062649],"length":1,"stats":{"Line":1}},{"line":145,"address":[2062701,2066534],"length":1,"stats":{"Line":2}},{"line":146,"address":[2062789,2063073,2062727],"length":1,"stats":{"Line":3}},{"line":147,"address":[2063138],"length":1,"stats":{"Line":1}},{"line":151,"address":[2063234],"length":1,"stats":{"Line":1}},{"line":156,"address":[2064049],"length":1,"stats":{"Line":1}},{"line":157,"address":[2064419,2064321,2064090],"length":1,"stats":{"Line":1}},{"line":160,"address":[2064072],"length":1,"stats":{"Line":1}},{"line":163,"address":[2063264],"length":1,"stats":{"Line":1}},{"line":164,"address":[2063360,2064539],"length":1,"stats":{"Line":2}},{"line":165,"address":[2064810,2064589],"length":1,"stats":{"Line":1}},{"line":166,"address":[2064574],"length":1,"stats":{"Line":1}},{"line":169,"address":[2063389],"length":1,"stats":{"Line":1}},{"line":175,"address":[2065093,2063501],"length":1,"stats":{"Line":2}},{"line":176,"address":[2065129],"length":1,"stats":{"Line":1}},{"line":180,"address":[2065402],"length":1,"stats":{"Line":1}},{"line":182,"address":[2063579],"length":1,"stats":{"Line":1}},{"line":189,"address":[2063595,2065428],"length":1,"stats":{"Line":2}},{"line":190,"address":[2065557],"length":1,"stats":{"Line":1}},{"line":191,"address":[2065736],"length":1,"stats":{"Line":1}},{"line":195,"address":[2065915],"length":1,"stats":{"Line":1}},{"line":199,"address":[2066094],"length":1,"stats":{"Line":1}},{"line":203,"address":[2066273],"length":1,"stats":{"Line":1}},{"line":204,"address":[2066342],"length":1,"stats":{"Line":1}},{"line":205,"address":[2066350],"length":1,"stats":{"Line":1}},{"line":208,"address":[2062884],"length":1,"stats":{"Line":0}},{"line":209,"address":[2066403],"length":1,"stats":{"Line":0}},{"line":210,"address":[2066472],"length":1,"stats":{"Line":0}},{"line":211,"address":[2066480],"length":1,"stats":{"Line":0}},{"line":216,"address":[2069055,2062734],"length":1,"stats":{"Line":2}},{"line":217,"address":[2066861,2067152],"length":1,"stats":{"Line":2}},{"line":218,"address":[2067191],"length":1,"stats":{"Line":1}},{"line":219,"address":[2067570],"length":1,"stats":{"Line":1}},{"line":223,"address":[2067983,2067655,2067773,2059906],"length":1,"stats":{"Line":2}},{"line":225,"address":[2067464],"length":1,"stats":{"Line":0}},{"line":231,"address":[2067512,2068279],"length":1,"stats":{"Line":0}},{"line":232,"address":[2068334],"length":1,"stats":{"Line":0}},{"line":233,"address":[2068583],"length":1,"stats":{"Line":0}},{"line":237,"address":[2068854],"length":1,"stats":{"Line":0}},{"line":240,"address":[2066963],"length":1,"stats":{"Line":0}},{"line":241,"address":[2068924],"length":1,"stats":{"Line":0}},{"line":242,"address":[2068993],"length":1,"stats":{"Line":0}},{"line":243,"address":[2069001],"length":1,"stats":{"Line":0}},{"line":249,"address":[2062676,2069331],"length":1,"stats":{"Line":1}},{"line":250,"address":[2069364],"length":1,"stats":{"Line":1}},{"line":354,"address":[2072076,2077164,2070240],"length":1,"stats":{"Line":1}},{"line":361,"address":[2070353],"length":1,"stats":{"Line":1}},{"line":362,"address":[2073467,2070711,2070543],"length":1,"stats":{"Line":1}},{"line":363,"address":[2070684,2070796,2077154,2070940],"length":1,"stats":{"Line":2}},{"line":365,"address":[2070978,2071076,2070881,2077120],"length":1,"stats":{"Line":2}},{"line":366,"address":[2071047,2071245,2071160,2077054],"length":1,"stats":{"Line":2}},{"line":367,"address":[2077039,2071452,2071218,2071299],"length":1,"stats":{"Line":2}},{"line":368,"address":[2071423,2076961,2071536,2071613],"length":1,"stats":{"Line":2}},{"line":371,"address":[2071594],"length":1,"stats":{"Line":1}},{"line":372,"address":[2071651],"length":1,"stats":{"Line":1}},{"line":373,"address":[2071722],"length":1,"stats":{"Line":1}},{"line":375,"address":[2071749],"length":1,"stats":{"Line":1}},{"line":376,"address":[2071768],"length":1,"stats":{"Line":1}},{"line":377,"address":[2071844],"length":1,"stats":{"Line":1}},{"line":380,"address":[2071878],"length":1,"stats":{"Line":1}},{"line":381,"address":[2071919,2072085],"length":1,"stats":{"Line":2}},{"line":383,"address":[2071884],"length":1,"stats":{"Line":1}},{"line":384,"address":[2071929],"length":1,"stats":{"Line":1}},{"line":385,"address":[2072000],"length":1,"stats":{"Line":1}},{"line":388,"address":[2072046],"length":1,"stats":{"Line":1}},{"line":391,"address":[2072087],"length":1,"stats":{"Line":1}},{"line":392,"address":[2072141],"length":1,"stats":{"Line":1}},{"line":393,"address":[2072205],"length":1,"stats":{"Line":1}},{"line":396,"address":[2072353,2072267],"length":1,"stats":{"Line":2}},{"line":398,"address":[2072369,2072430],"length":1,"stats":{"Line":2}},{"line":399,"address":[2072448],"length":1,"stats":{"Line":1}},{"line":401,"address":[2076655,2072564],"length":1,"stats":{"Line":1}},{"line":402,"address":[2076688],"length":1,"stats":{"Line":1}},{"line":407,"address":[2072577],"length":1,"stats":{"Line":1}},{"line":408,"address":[2072639],"length":1,"stats":{"Line":1}},{"line":409,"address":[2072755],"length":1,"stats":{"Line":1}},{"line":410,"address":[2072762],"length":1,"stats":{"Line":1}},{"line":413,"address":[2072865],"length":1,"stats":{"Line":1}},{"line":414,"address":[2072873],"length":1,"stats":{"Line":1}},{"line":415,"address":[2072881],"length":1,"stats":{"Line":1}},{"line":416,"address":[2072889],"length":1,"stats":{"Line":1}},{"line":417,"address":[2073024,2075362],"length":1,"stats":{"Line":2}},{"line":418,"address":[2073050,2073116,2073396],"length":1,"stats":{"Line":3}},{"line":419,"address":[2073533],"length":1,"stats":{"Line":1}},{"line":423,"address":[2073573,2073944],"length":1,"stats":{"Line":2}},{"line":424,"address":[2074032],"length":1,"stats":{"Line":1}},{"line":425,"address":[2074092,2074197,2070304,2074407],"length":1,"stats":{"Line":2}},{"line":427,"address":[2073611],"length":1,"stats":{"Line":1}},{"line":432,"address":[2073723,2074714],"length":1,"stats":{"Line":2}},{"line":433,"address":[2074769],"length":1,"stats":{"Line":1}},{"line":434,"address":[2074823],"length":1,"stats":{"Line":1}},{"line":436,"address":[2073753],"length":1,"stats":{"Line":1}},{"line":441,"address":[2075069],"length":1,"stats":{"Line":1}},{"line":442,"address":[2075170],"length":1,"stats":{"Line":1}},{"line":443,"address":[2075178],"length":1,"stats":{"Line":1}},{"line":446,"address":[2073211],"length":1,"stats":{"Line":0}},{"line":447,"address":[2075231],"length":1,"stats":{"Line":0}},{"line":448,"address":[2075300],"length":1,"stats":{"Line":0}},{"line":449,"address":[2075308],"length":1,"stats":{"Line":0}},{"line":454,"address":[2073057],"length":1,"stats":{"Line":1}},{"line":455,"address":[2075686],"length":1,"stats":{"Line":1}},{"line":456,"address":[2075952],"length":1,"stats":{"Line":1}},{"line":457,"address":[2075944],"length":1,"stats":{"Line":1}},{"line":460,"address":[2075762],"length":1,"stats":{"Line":1}},{"line":461,"address":[2075991],"length":1,"stats":{"Line":1}},{"line":462,"address":[2076060],"length":1,"stats":{"Line":1}},{"line":463,"address":[2076068],"length":1,"stats":{"Line":1}},{"line":469,"address":[2076193],"length":1,"stats":{"Line":1}},{"line":470,"address":[2076372],"length":1,"stats":{"Line":1}},{"line":472,"address":[2076448],"length":1,"stats":{"Line":1}},{"line":474,"address":[2076499],"length":1,"stats":{"Line":1}}],"covered":139,"coverable":156},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","src","identity_client.rs"],"content":"// standard\nuse std::clone::Clone;\nuse std::convert::TryInto;\nuse std::net::TcpStream;\n\n// extern crates\nuse bson::doc;\nuse bson::spec::BinarySubtype;\nuse bson::{Binary, Bson};\nuse honk_rpc::honk_rpc::{\n    get_message_overhead, get_request_section_size, RequestCookie, Response, Session,\n};\nuse rand::rngs::OsRng;\nuse rand::RngCore;\nuse tor_interface::tor_crypto::*;\n\n// internal crates\nuse crate::ascii_string::*;\nuse crate::gosling::*;\n\n//\n// Identity Client\n//\n\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"failed to convert x25519 private key to ed25519 private key\")]\n    ClientCreationFailed(#[source] tor_interface::tor_crypto::Error),\n\n    #[error(\"HonkRPC method failed: {0}\")]\n    HonkRPCFailure(#[from] honk_rpc::honk_rpc::Error),\n\n    #[error(\"client received unexpected response: {0}\")]\n    UnexpectedResponseReceived(String),\n\n    #[error(\"client is in invalid state: {0}\")]\n    InvalidState(String),\n\n    #[error(\"incorrect usage: {0}\")]\n    IncorrectUsage(String),\n\n    #[error(\"provided endpoint challenge response too large; encoded size would be {0} but session's maximum honk-rpc message size is {1}\")]\n    EndpointChallengeResponseTooLarge(usize, usize),\n}\n\npub(crate) enum IdentityClientEvent {\n    ChallengeReceived {\n        endpoint_challenge: bson::document::Document,\n    },\n    HandshakeCompleted {\n        identity_service_id: V3OnionServiceId,\n        endpoint_service_id: V3OnionServiceId,\n        endpoint_name: String,\n        client_auth_private_key: X25519PrivateKey,\n    },\n}\n\n#[derive(Debug, PartialEq)]\npub(crate) enum IdentityClientState {\n    BeginHandshake,\n    WaitingForChallenge,\n    WaitingForChallengeResponse,\n    WaitingForChallengeVerification,\n    HandshakeComplete,\n}\n\n//\n// An identity client object used for connecting\n// to an identity server\n//\npub(crate) struct IdentityClient {\n    // session data\n    rpc: Session\u003cTcpStream\u003e,\n    server_service_id: V3OnionServiceId,\n    requested_endpoint: AsciiString,\n    client_service_id: V3OnionServiceId,\n    client_identity_ed25519_private: Ed25519PrivateKey,\n    client_authorization_key_private: X25519PrivateKey,\n    client_authorization_signing_key_private: (Ed25519PrivateKey, SignBit),\n\n    // state machine data\n    state: IdentityClientState,\n    begin_handshake_request_cookie: Option\u003cRequestCookie\u003e,\n    server_cookie: Option\u003cServerCookie\u003e,\n    endpoint_challenge_response: Option\u003cbson::document::Document\u003e,\n    send_response_request_cookie: Option\u003cRequestCookie\u003e,\n}\n\nimpl IdentityClient {\n    fn get_state(\u0026self) -\u003e String {\n        format!(\"{{ state: {:?},  begin_handshake_request_cookie: {:?},  server_cookie: {:?}, endpoint_challenge_response: {:?},  send_response_request_cookie: {:?} }}\", self.state,  self.begin_handshake_request_cookie, self.server_cookie, self.endpoint_challenge_response, self.send_response_request_cookie)\n    }\n\n    pub fn new(\n        rpc: Session\u003cTcpStream\u003e,\n        server_service_id: V3OnionServiceId,\n        requested_endpoint: AsciiString,\n        client_identity_ed25519_private: Ed25519PrivateKey,\n        client_authorization_key_private: X25519PrivateKey,\n    ) -\u003e Result\u003cSelf, Error\u003e {\n        Ok(Self {\n            rpc,\n            server_service_id,\n            requested_endpoint,\n            client_service_id: V3OnionServiceId::from_private_key(\u0026client_identity_ed25519_private),\n            client_identity_ed25519_private,\n            client_authorization_signing_key_private: Ed25519PrivateKey::from_private_x25519(\n                \u0026client_authorization_key_private,\n            )\n            .map_err(Error::ClientCreationFailed)?,\n            client_authorization_key_private,\n\n            state: IdentityClientState::BeginHandshake,\n            begin_handshake_request_cookie: None,\n            server_cookie: None,\n            send_response_request_cookie: None,\n            endpoint_challenge_response: None,\n        })\n    }\n\n    pub fn update(\u0026mut self) -\u003e Result\u003cOption\u003cIdentityClientEvent\u003e, Error\u003e {\n        if self.state == IdentityClientState::HandshakeComplete {\n            return Err(Error::IncorrectUsage(\"update() may not be called after HandshakeComplete has been returned from previous update() call\".to_string()));\n        }\n\n        // update our rpc session\n        self.rpc.update(None)?;\n\n        // client state machine\n        match (\n            \u0026self.state,\n            self.begin_handshake_request_cookie,\n            self.server_cookie,\n            self.endpoint_challenge_response.take(),\n            self.send_response_request_cookie,\n        ) {\n            // send initial handshake request\n            (\n                \u0026IdentityClientState::BeginHandshake,\n                None, // begin_handshake_request_cookie\n                None, // server_cookie\n                None, // endpoint_challenge_response\n                None, // send_response_request_cookie\n            ) =\u003e {\n                self.begin_handshake_request_cookie = Some(self.rpc.client_call(\n                    \"gosling_identity\",\n                    \"begin_handshake\",\n                    0,\n                    doc! {\n                        \"version\" : bson::Bson::String(GOSLING_PROTOCOL_VERSION.to_string()),\n                        \"client_identity\" : bson::Bson::String(self.client_service_id.to_string()),\n                        \"endpoint\" : bson::Bson::String(self.requested_endpoint.clone().to_string()),\n                    },\n                )?);\n                self.state = IdentityClientState::WaitingForChallenge;\n            }\n            (\n                \u0026IdentityClientState::WaitingForChallenge,\n                Some(begin_handshake_request_cookie),\n                None, // server_cookie\n                None, // endpoint_challenge_response\n                None, // send_response_request_cookie\n            ) =\u003e {\n                if let Some(response) = self.rpc.client_next_response() {\n                    // check for response for the begin_handshake() call\n                    let mut response = match response {\n                        Response::Pending { cookie } =\u003e {\n                            if cookie != begin_handshake_request_cookie {\n                                return Err(Error::UnexpectedResponseReceived(\n                                    \"received unexpected pending response\".to_string(),\n                                ));\n                            }\n                            return Ok(None);\n                        }\n                        Response::Error { cookie, error_code } =\u003e {\n                            if cookie != begin_handshake_request_cookie {\n                                return Err(Error::UnexpectedResponseReceived(format!(\n                                    \"received unexpected error response; rpc error_code: {}\",\n                                    error_code\n                                )));\n                            }\n                            return Err(Error::UnexpectedResponseReceived(format!(\n                                \"received unexpected rpc error_code: {}\",\n                                error_code\n                            )));\n                        }\n                        Response::Success { cookie, result } =\u003e {\n                            if cookie != begin_handshake_request_cookie {\n                                return Err(Error::UnexpectedResponseReceived(\n                                    \"received unexpected success response\".to_string(),\n                                ));\n                            }\n                            match result {\n                                Some(Bson::Document(result)) =\u003e result,\n                                _ =\u003e {\n                                    return Err(Error::UnexpectedResponseReceived(\n                                        \"begin_handshake() response is unexpected bson type\"\n                                            .to_string(),\n                                    ))\n                                }\n                            }\n                        }\n                    };\n\n                    // save off the server cookie\n                    self.server_cookie = match response.get(\"server_cookie\") {\n                        Some(Bson::Binary(Binary {\n                            subtype: BinarySubtype::Generic,\n                            bytes: server_cookie,\n                        })) =\u003e match server_cookie.clone().try_into() {\n                            Ok(server_cookie) =\u003e Some(server_cookie),\n                            Err(_) =\u003e {\n                                return Err(Error::UnexpectedResponseReceived(format!(\n                                    \"unable to convert '{:?}' to server cookie\",\n                                    server_cookie\n                                )))\n                            }\n                        },\n                        Some(_) =\u003e {\n                            return Err(Error::UnexpectedResponseReceived(\n                                \"server_cookie is unxpected bson type\".to_string(),\n                            ))\n                        }\n                        None =\u003e {\n                            return Err(Error::UnexpectedResponseReceived(\n                                \"missing server_cookie\".to_string(),\n                            ))\n                        }\n                    };\n\n                    // get the endpoint challenge\n                    let endpoint_challenge = match response.get_mut(\"endpoint_challenge\") {\n                        Some(Bson::Document(endpoint_challenge)) =\u003e {\n                            std::mem::take(endpoint_challenge)\n                        }\n                        Some(_) =\u003e {\n                            return Err(Error::UnexpectedResponseReceived(\n                                \"endpoint challenge is unexpected bson type\".to_string(),\n                            ))\n                        }\n                        None =\u003e {\n                            return Err(Error::UnexpectedResponseReceived(\n                                \"missing endpoint_challenge\".to_string(),\n                            ))\n                        }\n                    };\n\n                    self.state = IdentityClientState::WaitingForChallengeResponse;\n                    return Ok(Some(IdentityClientEvent::ChallengeReceived {\n                        endpoint_challenge,\n                    }));\n                }\n            }\n            (\n                \u0026IdentityClientState::WaitingForChallengeResponse,\n                Some(_begin_handshake_request_cookie),\n                Some(_server_cookie),\n                None, // endpoint_challenge_response\n                None, // send_response_request_cookie\n            ) =\u003e {\n                // no-op, waiting for response for challenge response from caller\n            }\n            (\n                \u0026IdentityClientState::WaitingForChallengeResponse,\n                Some(_begin_handshake_request_cookie),\n                Some(server_cookie),\n                Some(endpoint_challenge_response),\n                None,\n            ) =\u003e {\n                // client_cookie\n                let mut client_cookie: ClientCookie = Default::default();\n                OsRng.fill_bytes(\u0026mut client_cookie);\n                let client_cookie = client_cookie;\n\n                // client_identity_proof_signature\n                let client_identity_proof = build_client_proof(\n                    DomainSeparator::GoslingIdentity,\n                    \u0026self.requested_endpoint,\n                    \u0026self.client_service_id,\n                    \u0026self.server_service_id,\n                    \u0026client_cookie,\n                    \u0026server_cookie,\n                );\n                let client_identity_proof_signature = self\n                    .client_identity_ed25519_private\n                    .sign_message(\u0026client_identity_proof);\n\n                // client_authorization_key\n                let client_authorization_key =\n                    X25519PublicKey::from_private_key(\u0026self.client_authorization_key_private);\n\n                // client_authorization_signature\n                let client_identity = self.client_service_id.to_string();\n                let (client_authorization_signature, signbit) = (\n                    self.client_authorization_signing_key_private\n                        .0\n                        .sign_message(client_identity.as_bytes()),\n                    self.client_authorization_signing_key_private.1,\n                );\n\n                // build our args object for rpc call\n                let args = doc! {\n                    \"client_cookie\" : bson::Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_cookie.to_vec()}),\n                    \"client_identity_proof_signature\" : bson::Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_identity_proof_signature.to_bytes().to_vec()}),\n                    \"client_authorization_key\" : bson::Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_authorization_key.as_bytes().to_vec()}),\n                    \"client_authorization_key_signbit\" : bson::Bson::Boolean(signbit.into()),\n                    \"client_authorization_signature\" : bson::Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_authorization_signature.to_bytes().to_vec()}),\n                    \"challenge_response\" : endpoint_challenge_response,\n                };\n\n                // make rpc call\n                self.send_response_request_cookie =\n                    Some(\n                        self.rpc\n                            .client_call(\"gosling_identity\", \"send_response\", 0, args)?,\n                    );\n                self.state = IdentityClientState::WaitingForChallengeVerification;\n            }\n            (\n                \u0026IdentityClientState::WaitingForChallengeVerification,\n                Some(_begin_handshake_request_cookie),\n                Some(_server_cookie),\n                None, // endpoint_challenge_response\n                Some(send_response_request_cookie),\n            ) =\u003e {\n                if let Some(response) = self.rpc.client_next_response() {\n                    let endpoint_service_id = match response {\n                        Response::Pending { cookie } =\u003e {\n                            if cookie == send_response_request_cookie {\n                                return Ok(None);\n                            } else {\n                                return Err(Error::UnexpectedResponseReceived(\n                                    \"received unexpectd pending response\".to_string(),\n                                ));\n                            }\n                        }\n                        Response::Error { cookie, error_code } =\u003e {\n                            if cookie == send_response_request_cookie {\n                                return Err(Error::UnexpectedResponseReceived(format!(\n                                    \"received unexpected error response; rpc error_code: {}\",\n                                    error_code\n                                )));\n                            } else {\n                                return Err(Error::UnexpectedResponseReceived(format!(\n                                    \"received unexpected rpc error_code: {}\",\n                                    error_code\n                                )));\n                            }\n                        }\n                        Response::Success { cookie, result } =\u003e {\n                            if cookie == send_response_request_cookie {\n                                match result {\n                                    Some(Bson::String(endpoint_service_id)) =\u003e {\n                                        match V3OnionServiceId::from_string(\u0026endpoint_service_id) {\n                                            Ok(endpoint_service_id) =\u003e endpoint_service_id,\n                                            Err(_) =\u003e return Err(Error::UnexpectedResponseReceived(format!(\"unable to parse received endpoint service id '{}' as v3 onion service id\", endpoint_service_id))),\n                                        }\n                                    }\n                                    _ =\u003e {\n                                        return Err(Error::UnexpectedResponseReceived(\n                                            \"endpoint service id is unexpected bson type\".to_string(),\n                                        ))\n                                    }\n                                }\n                            } else {\n                                return Err(Error::UnexpectedResponseReceived(\n                                    \"received unexpected success response\".to_string(),\n                                ));\n                            }\n                        }\n                    };\n                    self.state = IdentityClientState::HandshakeComplete;\n                    return Ok(Some(IdentityClientEvent::HandshakeCompleted {\n                        identity_service_id: self.server_service_id.clone(),\n                        endpoint_service_id,\n                        endpoint_name: self.requested_endpoint.clone().to_string(),\n                        client_auth_private_key: self.client_authorization_key_private.clone(),\n                    }));\n                }\n            }\n            _ =\u003e {\n                return Err(Error::InvalidState(self.get_state()));\n            }\n        }\n        Ok(None)\n    }\n\n    pub fn send_response(\n        \u0026mut self,\n        challenge_response: bson::document::Document,\n    ) -\u003e Result\u003c(), Error\u003e {\n        match (\n            \u0026self.state,\n            self.begin_handshake_request_cookie,\n            self.server_cookie,\n            self.endpoint_challenge_response.as_ref(),\n            self.send_response_request_cookie,\n        ) {\n            (\u0026IdentityClientState::WaitingForChallengeResponse,\n             Some(_begin_handshake_request_cookie),\n             Some(_server_cookie),\n             None, // endpoint_challenge_response\n             None  // end_response_request_cookie\n            ) =\u003e {\n                // calculate required size of request message and ensure it fits our\n                // specified message size budget\n                let arguments = doc!{\n                    \"client_cookie\" : Bson::Binary(Binary{subtype: BinarySubtype::Generic, bytes: [0u8; CLIENT_COOKIE_SIZE].to_vec()}),\n                    \"client_identity_proof_signature\" : Bson::Binary(Binary{subtype: BinarySubtype::Generic, bytes: [0u8; ED25519_SIGNATURE_SIZE].to_vec()}),\n                    \"client_authorization_key\" : Bson::Binary(Binary{subtype: BinarySubtype::Generic, bytes: [0u8; X25519_PUBLIC_KEY_SIZE].to_vec()}),\n                    \"client_authorization_key_signbit\" : Bson::Boolean(false),\n                    \"client_authorization_signature\" : Bson::Binary(Binary{subtype: BinarySubtype::Generic, bytes: [0u8; ED25519_SIGNATURE_SIZE].to_vec()}),\n                    \"challenge_response\" : challenge_response.clone(),\n                };\n                let request_section_size = get_request_section_size(Some(0i64), Some(\"gosling_identity\".to_string()), \"send_response\".to_string(), Some(0i32), Some(arguments))?;\n                let message_size = get_message_overhead()? + request_section_size;\n                let max_message_size = self.rpc.get_max_message_size();\n                if message_size \u003e max_message_size {\n                    Err(Error::EndpointChallengeResponseTooLarge(message_size, max_message_size))\n                } else {\n                    self.endpoint_challenge_response = Some(challenge_response);\n                    Ok(())\n                }\n            }\n            _ =\u003e Err(Error::IncorrectUsage(\"send_response() may only be called after ChallengeReceived event has been returned from update(), and it may only be called once\".to_string()))\n        }\n    }\n}\n","traces":[{"line":90,"address":[3993824],"length":1,"stats":{"Line":0}},{"line":91,"address":[3954484,3954104,3954294,3954199,3954577,3954389],"length":1,"stats":{"Line":0}},{"line":94,"address":[1951508,1950160,1951551],"length":1,"stats":{"Line":2}},{"line":101,"address":[1950196,1950671],"length":1,"stats":{"Line":4}},{"line":102,"address":[1950248],"length":1,"stats":{"Line":2}},{"line":104,"address":[1740116],"length":1,"stats":{"Line":2}},{"line":105,"address":[3954939],"length":1,"stats":{"Line":2}},{"line":106,"address":[3994751],"length":1,"stats":{"Line":2}},{"line":107,"address":[1741047,1740237,1740313],"length":1,"stats":{"Line":4}},{"line":110,"address":[1740935],"length":1,"stats":{"Line":0}},{"line":111,"address":[3955214],"length":1,"stats":{"Line":2}},{"line":113,"address":[3955269],"length":1,"stats":{"Line":2}},{"line":114,"address":[1740465],"length":1,"stats":{"Line":2}},{"line":115,"address":[1740477],"length":1,"stats":{"Line":2}},{"line":116,"address":[3955297],"length":1,"stats":{"Line":2}},{"line":117,"address":[1950653],"length":1,"stats":{"Line":2}},{"line":121,"address":[1741408,1754483,1743720],"length":1,"stats":{"Line":2}},{"line":122,"address":[1951664],"length":1,"stats":{"Line":2}},{"line":123,"address":[3956483],"length":1,"stats":{"Line":0}},{"line":127,"address":[1951719,1952375,1951656],"length":1,"stats":{"Line":4}},{"line":130,"address":[3996837,3996925,4005382,3998335,3996542,4002224],"length":1,"stats":{"Line":12}},{"line":131,"address":[1951982],"length":1,"stats":{"Line":2}},{"line":132,"address":[1951999],"length":1,"stats":{"Line":2}},{"line":133,"address":[1952029],"length":1,"stats":{"Line":2}},{"line":134,"address":[3956728],"length":1,"stats":{"Line":2}},{"line":135,"address":[3996528],"length":1,"stats":{"Line":2}},{"line":138,"address":[1743470],"length":1,"stats":{"Line":2}},{"line":145,"address":[1743256,1743595,1743674],"length":1,"stats":{"Line":2}},{"line":149,"address":[1742794,1742955,1743037,1742519,1742407,1742610],"length":1,"stats":{"Line":8}},{"line":150,"address":[3957330,3957398],"length":1,"stats":{"Line":4}},{"line":151,"address":[3997300],"length":1,"stats":{"Line":2}},{"line":152,"address":[1742902,1742987],"length":1,"stats":{"Line":4}},{"line":155,"address":[3958307],"length":1,"stats":{"Line":2}},{"line":157,"address":[1743813],"length":1,"stats":{"Line":2}},{"line":164,"address":[3998443],"length":1,"stats":{"Line":2}},{"line":166,"address":[1744019],"length":1,"stats":{"Line":2}},{"line":167,"address":[3958988],"length":1,"stats":{"Line":2}},{"line":168,"address":[1954348],"length":1,"stats":{"Line":2}},{"line":169,"address":[1954592],"length":1,"stats":{"Line":0}},{"line":170,"address":[3959213],"length":1,"stats":{"Line":0}},{"line":173,"address":[1744302],"length":1,"stats":{"Line":2}},{"line":175,"address":[3959106],"length":1,"stats":{"Line":0}},{"line":176,"address":[3998894],"length":1,"stats":{"Line":0}},{"line":177,"address":[4002110,4001981],"length":1,"stats":{"Line":0}},{"line":182,"address":[4001738,4001867],"length":1,"stats":{"Line":0}},{"line":187,"address":[1954362],"length":1,"stats":{"Line":2}},{"line":188,"address":[3998828],"length":1,"stats":{"Line":2}},{"line":189,"address":[1956997],"length":1,"stats":{"Line":0}},{"line":190,"address":[3999143],"length":1,"stats":{"Line":0}},{"line":193,"address":[3999106,3999173],"length":1,"stats":{"Line":4}},{"line":194,"address":[3959499],"length":1,"stats":{"Line":2}},{"line":196,"address":[4001258],"length":1,"stats":{"Line":0}},{"line":197,"address":[1954813],"length":1,"stats":{"Line":0}},{"line":206,"address":[3999374,3999484,4000093,3999739,3999548],"length":1,"stats":{"Line":10}},{"line":209,"address":[1955387],"length":1,"stats":{"Line":2}},{"line":210,"address":[3999807],"length":1,"stats":{"Line":2}},{"line":211,"address":[1745265],"length":1,"stats":{"Line":2}},{"line":213,"address":[1956386,1956515],"length":1,"stats":{"Line":0}},{"line":220,"address":[1746478],"length":1,"stats":{"Line":0}},{"line":221,"address":[3960013],"length":1,"stats":{"Line":0}},{"line":225,"address":[1955208],"length":1,"stats":{"Line":0}},{"line":226,"address":[1955121],"length":1,"stats":{"Line":0}},{"line":232,"address":[1955736,1955847],"length":1,"stats":{"Line":4}},{"line":233,"address":[1745803],"length":1,"stats":{"Line":2}},{"line":234,"address":[4000437],"length":1,"stats":{"Line":2}},{"line":237,"address":[1746014],"length":1,"stats":{"Line":0}},{"line":238,"address":[1956056],"length":1,"stats":{"Line":0}},{"line":242,"address":[1745689],"length":1,"stats":{"Line":0}},{"line":243,"address":[3960476],"length":1,"stats":{"Line":0}},{"line":248,"address":[3960750],"length":1,"stats":{"Line":2}},{"line":249,"address":[1956115],"length":1,"stats":{"Line":2}},{"line":254,"address":[1747699],"length":1,"stats":{"Line":0}},{"line":263,"address":[3962654],"length":1,"stats":{"Line":2}},{"line":271,"address":[1958158],"length":1,"stats":{"Line":2}},{"line":272,"address":[1958218],"length":1,"stats":{"Line":2}},{"line":273,"address":[3962914],"length":1,"stats":{"Line":2}},{"line":277,"address":[3962946],"length":1,"stats":{"Line":2}},{"line":278,"address":[4002698],"length":1,"stats":{"Line":2}},{"line":279,"address":[3962964],"length":1,"stats":{"Line":2}},{"line":280,"address":[1748104],"length":1,"stats":{"Line":2}},{"line":284,"address":[3963154,3963037],"length":1,"stats":{"Line":4}},{"line":286,"address":[1748181],"length":1,"stats":{"Line":2}},{"line":289,"address":[3963181],"length":1,"stats":{"Line":2}},{"line":293,"address":[1958559],"length":1,"stats":{"Line":2}},{"line":294,"address":[3963377],"length":1,"stats":{"Line":2}},{"line":295,"address":[3963249,3963344],"length":1,"stats":{"Line":4}},{"line":297,"address":[1748398],"length":1,"stats":{"Line":2}},{"line":298,"address":[1958715],"length":1,"stats":{"Line":2}},{"line":302,"address":[4003278,4003768,4004479,4004683,4003491,4004039,4003337,4004202],"length":1,"stats":{"Line":14}},{"line":303,"address":[1958981,1958897],"length":1,"stats":{"Line":4}},{"line":304,"address":[1959191],"length":1,"stats":{"Line":2}},{"line":305,"address":[3964124],"length":1,"stats":{"Line":2}},{"line":306,"address":[1749529],"length":1,"stats":{"Line":2}},{"line":307,"address":[4004302],"length":1,"stats":{"Line":2}},{"line":308,"address":[4004579],"length":1,"stats":{"Line":2}},{"line":312,"address":[3965314],"length":1,"stats":{"Line":2}},{"line":313,"address":[1960638],"length":1,"stats":{"Line":2}},{"line":314,"address":[3965507,3965143],"length":1,"stats":{"Line":2}},{"line":315,"address":[1960739],"length":1,"stats":{"Line":0}},{"line":317,"address":[3965344],"length":1,"stats":{"Line":2}},{"line":319,"address":[1750852],"length":1,"stats":{"Line":2}},{"line":326,"address":[3965791],"length":1,"stats":{"Line":2}},{"line":327,"address":[1961321],"length":1,"stats":{"Line":2}},{"line":328,"address":[3966071],"length":1,"stats":{"Line":2}},{"line":329,"address":[3966087],"length":1,"stats":{"Line":2}},{"line":330,"address":[4006022],"length":1,"stats":{"Line":2}},{"line":332,"address":[4006071],"length":1,"stats":{"Line":0}},{"line":333,"address":[1751349],"length":1,"stats":{"Line":0}},{"line":337,"address":[3966185],"length":1,"stats":{"Line":0}},{"line":338,"address":[4005973],"length":1,"stats":{"Line":0}},{"line":339,"address":[1754049,1754178],"length":1,"stats":{"Line":0}},{"line":344,"address":[3968841,3968712],"length":1,"stats":{"Line":0}},{"line":350,"address":[1961445],"length":1,"stats":{"Line":1}},{"line":351,"address":[3966166],"length":1,"stats":{"Line":1}},{"line":352,"address":[1961812,1962083],"length":1,"stats":{"Line":2}},{"line":353,"address":[3966809],"length":1,"stats":{"Line":1}},{"line":354,"address":[1962201,1962272],"length":1,"stats":{"Line":2}},{"line":355,"address":[3966965],"length":1,"stats":{"Line":1}},{"line":356,"address":[3967840,3967969],"length":1,"stats":{"Line":0}},{"line":360,"address":[1963511],"length":1,"stats":{"Line":0}},{"line":361,"address":[1962123],"length":1,"stats":{"Line":0}},{"line":366,"address":[3966586],"length":1,"stats":{"Line":0}},{"line":367,"address":[1961785],"length":1,"stats":{"Line":0}},{"line":372,"address":[3967273],"length":1,"stats":{"Line":1}},{"line":373,"address":[3967507],"length":1,"stats":{"Line":1}},{"line":374,"address":[3967294],"length":1,"stats":{"Line":1}},{"line":376,"address":[3967343],"length":1,"stats":{"Line":1}},{"line":377,"address":[1752542],"length":1,"stats":{"Line":1}},{"line":382,"address":[4008966,3996915],"length":1,"stats":{"Line":0}},{"line":385,"address":[3958495],"length":1,"stats":{"Line":2}},{"line":388,"address":[1757996,1754528,1758137],"length":1,"stats":{"Line":2}},{"line":392,"address":[3969701,3969479,3969843],"length":1,"stats":{"Line":6}},{"line":393,"address":[4009255],"length":1,"stats":{"Line":2}},{"line":394,"address":[4009270],"length":1,"stats":{"Line":2}},{"line":395,"address":[3969550],"length":1,"stats":{"Line":2}},{"line":396,"address":[4009337],"length":1,"stats":{"Line":2}},{"line":397,"address":[4009421],"length":1,"stats":{"Line":2}},{"line":399,"address":[1755017],"length":1,"stats":{"Line":2}},{"line":407,"address":[1755510,1755261,1755107,1755759,1756134,1756254,1755885,1755049],"length":1,"stats":{"Line":14}},{"line":408,"address":[1965395,1965312],"length":1,"stats":{"Line":4}},{"line":409,"address":[1755361],"length":1,"stats":{"Line":2}},{"line":410,"address":[3970510],"length":1,"stats":{"Line":2}},{"line":411,"address":[1966103],"length":1,"stats":{"Line":2}},{"line":412,"address":[3970885],"length":1,"stats":{"Line":2}},{"line":413,"address":[1966491],"length":1,"stats":{"Line":2}},{"line":415,"address":[4012627,4012642,4011730,4011102,4011194],"length":1,"stats":{"Line":4}},{"line":416,"address":[1757936,1757055,1757235,1757492],"length":1,"stats":{"Line":4}},{"line":417,"address":[1967786,1967740],"length":1,"stats":{"Line":4}},{"line":418,"address":[3972450,3972729],"length":1,"stats":{"Line":2}},{"line":419,"address":[1968021],"length":1,"stats":{"Line":0}},{"line":421,"address":[1968080,1967813],"length":1,"stats":{"Line":2}},{"line":422,"address":[1968167],"length":1,"stats":{"Line":2}},{"line":425,"address":[1965157,1968300],"length":1,"stats":{"Line":0}}],"covered":114,"coverable":153},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","src","identity_server.rs"],"content":"// standard\nuse std::clone::Clone;\nuse std::convert::TryInto;\nuse std::net::TcpStream;\n\n// extern crates\nuse bson::doc;\nuse bson::spec::BinarySubtype;\nuse bson::{Binary, Bson};\nuse honk_rpc::honk_rpc::{\n    get_message_overhead, get_response_section_size, ApiSet, ErrorCode, RequestCookie, Session,\n};\nuse rand::rngs::OsRng;\nuse rand::RngCore;\nuse tor_interface::tor_crypto::*;\n\n// internal crates\nuse crate::ascii_string::*;\nuse crate::gosling::*;\n\n//\n// Identity Server\n//\n\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"HonkRPC method failed: {0}\")]\n    HonkRPCFailure(#[from] honk_rpc::honk_rpc::Error),\n\n    #[error(\"server is in invalid state: {0}\")]\n    InvalidState(String),\n\n    #[error(\"incorrect usage: {0}\")]\n    IncorrectUsage(String),\n\n    #[error(\"client sent invalid request\")]\n    BadClient,\n\n    #[error(\"provided endpoint challenge too large; encoded size would be {0} but session's maximum honk-rpc message size is {1}\")]\n    EndpointChallengeTooLarge(usize, usize),\n}\n\npub(crate) enum IdentityServerEvent {\n    EndpointRequestReceived {\n        client_service_id: V3OnionServiceId,\n        requested_endpoint: AsciiString,\n    },\n\n    ChallengeResponseReceived {\n        challenge_response: bson::document::Document,\n    },\n\n    HandshakeCompleted {\n        endpoint_private_key: Ed25519PrivateKey,\n        endpoint_name: AsciiString,\n        client_service_id: V3OnionServiceId,\n        client_auth_public_key: X25519PublicKey,\n    },\n\n    HandshakeRejected {\n        // Client not on the block-list\n        client_allowed: bool,\n        // The requested endpoint is valid\n        client_requested_endpoint_valid: bool,\n        // The client proof is valid and signed with client's public key\n        client_proof_signature_valid: bool,\n        // The client authorization signature is valid\n        client_auth_signature_valid: bool,\n        // The challenge response is valid\n        challenge_response_valid: bool,\n    },\n}\n\n#[derive(Debug, PartialEq)]\nenum IdentityServerState {\n    // valid/expected states\n    WaitingForBeginHandshake,\n    GettingChallenge,\n    ChallengeReady,\n    WaitingForSendResponse,\n    GettingChallengeVerification,\n    ChallengeVerificationReady,\n    ChallengeVerificationResponseSent,\n    HandshakeComplete,\n    // failure state\n    HandshakeFailed,\n}\n\npub(crate) struct IdentityServer {\n    // Session Data\n    rpc: Option\u003cSession\u003cTcpStream\u003e\u003e,\n    server_identity: V3OnionServiceId,\n\n    // State Machine Data\n    state: IdentityServerState,\n    begin_handshake_request_cookie: Option\u003cRequestCookie\u003e,\n    client_identity: Option\u003cV3OnionServiceId\u003e,\n    requested_endpoint: Option\u003cAsciiString\u003e,\n    server_cookie: Option\u003cServerCookie\u003e,\n    endpoint_challenge: Option\u003cbson::document::Document\u003e,\n    send_response_request_cookie: Option\u003cRequestCookie\u003e,\n    client_auth_key: Option\u003cX25519PublicKey\u003e,\n    challenge_response: Option\u003cbson::document::Document\u003e,\n    endpoint_private_key: Option\u003cEd25519PrivateKey\u003e,\n\n    // Verification flags\n\n    // Client not on the block-list\n    client_allowed: bool,\n    // The requested endpoint is valid\n    client_requested_endpoint_valid: bool,\n    // The client proof is valid and signed with client's public key\n    client_proof_signature_valid: bool,\n    // The client authorization signature is valid\n    client_auth_signature_valid: bool,\n    // The challenge response is valid\n    challenge_response_valid: bool,\n}\n\nimpl IdentityServer {\n    fn get_state(\u0026self) -\u003e String {\n        format!(\"{{ state: {:?}, begin_handshake_request_cookie: {:?}, client_identity: {:?}, requested_endpoint: {:?}, server_cookie: {:?}, endpoint_challenge: {:?}, send_response_request_cookie: {:?}, client_auth_key: {:?}, challenge_response: {:?}, endpoint_private_key: {:?} }}\", self.state, self.begin_handshake_request_cookie, self.client_identity, self.requested_endpoint, self.server_cookie, self.endpoint_challenge, self.send_response_request_cookie, self.client_auth_key, self.challenge_response, self.endpoint_private_key)\n    }\n\n    pub fn new(rpc: Session\u003cTcpStream\u003e, server_identity: V3OnionServiceId) -\u003e Self {\n        IdentityServer {\n            // Session Data\n            rpc: Some(rpc),\n            server_identity,\n\n            // State Machine Data\n            state: IdentityServerState::WaitingForBeginHandshake,\n            begin_handshake_request_cookie: None,\n            client_identity: None,\n            requested_endpoint: None,\n            server_cookie: None,\n            endpoint_challenge: None,\n            send_response_request_cookie: None,\n            client_auth_key: None,\n            challenge_response: None,\n            endpoint_private_key: None,\n\n            // Verification Flags\n            client_allowed: false,\n            client_requested_endpoint_valid: false,\n            client_proof_signature_valid: false,\n            client_auth_signature_valid: false,\n            challenge_response_valid: false,\n        }\n    }\n\n    pub fn update(\u0026mut self) -\u003e Result\u003cOption\u003cIdentityServerEvent\u003e, Error\u003e {\n        // need to remove ownership of the HonkRPC session from Self\n        // before being able to pass self into the session update method\n        if let Some(mut rpc) = std::mem::take(\u0026mut self.rpc) {\n            match rpc.update(Some(\u0026mut [self])) {\n                Ok(()) =\u003e {\n                    self.rpc = Some(rpc);\n                }\n                Err(err) =\u003e {\n                    self.rpc = Some(rpc);\n                    return Err(err.into());\n                }\n            }\n        }\n\n        match(\u0026self.state,\n              self.begin_handshake_request_cookie,\n              self.client_identity.as_ref(),\n              self.requested_endpoint.as_ref(),\n              self.server_cookie.as_ref(),\n              self.endpoint_challenge.as_ref(),\n              self.send_response_request_cookie,\n              self.client_auth_key.as_ref(),\n              self.challenge_response.as_mut(),\n              self.endpoint_private_key.as_ref()) {\n            (\u0026IdentityServerState::WaitingForBeginHandshake,\n             None, // begin_handshake_request_cookie\n             None, // client_identity\n             None, // requested_endpoint\n             None, // server_cookie\n             None, // endpoint_challenge\n             None, // send_response_request_cookie\n             None, // client_auth_key\n             None, // challenge_response\n             None) // endpoint_private_key\n            =\u003e {\n                // no-op, waiting for client to connect and begin handshake\n            },\n            (\u0026IdentityServerState::WaitingForBeginHandshake,\n             Some(_begin_handshake_request_cookie),\n             Some(client_identity),\n             Some(requested_endpoint),\n             None, // server_cookie\n             None, // endpoint_challenge\n             None, // send_response_request_cookie\n             None, // client_auth_key\n             None, // challenge_response\n             None) // endpoint_private_key\n            =\u003e {\n                self.state = IdentityServerState::GettingChallenge;\n                return Ok(Some(IdentityServerEvent::EndpointRequestReceived{client_service_id: client_identity.clone(), requested_endpoint: requested_endpoint.clone()}));\n            },\n            (\u0026IdentityServerState::WaitingForSendResponse,\n             Some(_begin_handshake_request_cookie),\n             Some(_client_identity),\n             Some(_requested_endpoint),\n             Some(_server_cookie),\n             Some(_endpoint_challenge),\n             None, // send_response_request_cookie\n             None, // client_auth_key\n             None, // challenge_response\n             None) // endpoint_private_key\n            =\u003e {\n                // no-op, waiting for client to send challenge response\n            },\n            (\u0026IdentityServerState::WaitingForSendResponse,\n             Some(_begin_handshake_request_cookie),\n             Some(_client_identity),\n             Some(_requested_endpoint),\n             Some(_server_cookie),\n             Some(_endpoint_challenge),\n             Some(_send_response_request_cookie),\n             Some(_client_auth_key),\n             Some(challenge_response),\n             None) // endpoint_private_key\n            =\u003e {\n                self.state = IdentityServerState::GettingChallengeVerification;\n                return Ok(Some(IdentityServerEvent::ChallengeResponseReceived{\n                    challenge_response: std::mem::take(challenge_response),\n                }));\n            },\n            (\u0026IdentityServerState::ChallengeVerificationResponseSent,\n             Some(_begin_handshake_request_cookie),\n             Some(client_identity),\n             Some(requested_endpoint),\n             Some(_server_cookie),\n             Some(_endpoint_challenge),\n             Some(_send_response_request_cookie),\n             Some(client_auth_key),\n             Some(_challenge_response),\n             Some(endpoint_private_key))\n            =\u003e {\n                self.state = IdentityServerState::HandshakeComplete;\n                return Ok(Some(IdentityServerEvent::HandshakeCompleted{\n                    endpoint_private_key: endpoint_private_key.clone(),\n                    endpoint_name: requested_endpoint.clone(),\n                    client_service_id: client_identity.clone(),\n                    client_auth_public_key: client_auth_key.clone(),\n                }));\n            },\n            (\u0026IdentityServerState::ChallengeVerificationResponseSent,\n             Some(_begin_handshake_request_cookie),\n             Some(_client_identity),\n             Some(_requested_endpoint),\n             Some(_server_cookie),\n             Some(_endpoint_challenge),\n             Some(_send_response_request_cookie),\n             Some(_client_auth_key),\n             Some(_challenge_response),\n             None) // endpoint_private_key\n            =\u003e {\n                self.state = IdentityServerState::HandshakeComplete;\n                return Ok(Some(IdentityServerEvent::HandshakeRejected{\n                    client_allowed: self.client_allowed,\n                    client_requested_endpoint_valid: self.client_requested_endpoint_valid,\n                    client_proof_signature_valid: self.client_proof_signature_valid,\n                    client_auth_signature_valid: self.client_auth_signature_valid,\n                    challenge_response_valid: self.challenge_response_valid,\n                }));\n            },\n             _ =\u003e {\n                if self.state == IdentityServerState::HandshakeFailed {\n                    return Err(Error::BadClient);\n                } else {\n                    return Err(Error::InvalidState(self.get_state()));\n                }\n            }\n        }\n\n        Ok(None)\n    }\n\n    pub fn handle_endpoint_request_received(\n        \u0026mut self,\n        client_allowed: bool,\n        endpoint_valid: bool,\n        endpoint_challenge: bson::document::Document,\n    ) -\u003e Result\u003c(), Error\u003e {\n        match (\n            \u0026self.state,\n            self.rpc.as_ref(),\n            self.begin_handshake_request_cookie,\n            self.client_identity.as_ref(),\n            self.requested_endpoint.as_ref(),\n            self.server_cookie.as_ref(),\n            self.endpoint_challenge.as_ref(),\n            self.client_auth_key.as_ref(),\n            self.challenge_response.as_ref(),\n            self.endpoint_private_key.as_ref(),\n        ) {\n            (\n                \u0026IdentityServerState::GettingChallenge,\n                Some(rpc),\n                Some(_begin_handshake_request_cookie),\n                Some(_client_identity),\n                Some(_endpoint_name),\n                None, // server_cookie\n                None, // endpoint_challenge\n                None, // client_auth_key\n                None, // challenge_response\n                None, // endpoint_private_key\n            ) =\u003e {\n                let mut server_cookie: ServerCookie = Default::default();\n                OsRng.fill_bytes(\u0026mut server_cookie);\n\n                // calculate required size of response message and ensure if fits our\n                // specified message size budget\n                let result = doc!{\n                    \"server_cookie\" : Bson::Binary(Binary{subtype: BinarySubtype::Generic, bytes: server_cookie.to_vec()}),\n                    \"endpoint_challenge\" : endpoint_challenge.clone(),\n                };\n                let response_section_size = get_response_section_size(Some(Bson::Document(result)))?;\n                let message_size = get_message_overhead()? + response_section_size;\n                let max_message_size = rpc.get_max_message_size();\n                if message_size \u003e max_message_size {\n                    Err(Error::EndpointChallengeTooLarge(message_size, max_message_size))\n                } else {\n                    self.server_cookie = Some(server_cookie);\n                    self.endpoint_challenge = Some(endpoint_challenge);\n                    self.client_allowed = client_allowed;\n                    self.client_requested_endpoint_valid = endpoint_valid;\n                    self.state = IdentityServerState::ChallengeReady;\n                    Ok(())\n                }\n            }\n            _ =\u003e {\n                Err(Error::IncorrectUsage(\"handle_endpoint_request_received() may only be called after EndpointRequestReceived has been returned from update(), and it may only be called once\".to_string()))\n            }\n        }\n    }\n\n    pub fn handle_challenge_response_received(\n        \u0026mut self,\n        challenge_response_valid: bool,\n    ) -\u003e Result\u003c(), Error\u003e {\n        match (\n            \u0026self.state,\n            self.begin_handshake_request_cookie,\n            self.client_identity.as_ref(),\n            self.requested_endpoint.as_ref(),\n            self.server_cookie.as_ref(),\n            self.endpoint_challenge.as_ref(),\n            self.client_auth_key.as_ref(),\n            self.challenge_response.as_ref(),\n            self.endpoint_private_key.as_ref(),\n        ) {\n            (\n                \u0026IdentityServerState::GettingChallengeVerification,\n                Some(_begin_handshake_request_cookie),\n                Some(_client_identity),\n                Some(_requested_endpoint),\n                Some(_server_cookie),\n                Some(_endpoint_challenge),\n                Some(_client_auth_key),\n                Some(_challenge_response),\n                None,\n            ) =\u003e\n            // endpoint_private_key\n            {\n                self.challenge_response_valid = challenge_response_valid;\n                self.state = IdentityServerState::ChallengeVerificationReady;\n                Ok(())\n            }\n            _ =\u003e {\n                Err(Error::IncorrectUsage(\"handle_challenge_response_received() may only be called after ChallengeResponseReceived event has been returned from update(), and it may only be called once\".to_string()))\n            }\n        }\n    }\n}\n\nimpl ApiSet for IdentityServer {\n    fn namespace(\u0026self) -\u003e \u0026str {\n        \"gosling_identity\"\n    }\n\n    fn exec_function(\n        \u0026mut self,\n        name: \u0026str,\n        version: i32,\n        mut args: bson::document::Document,\n        request_cookie: Option\u003cRequestCookie\u003e,\n    ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n        let request_cookie = match request_cookie {\n            Some(request_cookie) =\u003e request_cookie,\n            None =\u003e {\n                return Some(Err(ErrorCode::Runtime(\n                    RpcError::RequestCookieRequired as i32,\n                )))\n            }\n        };\n\n        match (\n            name,\n            version,\n            \u0026self.state,\n            self.begin_handshake_request_cookie,\n            self.client_identity.as_ref(),\n            self.requested_endpoint.as_ref(),\n            self.server_cookie.as_ref(),\n            self.endpoint_challenge.as_ref(),\n            self.client_auth_key.as_ref(),\n            self.challenge_response.as_ref(),\n            self.endpoint_private_key.as_ref(),\n        ) {\n            // handle begin_handshake call\n            (\n                \"begin_handshake\",\n                0,\n                \u0026IdentityServerState::WaitingForBeginHandshake,\n                None, // begin_handshake_request_cookie\n                None, // client_identity\n                None, // requested_endpoint\n                None, // server_cookie\n                None, // endpoint_challenge\n                None, // client_auth_key\n                None, // challenge_response\n                None, // endpoint_private_key\n            ) =\u003e {\n                let valid_version = match args.remove(\"version\") {\n                    Some(Bson::String(value)) =\u003e value == GOSLING_PROTOCOL_VERSION,\n                    _ =\u003e false,\n                };\n                if !valid_version {\n                    self.state = IdentityServerState::HandshakeFailed;\n                    return Some(Err(ErrorCode::Runtime(RpcError::BadVersion as i32)));\n                }\n\n                if let (Some(Bson::String(client_identity)), Some(Bson::String(endpoint_name))) =\n                    (args.remove(\"client_identity\"), args.remove(\"endpoint\"))\n                {\n                    // client_identiity\n                    let client_identity = match V3OnionServiceId::from_string(\u0026client_identity) {\n                        Ok(client_identity) =\u003e client_identity,\n                        Err(_) =\u003e {\n                            self.state = IdentityServerState::HandshakeFailed;\n                            return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                        }\n                    };\n\n                    // endpoint name\n                    let endpoint_name = match AsciiString::new(endpoint_name) {\n                        Ok(endpoint_name) =\u003e endpoint_name,\n                        Err(_) =\u003e {\n                            self.state = IdentityServerState::HandshakeFailed;\n                            return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                        }\n                    };\n\n                    // save cookie\n                    self.begin_handshake_request_cookie = Some(request_cookie);\n\n                    // save results\n                    self.client_identity = Some(client_identity);\n                    self.requested_endpoint = Some(endpoint_name);\n                    None\n                } else {\n                    self.state = IdentityServerState::HandshakeFailed;\n                    Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)))\n                }\n            }\n            // handle send_response call\n            (\n                \"send_response\",\n                0,\n                \u0026IdentityServerState::WaitingForSendResponse,\n                Some(_begin_handshake_request_cookie),\n                Some(client_identity),\n                Some(requested_endpoint),\n                Some(server_cookie),\n                Some(_endpoint_challenge),\n                None, // client_auth_key\n                None, // challenge_response\n                None, // endpoint_private_key\n            ) =\u003e {\n                // arg validation\n                if let (\n                    Some(Bson::Binary(Binary {\n                        subtype: BinarySubtype::Generic,\n                        bytes: client_cookie,\n                    })),\n                    Some(Bson::Binary(Binary {\n                        subtype: BinarySubtype::Generic,\n                        bytes: client_identity_proof_signature,\n                    })),\n                    Some(Bson::Binary(Binary {\n                        subtype: BinarySubtype::Generic,\n                        bytes: client_authorization_key,\n                    })),\n                    Some(Bson::Boolean(client_authorization_key_signbit)),\n                    Some(Bson::Binary(Binary {\n                        subtype: BinarySubtype::Generic,\n                        bytes: client_authorization_signature,\n                    })),\n                    Some(Bson::Document(challenge_response)),\n                ) = (\n                    args.remove(\"client_cookie\"),\n                    args.remove(\"client_identity_proof_signature\"),\n                    args.remove(\"client_authorization_key\"),\n                    args.remove(\"client_authorization_key_signbit\"),\n                    args.remove(\"client_authorization_signature\"),\n                    args.remove(\"challenge_response\"),\n                ) {\n                    // client_cookie\n                    let client_cookie: ClientCookie = match client_cookie.try_into() {\n                        Ok(client_cookie) =\u003e client_cookie,\n                        Err(_) =\u003e {\n                            self.state = IdentityServerState::HandshakeFailed;\n                            return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                        }\n                    };\n\n                    // client_identity_proof_signature\n                    let client_identity_proof_signature: [u8; ED25519_SIGNATURE_SIZE] =\n                        match client_identity_proof_signature.try_into() {\n                            Ok(client_identity_proof_signature) =\u003e client_identity_proof_signature,\n                            Err(_) =\u003e {\n                                self.state = IdentityServerState::HandshakeFailed;\n                                return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                            }\n                        };\n                    let client_identity_proof_signature =\n                        match Ed25519Signature::from_raw(\u0026client_identity_proof_signature) {\n                            Ok(client_identity_proof_signature) =\u003e client_identity_proof_signature,\n                            Err(_) =\u003e {\n                                self.state = IdentityServerState::HandshakeFailed;\n                                return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                            }\n                        };\n\n                    // client_authorization_key\n                    let client_authorization_key: [u8; X25519_PUBLIC_KEY_SIZE] =\n                        match client_authorization_key.try_into() {\n                            Ok(client_authorization_key) =\u003e client_authorization_key,\n                            Err(_) =\u003e {\n                                self.state = IdentityServerState::HandshakeFailed;\n                                return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                            }\n                        };\n                    let client_authorization_key =\n                        X25519PublicKey::from_raw(\u0026client_authorization_key);\n\n                    // client_authorization_key_signbit\n                    let client_authorization_key_signbit: SignBit =\n                        client_authorization_key_signbit.into();\n\n                    // client_authorization_signature\n                    let client_authorization_signature: [u8; ED25519_SIGNATURE_SIZE] =\n                        match client_authorization_signature.try_into() {\n                            Ok(client_authorization_signature) =\u003e client_authorization_signature,\n                            Err(_) =\u003e {\n                                self.state = IdentityServerState::HandshakeFailed;\n                                return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                            }\n                        };\n                    let client_authorization_signature =\n                        match Ed25519Signature::from_raw(\u0026client_authorization_signature) {\n                            Ok(client_authorization_signature) =\u003e client_authorization_signature,\n                            Err(_) =\u003e {\n                                self.state = IdentityServerState::HandshakeFailed;\n                                return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                            }\n                        };\n\n                    // save  cookie\n                    self.send_response_request_cookie = Some(request_cookie);\n\n                    // convert client_identity to client's public ed25519 key\n                    if let Ok(client_identity_key) =\n                        Ed25519PublicKey::from_service_id(client_identity)\n                    {\n                        // construct + verify client proof\n                        let client_proof = build_client_proof(\n                            DomainSeparator::GoslingIdentity,\n                            requested_endpoint,\n                            client_identity,\n                            \u0026self.server_identity,\n                            \u0026client_cookie,\n                            server_cookie,\n                        );\n                        self.client_proof_signature_valid = client_identity_proof_signature\n                            .verify(\u0026client_proof, \u0026client_identity_key);\n                    }\n\n                    // evaluate the client authorization signature\n                    self.client_auth_signature_valid = client_authorization_signature\n                        .verify_x25519(\n                            client_identity.as_bytes(),\n                            \u0026client_authorization_key,\n                            client_authorization_key_signbit,\n                        );\n\n                    // save off client auth key for future endpoint generation\n                    self.client_auth_key = Some(client_authorization_key);\n\n                    // safe off challenge response for verification\n                    self.challenge_response = Some(challenge_response);\n\n                    None\n                } else {\n                    self.state = IdentityServerState::HandshakeFailed;\n                    Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)))\n                }\n            }\n            _ =\u003e {\n                self.state = IdentityServerState::HandshakeFailed;\n                Some(Err(ErrorCode::Runtime(RpcError::Failure as i32)))\n            }\n        }\n    }\n\n    fn next_result(\u0026mut self) -\u003e Option\u003c(RequestCookie, Result\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e)\u003e {\n        match (\n            \u0026self.state,\n            self.begin_handshake_request_cookie,\n            self.client_identity.as_ref(),\n            self.requested_endpoint.as_ref(),\n            self.server_cookie.as_ref(),\n            self.endpoint_challenge.as_mut(),\n            self.send_response_request_cookie,\n            self.client_auth_key.as_ref(),\n            self.challenge_response.as_ref(),\n        ) {\n            // return challenge from begin_handshake\n            (\n                \u0026IdentityServerState::ChallengeReady,\n                Some(begin_handshake_request_cookie),\n                Some(_client_identity),\n                Some(_requested_endpoint),\n                Some(server_cookie),\n                Some(endpoint_challenge),\n                None, // send_response_request_cookie\n                None, // client_auth_key\n                None,\n            ) =\u003e\n            // challenge_response\n            {\n                self.state = IdentityServerState::WaitingForSendResponse;\n                Some((\n                    begin_handshake_request_cookie,\n                    Ok(Some(Bson::Document(doc! {\n                        \"server_cookie\" : Bson::Binary(Binary{subtype: BinarySubtype::Generic, bytes: server_cookie.to_vec()}),\n                        \"endpoint_challenge\" : std::mem::take(endpoint_challenge),\n                    }))),\n                ))\n            }\n            (\u0026IdentityServerState::ChallengeReady, _, _, _, _, _, _, _, _) =\u003e unreachable!(),\n            (\n                \u0026IdentityServerState::ChallengeVerificationReady,\n                Some(_begin_handshake_request_cookie),\n                Some(_client_identity),\n                Some(_requested_endpoint),\n                Some(_server_cookie),\n                Some(_endpoint_challenge),\n                Some(send_response_request_cookie),\n                Some(_client_auth_key),\n                Some(_challenge_response),\n            ) =\u003e {\n                let mut success = true;\n                success \u0026= self.client_allowed;\n                success \u0026= self.client_requested_endpoint_valid;\n                success \u0026= self.client_proof_signature_valid;\n                success \u0026= self.client_auth_signature_valid;\n                success \u0026= self.challenge_response_valid;\n\n                self.state = IdentityServerState::ChallengeVerificationResponseSent;\n                if success {\n                    let endpoint_private_key = Ed25519PrivateKey::generate();\n                    let endpoint_service_id =\n                        V3OnionServiceId::from_private_key(\u0026endpoint_private_key);\n                    self.endpoint_private_key = Some(endpoint_private_key);\n                    Some((\n                        send_response_request_cookie,\n                        Ok(Some(Bson::String(endpoint_service_id.to_string()))),\n                    ))\n                } else {\n                    Some((\n                        send_response_request_cookie,\n                        Err(ErrorCode::Runtime(RpcError::Failure as i32)),\n                    ))\n                }\n            }\n            _ =\u003e None,\n        }\n    }\n}\n","traces":[{"line":121,"address":[4522480],"length":1,"stats":{"Line":0}},{"line":122,"address":[2091991,2091708,2091613,2091803,2091898,2091518,2092086,2091337,2092181,2092271],"length":1,"stats":{"Line":0}},{"line":125,"address":[4523840],"length":1,"stats":{"Line":2}},{"line":128,"address":[4484118],"length":1,"stats":{"Line":2}},{"line":152,"address":[2146208,2147470],"length":1,"stats":{"Line":2}},{"line":155,"address":[2093291],"length":1,"stats":{"Line":2}},{"line":156,"address":[2146419,2146577],"length":1,"stats":{"Line":4}},{"line":158,"address":[2146612,2146970],"length":1,"stats":{"Line":2}},{"line":160,"address":[2093766],"length":1,"stats":{"Line":0}},{"line":161,"address":[4485537,4485310],"length":1,"stats":{"Line":0}},{"line":162,"address":[2147165,2147360],"length":1,"stats":{"Line":0}},{"line":167,"address":[2149539,2147537,2149197,2148352,2147974,2148831,2147771],"length":1,"stats":{"Line":14}},{"line":168,"address":[4486016],"length":1,"stats":{"Line":2}},{"line":169,"address":[4525767],"length":1,"stats":{"Line":2}},{"line":170,"address":[4486052],"length":1,"stats":{"Line":2}},{"line":171,"address":[4525825],"length":1,"stats":{"Line":2}},{"line":172,"address":[4525854],"length":1,"stats":{"Line":2}},{"line":173,"address":[2094715],"length":1,"stats":{"Line":2}},{"line":174,"address":[2094733],"length":1,"stats":{"Line":2}},{"line":175,"address":[4486186],"length":1,"stats":{"Line":2}},{"line":176,"address":[2094791],"length":1,"stats":{"Line":2}},{"line":190,"address":[2095647],"length":1,"stats":{"Line":2}},{"line":201,"address":[2095700],"length":1,"stats":{"Line":2}},{"line":202,"address":[2095721],"length":1,"stats":{"Line":2}},{"line":204,"address":[4527370],"length":1,"stats":{"Line":2}},{"line":217,"address":[2096457],"length":1,"stats":{"Line":2}},{"line":228,"address":[4527641],"length":1,"stats":{"Line":2}},{"line":229,"address":[2149434],"length":1,"stats":{"Line":2}},{"line":230,"address":[2096494],"length":1,"stats":{"Line":2}},{"line":233,"address":[2097242],"length":1,"stats":{"Line":2}},{"line":244,"address":[2097343],"length":1,"stats":{"Line":2}},{"line":245,"address":[4528694],"length":1,"stats":{"Line":2}},{"line":246,"address":[2150290],"length":1,"stats":{"Line":2}},{"line":247,"address":[2097394],"length":1,"stats":{"Line":2}},{"line":248,"address":[4488882],"length":1,"stats":{"Line":2}},{"line":249,"address":[2097519],"length":1,"stats":{"Line":2}},{"line":252,"address":[2096867],"length":1,"stats":{"Line":1}},{"line":263,"address":[2149921],"length":1,"stats":{"Line":1}},{"line":264,"address":[2097048],"length":1,"stats":{"Line":1}},{"line":265,"address":[2097016],"length":1,"stats":{"Line":1}},{"line":266,"address":[2149949],"length":1,"stats":{"Line":1}},{"line":267,"address":[2149956],"length":1,"stats":{"Line":1}},{"line":268,"address":[2097036],"length":1,"stats":{"Line":1}},{"line":269,"address":[2097042],"length":1,"stats":{"Line":1}},{"line":273,"address":[4486440],"length":1,"stats":{"Line":0}},{"line":274,"address":[4489333],"length":1,"stats":{"Line":0}},{"line":276,"address":[2097766],"length":1,"stats":{"Line":0}},{"line":281,"address":[2095385],"length":1,"stats":{"Line":2}},{"line":284,"address":[4492353,4492472,4489408],"length":1,"stats":{"Line":2}},{"line":290,"address":[4489494,4489866,4490030],"length":1,"stats":{"Line":6}},{"line":291,"address":[4489510],"length":1,"stats":{"Line":2}},{"line":292,"address":[4529272],"length":1,"stats":{"Line":2}},{"line":293,"address":[2098176],"length":1,"stats":{"Line":2}},{"line":294,"address":[2098193],"length":1,"stats":{"Line":2}},{"line":295,"address":[2098221],"length":1,"stats":{"Line":2}},{"line":296,"address":[4529417],"length":1,"stats":{"Line":2}},{"line":297,"address":[4529445],"length":1,"stats":{"Line":2}},{"line":298,"address":[4529473],"length":1,"stats":{"Line":2}},{"line":299,"address":[2098333],"length":1,"stats":{"Line":2}},{"line":300,"address":[2098361],"length":1,"stats":{"Line":2}},{"line":302,"address":[2151769],"length":1,"stats":{"Line":2}},{"line":314,"address":[2151801],"length":1,"stats":{"Line":2}},{"line":315,"address":[2098924],"length":1,"stats":{"Line":2}},{"line":319,"address":[4530183,4530124,4530337,4530457],"length":1,"stats":{"Line":6}},{"line":320,"address":[4530143,4530227],"length":1,"stats":{"Line":4}},{"line":321,"address":[4530450],"length":1,"stats":{"Line":2}},{"line":323,"address":[2152381,2153780,2152740],"length":1,"stats":{"Line":2}},{"line":324,"address":[2100273,2099989,2099821,2100893],"length":1,"stats":{"Line":4}},{"line":325,"address":[2100302,2100258],"length":1,"stats":{"Line":4}},{"line":326,"address":[4492130,4491734],"length":1,"stats":{"Line":2}},{"line":327,"address":[2100654],"length":1,"stats":{"Line":0}},{"line":329,"address":[4491753],"length":1,"stats":{"Line":2}},{"line":330,"address":[2100444,2100716],"length":1,"stats":{"Line":2}},{"line":331,"address":[4492247],"length":1,"stats":{"Line":2}},{"line":332,"address":[2153706],"length":1,"stats":{"Line":2}},{"line":333,"address":[4532011],"length":1,"stats":{"Line":2}},{"line":334,"address":[2153736],"length":1,"stats":{"Line":2}},{"line":338,"address":[2098576,2100943],"length":1,"stats":{"Line":0}},{"line":343,"address":[2153952],"length":1,"stats":{"Line":2}},{"line":347,"address":[2154426,2154214],"length":1,"stats":{"Line":4}},{"line":348,"address":[4492566],"length":1,"stats":{"Line":2}},{"line":349,"address":[2101152],"length":1,"stats":{"Line":2}},{"line":350,"address":[2154033],"length":1,"stats":{"Line":2}},{"line":351,"address":[4532360],"length":1,"stats":{"Line":2}},{"line":352,"address":[4492639],"length":1,"stats":{"Line":2}},{"line":353,"address":[2101238],"length":1,"stats":{"Line":2}},{"line":354,"address":[2154121],"length":1,"stats":{"Line":2}},{"line":355,"address":[2154143],"length":1,"stats":{"Line":2}},{"line":356,"address":[2154165],"length":1,"stats":{"Line":2}},{"line":358,"address":[4533043],"length":1,"stats":{"Line":2}},{"line":371,"address":[4493347],"length":1,"stats":{"Line":2}},{"line":372,"address":[4533100],"length":1,"stats":{"Line":2}},{"line":373,"address":[4493377],"length":1,"stats":{"Line":2}},{"line":376,"address":[2101450],"length":1,"stats":{"Line":0}},{"line":383,"address":[4493408],"length":1,"stats":{"Line":2}},{"line":387,"address":[2108089,2102016,2116079],"length":1,"stats":{"Line":2}},{"line":394,"address":[4493588],"length":1,"stats":{"Line":2}},{"line":395,"address":[4533559],"length":1,"stats":{"Line":2}},{"line":397,"address":[2155159],"length":1,"stats":{"Line":0}},{"line":403,"address":[2156015,2155666,2164890,2155857],"length":1,"stats":{"Line":8}},{"line":406,"address":[4493839],"length":1,"stats":{"Line":2}},{"line":407,"address":[4493856],"length":1,"stats":{"Line":2}},{"line":408,"address":[4493879],"length":1,"stats":{"Line":2}},{"line":409,"address":[4533720],"length":1,"stats":{"Line":2}},{"line":410,"address":[2155442],"length":1,"stats":{"Line":2}},{"line":411,"address":[2155472],"length":1,"stats":{"Line":2}},{"line":412,"address":[2102654],"length":1,"stats":{"Line":2}},{"line":413,"address":[2155529],"length":1,"stats":{"Line":2}},{"line":414,"address":[2102716],"length":1,"stats":{"Line":2}},{"line":417,"address":[4494357],"length":1,"stats":{"Line":2}},{"line":430,"address":[2165165],"length":1,"stats":{"Line":2}},{"line":431,"address":[4503928],"length":1,"stats":{"Line":2}},{"line":432,"address":[4543659],"length":1,"stats":{"Line":0}},{"line":434,"address":[2112858],"length":1,"stats":{"Line":2}},{"line":435,"address":[4504364],"length":1,"stats":{"Line":0}},{"line":436,"address":[2165745],"length":1,"stats":{"Line":0}},{"line":439,"address":[2166302,2166051,2166219,2166258,2166086],"length":1,"stats":{"Line":8}},{"line":443,"address":[2166408,2166476],"length":1,"stats":{"Line":4}},{"line":444,"address":[4505161],"length":1,"stats":{"Line":2}},{"line":446,"address":[2166615],"length":1,"stats":{"Line":0}},{"line":447,"address":[4505284],"length":1,"stats":{"Line":0}},{"line":452,"address":[2166749],"length":1,"stats":{"Line":2}},{"line":453,"address":[4505471],"length":1,"stats":{"Line":2}},{"line":455,"address":[2166963],"length":1,"stats":{"Line":0}},{"line":456,"address":[2166984],"length":1,"stats":{"Line":0}},{"line":461,"address":[4545498],"length":1,"stats":{"Line":2}},{"line":464,"address":[2167149],"length":1,"stats":{"Line":2}},{"line":465,"address":[4505929,4506093],"length":1,"stats":{"Line":2}},{"line":466,"address":[4506218],"length":1,"stats":{"Line":2}},{"line":468,"address":[2113336],"length":1,"stats":{"Line":0}},{"line":469,"address":[4544525],"length":1,"stats":{"Line":0}},{"line":473,"address":[2103484],"length":1,"stats":{"Line":2}},{"line":487,"address":[4535751,4535428,4535634,4535673,4536069,4535971,4535927,4535795,4535712,4535883,4536051,4536033,4536015,4535165,4535595,4535839],"length":1,"stats":{"Line":32}},{"line":490,"address":[2157731],"length":1,"stats":{"Line":2}},{"line":494,"address":[2104959],"length":1,"stats":{"Line":2}},{"line":498,"address":[2105007],"length":1,"stats":{"Line":2}},{"line":500,"address":[2157867],"length":1,"stats":{"Line":2}},{"line":503,"address":[2105075],"length":1,"stats":{"Line":2}},{"line":505,"address":[2157935],"length":1,"stats":{"Line":2}},{"line":507,"address":[4534731],"length":1,"stats":{"Line":2}},{"line":508,"address":[2103602],"length":1,"stats":{"Line":2}},{"line":509,"address":[2156513],"length":1,"stats":{"Line":2}},{"line":510,"address":[2103765],"length":1,"stats":{"Line":2}},{"line":511,"address":[4535013],"length":1,"stats":{"Line":2}},{"line":512,"address":[2103925],"length":1,"stats":{"Line":2}},{"line":515,"address":[2105235,2105303],"length":1,"stats":{"Line":4}},{"line":516,"address":[2158133],"length":1,"stats":{"Line":2}},{"line":518,"address":[4496847],"length":1,"stats":{"Line":0}},{"line":519,"address":[4536612],"length":1,"stats":{"Line":0}},{"line":524,"address":[2105617],"length":1,"stats":{"Line":2}},{"line":526,"address":[2105706],"length":1,"stats":{"Line":2}},{"line":528,"address":[4497296],"length":1,"stats":{"Line":0}},{"line":529,"address":[4537061],"length":1,"stats":{"Line":0}},{"line":532,"address":[2106066],"length":1,"stats":{"Line":2}},{"line":534,"address":[4497539],"length":1,"stats":{"Line":2}},{"line":536,"address":[2159089],"length":1,"stats":{"Line":0}},{"line":537,"address":[2159110],"length":1,"stats":{"Line":0}},{"line":542,"address":[4497839],"length":1,"stats":{"Line":2}},{"line":544,"address":[4497924],"length":1,"stats":{"Line":2}},{"line":546,"address":[2159410],"length":1,"stats":{"Line":0}},{"line":547,"address":[4498047],"length":1,"stats":{"Line":0}},{"line":550,"address":[4498220],"length":1,"stats":{"Line":2}},{"line":554,"address":[4498251],"length":1,"stats":{"Line":2}},{"line":558,"address":[4538036],"length":1,"stats":{"Line":2}},{"line":560,"address":[2106957],"length":1,"stats":{"Line":2}},{"line":562,"address":[2159927],"length":1,"stats":{"Line":0}},{"line":563,"address":[2107144],"length":1,"stats":{"Line":0}},{"line":566,"address":[4498741],"length":1,"stats":{"Line":2}},{"line":568,"address":[4538534],"length":1,"stats":{"Line":2}},{"line":570,"address":[4498956],"length":1,"stats":{"Line":0}},{"line":571,"address":[4538721],"length":1,"stats":{"Line":0}},{"line":576,"address":[4499111],"length":1,"stats":{"Line":2}},{"line":579,"address":[2160531],"length":1,"stats":{"Line":2}},{"line":584,"address":[4499238],"length":1,"stats":{"Line":2}},{"line":587,"address":[4538990],"length":1,"stats":{"Line":2}},{"line":591,"address":[4499439],"length":1,"stats":{"Line":2}},{"line":592,"address":[4499359],"length":1,"stats":{"Line":2}},{"line":596,"address":[4539296],"length":1,"stats":{"Line":2}},{"line":598,"address":[4499527],"length":1,"stats":{"Line":2}},{"line":604,"address":[2108192],"length":1,"stats":{"Line":2}},{"line":607,"address":[2161075],"length":1,"stats":{"Line":2}},{"line":609,"address":[2108594],"length":1,"stats":{"Line":2}},{"line":611,"address":[4495739],"length":1,"stats":{"Line":0}},{"line":612,"address":[2157148],"length":1,"stats":{"Line":0}},{"line":616,"address":[2155903],"length":1,"stats":{"Line":0}},{"line":617,"address":[2155924],"length":1,"stats":{"Line":0}},{"line":622,"address":[4508986,4507520],"length":1,"stats":{"Line":2}},{"line":623,"address":[4508061,4507561,4509008,4507819,4507974],"length":1,"stats":{"Line":10}},{"line":624,"address":[2168913],"length":1,"stats":{"Line":2}},{"line":625,"address":[2116155],"length":1,"stats":{"Line":2}},{"line":626,"address":[2116167],"length":1,"stats":{"Line":2}},{"line":627,"address":[4507617],"length":1,"stats":{"Line":2}},{"line":628,"address":[4507643],"length":1,"stats":{"Line":2}},{"line":629,"address":[2169001],"length":1,"stats":{"Line":2}},{"line":630,"address":[4507698],"length":1,"stats":{"Line":2}},{"line":631,"address":[2169050],"length":1,"stats":{"Line":2}},{"line":632,"address":[4547495],"length":1,"stats":{"Line":2}},{"line":635,"address":[4548027],"length":1,"stats":{"Line":2}},{"line":648,"address":[2116901],"length":1,"stats":{"Line":2}},{"line":649,"address":[4548653],"length":1,"stats":{"Line":2}},{"line":651,"address":[4508400,4508346,4508554,4508678],"length":1,"stats":{"Line":6}},{"line":652,"address":[4508368,4508444],"length":1,"stats":{"Line":4}},{"line":653,"address":[2169979],"length":1,"stats":{"Line":2}},{"line":658,"address":[4549002],"length":1,"stats":{"Line":2}},{"line":669,"address":[4549103],"length":1,"stats":{"Line":2}},{"line":670,"address":[2170687],"length":1,"stats":{"Line":2}},{"line":671,"address":[4509392],"length":1,"stats":{"Line":2}},{"line":672,"address":[4509417],"length":1,"stats":{"Line":2}},{"line":673,"address":[2170762],"length":1,"stats":{"Line":2}},{"line":674,"address":[4509467],"length":1,"stats":{"Line":2}},{"line":676,"address":[4549236],"length":1,"stats":{"Line":2}},{"line":677,"address":[2170833,2170981,2171495],"length":1,"stats":{"Line":5}},{"line":678,"address":[2170986],"length":1,"stats":{"Line":2}},{"line":679,"address":[4509701],"length":1,"stats":{"Line":2}},{"line":681,"address":[4549505],"length":1,"stats":{"Line":2}},{"line":682,"address":[2171426],"length":1,"stats":{"Line":2}},{"line":684,"address":[2171276],"length":1,"stats":{"Line":2}},{"line":687,"address":[2170920],"length":1,"stats":{"Line":1}},{"line":689,"address":[2118108],"length":1,"stats":{"Line":1}},{"line":693,"address":[2116531],"length":1,"stats":{"Line":2}}],"covered":183,"coverable":220},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","src","lib.rs"],"content":"#![doc = include_str!(\"../README.md\")]\n\n// some internal functions take a lot of args but thats ok\n#![allow(clippy::too_many_arguments)]\n\nmod ascii_string;\n/// Implementation of the Gosling protocol\npub mod context;\n#[cfg(fuzzing)]\npub mod endpoint_client;\n#[cfg(not(fuzzing))]\nmod endpoint_client;\n#[cfg(fuzzing)]\npub mod endpoint_server;\n#[cfg(not(fuzzing))]\nmod endpoint_server;\npub(crate) mod gosling;\n#[cfg(fuzzing)]\npub mod identity_client;\n#[cfg(not(fuzzing))]\nmod identity_client;\n#[cfg(fuzzing)]\npub mod identity_server;\n#[cfg(not(fuzzing))]\nmod identity_server;\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","tests","context.rs"],"content":"// standard\nuse std::io::{BufRead, BufReader, Write};\nuse std::net::TcpStream;\n\n// extern crates\nuse anyhow::bail;\nuse bson::doc;\nuse serial_test::serial;\n#[cfg(feature = \"tor-interface/legacy-tor-provider\")]\nuse tor_interface::legacy_tor_client::*;\n#[cfg(feature = \"tor-interface/mock-tor-provider\")]\nuse tor_interface::mock_tor_client::*;\nuse tor_interface::tor_crypto::*;\nuse tor_interface::tor_provider::*;\n\n// internal crates\nuse gosling::context::*;\n\nconst INVALID_HANDSHAKE_HANDLE: HandshakeHandle = !0usize;\n\n#[test]\n#[cfg(feature = \"tor-interface/mock-tor-provider\")]\nfn test_mock_client_gosling_context() -\u003e anyhow::Result\u003c()\u003e {\n    let alice_tor_client = Box::new(MockTorClient::new());\n    let pat_tor_client = Box::new(MockTorClient::new());\n    gosling_context_test(alice_tor_client, pat_tor_client)\n}\n\n#[test]\n#[serial]\n#[cfg(feature = \"tor-interface/legacy-tor-provider\")]\nfn test_legacy_client_gosling_context() -\u003e anyhow::Result\u003c()\u003e {\n    let tor_path = which::which(\"tor\")?;\n\n    let mut alice_path = std::env::temp_dir();\n    alice_path.push(\"test_legacy_client_gosling_context_alice\");\n    let tor_config = LegacyTorClientConfig::BundledTor {\n        tor_bin_path: tor_path.clone(),\n        data_directory: alice_path,\n        proxy_settings: None,\n        allowed_ports: None,\n        pluggable_transports: None,\n        bridge_lines: None,\n    };\n    let alice_tor_client = Box::new(LegacyTorClient::new(tor_config)?);\n\n    let mut pat_path = std::env::temp_dir();\n    pat_path.push(\"test_legacy_client_gosling_context_pat\");\n    let tor_config = LegacyTorClientConfig::BundledTor {\n        tor_bin_path: tor_path,\n        data_directory: pat_path,\n        proxy_settings: None,\n        allowed_ports: None,\n        pluggable_transports: None,\n        bridge_lines: None,\n    };\n    let pat_tor_client = Box::new(LegacyTorClient::new(tor_config)?);\n\n    gosling_context_test(alice_tor_client, pat_tor_client)\n}\n\n#[cfg(test)]\nfn gosling_context_test(\n    alice_tor_client: Box\u003cdyn TorProvider\u003e,\n    pat_tor_client: Box\u003cdyn TorProvider\u003e,\n) -\u003e anyhow::Result\u003c()\u003e {\n    // Bootstrap Alice\n    let alice_private_key = Ed25519PrivateKey::generate();\n    let alice_service_id = V3OnionServiceId::from_private_key(\u0026alice_private_key);\n\n    println!(\n        \"Starting Alice gosling context ({})\",\n        alice_service_id.to_string()\n    );\n\n    let mut alice = Context::new(\n        alice_tor_client,\n        420,\n        420,\n        std::time::Duration::from_secs(60),\n        4096,\n        None,\n        alice_private_key,\n    )?;\n    alice.bootstrap()?;\n\n    let mut bootstrap_complete = false;\n    while !bootstrap_complete {\n        for event in alice.update()?.drain(..) {\n            match event {\n                ContextEvent::TorBootstrapStatusReceived {\n                    progress,\n                    tag,\n                    summary,\n                } =\u003e println!(\n                    \"Alice BootstrapStatus: {{ progress: {}, tag: {}, summary: '{}' }}\",\n                    progress, tag, summary\n                ),\n                ContextEvent::TorBootstrapCompleted =\u003e {\n                    println!(\"Alice Bootstrap Complete!\");\n                    bootstrap_complete = true;\n                }\n                ContextEvent::TorLogReceived { line } =\u003e {\n                    println!(\"--- ALICE --- {}\", line);\n                }\n                _ =\u003e {}\n            }\n        }\n    }\n\n    // Bootstrap Pat\n    let pat_private_key = Ed25519PrivateKey::generate();\n    let pat_service_id = V3OnionServiceId::from_private_key(\u0026pat_private_key);\n\n    println!(\n        \"Starting Pat gosling context ({})\",\n        pat_service_id.to_string()\n    );\n    let mut pat = Context::new(\n        pat_tor_client,\n        420,\n        420,\n        std::time::Duration::from_secs(60),\n        4096,\n        None,\n        pat_private_key,\n    )?;\n    pat.bootstrap()?;\n\n    let mut bootstrap_complete = false;\n    while !bootstrap_complete {\n        for event in pat.update()?.drain(..) {\n            match event {\n                ContextEvent::TorBootstrapStatusReceived {\n                    progress,\n                    tag,\n                    summary,\n                } =\u003e println!(\n                    \"Pat BootstrapStatus: {{ progress: {}, tag: {}, summary: '{}' }}\",\n                    progress, tag, summary\n                ),\n                ContextEvent::TorBootstrapCompleted =\u003e {\n                    println!(\"Pat Bootstrap Complete!\");\n                    bootstrap_complete = true;\n                }\n                ContextEvent::TorLogReceived { line } =\u003e {\n                    println!(\"--- PAT --- {}\", line);\n                }\n                _ =\u003e {}\n            }\n        }\n    }\n\n    // Start the Alice identity server\n    println!(\"Alice identity server starting\");\n    alice.identity_server_start()?;\n    let mut alice_identity_published: bool = false;\n\n    while !alice_identity_published {\n        for event in alice.update()?.drain(..) {\n            match event {\n                ContextEvent::IdentityServerPublished =\u003e {\n                    alice_identity_published = true;\n                    println!(\"Alice identity server published\");\n                }\n                ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                evt =\u003e bail!(\"alice.update() returned unexpected event: {:?}\", evt),\n            }\n        }\n    }\n\n    // Pat begins client handshake\n    println!(\"Pat identity client handshake begin\");\n    let mut pat_identity_handshake_handle: HandshakeHandle = INVALID_HANDSHAKE_HANDLE;\n    {\n        let mut pat_identity_handshake_tries_remaining = 3;\n        while pat_identity_handshake_tries_remaining \u003e 0\n            \u0026\u0026 pat_identity_handshake_handle == INVALID_HANDSHAKE_HANDLE\n        {\n            match pat.identity_client_begin_handshake(\n                alice_service_id.clone(),\n                \"test_endpoint\".to_string(),\n            ) {\n                Ok(handle) =\u003e {\n                    pat_identity_handshake_handle = handle;\n                }\n                Err(err) =\u003e {\n                    println!(\n                        \"Pat connecting to Alice's identity server failed with: {:?}\",\n                        err\n                    );\n                    pat_identity_handshake_tries_remaining -= 1;\n                }\n            }\n        }\n\n        if pat_identity_handshake_tries_remaining == 0 {\n            bail!(\"pat.identity_client_handshake() failed no more retries remain\");\n        }\n    }\n\n    // Alice waits for handshake start\n    let mut alice_identity_handshake_handle: HandshakeHandle = INVALID_HANDSHAKE_HANDLE;\n    println!(\"Alice waits for identity handshake start\");\n    {\n        let mut alice_identity_server_endpoint_request_received: bool = false;\n        while !alice_identity_server_endpoint_request_received {\n            for event in alice.update()?.drain(..) {\n                match event {\n                    ContextEvent::IdentityServerHandshakeStarted { handle } =\u003e {\n                        alice_identity_handshake_handle = handle;\n                        println!(\"Pat has connected to Alice identity server\");\n                    }\n                    ContextEvent::IdentityServerEndpointRequestReceived {\n                        handle,\n                        client_service_id,\n                        requested_endpoint,\n                    } =\u003e {\n                        assert_eq!(alice_identity_handshake_handle, handle);\n                        assert_eq!(pat_service_id, client_service_id);\n                        assert_eq!(requested_endpoint, \"test_endpoint\");\n                        alice_identity_server_endpoint_request_received = true;\n                        println!(\"Alice receives initial identity handshake request\");\n                    }\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"alice.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n            for event in pat.update()?.drain(..) {\n                match event {\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"pat.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n        }\n    }\n\n    // Alice sends challenge\n    println!(\"Alice sends identity server challenge\");\n    alice.identity_server_handle_endpoint_request_received(\n        alice_identity_handshake_handle,\n        true,\n        true,\n        doc! {},\n    )?;\n\n    // Pat responds to challenge\n    println!(\"Pat waits for server challenge\");\n    {\n        let mut pat_identity_client_challenge: Option\u003cbson::document::Document\u003e = None;\n        while pat_identity_client_challenge.is_none() {\n            for event in pat.update()?.drain(..) {\n                match event {\n                    ContextEvent::IdentityClientChallengeReceived {\n                        handle,\n                        endpoint_challenge,\n                    } =\u003e {\n                        assert_eq!(handle, pat_identity_handshake_handle);\n                        pat_identity_client_challenge = Some(endpoint_challenge);\n                    }\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"pat.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n            for event in alice.update()?.drain(..) {\n                match event {\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"alice.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n        }\n\n        println!(\"Pat responds to challenge\");\n        if let Some(challenge) = pat_identity_client_challenge {\n            assert_eq!(challenge, doc! {});\n            // send empty doc in response\n            pat.identity_client_handle_challenge_received(pat_identity_handshake_handle, doc! {})?;\n        } else {\n            bail!(\"missing pat_identity_client_challenge\");\n        }\n    }\n\n    // Alice evaluate challenge response\n    println!(\"Alice awaits challenge response\");\n    {\n        let mut alice_identity_server_challenge_response: Option\u003cbson::document::Document\u003e = None;\n        while alice_identity_server_challenge_response.is_none() {\n            for event in alice.update()?.drain(..) {\n                match event {\n                    ContextEvent::IdentityServerChallengeResponseReceived {\n                        handle,\n                        challenge_response,\n                    } =\u003e {\n                        assert_eq!(handle, alice_identity_handshake_handle);\n                        alice_identity_server_challenge_response = Some(challenge_response);\n                    }\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"alice.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n            for event in pat.update()?.drain(..) {\n                match event {\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"pat.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n        }\n        println!(\"Alice evaluates challenge response\");\n        if let Some(challenge_response) = alice_identity_server_challenge_response {\n            assert_eq!(challenge_response, doc! {});\n            println!(\"Alice accepts challenge response\");\n            alice.identity_server_handle_challenge_response_received(\n                alice_identity_handshake_handle,\n                true,\n            )?;\n        } else {\n            bail!(\"missing challenge response\");\n        }\n    }\n\n    // Alice and Pat awaits handshake results\n    println!(\"Identity handshake completing\");\n    let (\n        alice_endpoint_private_key,\n        alice_endpoint_service_id,\n        pat_auth_private_key,\n        pat_auth_public_key,\n    ) = {\n        let mut alice_endpoint_private_key: Option\u003cEd25519PrivateKey\u003e = None;\n        let mut alice_endpoint_service_id: Option\u003cV3OnionServiceId\u003e = None;\n        let mut pat_auth_private_key: Option\u003cX25519PrivateKey\u003e = None;\n        let mut pat_auth_public_key: Option\u003cX25519PublicKey\u003e = None;\n\n        let mut pat_identity_client_handshake_completed: bool = false;\n        let mut alice_identity_server_hanshake_completed: bool = false;\n        while !pat_identity_client_handshake_completed || !alice_identity_server_hanshake_completed\n        {\n            for event in alice.update()?.drain(..) {\n                match event {\n                    ContextEvent::IdentityServerHandshakeCompleted {\n                        handle,\n                        endpoint_private_key,\n                        endpoint_name,\n                        client_service_id,\n                        client_auth_public_key,\n                    } =\u003e {\n                        assert_eq!(handle, alice_identity_handshake_handle);\n                        alice_endpoint_private_key = Some(endpoint_private_key);\n                        assert_eq!(endpoint_name, \"test_endpoint\");\n                        assert_eq!(client_service_id, pat_service_id);\n                        pat_auth_public_key = Some(client_auth_public_key);\n                        alice_identity_server_hanshake_completed = true;\n                    }\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"alice.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n            for event in pat.update()?.drain(..) {\n                match event {\n                    ContextEvent::IdentityClientHandshakeCompleted {\n                        handle,\n                        identity_service_id,\n                        endpoint_service_id,\n                        endpoint_name,\n                        client_auth_private_key,\n                    } =\u003e {\n                        assert_eq!(handle, pat_identity_handshake_handle);\n                        assert_eq!(identity_service_id, alice_service_id);\n                        assert_eq!(endpoint_name, \"test_endpoint\");\n                        alice_endpoint_service_id = Some(endpoint_service_id);\n                        pat_auth_private_key = Some(client_auth_private_key);\n                        pat_identity_client_handshake_completed = true;\n                    }\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"pat.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n        }\n\n        // verify the private key returned by alice matches service id returned by pat\n        assert_eq!(\n            V3OnionServiceId::from_private_key(alice_endpoint_private_key.as_ref().unwrap()),\n            *alice_endpoint_service_id.as_ref().unwrap()\n        );\n\n        (\n            alice_endpoint_private_key.unwrap(),\n            alice_endpoint_service_id.unwrap(),\n            pat_auth_private_key.unwrap(),\n            pat_auth_public_key.unwrap(),\n        )\n    };\n\n    // Alice starts endpoint server\n    println!(\"Alice endpoint server starting\");\n    alice.endpoint_server_start(\n        alice_endpoint_private_key,\n        \"test_endpoint\".to_string(),\n        pat_service_id.clone(),\n        pat_auth_public_key.clone(),\n    )?;\n    {\n        let mut alice_endpoint_server_published: bool = false;\n        while !alice_endpoint_server_published {\n            for event in alice.update()?.drain(..) {\n                match event {\n                    ContextEvent::EndpointServerPublished {\n                        endpoint_service_id,\n                        endpoint_name,\n                    } =\u003e {\n                        assert_eq!(endpoint_service_id, alice_endpoint_service_id);\n                        assert_eq!(endpoint_name, \"test_endpoint\");\n                        println!(\"Alice endpoint server published\");\n                        alice_endpoint_server_published = true;\n                    }\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"alice.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n        }\n    }\n\n    // Pat begins client handshake\n    println!(\"Pat endpoint client handshake begin\");\n    let mut pat_endpoint_handshake_handle: HandshakeHandle = INVALID_HANDSHAKE_HANDLE;\n    {\n        let mut pat_endpoint_handshake_tries_remaining = 3;\n        while pat_endpoint_handshake_tries_remaining \u003e 0\n            \u0026\u0026 pat_endpoint_handshake_handle == INVALID_HANDSHAKE_HANDLE\n        {\n            match pat.endpoint_client_begin_handshake(\n                alice_endpoint_service_id.clone(),\n                pat_auth_private_key.clone(),\n                \"test_channel\".to_string(),\n            ) {\n                Ok(handle) =\u003e {\n                    pat_endpoint_handshake_handle = handle;\n                }\n                Err(err) =\u003e {\n                    println!(\n                        \"Pat connecting to Alice's identity server failed with:\\n{:?}\",\n                        err\n                    );\n                    pat_endpoint_handshake_tries_remaining -= 1;\n                }\n            }\n        }\n\n        if pat_endpoint_handshake_tries_remaining == 0 {\n            bail!(\"pat.endpoint_client_begin_handshake() failed no more retries remain\");\n        }\n    }\n\n    // Alice waits for handshake start\n    let mut alice_endpoint_server_handshake_handle: HandshakeHandle = INVALID_HANDSHAKE_HANDLE;\n    println!(\"Alice waits for endpoint handshake to start\");\n    {\n        let mut alice_endpoint_server_request_recieved: bool = false;\n        while !alice_endpoint_server_request_recieved {\n            for event in alice.update()?.drain(..) {\n                match event {\n                    ContextEvent::EndpointServerHandshakeStarted { handle } =\u003e {\n                        alice_endpoint_server_handshake_handle = handle;\n                        println!(\"Pat has connected to Alice endpoint server\")\n                    }\n                    ContextEvent::EndpointServerChannelRequestReceived {\n                        handle,\n                        client_service_id,\n                        requested_channel,\n                    } =\u003e {\n                        assert_eq!(handle, alice_endpoint_server_handshake_handle);\n                        assert_eq!(client_service_id, pat_service_id);\n                        assert_eq!(requested_channel, \"test_channel\");\n                        alice_endpoint_server_request_recieved = true;\n                        println!(\"Pat requesting '{0}' endpoint channel\", requested_channel);\n                    }\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"alice.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n            for event in pat.update()?.drain(..) {\n                match event {\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"pat.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n        }\n\n        // Alice sends handshake response\n        println!(\"Alice sends endpoint handshake response\");\n        alice.endpoint_server_handle_channel_request_received(\n            alice_endpoint_server_handshake_handle,\n            true,\n        )?;\n    }\n\n    // Alice and Pat await hndshake result\n    println!(\"Endpoint handshake completing\");\n    let (alice_server_stream, mut pat_client_stream) = {\n        let mut alice_server_stream: Option\u003cTcpStream\u003e = None;\n        let mut pat_client_stream: Option\u003cTcpStream\u003e = None;\n\n        let mut pat_endpoint_client_handshake_completed: bool = false;\n        let mut alice_endpoint_server_handshake_completed: bool = false;\n\n        while !pat_endpoint_client_handshake_completed || !alice_endpoint_server_handshake_completed\n        {\n            for event in alice.update()?.drain(..) {\n                match event {\n                    ContextEvent::EndpointServerHandshakeCompleted {\n                        handle,\n                        endpoint_service_id,\n                        client_service_id,\n                        channel_name,\n                        stream,\n                    } =\u003e {\n                        assert_eq!(handle, alice_endpoint_server_handshake_handle);\n                        assert_eq!(endpoint_service_id, alice_endpoint_service_id);\n                        assert_eq!(client_service_id, pat_service_id);\n                        assert_eq!(channel_name, \"test_channel\");\n                        alice_server_stream = Some(stream);\n                        alice_endpoint_server_handshake_completed = true;\n                    }\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    event =\u003e bail!(\"alice.update() returned unexepcted event: {:?}\", event),\n                }\n            }\n            for event in pat.update()?.drain(..) {\n                match event {\n                    ContextEvent::EndpointClientHandshakeCompleted {\n                        handle,\n                        endpoint_service_id,\n                        channel_name,\n                        stream,\n                    } =\u003e {\n                        assert_eq!(handle, pat_endpoint_handshake_handle);\n                        assert_eq!(endpoint_service_id, alice_endpoint_service_id);\n                        assert_eq!(channel_name, \"test_channel\");\n                        pat_client_stream = Some(stream);\n                        pat_endpoint_client_handshake_completed = true;\n                    }\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    event =\u003e bail!(\"pat.update() returned unexepcted event: {:?}\", event),\n                }\n            }\n        }\n        (alice_server_stream.unwrap(), pat_client_stream.unwrap())\n    };\n\n    println!(\"Endpoint handshake complete, TcpStreams returned\");\n\n    pat_client_stream.write(b\"Hello World!\\n\")?;\n    pat_client_stream.flush()?;\n\n    alice_server_stream.set_nonblocking(false)?;\n    let mut alice_reader = BufReader::new(alice_server_stream);\n\n    let mut response: String = Default::default();\n    alice_reader.read_line(\u0026mut response)?;\n\n    assert_eq!(response, \"Hello World!\\n\");\n\n    println!(\"TcpStream communication succesful\");\n\n    Ok(())\n}\n","traces":[{"line":63,"address":[1568192,1571677,1609144],"length":1,"stats":{"Line":0}},{"line":68,"address":[1568261],"length":1,"stats":{"Line":0}},{"line":69,"address":[1568649],"length":1,"stats":{"Line":0}},{"line":71,"address":[1568861],"length":1,"stats":{"Line":0}},{"line":77,"address":[1568993],"length":1,"stats":{"Line":0}},{"line":80,"address":[1569046],"length":1,"stats":{"Line":0}},{"line":82,"address":[1569109],"length":1,"stats":{"Line":0}},{"line":83,"address":[1569120],"length":1,"stats":{"Line":0}},{"line":85,"address":[1569444,1569687,1608971,1569733],"length":1,"stats":{"Line":0}},{"line":87,"address":[1569720],"length":1,"stats":{"Line":0}},{"line":88,"address":[1569728,1569894],"length":1,"stats":{"Line":0}},{"line":89,"address":[1570409,1570462,1569969,1572014,1569904,1570313,1572087],"length":1,"stats":{"Line":0}},{"line":90,"address":[1570516],"length":1,"stats":{"Line":0}},{"line":91,"address":[1570783],"length":1,"stats":{"Line":0}},{"line":99,"address":[1571713],"length":1,"stats":{"Line":0}},{"line":100,"address":[1570954,1571686],"length":1,"stats":{"Line":0}},{"line":101,"address":[1571705],"length":1,"stats":{"Line":0}},{"line":103,"address":[1570983],"length":1,"stats":{"Line":0}},{"line":104,"address":[1571762],"length":1,"stats":{"Line":0}},{"line":112,"address":[1569931],"length":1,"stats":{"Line":0}},{"line":113,"address":[1572117],"length":1,"stats":{"Line":0}},{"line":115,"address":[1572193],"length":1,"stats":{"Line":0}},{"line":120,"address":[1572464],"length":1,"stats":{"Line":0}},{"line":123,"address":[1572517],"length":1,"stats":{"Line":0}},{"line":125,"address":[1572580],"length":1,"stats":{"Line":0}},{"line":126,"address":[1572591],"length":1,"stats":{"Line":0}},{"line":128,"address":[1573158,1573204,1608875,1572915],"length":1,"stats":{"Line":0}},{"line":130,"address":[1573191],"length":1,"stats":{"Line":0}},{"line":131,"address":[1573199,1573365],"length":1,"stats":{"Line":0}},{"line":132,"address":[1573375,1573791,1573940,1573447,1573887,1575480,1575553],"length":1,"stats":{"Line":0}},{"line":133,"address":[1573994],"length":1,"stats":{"Line":0}},{"line":134,"address":[1574191],"length":1,"stats":{"Line":0}},{"line":142,"address":[1575182],"length":1,"stats":{"Line":0}},{"line":143,"address":[1575155,1574432],"length":1,"stats":{"Line":0}},{"line":144,"address":[1575174],"length":1,"stats":{"Line":0}},{"line":146,"address":[1574461],"length":1,"stats":{"Line":0}},{"line":147,"address":[1575228],"length":1,"stats":{"Line":0}},{"line":155,"address":[1573402,1575583],"length":1,"stats":{"Line":0}},{"line":156,"address":[1608854,1575602,1575691],"length":1,"stats":{"Line":0}},{"line":157,"address":[1575678],"length":1,"stats":{"Line":0}},{"line":159,"address":[1575686,1575852],"length":1,"stats":{"Line":0}},{"line":160,"address":[1576278,1575862,1575934,1576833,1577137,1576424,1576374],"length":1,"stats":{"Line":0}},{"line":161,"address":[1576462],"length":1,"stats":{"Line":0}},{"line":163,"address":[1576729],"length":1,"stats":{"Line":0}},{"line":164,"address":[1576737,1576804],"length":1,"stats":{"Line":0}},{"line":167,"address":[1577000,1576561,1576838],"length":1,"stats":{"Line":0}},{"line":173,"address":[1575889,1577150],"length":1,"stats":{"Line":0}},{"line":174,"address":[1577169],"length":1,"stats":{"Line":0}},{"line":176,"address":[1577181],"length":1,"stats":{"Line":0}},{"line":177,"address":[1577192],"length":1,"stats":{"Line":0}},{"line":178,"address":[1577214],"length":1,"stats":{"Line":0}},{"line":180,"address":[1608425],"length":1,"stats":{"Line":0}},{"line":181,"address":[1577241],"length":1,"stats":{"Line":0}},{"line":182,"address":[1608398],"length":1,"stats":{"Line":0}},{"line":184,"address":[1608494],"length":1,"stats":{"Line":0}},{"line":185,"address":[1608510],"length":1,"stats":{"Line":0}},{"line":187,"address":[1608523],"length":1,"stats":{"Line":0}},{"line":188,"address":[1608705],"length":1,"stats":{"Line":0}},{"line":192,"address":[1608825,1608774],"length":1,"stats":{"Line":0}},{"line":197,"address":[1577202],"length":1,"stats":{"Line":0}},{"line":198,"address":[1577251,1577323],"length":1,"stats":{"Line":0}},{"line":203,"address":[1577277],"length":1,"stats":{"Line":0}},{"line":204,"address":[1577367,1577289],"length":1,"stats":{"Line":0}},{"line":206,"address":[1577386],"length":1,"stats":{"Line":0}},{"line":207,"address":[1577394],"length":1,"stats":{"Line":0}},{"line":208,"address":[1580118,1577916,1577969,1577820,1577476,1580488,1577404],"length":1,"stats":{"Line":0}},{"line":209,"address":[1578007],"length":1,"stats":{"Line":0}},{"line":210,"address":[1579392],"length":1,"stats":{"Line":0}},{"line":211,"address":[1579408],"length":1,"stats":{"Line":0}},{"line":212,"address":[1579416,1579636],"length":1,"stats":{"Line":0}},{"line":214,"address":[1579461],"length":1,"stats":{"Line":0}},{"line":219,"address":[1579660,1579539],"length":1,"stats":{"Line":0}},{"line":220,"address":[1579829,1579738],"length":1,"stats":{"Line":0}},{"line":221,"address":[1579909],"length":1,"stats":{"Line":0}},{"line":222,"address":[1580027],"length":1,"stats":{"Line":0}},{"line":223,"address":[1580035],"length":1,"stats":{"Line":0}},{"line":226,"address":[1579194,1580307,1580142],"length":1,"stats":{"Line":0}},{"line":229,"address":[1578513,1578126,1578609,1578659,1579181],"length":1,"stats":{"Line":0}},{"line":230,"address":[1578685],"length":1,"stats":{"Line":0}},{"line":232,"address":[1578771,1579074,1578909],"length":1,"stats":{"Line":0}},{"line":239,"address":[1577431,1580501],"length":1,"stats":{"Line":0}},{"line":240,"address":[1580563,1608385,1580813],"length":1,"stats":{"Line":0}},{"line":241,"address":[1580520],"length":1,"stats":{"Line":0}},{"line":244,"address":[1580536],"length":1,"stats":{"Line":0}},{"line":248,"address":[1580846,1580656],"length":1,"stats":{"Line":0}},{"line":250,"address":[1580865],"length":1,"stats":{"Line":0}},{"line":251,"address":[1580986,1580899],"length":1,"stats":{"Line":0}},{"line":252,"address":[1605922,1607865,1608286,1605435,1605776,1581018,1605872],"length":1,"stats":{"Line":0}},{"line":253,"address":[1605960],"length":1,"stats":{"Line":0}},{"line":254,"address":[1607307],"length":1,"stats":{"Line":0}},{"line":258,"address":[1607361],"length":1,"stats":{"Line":0}},{"line":259,"address":[1607484,1607744],"length":1,"stats":{"Line":0}},{"line":262,"address":[1608089,1607927,1607109],"length":1,"stats":{"Line":0}},{"line":265,"address":[1606533,1606053,1606437,1606583,1607096],"length":1,"stats":{"Line":0}},{"line":266,"address":[1606609],"length":1,"stats":{"Line":0}},{"line":268,"address":[1606998,1606695,1606833],"length":1,"stats":{"Line":0}},{"line":273,"address":[1580992,1581048],"length":1,"stats":{"Line":0}},{"line":274,"address":[1581067],"length":1,"stats":{"Line":0}},{"line":275,"address":[1581206,1581306],"length":1,"stats":{"Line":0}},{"line":277,"address":[1605305,1581635,1581486],"length":1,"stats":{"Line":0}},{"line":279,"address":[1605384,1581225],"length":1,"stats":{"Line":0}},{"line":284,"address":[1581804],"length":1,"stats":{"Line":0}},{"line":286,"address":[1581849],"length":1,"stats":{"Line":0}},{"line":287,"address":[1581970,1581883],"length":1,"stats":{"Line":0}},{"line":288,"address":[1602693,1602789,1604782,1605206,1582002,1602839,1602349],"length":1,"stats":{"Line":0}},{"line":289,"address":[1602877],"length":1,"stats":{"Line":0}},{"line":290,"address":[1604224],"length":1,"stats":{"Line":0}},{"line":294,"address":[1604278],"length":1,"stats":{"Line":0}},{"line":295,"address":[1604401,1604661],"length":1,"stats":{"Line":0}},{"line":298,"address":[1604026,1605006,1604844],"length":1,"stats":{"Line":0}},{"line":301,"address":[1603354,1603500,1604013,1602970,1603450],"length":1,"stats":{"Line":0}},{"line":302,"address":[1603526],"length":1,"stats":{"Line":0}},{"line":304,"address":[1603612,1603750,1603915],"length":1,"stats":{"Line":0}},{"line":308,"address":[1582032,1581976],"length":1,"stats":{"Line":0}},{"line":309,"address":[1582051],"length":1,"stats":{"Line":0}},{"line":310,"address":[1582190,1582290],"length":1,"stats":{"Line":0}},{"line":311,"address":[1582470],"length":1,"stats":{"Line":0}},{"line":312,"address":[1602213,1582754,1582523],"length":1,"stats":{"Line":0}},{"line":313,"address":[1582515],"length":1,"stats":{"Line":0}},{"line":317,"address":[1582209,1602292],"length":1,"stats":{"Line":0}},{"line":322,"address":[1582795],"length":1,"stats":{"Line":0}},{"line":324,"address":[1588877],"length":1,"stats":{"Line":0}},{"line":325,"address":[1588895],"length":1,"stats":{"Line":0}},{"line":326,"address":[1588959],"length":1,"stats":{"Line":0}},{"line":327,"address":[1588991],"length":1,"stats":{"Line":0}},{"line":329,"address":[1582840],"length":1,"stats":{"Line":0}},{"line":330,"address":[1582860],"length":1,"stats":{"Line":0}},{"line":331,"address":[1582868],"length":1,"stats":{"Line":0}},{"line":332,"address":[1582884],"length":1,"stats":{"Line":0}},{"line":334,"address":[1582892],"length":1,"stats":{"Line":0}},{"line":335,"address":[1582900],"length":1,"stats":{"Line":0}},{"line":336,"address":[1582908,1582945],"length":1,"stats":{"Line":0}},{"line":338,"address":[1583482,1583386,1587672,1583532,1587242,1582918,1583042],"length":1,"stats":{"Line":0}},{"line":339,"address":[1583570],"length":1,"stats":{"Line":0}},{"line":340,"address":[1586358],"length":1,"stats":{"Line":0}},{"line":347,"address":[1586422],"length":1,"stats":{"Line":0}},{"line":348,"address":[1586716,1586545],"length":1,"stats":{"Line":0}},{"line":349,"address":[1586820],"length":1,"stats":{"Line":0}},{"line":350,"address":[1586946],"length":1,"stats":{"Line":0}},{"line":351,"address":[1587066],"length":1,"stats":{"Line":0}},{"line":352,"address":[1587152],"length":1,"stats":{"Line":0}},{"line":355,"address":[1587466,1586025,1587304],"length":1,"stats":{"Line":0}},{"line":358,"address":[1584202,1583669,1584056,1585592,1584152,1586015],"length":1,"stats":{"Line":0}},{"line":359,"address":[1584240],"length":1,"stats":{"Line":0}},{"line":360,"address":[1584553],"length":1,"stats":{"Line":0}},{"line":367,"address":[1584733],"length":1,"stats":{"Line":0}},{"line":368,"address":[1584864,1584950],"length":1,"stats":{"Line":0}},{"line":369,"address":[1585033],"length":1,"stats":{"Line":0}},{"line":370,"address":[1585151],"length":1,"stats":{"Line":0}},{"line":371,"address":[1585287],"length":1,"stats":{"Line":0}},{"line":372,"address":[1585497],"length":1,"stats":{"Line":0}},{"line":375,"address":[1584339,1585654,1585819],"length":1,"stats":{"Line":0}},{"line":381,"address":[1587874],"length":1,"stats":{"Line":0}},{"line":387,"address":[1588110],"length":1,"stats":{"Line":0}},{"line":388,"address":[1588205],"length":1,"stats":{"Line":0}},{"line":389,"address":[1588345],"length":1,"stats":{"Line":0}},{"line":390,"address":[1588481],"length":1,"stats":{"Line":0}},{"line":395,"address":[1589023,1589093],"length":1,"stats":{"Line":0}},{"line":396,"address":[1589318,1589599,1589425,1602073],"length":1,"stats":{"Line":0}},{"line":397,"address":[1589112],"length":1,"stats":{"Line":0}},{"line":398,"address":[1589226,1589158],"length":1,"stats":{"Line":0}},{"line":399,"address":[1589250],"length":1,"stats":{"Line":0}},{"line":400,"address":[1589311],"length":1,"stats":{"Line":0}},{"line":403,"address":[1589458],"length":1,"stats":{"Line":0}},{"line":404,"address":[1589466,1589632],"length":1,"stats":{"Line":0}},{"line":405,"address":[1591451,1589714,1590154,1590204,1589642,1590058,1591065],"length":1,"stats":{"Line":0}},{"line":406,"address":[1590242],"length":1,"stats":{"Line":0}},{"line":407,"address":[1590539],"length":1,"stats":{"Line":0}},{"line":411,"address":[1590732,1590643],"length":1,"stats":{"Line":0}},{"line":412,"address":[1590815],"length":1,"stats":{"Line":0}},{"line":413,"address":[1590933],"length":1,"stats":{"Line":0}},{"line":414,"address":[1590978],"length":1,"stats":{"Line":0}},{"line":417,"address":[1591089,1590341,1591251],"length":1,"stats":{"Line":0}},{"line":424,"address":[1589669,1591461],"length":1,"stats":{"Line":0}},{"line":425,"address":[1591480],"length":1,"stats":{"Line":0}},{"line":427,"address":[1591492],"length":1,"stats":{"Line":0}},{"line":428,"address":[1591503],"length":1,"stats":{"Line":0}},{"line":429,"address":[1591525],"length":1,"stats":{"Line":0}},{"line":431,"address":[1601659,1601592],"length":1,"stats":{"Line":0}},{"line":432,"address":[1591552],"length":1,"stats":{"Line":0}},{"line":433,"address":[1601509],"length":1,"stats":{"Line":0}},{"line":434,"address":[1601524],"length":1,"stats":{"Line":0}},{"line":436,"address":[1601685],"length":1,"stats":{"Line":0}},{"line":437,"address":[1601701],"length":1,"stats":{"Line":0}},{"line":439,"address":[1601714],"length":1,"stats":{"Line":0}},{"line":440,"address":[1601896],"length":1,"stats":{"Line":0}},{"line":444,"address":[1601965,1602022],"length":1,"stats":{"Line":0}},{"line":449,"address":[1591513],"length":1,"stats":{"Line":0}},{"line":450,"address":[1591562,1591634],"length":1,"stats":{"Line":0}},{"line":455,"address":[1591588],"length":1,"stats":{"Line":0}},{"line":456,"address":[1591678,1591600],"length":1,"stats":{"Line":0}},{"line":458,"address":[1591697],"length":1,"stats":{"Line":0}},{"line":459,"address":[1591705],"length":1,"stats":{"Line":0}},{"line":460,"address":[1591787,1592131,1594567,1591715,1592280,1592227,1594937],"length":1,"stats":{"Line":0}},{"line":461,"address":[1592318],"length":1,"stats":{"Line":0}},{"line":462,"address":[1593703],"length":1,"stats":{"Line":0}},{"line":463,"address":[1593719],"length":1,"stats":{"Line":0}},{"line":464,"address":[1593727,1593947],"length":1,"stats":{"Line":0}},{"line":466,"address":[1593802],"length":1,"stats":{"Line":0}},{"line":471,"address":[1593850,1593971],"length":1,"stats":{"Line":0}},{"line":472,"address":[1594052,1594141],"length":1,"stats":{"Line":0}},{"line":473,"address":[1594224],"length":1,"stats":{"Line":0}},{"line":474,"address":[1594342],"length":1,"stats":{"Line":0}},{"line":475,"address":[1594460],"length":1,"stats":{"Line":0}},{"line":478,"address":[1593505,1594756,1594591],"length":1,"stats":{"Line":0}},{"line":481,"address":[1592970,1593492,1592437,1592920,1592824],"length":1,"stats":{"Line":0}},{"line":482,"address":[1592996],"length":1,"stats":{"Line":0}},{"line":484,"address":[1593082,1593220,1593385],"length":1,"stats":{"Line":0}},{"line":490,"address":[1591742,1594950],"length":1,"stats":{"Line":0}},{"line":491,"address":[1594977,1601480,1595215],"length":1,"stats":{"Line":0}},{"line":492,"address":[1594969],"length":1,"stats":{"Line":0}},{"line":498,"address":[1595248,1595058],"length":1,"stats":{"Line":0}},{"line":499,"address":[1599939],"length":1,"stats":{"Line":0}},{"line":500,"address":[1595267],"length":1,"stats":{"Line":0}},{"line":501,"address":[1595286],"length":1,"stats":{"Line":0}},{"line":503,"address":[1595305],"length":1,"stats":{"Line":0}},{"line":504,"address":[1595313],"length":1,"stats":{"Line":0}},{"line":506,"address":[1595321,1595361],"length":1,"stats":{"Line":0}},{"line":508,"address":[1599679,1595513,1595857,1595953,1596003,1599271,1595331],"length":1,"stats":{"Line":0}},{"line":509,"address":[1596041],"length":1,"stats":{"Line":0}},{"line":510,"address":[1598376],"length":1,"stats":{"Line":0}},{"line":517,"address":[1598522],"length":1,"stats":{"Line":0}},{"line":518,"address":[1598653,1598739],"length":1,"stats":{"Line":0}},{"line":519,"address":[1598822],"length":1,"stats":{"Line":0}},{"line":520,"address":[1598950],"length":1,"stats":{"Line":0}},{"line":521,"address":[1599068],"length":1,"stats":{"Line":0}},{"line":522,"address":[1599176],"length":1,"stats":{"Line":0}},{"line":525,"address":[1599333,1598178,1599498],"length":1,"stats":{"Line":0}},{"line":528,"address":[1596623,1596673,1596140,1596527,1597745,1598168],"length":1,"stats":{"Line":0}},{"line":529,"address":[1596711],"length":1,"stats":{"Line":0}},{"line":530,"address":[1597102],"length":1,"stats":{"Line":0}},{"line":536,"address":[1597124],"length":1,"stats":{"Line":0}},{"line":537,"address":[1597255,1597341],"length":1,"stats":{"Line":0}},{"line":538,"address":[1597424],"length":1,"stats":{"Line":0}},{"line":539,"address":[1597542],"length":1,"stats":{"Line":0}},{"line":540,"address":[1597650],"length":1,"stats":{"Line":0}},{"line":543,"address":[1597807,1597972,1596810],"length":1,"stats":{"Line":0}},{"line":547,"address":[1599865,1595371,1599776],"length":1,"stats":{"Line":0}},{"line":550,"address":[1600031,1599961],"length":1,"stats":{"Line":0}},{"line":552,"address":[1601362,1600050,1600222],"length":1,"stats":{"Line":0}},{"line":553,"address":[1600271,1600207,1600364,1601344],"length":1,"stats":{"Line":0}},{"line":555,"address":[1601326,1600507,1568229,1600335,1600413],"length":1,"stats":{"Line":0}},{"line":556,"address":[1600477],"length":1,"stats":{"Line":0}},{"line":558,"address":[1600556],"length":1,"stats":{"Line":0}},{"line":559,"address":[1601257,1600619,1600830,1600699],"length":1,"stats":{"Line":0}},{"line":561,"address":[1600793,1600878],"length":1,"stats":{"Line":0}},{"line":563,"address":[1600952],"length":1,"stats":{"Line":0}},{"line":565,"address":[1600997],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":248},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","honk-rpc","fuzz","fuzz_targets","fuzz_session.rs"],"content":"#![no_main]\n\n// std\nuse std::collections::{BTreeSet, VecDeque};\nuse std::net::{SocketAddr, TcpListener, TcpStream};\n\n// honk_rpc\nuse honk_rpc::honk_rpc::{ApiSet, Error, ErrorCode, RequestCookie, Response, Session};\n\n// extern\nuse bson::Bson;\n\n// fuzzing\nuse libfuzzer_sys::fuzz_target;\nuse libfuzzer_sys::arbitrary;\nuse libfuzzer_sys::arbitrary::Arbitrary;\n\n#[derive(Arbitrary, Debug)]\nenum SessionMethod {\n    Update,\n    ClientCallSync,\n    ClientCallAsync {\n        // the number of update calls the ApiSet should wait before returning\n        wait_count: u8,\n    },\n    ClientCallInvalid{\n        namespace: Option\u003cString\u003e,\n        function: Option\u003cString\u003e,\n        version: Option\u003ci32\u003e,\n        // arguments: Option\u003cbson::document::Document\u003e,\n    },\n    ClientDrainResponses,\n}\n\n\n#[derive(Default)]\nstruct TestApiSet {\n    pending_async_calls: Vec\u003c(u8, RequestCookie)\u003e,\n    complete_async_calls: VecDeque\u003cRequestCookie\u003e,\n}\n\n// impl ApiSet\nimpl ApiSet for TestApiSet {\n    fn namespace(\u0026self) -\u003e \u0026str {\n        \"fuzzing\"\n    }\n\n    fn exec_function(\n        \u0026mut self,\n        name: \u0026str,\n        version: i32,\n        mut args: bson::document::Document,\n        request_cookie: Option\u003cRequestCookie\u003e) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n        match (name, version) {\n            (\"sync_call\", 0) =\u003e Some(Ok(Some(bson::Bson::Null))),\n            (\"sync_call\", _) =\u003e Some(Err(ErrorCode::RequestVersionInvalid)),\n            (\"async_call\", 0) =\u003e {\n                if let Some(request_cookie) = request_cookie {\n                    if let Some(bson::Bson::Int32(val)) = args.get_mut(\"wait_count\") {\n                        let \u0026mut val = val;\n                        let wait_count = val.clamp(0, 255) as u8;\n                        self.pending_async_calls.push((wait_count, request_cookie));\n                    }\n                }\n                None\n            },\n            (\"async_call\", _) =\u003e Some(Err(ErrorCode::RequestVersionInvalid)),\n            _ =\u003e Some(Err(ErrorCode::RequestFunctionInvalid)),\n        }\n    }\n\n    fn update(\u0026mut self) -\u003e () {\n        self.pending_async_calls.retain_mut(|record| -\u003e bool {\n            if record.0 == 0 {\n                self.complete_async_calls.push_back(record.1);\n                false\n            } else {\n                record.0 -= 1;\n                true\n            }\n        });\n    }\n\n    fn next_result(\u0026mut self) -\u003e Option\u003c(RequestCookie, Result\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e)\u003e {\n        match self.complete_async_calls.pop_front() {\n            Some(cookie) =\u003e Some((cookie, Ok(Some(bson::Bson::Null)))),\n            None =\u003e None\n        }\n    }\n}\n\n\nstruct Context {\n    session: Session\u003cTcpStream\u003e,\n    apiset: TestApiSet,\n    pending_successes: BTreeSet\u003cRequestCookie\u003e,\n    pending_failures: BTreeSet\u003cRequestCookie\u003e,\n}\n\nimpl Context {\n    fn new(session: Session\u003cTcpStream\u003e) -\u003e Context {\n        Context{session, apiset: Default::default(), pending_successes: Default::default(), pending_failures: Default::default()}\n    }\n}\n\nfuzz_target!(|methods: Vec\u003cSessionMethod\u003e| {\n    let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n    let listener = TcpListener::bind(socket_addr).unwrap();\n    let socket_addr = listener.local_addr().unwrap();\n\n    let alice_stream = TcpStream::connect(socket_addr).unwrap();\n    alice_stream.set_nonblocking(true).unwrap();\n\n    let (pat_stream, _socket_addr) = listener.accept().unwrap();\n    pat_stream.set_nonblocking(true).unwrap();\n\n    let alice = Session::new(alice_stream);\n    let pat = Session::new(pat_stream);\n\n    let mut current = \u0026mut Context::new(alice);\n    let mut next = \u0026mut Context::new(pat);\n\n    // run the methods on our pair of HonkRpc Sessions\n    for method in methods {\n        match method {\n            SessionMethod::Update =\u003e match current.session.update(Some(\u0026mut [\u0026mut current.apiset])) {\n                Ok(()) =\u003e {},\n                Err(Error::MessageConversionFailed(ErrorCode::RequestFunctionInvalid)) =\u003e {},\n                Err(error) =\u003e panic!(\"{:?}\", error),\n            },\n            SessionMethod::ClientCallSync =\u003e {\n                let cookie = current.session.client_call(\"fuzzing\", \"sync_call\", 0, bson::doc!{}).unwrap();\n                assert!(current.pending_successes.insert(cookie));\n            }\n            SessionMethod::ClientCallAsync{wait_count} =\u003e {\n                let cookie = current.session.client_call(\"fuzzing\", \"async_call\", 0, bson::doc!{\"wait_count\" : Bson::Int32(wait_count as i32)}).unwrap();\n                assert!(current.pending_successes.insert(cookie));\n            }\n            SessionMethod::ClientCallInvalid{namespace,function,version} =\u003e {\n                // ensure invalid namespace\n                let namespace = match namespace {\n                    Some(namespace) =\u003e namespace,\n                    None =\u003e \"invalid\".to_string(),\n                };\n                let namespace = match namespace.as_str() {\n                    \"fuzzing\" =\u003e \"invalid\",\n                    namespace =\u003e namespace,\n                };\n\n                // ensure invalid function name\n                let function = match function {\n                    Some(function) =\u003e function,\n                    None =\u003e \"invalid\".to_string(),\n                };\n                let function = match function.as_str() {\n                    \"sync_call\" =\u003e \"invalid\",\n                    \"async_call\" =\u003e \"invalid\",\n                    function =\u003e function,\n                };\n\n                // ensure invalid function version\n                let version = match version {\n                    Some(0) =\u003e 1,\n                    Some(version) =\u003e version,\n                    None =\u003e 1,\n                };\n\n                let cookie = current.session.client_call(namespace, function, version, bson::doc!{}).unwrap();\n                assert!(current.pending_failures.insert(cookie));\n            }\n            SessionMethod::ClientDrainResponses =\u003e {\n                for response in current.session.client_drain_responses() {\n                    match response {\n                        Response::Pending{cookie} =\u003e assert!(current.pending_successes.contains(\u0026cookie) || current.pending_failures.contains(\u0026cookie)),\n                        Response::Success{cookie, result: _} =\u003e assert!(current.pending_successes.remove(\u0026cookie)),\n                        Response::Error{cookie, error_code} =\u003e {\n                            assert!(current.pending_failures.remove(\u0026cookie));\n                            assert!(error_code == ErrorCode::RequestNamespaceInvalid ||\n                                    error_code == ErrorCode::RequestFunctionInvalid ||\n                                    error_code == ErrorCode::RequestVersionInvalid);\n                        }\n                    }\n                }\n            },\n        }\n        std::mem::swap(\u0026mut current, \u0026mut next);\n    }\n});\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","honk-rpc","src","byte_counter.rs"],"content":"use std::io::Write;\n\n#[derive(Default)]\npub(crate) struct ByteCounter {\n    bytes: usize,\n}\n\nimpl ByteCounter {\n    pub fn bytes(\u0026self) -\u003e usize {\n        self.bytes\n    }\n}\n\nimpl Write for ByteCounter {\n    fn write(\u0026mut self, buf: \u0026[u8]) -\u003e Result\u003cusize, std::io::Error\u003e {\n        self.bytes += buf.len();\n        Ok(buf.len())\n    }\n\n    fn flush(\u0026mut self) -\u003e Result\u003c(), std::io::Error\u003e {\n        Ok(())\n    }\n}\n","traces":[{"line":9,"address":[1702144],"length":1,"stats":{"Line":5}},{"line":10,"address":[14396581],"length":1,"stats":{"Line":5}},{"line":15,"address":[1340240],"length":1,"stats":{"Line":5}},{"line":16,"address":[14396621,14396681],"length":1,"stats":{"Line":5}},{"line":17,"address":[16447756],"length":1,"stats":{"Line":5}},{"line":20,"address":[3173840],"length":1,"stats":{"Line":0}},{"line":21,"address":[3173845],"length":1,"stats":{"Line":0}}],"covered":5,"coverable":7},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","honk-rpc","src","honk_rpc.rs"],"content":"// standard\nuse std::collections::VecDeque;\nuse std::fmt::Debug;\nuse std::io::{Cursor, ErrorKind};\n#[cfg(test)]\nuse std::net::{SocketAddr, TcpListener, TcpStream};\nuse std::option::Option;\n\n// extern crates\nuse bson::doc;\nuse bson::document::ValueAccessError;\n\nuse crate::byte_counter::ByteCounter;\n\n/// Represents various error codes that can be present in a Honk-RPC `error_section`\n#[derive(Debug, Eq, PartialEq)]\npub enum ErrorCode {\n    /// Failure to parse a received BSON document.\n    BsonParseFailed,\n    /// Received message document was too big; the default maximum message size\n    /// is 4096 bytes, but can be adjusted.\n    MessageTooBig,\n    /// Received message document missing required fields.\n    MessageParseFailed,\n    /// Received message contained version the receiver cannot handle.\n    MessageVersionIncompatible,\n    /// Section in received message contains unknown id.\n    SectionIdUnknown,\n    /// Section in received message missing required field, or provided\n    /// field is wrong datatype.\n    SectionParseFailed,\n    /// Provided request cookie is already in use.\n    RequestCookieInvalid,\n    /// Provided request namespace does not exist.\n    RequestNamespaceInvalid,\n    /// Provided request function does not exist within the provided namespace.\n    RequestFunctionInvalid,\n    /// Provided request version does not exist.\n    RequestVersionInvalid,\n    /// Provided response cookie is not recognized.\n    ResponseCookieInvalid,\n    /// Provided response state is not valid.\n    ResponseStateInvalid,\n    /// Represents an application-specific runtime error with a specific error code.\n    Runtime(i32),\n    /// Represents an unknown error with a specific error code.\n    Unknown(i32),\n}\n\n/// The error type for the `Session` type.\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    /// Failed to read data from read stream due to `std::io::Error`\n    #[error(\"failed to read data from read stream\")]\n    ReaderReadFailed(#[source] std::io::Error),\n\n    /// Bson documents need to be at least 4 bytes long\n    #[error(\"received invalid bson document size header value of {0}, must be at least 4\")]\n    BsonDocumentSizeTooSmall(i32),\n\n    /// Received Bson document header is larger than Session supports\n    #[error(\"received invalid bson document size header value of {0}, must be less than {1}\")]\n    BsonDocumentSizeTooLarge(i32, i32),\n\n    /// Too much time has elapsed without receiving a message\n    #[error(\"waited longer than {} seconds for read\", .0.as_secs_f32())]\n    MessageReadTimedOut(std::time::Duration),\n\n    /// Failed to parse bson message\n    #[error(\"failed to parse bson Message document\")]\n    BsonDocumentParseFailed(#[source] bson::de::Error),\n\n    /// Failed to convert bson document to Honk-RPC message\n    #[error(\"failed to convert bson document to Message\")]\n    MessageConversionFailed(#[source] crate::honk_rpc::ErrorCode),\n\n    /// Failed to serialise bson document\n    #[error(\"failed to serialize bson document\")]\n    BsonWriteFailed(#[source] bson::ser::Error),\n\n    /// Failed to write data to write stream due to `std::io::Error`\n    #[error(\"failed to write data to write stream\")]\n    WriterWriteFailed(#[source] std::io::Error),\n\n    /// Failed to flush data to write stream due to `std::io::Error`\n    #[error(\"failed to flush message to write stream\")]\n    WriterFlushFailed(#[source] std::io::Error),\n\n    /// Received a Honk-RPC `error_section` without an associated request cookie\n    #[error(\"recieved error section without cookie\")]\n    UnknownErrorSectionReceived(#[source] crate::honk_rpc::ErrorCode),\n\n    /// Attempted to define invalid maximum message size\n    #[error(\n        \"tried to set invalid max message size; must be \u003e=5 bytes and \u003c= i32::MAX (2147483647)\"\n    )]\n    InvalidMaxMesageSize(),\n\n    /// Attempted to send a Honk-RPC `section` that is too large to fit in a message\n    #[error(\"queued message section is too large to write; calculated size is {0} but must be less than {1}\")]\n    SectionTooLarge(usize, usize),\n}\n\nimpl From\u003ci32\u003e for ErrorCode {\n    fn from(value: i32) -\u003e ErrorCode {\n        match value {\n            -1i32 =\u003e ErrorCode::BsonParseFailed,\n            -2i32 =\u003e ErrorCode::MessageTooBig,\n            -3i32 =\u003e ErrorCode::MessageParseFailed,\n            -4i32 =\u003e ErrorCode::MessageVersionIncompatible,\n            -5i32 =\u003e ErrorCode::SectionIdUnknown,\n            -6i32 =\u003e ErrorCode::SectionParseFailed,\n            -7i32 =\u003e ErrorCode::RequestCookieInvalid,\n            -8i32 =\u003e ErrorCode::RequestNamespaceInvalid,\n            -9i32 =\u003e ErrorCode::RequestFunctionInvalid,\n            -10i32 =\u003e ErrorCode::RequestVersionInvalid,\n            -11i32 =\u003e ErrorCode::ResponseCookieInvalid,\n            -12i32 =\u003e ErrorCode::ResponseStateInvalid,\n            value =\u003e {\n                if value \u003e 0 {\n                    ErrorCode::Runtime(value)\n                } else {\n                    ErrorCode::Unknown(value)\n                }\n            }\n        }\n    }\n}\n\nimpl From\u003cErrorCode\u003e for i32 {\n    fn from(err: ErrorCode) -\u003e Self {\n        match err {\n            ErrorCode::BsonParseFailed =\u003e -1i32,\n            ErrorCode::MessageTooBig =\u003e -2i32,\n            ErrorCode::MessageParseFailed =\u003e -3i32,\n            ErrorCode::MessageVersionIncompatible =\u003e -4i32,\n            ErrorCode::SectionIdUnknown =\u003e -5i32,\n            ErrorCode::SectionParseFailed =\u003e -6i32,\n            ErrorCode::RequestCookieInvalid =\u003e -7i32,\n            ErrorCode::RequestNamespaceInvalid =\u003e -8i32,\n            ErrorCode::RequestFunctionInvalid =\u003e -9i32,\n            ErrorCode::RequestVersionInvalid =\u003e -10i32,\n            ErrorCode::ResponseCookieInvalid =\u003e -11i32,\n            ErrorCode::ResponseStateInvalid =\u003e -12i32,\n            ErrorCode::Runtime(val) =\u003e val,\n            ErrorCode::Unknown(val) =\u003e val,\n        }\n    }\n}\n\nimpl std::fmt::Display for ErrorCode {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter) -\u003e std::fmt::Result {\n        match self {\n            ErrorCode::BsonParseFailed =\u003e write!(f, \"ProtocolError: failed to parse BSON object\"),\n            ErrorCode::MessageTooBig =\u003e write!(f, \"ProtocolError: received document too large\"),\n            ErrorCode::MessageParseFailed =\u003e {\n                write!(f, \"ProtocolError: received message has invalid schema\")\n            }\n            ErrorCode::MessageVersionIncompatible =\u003e write!(\n                f,\n                \"ProtocolError: received message has incompatible version\"\n            ),\n            ErrorCode::SectionIdUnknown =\u003e write!(\n                f,\n                \"ProtocolError: received message contains section of unknown type\"\n            ),\n            ErrorCode::SectionParseFailed =\u003e write!(\n                f,\n                \"ProtocolError: received message contains section with invalid schema\"\n            ),\n            ErrorCode::RequestCookieInvalid =\u003e {\n                write!(f, \"ProtocolError: request cookie already in use\")\n            }\n            ErrorCode::RequestNamespaceInvalid =\u003e write!(\n                f,\n                \"ProtocolError: request function does not exist in requested namespace\"\n            ),\n            ErrorCode::RequestFunctionInvalid =\u003e {\n                write!(f, \"ProtocolError: request function does not exist\")\n            }\n            ErrorCode::RequestVersionInvalid =\u003e {\n                write!(f, \"ProtocolError: request function version does not exist\")\n            }\n            ErrorCode::ResponseCookieInvalid =\u003e {\n                write!(f, \"ProtocolError: response cookie is not recognized\")\n            }\n            ErrorCode::ResponseStateInvalid =\u003e write!(f, \"ProtocolError: response state not valid\"),\n            ErrorCode::Runtime(code) =\u003e write!(f, \"RuntimeError: runtime error {}\", code),\n            ErrorCode::Unknown(code) =\u003e write!(f, \"UnknownError: unknown error code {}\", code),\n        }\n    }\n}\n\nimpl std::error::Error for ErrorCode {}\n\n// Honk-RPC semver is packed into an i32\nconst fn semver_to_i32(major: u8, minor: u8, patch: u8) -\u003e i32 {\n    let major = major as i32;\n    let minor = minor as i32;\n    let patch = patch as i32;\n    (major \u003c\u003c 16) | (minor \u003c\u003c 8) | patch\n}\n\nconst fn i32_to_semver(ver: i32) -\u003e Option\u003c(u8, u8, u8)\u003e {\n    if ver \u003e= 0 \u0026\u0026 ver \u003c= 0xffffff {\n        let major = (ver \u0026 0xff0000) \u003e\u003e 16;\n        let minor = (ver \u0026 0xff00) \u003e\u003e 8;\n        let patch = ver \u0026 0xff;\n        Some((major as u8, minor as u8, patch as u8))\n    } else {\n        None\n    }\n}\n\n// Honk-RPC version 0.1.0\nconst HONK_RPC_VERSION: i32 = semver_to_i32(0, 1, 0);\n\nstruct Message {\n    honk_rpc: i32,\n    sections: Vec\u003cSection\u003e,\n}\n\nimpl TryFrom\u003cbson::document::Document\u003e for Message {\n    type Error = ErrorCode;\n\n    fn try_from(value: bson::document::Document) -\u003e Result\u003cSelf, Self::Error\u003e {\n        let mut value = value;\n\n        // verify version\n        let honk_rpc = match value.get_i32(\"honk_rpc\") {\n            Ok(HONK_RPC_VERSION) =\u003e HONK_RPC_VERSION,\n            Ok(honk_rpc) =\u003e {\n                return if let Some(_version) = i32_to_semver(honk_rpc) {\n                    // some other semver we cannot handle\n                    Err(ErrorCode::MessageVersionIncompatible)\n                } else {\n                    // an invalid semver\n                    Err(ErrorCode::MessageParseFailed)\n                };\n            }\n            Err(_err) =\u003e return Err(ErrorCode::MessageParseFailed),\n        };\n\n        if let Ok(sections) = value.get_array_mut(\"sections\") {\n            // messages must have at least one section\n            if sections.is_empty() {\n                return Err(ErrorCode::MessageParseFailed);\n            }\n\n            let mut message = Message {\n                honk_rpc,\n                sections: Default::default(),\n            };\n\n            for section in sections.iter_mut() {\n                if let bson::Bson::Document(section) = std::mem::take(section) {\n                    message.sections.push(Section::try_from(section)?);\n                } else {\n                    return Err(ErrorCode::SectionParseFailed);\n                }\n            }\n            Ok(message)\n        } else {\n            Err(ErrorCode::MessageParseFailed)\n        }\n    }\n}\n\nimpl From\u003cMessage\u003e for bson::document::Document {\n    fn from(value: Message) -\u003e bson::document::Document {\n        let mut value = value;\n        let mut message = bson::document::Document::new();\n        message.insert(\"honk_rpc\", value.honk_rpc);\n\n        let mut sections = bson::Array::new();\n        for section in value.sections.drain(0..) {\n            sections.push(bson::Bson::Document(bson::document::Document::from(\n                section,\n            )));\n        }\n        message.insert(\"sections\", sections);\n\n        message\n    }\n}\n\n/// A type alias for the cookie used to track client requests.\npub type RequestCookie = i64;\n\nconst ERROR_SECTION_ID: i32 = 0i32;\nconst REQUEST_SECTION_ID: i32 = 1i32;\nconst RESPONSE_SECTION_ID: i32 = 2i32;\n\nenum Section {\n    Error(ErrorSection),\n    Request(RequestSection),\n    Response(ResponseSection),\n}\n\nstruct ErrorSection {\n    cookie: Option\u003cRequestCookie\u003e,\n    code: ErrorCode,\n    message: Option\u003cString\u003e,\n    data: Option\u003cbson::Bson\u003e,\n}\n\nstruct RequestSection {\n    cookie: Option\u003cRequestCookie\u003e,\n    namespace: String,\n    function: String,\n    version: i32,\n    arguments: bson::document::Document,\n}\n\n#[repr(i32)]\n#[derive(Debug, PartialEq)]\nenum RequestState {\n    Pending = 0i32,\n    Complete = 1i32,\n}\n\nstruct ResponseSection {\n    cookie: RequestCookie,\n    state: RequestState,\n    result: Option\u003cbson::Bson\u003e,\n}\n\nimpl TryFrom\u003cbson::document::Document\u003e for Section {\n    type Error = ErrorCode;\n\n    fn try_from(\n        value: bson::document::Document,\n    ) -\u003e Result\u003cSelf, \u003cSelf as TryFrom\u003cbson::document::Document\u003e\u003e::Error\u003e {\n        match value.get_i32(\"id\") {\n            Ok(ERROR_SECTION_ID) =\u003e Ok(Section::Error(ErrorSection::try_from(value)?)),\n            Ok(REQUEST_SECTION_ID) =\u003e Ok(Section::Request(RequestSection::try_from(value)?)),\n            Ok(RESPONSE_SECTION_ID) =\u003e Ok(Section::Response(ResponseSection::try_from(value)?)),\n            Ok(_) =\u003e Err(ErrorCode::SectionIdUnknown),\n            Err(_) =\u003e Err(ErrorCode::SectionParseFailed),\n        }\n    }\n}\n\nimpl From\u003cSection\u003e for bson::document::Document {\n    fn from(value: Section) -\u003e bson::document::Document {\n        match value {\n            Section::Error(section) =\u003e bson::document::Document::from(section),\n            Section::Request(section) =\u003e bson::document::Document::from(section),\n            Section::Response(section) =\u003e bson::document::Document::from(section),\n        }\n    }\n}\n\nimpl TryFrom\u003cbson::document::Document\u003e for ErrorSection {\n    type Error = ErrorCode;\n\n    fn try_from(value: bson::document::Document) -\u003e Result\u003cSelf, Self::Error\u003e {\n        let mut value = value;\n\n        let cookie = match value.get_i64(\"cookie\") {\n            Ok(cookie) =\u003e Some(cookie),\n            Err(ValueAccessError::NotPresent) =\u003e None,\n            Err(_) =\u003e return Err(ErrorCode::SectionParseFailed),\n        };\n\n        let code = match value.get_i32(\"code\") {\n            Ok(code) =\u003e ErrorCode::from(code),\n            Err(_) =\u003e return Err(ErrorCode::SectionParseFailed),\n        };\n\n        let message = match value.get_str(\"message\") {\n            Ok(message) =\u003e Some(message.to_string()),\n            Err(ValueAccessError::NotPresent) =\u003e None,\n            Err(_) =\u003e return Err(ErrorCode::SectionParseFailed),\n        };\n\n        let data = value.get_mut(\"data\").map(std::mem::take);\n\n        Ok(ErrorSection {\n            cookie,\n            code,\n            message,\n            data,\n        })\n    }\n}\n\nimpl From\u003cErrorSection\u003e for bson::document::Document {\n    fn from(value: ErrorSection) -\u003e bson::document::Document {\n        let mut error_section = bson::document::Document::new();\n        error_section.insert(\"id\", ERROR_SECTION_ID);\n\n        if let Some(cookie) = value.cookie {\n            error_section.insert(\"cookie\", cookie);\n        }\n\n        error_section.insert(\"code\", Into::\u003ci32\u003e::into(value.code));\n\n        if let Some(message) = value.message {\n            error_section.insert(\"message\", message);\n        }\n\n        if let Some(data) = value.data {\n            error_section.insert(\"data\", data);\n        }\n\n        error_section\n    }\n}\n\nimpl TryFrom\u003cbson::document::Document\u003e for RequestSection {\n    type Error = ErrorCode;\n\n    fn try_from(value: bson::document::Document) -\u003e Result\u003cSelf, Self::Error\u003e {\n        let mut value = value;\n\n        let cookie = match value.get_i64(\"cookie\") {\n            Ok(cookie) =\u003e Some(cookie),\n            Err(ValueAccessError::NotPresent) =\u003e None,\n            Err(_) =\u003e return Err(ErrorCode::SectionParseFailed),\n        };\n\n        let namespace = match value.get_str(\"namespace\") {\n            Ok(namespace) =\u003e namespace.to_string(),\n            Err(ValueAccessError::NotPresent) =\u003e String::default(),\n            Err(_) =\u003e return Err(ErrorCode::SectionParseFailed),\n        };\n\n        let function = match value.get_str(\"function\") {\n            Ok(function) =\u003e {\n                if function.is_empty() {\n                    return Err(ErrorCode::RequestFunctionInvalid);\n                } else {\n                    function.to_string()\n                }\n            }\n            Err(_) =\u003e return Err(ErrorCode::SectionParseFailed),\n        };\n\n        let version = match value.get_i32(\"version\") {\n            Ok(version) =\u003e version,\n            Err(ValueAccessError::NotPresent) =\u003e 0i32,\n            Err(_) =\u003e return Err(ErrorCode::SectionParseFailed),\n        };\n\n        let arguments = match value.get_document_mut(\"arguments\") {\n            Ok(arguments) =\u003e std::mem::take(arguments),\n            Err(ValueAccessError::NotPresent) =\u003e bson::document::Document::new(),\n            Err(_) =\u003e return Err(ErrorCode::SectionParseFailed),\n        };\n\n        Ok(RequestSection {\n            cookie,\n            namespace,\n            function,\n            version,\n            arguments,\n        })\n    }\n}\n\nimpl From\u003cRequestSection\u003e for bson::document::Document {\n    fn from(value: RequestSection) -\u003e bson::document::Document {\n        let mut request_section = bson::document::Document::new();\n        request_section.insert(\"id\", REQUEST_SECTION_ID);\n\n        if let Some(cookie) = value.cookie {\n            request_section.insert(\"cookie\", cookie);\n        }\n\n        if !value.namespace.is_empty() {\n            request_section.insert(\"namespace\", value.namespace);\n        }\n\n        request_section.insert(\"function\", value.function);\n\n        if value.version != 0i32 {\n            request_section.insert(\"version\", value.version);\n        }\n\n        request_section.insert(\"arguments\", value.arguments);\n\n        request_section\n    }\n}\n\nimpl TryFrom\u003cbson::document::Document\u003e for ResponseSection {\n    type Error = ErrorCode;\n\n    fn try_from(value: bson::document::Document) -\u003e Result\u003cSelf, Self::Error\u003e {\n        let mut value = value;\n        let cookie = match value.get_i64(\"cookie\") {\n            Ok(cookie) =\u003e cookie,\n            Err(_) =\u003e return Err(ErrorCode::SectionParseFailed),\n        };\n\n        let state = match value.get_i32(\"state\") {\n            Ok(0i32) =\u003e RequestState::Pending,\n            Ok(1i32) =\u003e RequestState::Complete,\n            Ok(_) =\u003e return Err(ErrorCode::ResponseStateInvalid),\n            Err(_) =\u003e return Err(ErrorCode::SectionParseFailed),\n        };\n\n        let result = value.get_mut(\"result\").map(std::mem::take);\n\n        // if pending there should be no result\n        if state == RequestState::Pending \u0026\u0026 result.is_some() {\n            return Err(ErrorCode::SectionParseFailed);\n        }\n\n        Ok(ResponseSection {\n            cookie,\n            state,\n            result,\n        })\n    }\n}\n\nimpl From\u003cResponseSection\u003e for bson::document::Document {\n    fn from(value: ResponseSection) -\u003e bson::document::Document {\n        let mut response_section = bson::document::Document::new();\n        response_section.insert(\"id\", RESPONSE_SECTION_ID);\n\n        response_section.insert(\"cookie\", value.cookie);\n        response_section.insert(\"state\", value.state as i32);\n\n        if let Some(result) = value.result {\n            response_section.insert(\"result\", result);\n        }\n\n        response_section\n    }\n}\n\n/// The `ApiSet` trait represents a set of APIs that can be remotely invoked by a connecting Honk-RPC client.\n/// # Example\n/// This exampe `ApiSet` implements two methods, `example::println()` and `example::async_println()`. The\n/// `println()` method immediatley prints, whereas `async_println()` queues request and\n/// prints the messagge at a later date via `update()`\n///\n/// ```rust\n/// # use honk_rpc::honk_rpc::*;\n/// # use std::collections::VecDeque;\n///\n/// const RUNTIME_ERROR_INVALID_ARG: ErrorCode = ErrorCode::Runtime(1i32);\n///\n/// struct PrintlnApiSet {\n///     // queued print reuests\n///     async_println_work: Vec\u003c(Option\u003cRequestCookie\u003e, String)\u003e,\n///     // successful async requests\n///     async_println_cookies: VecDeque\u003cRequestCookie\u003e,\n/// }\n///\n/// impl PrintlnApiSet {\n///   // prints message immediately\n///   fn println_0(\n///       \u0026mut self,\n///       mut args: bson::document::Document,\n///   ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n///     if let Some(bson::Bson::String(val)) = args.get_mut(\"val\") {\n///         println!(\"example::echo_0(val): '{}'\", val);\n///         Some(Ok(Some(bson::Bson::String(std::mem::take(val)))))\n///     } else {\n///         Some(Err(RUNTIME_ERROR_INVALID_ARG))\n///     }\n///   }\n///\n///   // queues message up for printing later\n///   fn async_println_0(\n///       \u0026mut self,\n///       request_cookie: Option\u003cRequestCookie\u003e,\n///       mut args: bson::document::Document,\n///   ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e{\n///     if let Some(bson::Bson::String(val)) = args.get_mut(\"val\") {\n///         self.async_println_work.push((request_cookie, std::mem::take(val)));\n///         None\n///     } else {\n///         Some(Err(RUNTIME_ERROR_INVALID_ARG))\n///     }\n///   }\n/// }\n///\n/// impl ApiSet for PrintlnApiSet {\n///     fn namespace(\u0026self) -\u003e \u0026str {\n///         \"example\"\n///     }\n///\n///     // handles and routes requests for `println` and `async_println`\n///     fn exec_function(\n///         \u0026mut self,\n///         name: \u0026str,\n///         version: i32,\n///         args: bson::document::Document,\n///         request_cookie: Option\u003cRequestCookie\u003e,\n///     ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n///         match (name, version) {\n///             (\"println\", 0) =\u003e self.println_0(args),\n///             (\"async_println\", 0) =\u003e self.async_println_0(request_cookie, args),\n///             (name, version) =\u003e {\n///                 println!(\"received {{ name: '{}', version: {} }}\", name, version);\n///                 Some(Err(ErrorCode::RequestFunctionInvalid))\n///             }\n///         }\n///     }\n///\n///     // handles queued `async_println` requests\n///     fn update(\u0026mut self) {\n///         for ((cookie, val)) in self.async_println_work.drain(..) {\n///             println!(\"{}\", val);\n///             if let Some(cookie) = cookie {\n///                 self.async_println_cookies.push_back(cookie);\n///             }\n///         }\n///     }\n///\n///     // finally return queued async results\n///     fn next_result(\u0026mut self) -\u003e Option\u003c(RequestCookie, Result\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e)\u003e {\n///         if let Some(cookie) = self.async_println_cookies.pop_front() {\n///             Some((cookie, Ok(None)))\n///         } else {\n///             None\n///         }\n///     }\n/// }\n///```\n\npub trait ApiSet {\n    /// Returns the namespace of this `ApiSet`.\n    fn namespace(\u0026self) -\u003e \u0026str;\n\n    /// Schedules the execution of the requested remote procedure call. Calls to this\n    /// function map directly to a received Honk-RPC request. Each request has the\n    /// following parameters:\n    /// - `name`: The name of the function to execute.\n    /// - `version`: The version of the function to execute.\n    /// - `args`: The arguments to pass to the function.\n    /// - `request_cookie`: An optional cookie to track the request.\n    ///\n    /// This function handles both synchronous and asynchronous requests. The possible\n    /// return values for each are:\n    /// - Synchronous requests may execute and signal success by returning `Some(Ok(..))`.\n    /// - Synchronous requests may execute and signal failure by returning `Some(Err(..))`.\n    /// - Asynchronous requests must defer execution by returning `None`.\n    fn exec_function(\n        \u0026mut self,\n        name: \u0026str,\n        version: i32,\n        args: bson::document::Document,\n        request_cookie: Option\u003cRequestCookie\u003e,\n    ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e;\n\n    /// Updates any internal state required to make forward progress on any requested\n    /// remote procedure calls. Implementation of this method is optional and not needed\n    /// if the implementor does not have any async functions. If left unimplemented, this\n    /// function is a no-op.\n    fn update(\u0026mut self) {}\n\n    /// Returns the result of any in-flight asynchronous requests.\n    /// - Asynchronous requests may signal success by returning `Some((cookie, Ok(..)))`\n    /// - Asynchronous requests may signal failure by returning `Some((cookie, Err(..)))`\n    /// - returns None if no asynchronous results are available\n    ///\n    /// This method is optional and not needed if the implementor does not have any async\n    /// functions, in which case the default implementation will return `None`.\n    fn next_result(\u0026mut self) -\u003e Option\u003c(RequestCookie, Result\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e)\u003e {\n        None\n    }\n}\n\n/// Represents the response to a client request.\npub enum Response {\n    /// A pending response, indicating that the request is still being processed.\n    Pending {\n        /// The cookie associated with the request.\n        cookie: RequestCookie,\n    },\n    /// A successful response, containing the result of the request.\n    Success {\n        /// The cookie associated with the request.\n        cookie: RequestCookie,\n        /// The result of the request.\n        result: Option\u003cbson::Bson\u003e,\n    },\n    /// An error response, containing the error code.\n    Error {\n        /// The cookie associated with the request.\n        cookie: RequestCookie,\n        /// The error code indicating the type of error that occurred.\n        error_code: ErrorCode,\n    },\n}\n\n// 4 kilobytes per specification\n/// The default maximum allowed Honk-RPC message (4096 bytes)\npub const DEFAULT_MAX_MESSAGE_SIZE: usize = 4 * 1024;\n/// The default maximum allowed duration between Honk-RPC (60 seconds)\npub const DEFAULT_MAX_WAIT_TIME: std::time::Duration = std::time::Duration::from_secs(60);\n\n// Base Message Bson Format\n// document size             4 (sizeof i32 )\nconst HEADER_SIZE: usize = 4usize;\n// \"honk_rpc\" : i32          1 (0x10) + 8 (strlen \"honk_rpc\") + 1 (null) + 4 (sizeof i32)\nconst HONK_RPC_SIZE: usize = 14usize;\n// \"sections\" : {\"0\": Null}  1 (0x04) + 8 (strlen \"sections\") + 1 (null) + 4 (sizeof i32) + 1 (0x0a) + 1 (strlen \"0\") + 1 (null) + 1 (0x00)\nconst SECTIONS_SIZE: usize = 18usize;\n// footer                    1 (0x00)\nconst FOOTER_SIZE: usize = 1usize;\n\n// The honk-rpc message overhead before the content of a single section is added\nconst MIN_MESSAGE_SIZE: usize = HEADER_SIZE + HONK_RPC_SIZE + SECTIONS_SIZE + FOOTER_SIZE;\n\n/// Computes the overhead of the Honk-RPC message type. This method in conjunction with\n/// the other `get_*_section_size(..)` functions can be used to compute the size of a\n/// Honk-RPC message with exactly one section.\npub fn get_message_overhead() -\u003e Result\u003cusize, Error\u003e {\n    // construct an example empty message; the size of a real message with\n    // one section can be calculated as the sizeof(message) + sizeof(section)\n    let message = doc! {\n        \"honk_rpc\" : HONK_RPC_VERSION,\n        \"sections\" : [\n            bson::Bson::Null\n        ]\n    };\n\n    let mut counter: ByteCounter = Default::default();\n    message\n        .to_writer(\u0026mut counter)\n        .map_err(Error::BsonWriteFailed)?;\n\n    Ok(counter.bytes())\n}\n\n/// Computes the required size of a Honk-RPC error section in bytes.\n///\n/// Returns the size of the BSON-encoded error section. If BSON encoding fails,\n/// an `Error::BsonWriteFailed` is returned.\npub fn get_error_section_size(\n    cookie: Option\u003cRequestCookie\u003e,\n    message: Option\u003cString\u003e,\n    data: Option\u003cbson::Bson\u003e,\n) -\u003e Result\u003cusize, Error\u003e {\n    let mut error_section = doc! {\n        \"id\": ERROR_SECTION_ID,\n        \"code\": Into::\u003ci32\u003e::into(ErrorCode::Unknown(0)),\n    };\n\n    if let Some(cookie) = cookie {\n        error_section.insert(\"cookie\", bson::Bson::Int64(cookie));\n    }\n\n    if let Some(message) = message {\n        error_section.insert(\"message\", bson::Bson::String(message));\n    }\n\n    if let Some(data) = data {\n        error_section.insert(\"data\", data);\n    }\n\n    let mut counter: ByteCounter = Default::default();\n    error_section\n        .to_writer(\u0026mut counter)\n        .map_err(Error::BsonWriteFailed)?;\n\n    Ok(counter.bytes())\n}\n\n/// Computes the required size of a Honk-RPC requests section in bytes.\n///\n/// Returns the size of the BSON-encoded request section. If BSON encoding fails,\n/// an `Error::BsonWriteFailed` is returned.\npub fn get_request_section_size(\n    cookie: Option\u003cRequestCookie\u003e,\n    namespace: Option\u003cString\u003e,\n    function: String,\n    version: Option\u003ci32\u003e,\n    arguments: Option\u003cbson::Document\u003e,\n) -\u003e Result\u003cusize, Error\u003e {\n    let mut request_section = doc! {\n        \"id\": REQUEST_SECTION_ID,\n        \"function\": bson::Bson::String(function),\n    };\n\n    if let Some(cookie) = cookie {\n        request_section.insert(\"cookie\", bson::Bson::Int64(cookie));\n    }\n\n    if let Some(namespace) = namespace {\n        request_section.insert(\"namespace\", bson::Bson::String(namespace));\n    }\n\n    if let Some(version) = version {\n        request_section.insert(\"version\", bson::Bson::Int32(version));\n    }\n\n    if let Some(arguments) = arguments {\n        request_section.insert(\"arguments\", arguments);\n    }\n\n    let mut counter: ByteCounter = Default::default();\n    request_section\n        .to_writer(\u0026mut counter)\n        .map_err(Error::BsonWriteFailed)?;\n\n    Ok(counter.bytes())\n}\n\n/// Computes the required size of a Honk-RPC response section in bytes.\n///\n/// Returns the size of the BSON-encoded response section. If BSON encoding fails,\n/// an `Error::BsonWriteFailed` is returned.\npub fn get_response_section_size(result: Option\u003cbson::Bson\u003e) -\u003e Result\u003cusize, Error\u003e {\n    let mut response_section = doc! {\n        \"id\": RESPONSE_SECTION_ID,\n        \"cookie\": bson::Bson::Int64(0),\n        \"state\": bson::Bson::Int32(0),\n    };\n\n    if let Some(result) = result {\n        response_section.insert(\"result\", result);\n    }\n\n    let mut counter: ByteCounter = Default::default();\n    response_section\n        .to_writer(\u0026mut counter)\n        .map_err(Error::BsonWriteFailed)?;\n\n    Ok(counter.bytes())\n}\n\n/// The object that handles the communication between two endpoints  using the\n/// Honk-RPC protocol. Provides methods for setting and getting configuration\n/// parameters, reading and processing message documents, and handling API\n/// requests and responses.\npub struct Session\u003cRW\u003e {\n    // read-write stream\n    stream: RW,\n    // we write outgoing data to an intermediate buffer to handle writer blocking\n    message_write_buffer: VecDeque\u003cu8\u003e,\n\n    // message read data\n\n    // remaining number of bytes to read for current message\n    // if None, no message read is in progress\n    remaining_byte_count: Option\u003cusize\u003e,\n    // data we've read but not yet a full Message object\n    message_read_buffer: Vec\u003cu8\u003e,\n    // received sections to be handled\n    pending_sections: VecDeque\u003cSection\u003e,\n    // remote client's inbound remote procedure calls to local server\n    inbound_requests: Vec\u003cRequestSection\u003e,\n    // remote server's responses to local client's remote procedure calls\n    inbound_responses: VecDeque\u003cResponse\u003e,\n\n    // message write data\n\n    // we serialize outgoing messages to this buffer first to verify size limitations\n    message_serialization_buffer: VecDeque\u003cu8\u003e,\n    // the next request cookie to use when making a remote prodedure call\n    next_cookie: RequestCookie,\n    // sections to be sent to the remote server\n    outbound_sections: Vec\u003cbson::Document\u003e,\n\n    // the maximum size of a message we've agreed to allow in the session\n    max_message_size: usize,\n    // the maximum amount of time the session is willing to wait to receive a message\n    // before terminating the session\n    max_wait_time: std::time::Duration,\n    // last time a new message read began\n    read_timestamp: std::time::Instant,\n}\n\n#[allow(dead_code)]\nimpl\u003cRW\u003e Session\u003cRW\u003e\nwhere\n    RW: std::io::Read + std::io::Write + Send,\n{\n    /// Sets the maximum message size this `Session` is willing to read from from the underlying `RW`. Attempted reads  will abort if the next bson document's `i32` size field is greater than the `max_message_size` defined in this function.\n    pub fn set_max_message_size(\u0026mut self, max_message_size: i32) -\u003e Result\u003c(), Error\u003e {\n        if max_message_size \u003c MIN_MESSAGE_SIZE as i32 {\n            // base size of a honk-rpc mssage\n            Err(Error::InvalidMaxMesageSize())\n        } else {\n            self.max_message_size = max_message_size as usize;\n            Ok(())\n        }\n    }\n\n    /// Gets the maximum allowed message size this `Session` is willing to read from the underlying `RW`. The default value is 4096 bytes.\n    pub fn get_max_message_size(\u0026self) -\u003e usize {\n        self.max_message_size\n    }\n\n    /// Sets the maximum amount of time this `Session` is willing to wait for a new Honk-RPC message on the underlying `RW`. `Session` updates will fil after `max_wait_time` has elapsed without receiving any new Honk-RPC message documents.\n    pub fn set_max_wait_time(\u0026mut self, max_wait_time: std::time::Duration) {\n        self.max_wait_time = max_wait_time;\n    }\n\n    /// Gets the maximum amount this `Session` is willing to wait for a new Honk-RPC message. The default value is 60 seconds.\n    pub fn get_max_wait_time(\u0026self) -\u003e std::time::Duration {\n        self.max_wait_time\n    }\n\n    /// Creates a new `Session` using the given `stream`.\n    pub fn new(stream: RW) -\u003e Self {\n        let mut message_write_buffer: VecDeque\u003cu8\u003e = Default::default();\n        message_write_buffer.reserve(DEFAULT_MAX_MESSAGE_SIZE);\n\n        let mut message_serialization_buffer: VecDeque\u003cu8\u003e = Default::default();\n        message_serialization_buffer.reserve(DEFAULT_MAX_MESSAGE_SIZE);\n\n        Session {\n            stream,\n            message_write_buffer,\n            remaining_byte_count: None,\n            message_read_buffer: Default::default(),\n            pending_sections: Default::default(),\n            inbound_requests: Default::default(),\n            inbound_responses: Default::default(),\n            message_serialization_buffer,\n            next_cookie: Default::default(),\n            outbound_sections: Default::default(),\n            max_message_size: DEFAULT_MAX_MESSAGE_SIZE,\n            max_wait_time: DEFAULT_MAX_WAIT_TIME,\n            read_timestamp: std::time::Instant::now(),\n        }\n    }\n\n    /// Consumes the `Session` and returns the underlying stream.\n    pub fn into_stream(self) -\u003e RW {\n        self.stream\n    }\n\n    // read a block of bytes from the undelrying stream\n    fn stream_read(\u0026mut self, buffer: \u0026mut [u8]) -\u003e Result\u003cusize, Error\u003e {\n        match self.stream.read(buffer) {\n            Err(err) =\u003e {\n                if err.kind() == ErrorKind::WouldBlock || err.kind() == ErrorKind::TimedOut {\n                    // abort if we've gone too long without a new message\n                    if std::time::Instant::now().duration_since(self.read_timestamp)\n                        \u003e self.max_wait_time\n                    {\n                        Err(Error::MessageReadTimedOut(self.max_wait_time))\n                    } else {\n                        Ok(0)\n                    }\n                } else {\n                    Err(Error::ReaderReadFailed(err))\n                }\n            }\n            Ok(0) =\u003e Err(Error::ReaderReadFailed(std::io::Error::from(\n                ErrorKind::UnexpectedEof,\n            ))),\n            Ok(count) =\u003e {\n                // update read_timestamp\n                self.read_timestamp = std::time::Instant::now();\n                Ok(count)\n            }\n        }\n    }\n\n    // read the next block of bytes as a bson document size header\n    fn read_message_size(\u0026mut self) -\u003e Result\u003c(), Error\u003e {\n        match self.remaining_byte_count {\n            // we've already read the size header\n            Some(_remaining) =\u003e Ok(()),\n            // still need to read the size header\n            None =\u003e {\n                // may have been partially read already so ensure it's the right size\n                assert!(self.message_read_buffer.len() \u003c std::mem::size_of::\u003ci32\u003e());\n                let bytes_needed = std::mem::size_of::\u003ci32\u003e() - self.message_read_buffer.len();\n                // ensure we have enough space for an entire int32\n                let mut buffer = [0u8; std::mem::size_of::\u003ci32\u003e()];\n                // but shrink view down to number of bytes remaining\n                let buffer = \u0026mut buffer[0..bytes_needed];\n                match self.stream_read(buffer) {\n                    Err(err) =\u003e Err(err),\n                    Ok(0) =\u003e Ok(()),\n                    Ok(count) =\u003e {\n                        #[cfg(test)]\n                        println!(\"\u003c\u003c\u003c read {} bytes for message header\", count);\n                        self.message_read_buffer\n                            .extend_from_slice(\u0026buffer[0..count]);\n\n                        // all bytes required for i32 message size have been read\n                        if self.message_read_buffer.len() == std::mem::size_of::\u003ci32\u003e() {\n                            let size = \u0026self.message_read_buffer.as_slice();\n                            let size: i32 = (size[0] as i32)\n                                | (size[1] as i32) \u003c\u003c 8\n                                | (size[2] as i32) \u003c\u003c 16\n                                | (size[3] as i32) \u003c\u003c 24;\n                            // size should be at least larger than the bytes required for size header\n                            if size \u003c= std::mem::size_of::\u003ci32\u003e() as i32 {\n                                return Err(Error::BsonDocumentSizeTooSmall(size));\n                            }\n                            // convert to usize type now that we know it's not negative\n                            if size as usize \u003e self.max_message_size {\n                                return Err(Error::BsonDocumentSizeTooLarge(\n                                    size,\n                                    self.max_message_size as i32,\n                                ));\n                            }\n\n                            // deduct size of i32 header and save\n                            let size = size as usize - std::mem::size_of::\u003ci32\u003e();\n\n                            self.remaining_byte_count = Some(size);\n                        }\n                        Ok(())\n                    }\n                }\n            }\n        }\n    }\n\n    // read the remainder of a bson message\n    fn read_message(\u0026mut self) -\u003e Result\u003cOption\u003cMessage\u003e, Error\u003e {\n        // update remaining bytes to read for message\n        self.read_message_size()?;\n        // read the message bytes\n        if let Some(remaining) = self.remaining_byte_count {\n            #[cfg(test)]\n            println!(\"--- message requires {} more bytes\", remaining);\n\n            let mut buffer = vec![0u8; remaining];\n            match self.stream_read(\u0026mut buffer) {\n                Err(err) =\u003e Err(err),\n                Ok(0) =\u003e Ok(None),\n                Ok(count) =\u003e {\n                    #[cfg(test)]\n                    println!(\"\u003c\u003c\u003c read {} bytes\", count);\n                    // append read bytes\n                    self.message_read_buffer\n                        .extend_from_slice(\u0026buffer[0..count]);\n                    if remaining == count {\n                        self.remaining_byte_count = None;\n\n                        let mut cursor = Cursor::new(std::mem::take(\u0026mut self.message_read_buffer));\n                        let bson = bson::document::Document::from_reader(\u0026mut cursor)\n                            .map_err(Error::BsonDocumentParseFailed)?;\n\n                        // take back our allocated vec and clear it\n                        self.message_read_buffer = cursor.into_inner();\n                        self.message_read_buffer.clear();\n\n                        #[cfg(test)]\n                        println!(\"\u003c\u003c\u003c read message: {}\", bson);\n\n                        Ok(Some(\n                            Message::try_from(bson).map_err(Error::MessageConversionFailed)?,\n                        ))\n                    } else {\n                        // update the remaining byte count\n                        self.remaining_byte_count = Some(remaining - count);\n                        Ok(None)\n                    }\n                }\n            }\n        } else {\n            Ok(None)\n        }\n    }\n\n    // read and save of available sections\n    fn read_sections(\u0026mut self) -\u003e Result\u003c(), Error\u003e {\n        loop {\n            match self.read_message() {\n                Ok(Some(mut message)) =\u003e {\n                    self.pending_sections.extend(message.sections.drain(..));\n                }\n                Ok(None) =\u003e return Ok(()),\n                Err(err) =\u003e {\n                    match err {\n                        // in the event of timeouts and IO errors we finish any remaining work\n                        Error::MessageReadTimedOut(_) | Error::ReaderReadFailed(_) =\u003e {\n                            // ensure no pending items to handle\n                            if self.pending_sections.is_empty() \u0026\u0026 self.inbound_responses.is_empty()\n                            {\n                                return Err(err);\n                            }\n                            return Ok(());\n                        }\n                        // all other errors we terminate\n                        _ =\u003e return Err(err),\n                    }\n                }\n            }\n        }\n    }\n\n    // route read sections to client and server buffers\n    fn process_sections(\u0026mut self) -\u003e Result\u003c(), Error\u003e {\n        while let Some(section) = self.pending_sections.pop_front() {\n            match section {\n                Section::Error(error) =\u003e {\n                    if let Some(cookie) = error.cookie {\n                        // error in response to a request\n                        self.inbound_responses.push_back(Response::Error {\n                            cookie,\n                            error_code: error.code,\n                        });\n                    } else {\n                        return Err(Error::UnknownErrorSectionReceived(error.code));\n                    }\n                }\n                Section::Request(request) =\u003e {\n                    // request to route to our apisets\n                    self.inbound_requests.push(request);\n                }\n                Section::Response(response) =\u003e {\n                    // response to our client\n\n                    match (response.cookie, response.state, response.result) {\n                        (cookie, RequestState::Complete, result) =\u003e {\n                            self.inbound_responses\n                                .push_back(Response::Success { cookie, result });\n                        }\n                        (cookie, RequestState::Pending, _) =\u003e {\n                            self.inbound_responses\n                                .push_back(Response::Pending { cookie });\n                        }\n                    }\n                }\n            }\n        }\n\n        Ok(())\n    }\n\n    // queue outbound section for packaging into a Honk-RPC message\n    fn push_outbound_section(\u0026mut self, section: Section) -\u003e Result\u003c(), Error\u003e {\n        let max_section_size = self.max_message_size - MIN_MESSAGE_SIZE;\n\n        let mut counter: ByteCounter = Default::default();\n        let section: bson::Document = section.into();\n        section\n            .to_writer(\u0026mut counter)\n            .map_err(Error::BsonWriteFailed)?;\n        let section_size = counter.bytes();\n\n        if section_size \u003c= max_section_size {\n            self.outbound_sections.push(section);\n            Ok(())\n        } else {\n            Err(Error::SectionTooLarge(section_size, max_section_size))\n        }\n    }\n\n    // package outbound sections into a message, and serialize message to the message_write_buffer\n    fn serialize_messages(\u0026mut self) -\u003e Result\u003c(), Error\u003e {\n        // if no pending sections there is nothing to do\n        if self.outbound_sections.is_empty() {\n            return Ok(());\n        }\n\n        // build message and convert to bson to send\n        let message = Message {\n            honk_rpc: HONK_RPC_VERSION,\n            sections: Default::default(),\n        };\n        let mut message = bson::document::Document::from(message);\n        message.insert(\"sections\", std::mem::take(\u0026mut self.outbound_sections));\n        self.serialize_messages_impl(message)\n    }\n\n    // pack sections into messages and serialise them to buffer\n    fn serialize_messages_impl(\n        \u0026mut self,\n        mut message: bson::document::Document,\n    ) -\u003e Result\u003c(), Error\u003e {\n        self.message_serialization_buffer.clear();\n        message\n            .to_writer(\u0026mut self.message_serialization_buffer)\n            .map_err(Error::BsonWriteFailed)?;\n\n        if self.message_serialization_buffer.len() \u003e self.max_message_size {\n            // if we can't split a message anymore then we have a problem\n            let sections = message.get_array_mut(\"sections\").unwrap();\n            assert!(sections.len() \u003e 1);\n\n            let right = doc! {\n                \"honk_rpc\" : HONK_RPC_VERSION,\n                \"sections\" : sections.split_off(sections.len() / 2),\n            };\n            let left = message;\n\n            self.serialize_messages_impl(left)?;\n            self.serialize_messages_impl(right)?;\n        } else {\n            #[cfg(test)]\n            println!(\"\u003e\u003e\u003e write message: {:?}\", message);\n            // copy the serialized message into the pending write buffer\n            self.message_write_buffer\n                .append(\u0026mut self.message_serialization_buffer);\n        }\n\n        Ok(())\n    }\n\n    // write data to stream and remove from write buffer\n    fn write_pending_data(\u0026mut self) -\u003e Result\u003c(), Error\u003e {\n        let bytes_written = self.write_pending_data_impl()?;\n        self.stream.flush().map_err(Error::WriterWriteFailed)?;\n        // removes the written bytes\n        self.message_write_buffer.drain(0..bytes_written);\n        // and shuffles the data so it is contiguous\n        self.message_write_buffer.make_contiguous();\n\n        Ok(())\n    }\n\n    fn write_pending_data_impl(\u0026mut self) -\u003e Result\u003cusize, Error\u003e {\n        // write pending data\n        let (mut pending_data, empty): (\u0026[u8], \u0026[u8]) = self.message_write_buffer.as_slices();\n        assert!(empty.is_empty());\n        let pending_bytes: usize = pending_data.len();\n        let mut bytes_written: usize = 0usize;\n\n        while bytes_written != pending_bytes {\n            match self.stream.write(pending_data) {\n                Err(err) =\u003e {\n                    let kind = err.kind();\n                    if kind == ErrorKind::WouldBlock || kind == ErrorKind::TimedOut {\n                        // no *additional* bytes written so return bytes written so far\n                        return Ok(bytes_written);\n                    } else {\n                        return Err(Error::WriterWriteFailed(err));\n                    }\n                }\n                Ok(count) =\u003e {\n                    bytes_written += count;\n                    #[cfg(test)]\n                    println!(\"\u003e\u003e\u003e sent {} of {} bytes\", bytes_written, pending_bytes);\n                    pending_data = \u0026pending_data[count..];\n                }\n            }\n        }\n\n        Ok(bytes_written)\n    }\n\n    /// Read and process Honk-RPC message documents from connected peer, handle any new incoming Honk-RPC requests, update any in-progress async requests and write pending reponses, errors and requests to peer. This function must be called regularly for the `Session` to make forward progress.\n    pub fn update(\u0026mut self, apisets: Option\u003c\u0026mut [\u0026mut dyn ApiSet]\u003e) -\u003e Result\u003c(), Error\u003e {\n        // read sections from remote\n        self.read_sections()?;\n        // route sections to buffers\n        self.process_sections()?;\n\n        // handle incoming api calls\n        let apisets = apisets.unwrap_or(\u0026mut []);\n        self.handle_requests(apisets)?;\n\n        // serialize pending responses\n        self.serialize_messages()?;\n\n        // write pendng data to writer\n        self.write_pending_data()?;\n\n        Ok(())\n    }\n\n    // apisets : a slice of mutable ApiSet references sorted by their namespaces\n    fn handle_requests(\u0026mut self, apisets: \u0026mut [\u0026mut dyn ApiSet]) -\u003e Result\u003c(), Error\u003e {\n        // first handle all of our inbound requests\n        let mut inbound_requests = std::mem::take(\u0026mut self.inbound_requests);\n        for mut request in inbound_requests.drain(..) {\n            if let Ok(idx) =\n                apisets.binary_search_by(|probe| probe.namespace().cmp(\u0026request.namespace))\n            {\n                let apiset = match apisets.get_mut(idx) {\n                    Some(apiset) =\u003e apiset,\n                    None =\u003e unreachable!(),\n                };\n                match apiset.exec_function(\n                    \u0026request.function,\n                    request.version,\n                    std::mem::take(\u0026mut request.arguments),\n                    request.cookie,\n                ) {\n                    // func found, invoked and succeeded\n                    Some(Ok(result)) =\u003e {\n                        if let Some(cookie) = request.cookie {\n                            self.push_outbound_section(Section::Response(ResponseSection {\n                                cookie,\n                                state: RequestState::Complete,\n                                result,\n                            }))?;\n                        }\n                    }\n                    // func found, invoked and failed\n                    Some(Err(error_code)) =\u003e {\n                        self.push_outbound_section(Section::Error(ErrorSection {\n                            cookie: request.cookie,\n                            code: error_code,\n                            message: None,\n                            data: None,\n                        }))?;\n                    }\n                    // func found, called, and result is pending\n                    None =\u003e {\n                        if let Some(cookie) = request.cookie {\n                            self.push_outbound_section(Section::Response(ResponseSection {\n                                cookie,\n                                state: RequestState::Pending,\n                                result: None,\n                            }))?;\n                        }\n                    }\n                }\n            } else {\n                // invalid namespace\n                self.push_outbound_section(Section::Error(ErrorSection {\n                    cookie: request.cookie,\n                    code: ErrorCode::RequestNamespaceInvalid,\n                    message: None,\n                    data: None,\n                }))?;\n            }\n        }\n\n        // next send out async responses from apisets\n        for apiset in apisets.iter_mut() {\n            // allow apiset to do any required repetitive work\n            apiset.update();\n            // put pending results in our message\n            while let Some((cookie, result)) = apiset.next_result() {\n                match (cookie, result) {\n                    // function completed successfully\n                    (cookie, Ok(result)) =\u003e {\n                        self.push_outbound_section(Section::Response(ResponseSection {\n                            cookie,\n                            state: RequestState::Complete,\n                            result,\n                        }))?;\n                    }\n                    // function completed with failure\n                    (cookie, Err(error_code)) =\u003e {\n                        self.push_outbound_section(Section::Error(ErrorSection {\n                            cookie: Some(cookie),\n                            code: error_code,\n                            message: None,\n                            data: None,\n                        }))?;\n                    }\n                }\n            }\n        }\n        Ok(())\n    }\n\n    /// Performs a client call to a remote function. Returns a `RequestCookie` to associate this client call with a future `Response`.\n    pub fn client_call(\n        \u0026mut self,\n        namespace: \u0026str,\n        function: \u0026str,\n        version: i32,\n        arguments: bson::document::Document,\n    ) -\u003e Result\u003cRequestCookie, Error\u003e {\n        // always make sure we have a new cookie\n        let cookie = self.next_cookie;\n        self.next_cookie += 1;\n\n        // add request to outgoing buffer\n        self.push_outbound_section(Section::Request(RequestSection {\n            cookie: Some(cookie),\n            namespace: namespace.to_string(),\n            function: function.to_string(),\n            version,\n            arguments,\n        }))?;\n\n        Ok(cookie)\n    }\n\n    /// Drains all `Response` objects resulting from prevoius invocations of `Session::client_call()`\n    pub fn client_drain_responses(\u0026mut self) -\u003e std::collections::vec_deque::Drain\u003cResponse\u003e {\n        self.inbound_responses.drain(..)\n    }\n\n    /// Retrieves the next `Response` object from previous invocations of `Session::client_call()`\n    pub fn client_next_response(\u0026mut self) -\u003e Option\u003cResponse\u003e {\n        self.inbound_responses.pop_front()\n    }\n}\n\n#[test]\nfn test_honk_client_read_write() -\u003e anyhow::Result\u003c()\u003e {\n    let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n    let listener = TcpListener::bind(socket_addr)?;\n    let socket_addr = listener.local_addr()?;\n\n    let stream1 = TcpStream::connect(socket_addr)?;\n    stream1.set_nonblocking(true)?;\n    let (stream2, _socket_addr) = listener.accept()?;\n    stream2.set_nonblocking(true)?;\n\n    let mut alice = Session::new(stream1);\n    let mut pat = Session::new(stream2);\n\n    println!(\"--- pat reads message, but none has been sent\");\n\n    // no message sent yet\n    assert!(pat.read_message()?.is_none());\n\n    println!(\"--- alice sends no message, but no pending sections so no message sent\");\n\n    // send an empty message\n    alice.serialize_messages()?;\n    alice.write_pending_data()?;\n\n    println!(\"--- pat reads message, but none has been sent\");\n\n    // ensure no mesage as actually sent\n    match pat.read_message() {\n        Ok(Some(msg)) =\u003e panic!(\n            \"message should not have been sent: {}\",\n            bson::document::Document::from(msg)\n        ),\n        Ok(None) =\u003e {}\n        Err(err) =\u003e panic!(\"{:?}\", err),\n    }\n\n    println!(\"--- pat sends an error message\");\n\n    const CUSTOM_ERROR: \u0026str = \"Custom Error!\";\n\n    pat.push_outbound_section(Section::Error(ErrorSection {\n        cookie: Some(42069),\n        code: ErrorCode::Runtime(1),\n        message: Some(CUSTOM_ERROR.to_string()),\n        data: None,\n    }))?;\n\n    pat.serialize_messages()?;\n    pat.write_pending_data()?;\n\n    println!(\"--- alice reads and verifies message\");\n\n    // wait for alice to receive message\n    let mut alice_read_message: bool = false;\n    while !alice_read_message {\n        // println!(\"reading...\");\n        if let Some(mut msg) = alice.read_message()? {\n            assert_eq!(msg.sections.len(), 1);\n            match msg.sections.pop() {\n                Some(Section::Error(section)) =\u003e {\n                    match (section.cookie, section.code, section.message) {\n                        (Some(42069), ErrorCode::Runtime(1), Some(message)) =\u003e {\n                            assert_eq!(message, CUSTOM_ERROR);\n                            alice_read_message = true;\n                        }\n                        (cookie, code, message) =\u003e panic!(\n                            \"unexpected error section: cookie: {:?}, code: {:?}, message: {:?}\",\n                            cookie, code, message\n                        ),\n                    };\n                }\n                Some(_) =\u003e panic!(\"was expecting an Error section\"),\n                None =\u003e panic!(\"we should have a message\"),\n            }\n        }\n    }\n\n    println!(\"--- alice sends multi-section message\");\n\n    alice.push_outbound_section(Section::Error(ErrorSection {\n        cookie: Some(42069),\n        code: ErrorCode::Runtime(2),\n        message: Some(CUSTOM_ERROR.to_string()),\n        data: None,\n    }))?;\n    alice.push_outbound_section(Section::Request(RequestSection {\n        cookie: None,\n        namespace: \"std\".to_string(),\n        function: \"print\".to_string(),\n        version: 0,\n        arguments: doc! {\"message\": \"hello!\"},\n    }))?;\n    alice.push_outbound_section(Section::Response(ResponseSection {\n        cookie: 123456,\n        state: RequestState::Pending,\n        result: None,\n    }))?;\n\n    // send a multi-section mesage\n    alice.serialize_messages()?;\n    alice.write_pending_data()?;\n\n    println!(\"--- pat reads and verifies multi-section message\");\n\n    // read sections sent to pat\n    let mut pat_read_message: bool = false;\n    while !pat_read_message {\n        if let Some(msg) = pat.read_message()? {\n            assert_eq!(msg.sections.len(), 3);\n            for section in msg.sections.iter() {\n                match section {\n                    Section::Error(section) =\u003e {\n                        assert_eq!(section.cookie, Some(42069));\n                        assert_eq!(section.code, ErrorCode::Runtime(2));\n                        assert_eq!(section.message, Some(CUSTOM_ERROR.to_string()));\n                        assert_eq!(section.data, None);\n                    }\n                    Section::Request(section) =\u003e {\n                        assert_eq!(section.cookie, None);\n                        assert_eq!(section.namespace, \"std\");\n                        assert_eq!(section.function, \"print\");\n                        assert_eq!(section.version, 0i32);\n                    }\n                    Section::Response(section) =\u003e {\n                        assert_eq!(section.cookie, 123456);\n                        assert_eq!(section.state, RequestState::Pending);\n                        assert_eq!(section.result, None);\n                    }\n                }\n            }\n            pat_read_message = true;\n        }\n    }\n\n    Ok(())\n}\n\n#[cfg(test)]\nstruct TestApiSet {\n    call_count: usize,\n}\n\n#[cfg(test)]\nimpl ApiSet for TestApiSet {\n    fn namespace(\u0026self) -\u003e \u0026str {\n        \"namespace\"\n    }\n\n    fn exec_function(\n        \u0026mut self,\n        name: \u0026str,\n        version: i32,\n        _args: bson::document::Document,\n        _request_section: Option\u003cRequestCookie\u003e,\n    ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n        match (name, version) {\n            (\"function\", 0) =\u003e {\n                println!(\"--- namespace::function_0() called\");\n                self.call_count += 1;\n            }\n            _ =\u003e (),\n        }\n        Some(Ok(None))\n    }\n}\n\n#[test]\nfn test_honk_timeout() -\u003e anyhow::Result\u003c()\u003e {\n    let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n    let listener = TcpListener::bind(socket_addr)?;\n    let socket_addr = listener.local_addr()?;\n\n    let alice_stream = TcpStream::connect(socket_addr)?;\n    alice_stream.set_nonblocking(true)?;\n    alice_stream.set_nodelay(true)?;\n    println!(\"--- alice peer_addr: {}\", alice_stream.peer_addr()?);\n    let (pat_stream, _socket_addr) = listener.accept()?;\n    pat_stream.set_nonblocking(true)?;\n    pat_stream.set_nodelay(true)?;\n\n    let mut alice = Session::new(alice_stream);\n    let mut alice_apiset = TestApiSet { call_count: 0usize };\n    let mut pat = Session::new(pat_stream);\n\n    let start = std::time::Instant::now();\n\n    println!(\n        \"--- {:?} alice set max_wait_time to 3 seconds\",\n        std::time::Instant::now().duration_since(start)\n    );\n    alice.update(None)?;\n    alice.set_max_wait_time(std::time::Duration::from_secs(3));\n    alice.update(None)?;\n\n    // a read will happen so time should reset\n    println!(\n        \"--- {:?} sleep 2 seconds\",\n        std::time::Instant::now().duration_since(start)\n    );\n    std::thread::sleep(std::time::Duration::from_secs(2));\n\n    println!(\n        \"--- {:?} pat calls namespace::function_0()\",\n        std::time::Instant::now().duration_since(start)\n    );\n    pat.client_call(\"namespace\", \"function\", 0, doc! {})?;\n    while alice_apiset.call_count != 1 {\n        pat.update(None)?;\n        alice.update(Some(\u0026mut [\u0026mut alice_apiset]))?;\n    }\n\n    // a read will happen so time should reset\n    println!(\n        \"--- {:?} sleep 2 seconds\",\n        std::time::Instant::now().duration_since(start)\n    );\n    std::thread::sleep(std::time::Duration::from_secs(2));\n    pat.update(None)?;\n    alice.update(None)?;\n\n    println!(\n        \"--- {:?} pat calls namespace::function_0()\",\n        std::time::Instant::now().duration_since(start)\n    );\n    pat.client_call(\"namespace\", \"function\", 0, doc! {})?;\n    while alice_apiset.call_count != 2 {\n        pat.update(None)?;\n        alice.update(Some(\u0026mut [\u0026mut alice_apiset]))?;\n    }\n\n    // on reads occur so alice should timeout\n    println!(\n        \"--- {:?} sleep 4 seconds\",\n        std::time::Instant::now().duration_since(start)\n    );\n    std::thread::sleep(std::time::Duration::from_secs(4));\n\n    println!(\n        \"--- {:?} pat+alice update\",\n        std::time::Instant::now().duration_since(start)\n    );\n    pat.update(None)?;\n    match alice.update(None) {\n        Ok(()) =\u003e panic!(\"should have timed out\"),\n        Err(Error::MessageReadTimedOut(duration)) =\u003e {\n            println!(\"--- expected time out after {:?}\", duration)\n        }\n        Err(err) =\u003e panic!(\"unexpected error: {:?}\", err),\n    }\n    Ok(())\n}\n","traces":[{"line":105,"address":[16488528],"length":1,"stats":{"Line":3}},{"line":106,"address":[3178842],"length":1,"stats":{"Line":3}},{"line":107,"address":[16488589],"length":1,"stats":{"Line":0}},{"line":108,"address":[3178903],"length":1,"stats":{"Line":0}},{"line":109,"address":[16452881],"length":1,"stats":{"Line":0}},{"line":110,"address":[14401787],"length":1,"stats":{"Line":0}},{"line":111,"address":[14401797],"length":1,"stats":{"Line":0}},{"line":112,"address":[478223],"length":1,"stats":{"Line":0}},{"line":113,"address":[1707385],"length":1,"stats":{"Line":0}},{"line":114,"address":[1707395],"length":1,"stats":{"Line":0}},{"line":115,"address":[14401837],"length":1,"stats":{"Line":0}},{"line":116,"address":[14401847],"length":1,"stats":{"Line":0}},{"line":117,"address":[16488689],"length":1,"stats":{"Line":0}},{"line":118,"address":[478283],"length":1,"stats":{"Line":0}},{"line":120,"address":[1707486,1707314,1707468],"length":1,"stats":{"Line":6}},{"line":121,"address":[16488738],"length":1,"stats":{"Line":3}},{"line":123,"address":[1707456],"length":1,"stats":{"Line":0}},{"line":131,"address":[16488752],"length":1,"stats":{"Line":3}},{"line":132,"address":[16488760],"length":1,"stats":{"Line":3}},{"line":133,"address":[16488792],"length":1,"stats":{"Line":0}},{"line":134,"address":[3179109],"length":1,"stats":{"Line":0}},{"line":135,"address":[1707551],"length":1,"stats":{"Line":0}},{"line":136,"address":[1707561],"length":1,"stats":{"Line":0}},{"line":137,"address":[3179139],"length":1,"stats":{"Line":0}},{"line":138,"address":[14402013],"length":1,"stats":{"Line":0}},{"line":139,"address":[1707591],"length":1,"stats":{"Line":0}},{"line":140,"address":[478449],"length":1,"stats":{"Line":0}},{"line":141,"address":[14402043],"length":1,"stats":{"Line":0}},{"line":142,"address":[14402053],"length":1,"stats":{"Line":0}},{"line":143,"address":[16488895],"length":1,"stats":{"Line":0}},{"line":144,"address":[3179209],"length":1,"stats":{"Line":0}},{"line":145,"address":[16488915],"length":1,"stats":{"Line":3}},{"line":146,"address":[14402097],"length":1,"stats":{"Line":0}},{"line":152,"address":[14402128],"length":1,"stats":{"Line":1}},{"line":153,"address":[3179297],"length":1,"stats":{"Line":1}},{"line":154,"address":[14402191],"length":1,"stats":{"Line":0}},{"line":155,"address":[14402235],"length":1,"stats":{"Line":0}},{"line":157,"address":[16453383],"length":1,"stats":{"Line":0}},{"line":159,"address":[478745],"length":1,"stats":{"Line":0}},{"line":163,"address":[16489211],"length":1,"stats":{"Line":0}},{"line":167,"address":[16453533],"length":1,"stats":{"Line":0}},{"line":172,"address":[1708047],"length":1,"stats":{"Line":0}},{"line":174,"address":[1708097],"length":1,"stats":{"Line":0}},{"line":179,"address":[3179715],"length":1,"stats":{"Line":0}},{"line":182,"address":[479045],"length":1,"stats":{"Line":0}},{"line":185,"address":[479095],"length":1,"stats":{"Line":0}},{"line":187,"address":[16453833],"length":1,"stats":{"Line":0}},{"line":188,"address":[3180042,3179920],"length":1,"stats":{"Line":2}},{"line":189,"address":[479539,479417],"length":1,"stats":{"Line":0}},{"line":197,"address":[14403232],"length":1,"stats":{"Line":0}},{"line":198,"address":[16454356],"length":1,"stats":{"Line":0}},{"line":199,"address":[16454363],"length":1,"stats":{"Line":0}},{"line":200,"address":[16454370],"length":1,"stats":{"Line":0}},{"line":201,"address":[14403273],"length":1,"stats":{"Line":0}},{"line":204,"address":[1708864],"length":1,"stats":{"Line":0}},{"line":205,"address":[16490146,16490136],"length":1,"stats":{"Line":0}},{"line":206,"address":[16490163],"length":1,"stats":{"Line":0}},{"line":207,"address":[16454450],"length":1,"stats":{"Line":0}},{"line":208,"address":[1708929],"length":1,"stats":{"Line":0}},{"line":209,"address":[14403370],"length":1,"stats":{"Line":0}},{"line":211,"address":[1708877],"length":1,"stats":{"Line":0}},{"line":226,"address":[16491862,16492161,16490256],"length":1,"stats":{"Line":5}},{"line":227,"address":[1709017],"length":1,"stats":{"Line":4}},{"line":230,"address":[1709009,1709093,1709172],"length":1,"stats":{"Line":12}},{"line":232,"address":[1709336],"length":1,"stats":{"Line":0}},{"line":233,"address":[16491976,16490614,16492094],"length":1,"stats":{"Line":0}},{"line":235,"address":[1710786],"length":1,"stats":{"Line":0}},{"line":238,"address":[3182405],"length":1,"stats":{"Line":0}},{"line":241,"address":[1709234],"length":1,"stats":{"Line":0}},{"line":244,"address":[14404370,14403796,14403732,14403899],"length":1,"stats":{"Line":12}},{"line":246,"address":[1709403,1709476],"length":1,"stats":{"Line":8}},{"line":247,"address":[3181074],"length":1,"stats":{"Line":0}},{"line":252,"address":[16455018],"length":1,"stats":{"Line":4}},{"line":255,"address":[480506,480756,481300,480439],"length":1,"stats":{"Line":19}},{"line":256,"address":[480803,480780],"length":1,"stats":{"Line":10}},{"line":257,"address":[14404579,14404731,14404964],"length":1,"stats":{"Line":8}},{"line":259,"address":[1710179],"length":1,"stats":{"Line":0}},{"line":262,"address":[14404259],"length":1,"stats":{"Line":4}},{"line":264,"address":[3180991],"length":1,"stats":{"Line":0}},{"line":270,"address":[14429670,14428848,14429701],"length":1,"stats":{"Line":4}},{"line":271,"address":[1734433],"length":1,"stats":{"Line":4}},{"line":272,"address":[16479994],"length":1,"stats":{"Line":4}},{"line":273,"address":[16515779,16515858],"length":1,"stats":{"Line":8}},{"line":275,"address":[16480149],"length":1,"stats":{"Line":4}},{"line":276,"address":[16515970,16516172,16515896,16516094],"length":1,"stats":{"Line":13}},{"line":277,"address":[14429347,14429524],"length":1,"stats":{"Line":0}},{"line":281,"address":[3206505],"length":1,"stats":{"Line":4}},{"line":283,"address":[16516309],"length":1,"stats":{"Line":4}},{"line":331,"address":[16456448,16457744,16457773],"length":1,"stats":{"Line":4}},{"line":334,"address":[16456568,16456478],"length":1,"stats":{"Line":8}},{"line":335,"address":[482538,482017,482358],"length":1,"stats":{"Line":6}},{"line":336,"address":[14406205,14405763],"length":1,"stats":{"Line":8}},{"line":337,"address":[16493242,16492709],"length":1,"stats":{"Line":8}},{"line":338,"address":[16456705],"length":1,"stats":{"Line":0}},{"line":339,"address":[481921],"length":1,"stats":{"Line":0}},{"line":345,"address":[16480832],"length":1,"stats":{"Line":4}},{"line":346,"address":[1735318],"length":1,"stats":{"Line":4}},{"line":347,"address":[14429787],"length":1,"stats":{"Line":3}},{"line":348,"address":[3206965],"length":1,"stats":{"Line":4}},{"line":349,"address":[14429877],"length":1,"stats":{"Line":4}},{"line":357,"address":[16458871,16457792,16458849],"length":1,"stats":{"Line":3}},{"line":358,"address":[16457809],"length":1,"stats":{"Line":3}},{"line":360,"address":[14406761,14406894,14406838],"length":1,"stats":{"Line":6}},{"line":361,"address":[16493688],"length":1,"stats":{"Line":3}},{"line":362,"address":[3184083],"length":1,"stats":{"Line":0}},{"line":363,"address":[16458070],"length":1,"stats":{"Line":0}},{"line":366,"address":[16493746,16493846],"length":1,"stats":{"Line":6}},{"line":367,"address":[16458249,16458160],"length":1,"stats":{"Line":6}},{"line":368,"address":[16458198],"length":1,"stats":{"Line":0}},{"line":371,"address":[16494115,16494003],"length":1,"stats":{"Line":5}},{"line":372,"address":[16458340,16458407],"length":1,"stats":{"Line":2}},{"line":373,"address":[1712951],"length":1,"stats":{"Line":2}},{"line":374,"address":[16458512],"length":1,"stats":{"Line":0}},{"line":377,"address":[1712919,1713067],"length":1,"stats":{"Line":6}},{"line":379,"address":[14407590],"length":1,"stats":{"Line":3}},{"line":380,"address":[14407526],"length":1,"stats":{"Line":3}},{"line":382,"address":[16494374],"length":1,"stats":{"Line":3}},{"line":389,"address":[14430927,14429936,14430894],"length":1,"stats":{"Line":3}},{"line":390,"address":[1121990],"length":1,"stats":{"Line":3}},{"line":391,"address":[1122178,1122105],"length":1,"stats":{"Line":6}},{"line":393,"address":[16517006],"length":1,"stats":{"Line":3}},{"line":394,"address":[1122225,1122292],"length":1,"stats":{"Line":6}},{"line":397,"address":[16517070,16517128],"length":1,"stats":{"Line":6}},{"line":399,"address":[16481460],"length":1,"stats":{"Line":3}},{"line":400,"address":[16481613,16481528],"length":1,"stats":{"Line":2}},{"line":403,"address":[3207609,3207669],"length":1,"stats":{"Line":3}},{"line":404,"address":[16481834,16481732],"length":1,"stats":{"Line":0}},{"line":407,"address":[1736245],"length":1,"stats":{"Line":3}},{"line":414,"address":[485736,484112,485714],"length":1,"stats":{"Line":4}},{"line":415,"address":[14407809],"length":1,"stats":{"Line":4}},{"line":417,"address":[3185007,3185084,3185140],"length":1,"stats":{"Line":9}},{"line":418,"address":[1713534],"length":1,"stats":{"Line":4}},{"line":419,"address":[3185196],"length":1,"stats":{"Line":1}},{"line":420,"address":[484399],"length":1,"stats":{"Line":0}},{"line":423,"address":[1713690,1713766,1713592],"length":1,"stats":{"Line":8}},{"line":424,"address":[16494983,16495050],"length":1,"stats":{"Line":9}},{"line":425,"address":[3185400,3185455],"length":1,"stats":{"Line":0}},{"line":426,"address":[3185412],"length":1,"stats":{"Line":0}},{"line":429,"address":[1713788,1713933],"length":1,"stats":{"Line":10}},{"line":430,"address":[3185530],"length":1,"stats":{"Line":5}},{"line":431,"address":[16459540,16459603],"length":1,"stats":{"Line":9}},{"line":432,"address":[1714103],"length":1,"stats":{"Line":0}},{"line":434,"address":[3185659],"length":1,"stats":{"Line":4}},{"line":437,"address":[484772],"length":1,"stats":{"Line":0}},{"line":440,"address":[16459682,16459764,16459829],"length":1,"stats":{"Line":12}},{"line":441,"address":[485022],"length":1,"stats":{"Line":1}},{"line":442,"address":[16495613],"length":1,"stats":{"Line":4}},{"line":443,"address":[16495631],"length":1,"stats":{"Line":0}},{"line":446,"address":[485065,485158,485207],"length":1,"stats":{"Line":8}},{"line":447,"address":[16495754,16495692],"length":1,"stats":{"Line":8}},{"line":448,"address":[16460386,16460450],"length":1,"stats":{"Line":0}},{"line":449,"address":[16460410],"length":1,"stats":{"Line":0}},{"line":452,"address":[16495929],"length":1,"stats":{"Line":4}},{"line":453,"address":[16495756],"length":1,"stats":{"Line":4}},{"line":454,"address":[14408950],"length":1,"stats":{"Line":4}},{"line":455,"address":[1714566],"length":1,"stats":{"Line":4}},{"line":456,"address":[3186182],"length":1,"stats":{"Line":4}},{"line":457,"address":[485369],"length":1,"stats":{"Line":4}},{"line":463,"address":[3209138,3208224,3209065],"length":1,"stats":{"Line":4}},{"line":464,"address":[16517942],"length":1,"stats":{"Line":4}},{"line":465,"address":[1736863,1736783],"length":1,"stats":{"Line":8}},{"line":467,"address":[16482423],"length":1,"stats":{"Line":4}},{"line":468,"address":[16518174,16518230],"length":1,"stats":{"Line":8}},{"line":471,"address":[1736951,1736989],"length":1,"stats":{"Line":8}},{"line":472,"address":[14431589,14431432],"length":1,"stats":{"Line":9}},{"line":475,"address":[3208744,3208649],"length":1,"stats":{"Line":9}},{"line":477,"address":[14431632],"length":1,"stats":{"Line":5}},{"line":478,"address":[3208921],"length":1,"stats":{"Line":1}},{"line":481,"address":[16482954,16482754],"length":1,"stats":{"Line":10}},{"line":483,"address":[14431874],"length":1,"stats":{"Line":5}},{"line":490,"address":[16461420,16460544],"length":1,"stats":{"Line":4}},{"line":491,"address":[16460561],"length":1,"stats":{"Line":4}},{"line":492,"address":[14409593,14409516],"length":1,"stats":{"Line":8}},{"line":493,"address":[3186747],"length":1,"stats":{"Line":4}},{"line":494,"address":[3186806],"length":1,"stats":{"Line":0}},{"line":497,"address":[16496556,16496464],"length":1,"stats":{"Line":8}},{"line":498,"address":[1715470],"length":1,"stats":{"Line":4}},{"line":499,"address":[16496747],"length":1,"stats":{"Line":4}},{"line":500,"address":[14409853],"length":1,"stats":{"Line":0}},{"line":501,"address":[486119],"length":1,"stats":{"Line":0}},{"line":504,"address":[486246],"length":1,"stats":{"Line":4}},{"line":507,"address":[16497018,16496889,16496815],"length":1,"stats":{"Line":12}},{"line":508,"address":[16461331],"length":1,"stats":{"Line":0}},{"line":511,"address":[16461213],"length":1,"stats":{"Line":4}},{"line":513,"address":[16496895],"length":1,"stats":{"Line":4}},{"line":514,"address":[16461178],"length":1,"stats":{"Line":4}},{"line":520,"address":[16518880,16519526,16519545],"length":1,"stats":{"Line":4}},{"line":521,"address":[16518902],"length":1,"stats":{"Line":4}},{"line":522,"address":[16519077,16519000],"length":1,"stats":{"Line":8}},{"line":524,"address":[3209402],"length":1,"stats":{"Line":4}},{"line":525,"address":[3209466],"length":1,"stats":{"Line":4}},{"line":527,"address":[1124380],"length":1,"stats":{"Line":4}},{"line":528,"address":[3209674,3209775],"length":1,"stats":{"Line":6}},{"line":531,"address":[16483691],"length":1,"stats":{"Line":4}},{"line":656,"address":[3977024,3977029],"length":1,"stats":{"Line":12}},{"line":665,"address":[1126576],"length":1,"stats":{"Line":1}},{"line":666,"address":[],"length":0,"stats":{"Line":1}},{"line":715,"address":[486656,487724],"length":1,"stats":{"Line":2}},{"line":718,"address":[3187716,3188606,3187505],"length":1,"stats":{"Line":4}},{"line":721,"address":[486876],"length":1,"stats":{"Line":2}},{"line":725,"address":[1716595,1716653],"length":1,"stats":{"Line":4}},{"line":726,"address":[14411093,14411358],"length":1,"stats":{"Line":2}},{"line":728,"address":[1716814],"length":1,"stats":{"Line":0}},{"line":730,"address":[16462318,16462498],"length":1,"stats":{"Line":4}},{"line":737,"address":[16464355,16462592,16464303],"length":1,"stats":{"Line":0}},{"line":742,"address":[16462746,16462943,16462629],"length":1,"stats":{"Line":0}},{"line":744,"address":[3188913],"length":1,"stats":{"Line":0}},{"line":747,"address":[14411954],"length":1,"stats":{"Line":0}},{"line":748,"address":[488394,488243],"length":1,"stats":{"Line":0}},{"line":751,"address":[3189186,3189286],"length":1,"stats":{"Line":0}},{"line":752,"address":[488583,488449],"length":1,"stats":{"Line":0}},{"line":755,"address":[14412280,14412339],"length":1,"stats":{"Line":0}},{"line":756,"address":[14412430,14412486],"length":1,"stats":{"Line":0}},{"line":759,"address":[3189610,3189646],"length":1,"stats":{"Line":0}},{"line":760,"address":[3189654,3188651,3189919],"length":1,"stats":{"Line":0}},{"line":762,"address":[3189807],"length":1,"stats":{"Line":0}},{"line":764,"address":[3189775,3189958],"length":1,"stats":{"Line":0}},{"line":771,"address":[1718848,1720818,1720713],"length":1,"stats":{"Line":2}},{"line":778,"address":[16464583,16464807,16464450],"length":1,"stats":{"Line":6}},{"line":780,"address":[16464726],"length":1,"stats":{"Line":2}},{"line":783,"address":[490082],"length":1,"stats":{"Line":2}},{"line":784,"address":[3191134,3190983],"length":1,"stats":{"Line":4}},{"line":787,"address":[1719490,1719590],"length":1,"stats":{"Line":4}},{"line":788,"address":[3191295,3191189],"length":1,"stats":{"Line":4}},{"line":791,"address":[16465282,16465251],"length":1,"stats":{"Line":4}},{"line":792,"address":[1719866,1719757],"length":1,"stats":{"Line":4}},{"line":795,"address":[3191399,3191458],"length":1,"stats":{"Line":4}},{"line":796,"address":[1719969,1720025],"length":1,"stats":{"Line":4}},{"line":799,"address":[16501277,16501313],"length":1,"stats":{"Line":4}},{"line":800,"address":[3190463,3191625,3191890],"length":1,"stats":{"Line":4}},{"line":802,"address":[16465746],"length":1,"stats":{"Line":0}},{"line":804,"address":[1720178,1720361],"length":1,"stats":{"Line":4}},{"line":811,"address":[16467687,16467668,16466384],"length":1,"stats":{"Line":2}},{"line":812,"address":[16502134,16502235,16502403,16502532],"length":1,"stats":{"Line":8}},{"line":814,"address":[491781],"length":1,"stats":{"Line":2}},{"line":815,"address":[3192807],"length":1,"stats":{"Line":2}},{"line":818,"address":[492068],"length":1,"stats":{"Line":2}},{"line":819,"address":[3193094,3193191],"length":1,"stats":{"Line":4}},{"line":822,"address":[492319,492242],"length":1,"stats":{"Line":4}},{"line":823,"address":[492575,492348],"length":1,"stats":{"Line":2}},{"line":825,"address":[492463],"length":1,"stats":{"Line":0}},{"line":827,"address":[1721776,1721954],"length":1,"stats":{"Line":4}},{"line":878,"address":[4476080],"length":1,"stats":{"Line":1}},{"line":879,"address":[2045891,2045849],"length":1,"stats":{"Line":2}},{"line":881,"address":[1731866],"length":1,"stats":{"Line":0}},{"line":883,"address":[4436396],"length":1,"stats":{"Line":1}},{"line":884,"address":[],"length":0,"stats":{"Line":1}},{"line":889,"address":[4476064],"length":1,"stats":{"Line":2}},{"line":890,"address":[4476069],"length":1,"stats":{"Line":2}},{"line":894,"address":[4475088],"length":1,"stats":{"Line":2}},{"line":895,"address":[],"length":0,"stats":{"Line":2}},{"line":899,"address":[],"length":0,"stats":{"Line":0}},{"line":900,"address":[],"length":0,"stats":{"Line":0}},{"line":904,"address":[2051020,2050932,2049728],"length":1,"stats":{"Line":5}},{"line":905,"address":[1126661],"length":1,"stats":{"Line":5}},{"line":906,"address":[1126746],"length":1,"stats":{"Line":5}},{"line":908,"address":[4440433],"length":1,"stats":{"Line":5}},{"line":909,"address":[2049921],"length":1,"stats":{"Line":5}},{"line":915,"address":[990431],"length":1,"stats":{"Line":5}},{"line":916,"address":[4480379],"length":1,"stats":{"Line":5}},{"line":917,"address":[1736071],"length":1,"stats":{"Line":5}},{"line":918,"address":[1736123],"length":1,"stats":{"Line":5}},{"line":920,"address":[],"length":0,"stats":{"Line":0}},{"line":921,"address":[4480665],"length":1,"stats":{"Line":5}},{"line":924,"address":[990764],"length":1,"stats":{"Line":5}},{"line":929,"address":[4462690,4462304],"length":1,"stats":{"Line":2}},{"line":930,"address":[1718265],"length":1,"stats":{"Line":2}},{"line":934,"address":[4462720,4463560],"length":1,"stats":{"Line":5}},{"line":935,"address":[4423056],"length":1,"stats":{"Line":5}},{"line":936,"address":[973377],"length":1,"stats":{"Line":5}},{"line":937,"address":[1128056,1128274,1128351],"length":1,"stats":{"Line":10}},{"line":939,"address":[1719047,1719433,1719203,1719354,1719295],"length":1,"stats":{"Line":25}},{"line":940,"address":[2033112],"length":1,"stats":{"Line":6}},{"line":942,"address":[1719369],"length":1,"stats":{"Line":1}},{"line":944,"address":[4463429],"length":1,"stats":{"Line":6}},{"line":947,"address":[4423465],"length":1,"stats":{"Line":0}},{"line":950,"address":[1718798],"length":1,"stats":{"Line":2}},{"line":951,"address":[973414],"length":1,"stats":{"Line":2}},{"line":953,"address":[973486],"length":1,"stats":{"Line":4}},{"line":955,"address":[1128160],"length":1,"stats":{"Line":5}},{"line":956,"address":[2032743],"length":1,"stats":{"Line":5}},{"line":962,"address":[],"length":0,"stats":{"Line":4}},{"line":963,"address":[1729444],"length":1,"stats":{"Line":4}},{"line":965,"address":[984110],"length":1,"stats":{"Line":0}},{"line":967,"address":[],"length":0,"stats":{"Line":0}},{"line":969,"address":[4433999,4434060],"length":1,"stats":{"Line":4}},{"line":970,"address":[],"length":0,"stats":{"Line":4}},{"line":972,"address":[2043618],"length":1,"stats":{"Line":5}},{"line":974,"address":[984251],"length":1,"stats":{"Line":5}},{"line":975,"address":[984314,984380],"length":1,"stats":{"Line":10}},{"line":976,"address":[984393],"length":1,"stats":{"Line":3}},{"line":977,"address":[4434380],"length":1,"stats":{"Line":5}},{"line":978,"address":[2043885],"length":1,"stats":{"Line":5}},{"line":981,"address":[4434638,4434434],"length":1,"stats":{"Line":10}},{"line":982,"address":[1129425],"length":1,"stats":{"Line":1}},{"line":985,"address":[4434649,4435311],"length":1,"stats":{"Line":10}},{"line":986,"address":[4434711],"length":1,"stats":{"Line":5}},{"line":987,"address":[985087,984935,985011,984831,984896],"length":1,"stats":{"Line":20}},{"line":988,"address":[4474532,4474586,4474637],"length":1,"stats":{"Line":10}},{"line":989,"address":[2044390,2044335,2044441],"length":1,"stats":{"Line":10}},{"line":990,"address":[4474683,4474738,4474782],"length":1,"stats":{"Line":10}},{"line":992,"address":[985100],"length":1,"stats":{"Line":5}},{"line":993,"address":[1730547],"length":1,"stats":{"Line":0}},{"line":996,"address":[985146],"length":1,"stats":{"Line":5}},{"line":997,"address":[4435195],"length":1,"stats":{"Line":0}},{"line":998,"address":[],"length":0,"stats":{"Line":0}},{"line":999,"address":[1730642],"length":1,"stats":{"Line":0}},{"line":1004,"address":[4435260,4435145,4435316],"length":1,"stats":{"Line":10}},{"line":1006,"address":[1130252],"length":1,"stats":{"Line":5}},{"line":1008,"address":[1730145],"length":1,"stats":{"Line":5}},{"line":1016,"address":[976536,976609,974112],"length":1,"stats":{"Line":4}},{"line":1018,"address":[1719614,1719510],"length":1,"stats":{"Line":7}},{"line":1020,"address":[1719603,1719826,1719672],"length":1,"stats":{"Line":15}},{"line":1024,"address":[2033515],"length":1,"stats":{"Line":5}},{"line":1025,"address":[1719898,1719718],"length":1,"stats":{"Line":10}},{"line":1026,"address":[4424314],"length":1,"stats":{"Line":0}},{"line":1027,"address":[4424373],"length":1,"stats":{"Line":0}},{"line":1028,"address":[],"length":0,"stats":{"Line":5}},{"line":1032,"address":[4464224,4464349],"length":1,"stats":{"Line":9}},{"line":1033,"address":[],"length":0,"stats":{"Line":5}},{"line":1034,"address":[4464370,4464610,4465854],"length":1,"stats":{"Line":8}},{"line":1035,"address":[4424668],"length":1,"stats":{"Line":4}},{"line":1037,"address":[974967,975167],"length":1,"stats":{"Line":8}},{"line":1038,"address":[4424926,4424994,4425474],"length":1,"stats":{"Line":8}},{"line":1039,"address":[4465106],"length":1,"stats":{"Line":0}},{"line":1042,"address":[],"length":0,"stats":{"Line":8}},{"line":1043,"address":[4465409],"length":1,"stats":{"Line":5}},{"line":1048,"address":[2035441],"length":1,"stats":{"Line":4}},{"line":1049,"address":[976348,975912],"length":1,"stats":{"Line":5}},{"line":1053,"address":[975131,975004,974905],"length":1,"stats":{"Line":0}},{"line":1054,"address":[1720425],"length":1,"stats":{"Line":0}},{"line":1059,"address":[],"length":0,"stats":{"Line":5}},{"line":1064,"address":[4466160,4466711],"length":1,"stats":{"Line":4}},{"line":1065,"address":[4426962,4426446],"length":1,"stats":{"Line":8}},{"line":1066,"address":[4466203],"length":1,"stats":{"Line":4}},{"line":1067,"address":[1722329],"length":1,"stats":{"Line":4}},{"line":1068,"address":[4466516,4466639],"length":1,"stats":{"Line":8}},{"line":1070,"address":[],"length":0,"stats":{"Line":4}},{"line":1071,"address":[4426543],"length":1,"stats":{"Line":3}},{"line":1072,"address":[1722231],"length":1,"stats":{"Line":3}},{"line":1074,"address":[],"length":0,"stats":{"Line":0}},{"line":1076,"address":[4427151,4427056,4427120],"length":1,"stats":{"Line":8}},{"line":1078,"address":[4466924],"length":1,"stats":{"Line":1}},{"line":1080,"address":[2036603],"length":1,"stats":{"Line":2}},{"line":1083,"address":[2036461],"length":1,"stats":{"Line":0}},{"line":1091,"address":[],"length":0,"stats":{"Line":4}},{"line":1092,"address":[4472526],"length":1,"stats":{"Line":4}},{"line":1093,"address":[],"length":0,"stats":{"Line":4}},{"line":1094,"address":[4472678],"length":1,"stats":{"Line":2}},{"line":1095,"address":[1134402,1134645],"length":1,"stats":{"Line":4}},{"line":1097,"address":[2042714,2042696],"length":1,"stats":{"Line":4}},{"line":1098,"address":[],"length":0,"stats":{"Line":0}},{"line":1099,"address":[1134665],"length":1,"stats":{"Line":2}},{"line":1102,"address":[2042778],"length":1,"stats":{"Line":0}},{"line":1105,"address":[4472728],"length":1,"stats":{"Line":4}},{"line":1107,"address":[2042491],"length":1,"stats":{"Line":4}},{"line":1109,"address":[1728511],"length":1,"stats":{"Line":4}},{"line":1112,"address":[1728541],"length":1,"stats":{"Line":4}},{"line":1113,"address":[],"length":0,"stats":{"Line":4}},{"line":1114,"address":[4473439,4473563,4473633],"length":1,"stats":{"Line":12}},{"line":1115,"address":[1135122],"length":1,"stats":{"Line":4}},{"line":1117,"address":[983575],"length":1,"stats":{"Line":3}},{"line":1118,"address":[4433875,4433532,4433502],"length":1,"stats":{"Line":9}},{"line":1119,"address":[2042978],"length":1,"stats":{"Line":3}},{"line":1126,"address":[],"length":0,"stats":{"Line":4}},{"line":1130,"address":[987256,986352],"length":1,"stats":{"Line":4}},{"line":1131,"address":[986461,986387],"length":1,"stats":{"Line":4}},{"line":1133,"address":[4436660,4436577],"length":1,"stats":{"Line":8}},{"line":1134,"address":[],"length":0,"stats":{"Line":4}},{"line":1135,"address":[4476779,4476550,4476251,4476480],"length":1,"stats":{"Line":14}},{"line":1136,"address":[],"length":0,"stats":{"Line":0}},{"line":1137,"address":[4476667],"length":1,"stats":{"Line":0}},{"line":1138,"address":[2046545,2046367],"length":1,"stats":{"Line":10}},{"line":1140,"address":[987170,986945,987016],"length":1,"stats":{"Line":10}},{"line":1141,"address":[2046631],"length":1,"stats":{"Line":5}},{"line":1142,"address":[4437297],"length":1,"stats":{"Line":5}},{"line":1144,"address":[2046572],"length":1,"stats":{"Line":0}},{"line":1149,"address":[4435376,4435814,4435843],"length":1,"stats":{"Line":4}},{"line":1151,"address":[1136342],"length":1,"stats":{"Line":4}},{"line":1152,"address":[2045016],"length":1,"stats":{"Line":4}},{"line":1158,"address":[4435439],"length":1,"stats":{"Line":4}},{"line":1160,"address":[4475225],"length":1,"stats":{"Line":4}},{"line":1161,"address":[4435513,4435603],"length":1,"stats":{"Line":8}},{"line":1162,"address":[],"length":0,"stats":{"Line":4}},{"line":1166,"address":[1732864,1734884,1734857],"length":1,"stats":{"Line":4}},{"line":1170,"address":[],"length":0,"stats":{"Line":4}},{"line":1171,"address":[2047319,2048954,2047075],"length":1,"stats":{"Line":4}},{"line":1172,"address":[2047068],"length":1,"stats":{"Line":4}},{"line":1173,"address":[987633],"length":1,"stats":{"Line":0}},{"line":1175,"address":[987774,989088,987606],"length":1,"stats":{"Line":10}},{"line":1177,"address":[4437930,4438156],"length":1,"stats":{"Line":2}},{"line":1178,"address":[4477908],"length":1,"stats":{"Line":1}},{"line":1180,"address":[4438221,4438438],"length":1,"stats":{"Line":2}},{"line":1181,"address":[],"length":0,"stats":{"Line":0}},{"line":1182,"address":[4478132],"length":1,"stats":{"Line":1}},{"line":1184,"address":[1138109],"length":1,"stats":{"Line":1}},{"line":1186,"address":[],"length":0,"stats":{"Line":2}},{"line":1187,"address":[1732899,1734618,1734538,1734266,1734778],"length":1,"stats":{"Line":6}},{"line":1192,"address":[4437961,4437900,4437914],"length":1,"stats":{"Line":14}},{"line":1193,"address":[987795],"length":1,"stats":{"Line":5}},{"line":1196,"address":[],"length":0,"stats":{"Line":5}},{"line":1200,"address":[],"length":0,"stats":{"Line":4}},{"line":1201,"address":[4475630,4475809],"length":1,"stats":{"Line":5}},{"line":1202,"address":[4475622,4475944,4475718],"length":1,"stats":{"Line":8}},{"line":1204,"address":[1731565],"length":1,"stats":{"Line":4}},{"line":1206,"address":[986196],"length":1,"stats":{"Line":4}},{"line":1208,"address":[1731618],"length":1,"stats":{"Line":4}},{"line":1211,"address":[4479280,4479977],"length":1,"stats":{"Line":5}},{"line":1213,"address":[989438],"length":1,"stats":{"Line":5}},{"line":1214,"address":[4479379],"length":1,"stats":{"Line":5}},{"line":1215,"address":[4479417],"length":1,"stats":{"Line":5}},{"line":1216,"address":[989562],"length":1,"stats":{"Line":4}},{"line":1218,"address":[1140105,1139531],"length":1,"stats":{"Line":9}},{"line":1219,"address":[4479490],"length":1,"stats":{"Line":5}},{"line":1220,"address":[2049309],"length":1,"stats":{"Line":0}},{"line":1221,"address":[4440021,4439866],"length":1,"stats":{"Line":0}},{"line":1222,"address":[4479772,4479867],"length":1,"stats":{"Line":0}},{"line":1224,"address":[4479839],"length":1,"stats":{"Line":0}},{"line":1226,"address":[2049606],"length":1,"stats":{"Line":0}},{"line":1229,"address":[4439802],"length":1,"stats":{"Line":5}},{"line":1230,"address":[],"length":0,"stats":{"Line":10}},{"line":1233,"address":[1140048,1140095],"length":1,"stats":{"Line":10}},{"line":1238,"address":[989588],"length":1,"stats":{"Line":4}},{"line":1242,"address":[1736912],"length":1,"stats":{"Line":4}},{"line":1244,"address":[1737112,1736968],"length":1,"stats":{"Line":5}},{"line":1246,"address":[4441710,4441975],"length":1,"stats":{"Line":4}},{"line":1249,"address":[4481594],"length":1,"stats":{"Line":4}},{"line":1250,"address":[2051585,2051371],"length":1,"stats":{"Line":4}},{"line":1253,"address":[1141066,1140860],"length":1,"stats":{"Line":4}},{"line":1256,"address":[4481360,4481919,4482066],"length":1,"stats":{"Line":8}},{"line":1258,"address":[992105],"length":1,"stats":{"Line":4}},{"line":1262,"address":[977488,982715],"length":1,"stats":{"Line":4}},{"line":1264,"address":[],"length":0,"stats":{"Line":4}},{"line":1265,"address":[2037086,2037159,2036899,2036962],"length":1,"stats":{"Line":16}},{"line":1266,"address":[1727809,1725075],"length":1,"stats":{"Line":12}},{"line":1267,"address":[],"length":0,"stats":{"Line":0}},{"line":1269,"address":[4469718,4469363],"length":1,"stats":{"Line":8}},{"line":1270,"address":[1143872],"length":1,"stats":{"Line":4}},{"line":1273,"address":[4470029,4469801,4469944],"length":1,"stats":{"Line":12}},{"line":1274,"address":[4469818],"length":1,"stats":{"Line":4}},{"line":1275,"address":[1725612],"length":1,"stats":{"Line":4}},{"line":1276,"address":[1143963],"length":1,"stats":{"Line":4}},{"line":1277,"address":[],"length":0,"stats":{"Line":4}},{"line":1280,"address":[2040484],"length":1,"stats":{"Line":4}},{"line":1281,"address":[],"length":0,"stats":{"Line":8}},{"line":1282,"address":[1145698,1145860,1145366],"length":1,"stats":{"Line":8}},{"line":1283,"address":[],"length":0,"stats":{"Line":0}},{"line":1284,"address":[4431424],"length":1,"stats":{"Line":4}},{"line":1285,"address":[1145246],"length":1,"stats":{"Line":4}},{"line":1290,"address":[4470810],"length":1,"stats":{"Line":2}},{"line":1291,"address":[1727785,1727833,1727599,1726629],"length":1,"stats":{"Line":4}},{"line":1292,"address":[],"length":0,"stats":{"Line":2}},{"line":1293,"address":[],"length":0,"stats":{"Line":0}},{"line":1294,"address":[4431120],"length":1,"stats":{"Line":2}},{"line":1295,"address":[],"length":0,"stats":{"Line":2}},{"line":1299,"address":[],"length":0,"stats":{"Line":0}},{"line":1300,"address":[4430337,4430269],"length":1,"stats":{"Line":6}},{"line":1301,"address":[4470684,4470126,4470498],"length":1,"stats":{"Line":6}},{"line":1302,"address":[],"length":0,"stats":{"Line":0}},{"line":1303,"address":[980468],"length":1,"stats":{"Line":3}},{"line":1304,"address":[4430374],"length":1,"stats":{"Line":3}},{"line":1311,"address":[4472323,4472141,4469445],"length":1,"stats":{"Line":0}},{"line":1312,"address":[4469382],"length":1,"stats":{"Line":0}},{"line":1313,"address":[],"length":0,"stats":{"Line":0}},{"line":1314,"address":[979794],"length":1,"stats":{"Line":0}},{"line":1315,"address":[2039165],"length":1,"stats":{"Line":0}},{"line":1321,"address":[977916,978096],"length":1,"stats":{"Line":8}},{"line":1323,"address":[],"length":0,"stats":{"Line":8}},{"line":1325,"address":[2037483],"length":1,"stats":{"Line":4}},{"line":1326,"address":[978273],"length":1,"stats":{"Line":3}},{"line":1328,"address":[4428237],"length":1,"stats":{"Line":3}},{"line":1329,"address":[4428376,4429236,4429050],"length":1,"stats":{"Line":6}},{"line":1330,"address":[],"length":0,"stats":{"Line":0}},{"line":1331,"address":[1142233],"length":1,"stats":{"Line":3}},{"line":1332,"address":[],"length":0,"stats":{"Line":0}},{"line":1336,"address":[],"length":0,"stats":{"Line":1}},{"line":1337,"address":[4427358,4429469,4428780,4429283],"length":1,"stats":{"Line":7}},{"line":1338,"address":[4468468],"length":1,"stats":{"Line":1}},{"line":1339,"address":[],"length":0,"stats":{"Line":0}},{"line":1340,"address":[978890],"length":1,"stats":{"Line":1}},{"line":1341,"address":[4468516],"length":1,"stats":{"Line":1}},{"line":1347,"address":[4467667],"length":1,"stats":{"Line":4}},{"line":1351,"address":[4462253,4461296],"length":1,"stats":{"Line":4}},{"line":1359,"address":[4461402],"length":1,"stats":{"Line":4}},{"line":1360,"address":[2031253,2031166],"length":1,"stats":{"Line":4}},{"line":1363,"address":[2031940,2031468,2031979,2031090],"length":1,"stats":{"Line":8}},{"line":1364,"address":[],"length":0,"stats":{"Line":4}},{"line":1365,"address":[1717486],"length":1,"stats":{"Line":4}},{"line":1366,"address":[1146836],"length":1,"stats":{"Line":4}},{"line":1367,"address":[],"length":0,"stats":{"Line":0}},{"line":1368,"address":[1146893],"length":1,"stats":{"Line":4}},{"line":1371,"address":[4462079],"length":1,"stats":{"Line":5}},{"line":1375,"address":[987296],"length":1,"stats":{"Line":1}},{"line":1376,"address":[987313],"length":1,"stats":{"Line":1}},{"line":1380,"address":[],"length":0,"stats":{"Line":4}},{"line":1381,"address":[],"length":0,"stats":{"Line":4}}],"covered":357,"coverable":496},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","honk-rpc","src","lib.rs"],"content":"#![doc = include_str!(\"../README.md\")]\n\nmod byte_counter;\npub mod honk_rpc;\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","honk-rpc","tests","honk_rpc.rs"],"content":"// standard\nuse std::collections::VecDeque;\nuse std::net::{SocketAddr, TcpListener, TcpStream};\n\n// extern crates\nuse bson::doc;\nuse data_encoding::HEXLOWER;\nuse sha3::{Digest, Sha3_256};\n\n// internal crates\nuse honk_rpc::honk_rpc::*;\n\n#[derive(Default)]\nstruct TestApiSet {\n    delay_echo_results: VecDeque\u003c(RequestCookie, Result\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e)\u003e,\n}\n\nconst RUNTIME_ERROR_INVALID_ARG: ErrorCode = ErrorCode::Runtime(1i32);\nconst RUNTIME_ERROR_NOT_IMPLEMENTED: ErrorCode = ErrorCode::Runtime(2i32);\n\nimpl TestApiSet {\n    // returns the same string arg sent\n    fn echo_0(\n        \u0026mut self,\n        mut args: bson::document::Document,\n    ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n        if let Some(bson::Bson::String(val)) = args.get_mut(\"val\") {\n            println!(\"TestApiSet::echo_0(val): val = '{}'\", val);\n            // Some((Some(bson::Bson::String(std::mem::take(val))), None))\n            Some(Ok(Some(bson::Bson::String(std::mem::take(val)))))\n        } else {\n            Some(Err(RUNTIME_ERROR_INVALID_ARG))\n        }\n    }\n\n    // second version of echo that isn't implemented\n    fn echo_1(\n        \u0026mut self,\n        _args: bson::document::Document,\n    ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n        Some(Err(RUNTIME_ERROR_NOT_IMPLEMENTED))\n    }\n\n    // same as echo but takes awhile and appends ' - Delayed!' to source string before returning\n    fn delay_echo_0(\n        \u0026mut self,\n        request_cookie: Option\u003cRequestCookie\u003e,\n        mut args: bson::document::Document,\n    ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n        if let Some(bson::Bson::String(val)) = args.get_mut(\"val\") {\n            println!(\"TestApiSet::delay_echo_0(val): val = '{}'\", val);\n            // only enqueue response if a request cookie is provided\n            if let Some(request_cookie) = request_cookie {\n                val.push_str(\" - Delayed!\");\n                self.delay_echo_results.push_back((\n                    request_cookie,\n                    Ok(Some(bson::Bson::String(std::mem::take(val)))),\n                ));\n            }\n            // async func so don't return result immediately\n            None\n        } else {\n            Some(Err(RUNTIME_ERROR_INVALID_ARG))\n        }\n    }\n\n    fn sha256_0(\n        \u0026mut self,\n        mut args: bson::document::Document,\n    ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n        if let Some(bson::Bson::Binary(val)) = args.get_mut(\"data\") {\n            let mut sha256 = Sha3_256::new();\n            sha256.update(\u0026val.bytes);\n\n            let hash = sha256.finalize();\n\n            Some(Ok(Some(bson::Bson::String(HEXLOWER.encode(\u0026hash)))))\n        } else {\n            Some(Err(RUNTIME_ERROR_INVALID_ARG))\n        }\n    }\n}\n\nimpl ApiSet for TestApiSet {\n    fn namespace(\u0026self) -\u003e \u0026str {\n        \"test\"\n    }\n\n    fn exec_function(\n        \u0026mut self,\n        name: \u0026str,\n        version: i32,\n        args: bson::document::Document,\n        request_cookie: Option\u003cRequestCookie\u003e,\n    ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n        match (name, version) {\n            (\"echo\", 0) =\u003e self.echo_0(args),\n            (\"echo\", 1) =\u003e self.echo_1(args),\n            (\"delay_echo\", 0) =\u003e self.delay_echo_0(request_cookie, args),\n            (\"sha256\", 0) =\u003e self.sha256_0(args),\n            (name, version) =\u003e {\n                println!(\"received {{ name: '{}', version: {} }}\", name, version);\n                Some(Err(ErrorCode::RequestFunctionInvalid))\n            }\n        }\n    }\n\n    fn next_result(\u0026mut self) -\u003e Option\u003c(RequestCookie, Result\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e)\u003e {\n        self.delay_echo_results.pop_front()\n    }\n}\n\n#[test]\nfn test_honk_client_apiset() -\u003e anyhow::Result\u003c()\u003e {\n    let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n    let listener = TcpListener::bind(socket_addr)?;\n    let socket_addr = listener.local_addr()?;\n\n    let stream1 = TcpStream::connect(socket_addr)?;\n    stream1.set_nonblocking(true)?;\n    let (stream2, _socket_addr) = listener.accept()?;\n    stream2.set_nonblocking(true)?;\n\n    let mut alice = Session::new(stream1);\n    let mut pat = Session::new(stream2);\n\n    let mut test_api_set: TestApiSet = Default::default();\n    let alice_apisets: \u0026mut [\u0026mut dyn ApiSet] = \u0026mut [\u0026mut test_api_set];\n\n    //\n    // Pat calls remote test::echo_0 call\n    //\n\n    println!(\"--- pat calling test::echo(val: \\\"Hello Alice!\\\")\");\n    let sent_cookie = pat.client_call(\"test\", \"echo\", 0, doc! {\"val\" : \"Hello Alice!\"})?;\n\n    println!(\"--- pat wits for response from alice\");\n    let mut pat_sync_call_handled: bool = false;\n    while !pat_sync_call_handled {\n        alice.update(Some(alice_apisets))?;\n        pat.update(None)?;\n        if let Some(response) = pat.client_next_response() {\n            match response {\n                Response::Pending { cookie } =\u003e {\n                    panic!(\"received unexpected pending, cookie: {}\", cookie);\n                }\n                Response::Success { cookie, result } =\u003e {\n                    assert_eq!(sent_cookie, cookie);\n                    if let Some(bson::Bson::String(result)) = result {\n                        assert_eq!(result, \"Hello Alice!\");\n                        pat_sync_call_handled = true;\n                    }\n                }\n                Response::Error { cookie, error_code } =\u003e {\n                    panic!(\n                        \"received unexpected error: {}, cookie: {}\",\n                        error_code, cookie\n                    );\n                }\n            }\n        }\n    }\n\n    //\n    // Pat calls remote test::echo_0 call (with wrong arg)\n    //\n    println!(\"--- pat calling test::echo(string: \\\"Hello Alice!\\\"), should fail because bad arg\");\n    let sent_cookie = pat.client_call(\"test\", \"echo\", 0, doc! {\"string\" : \"Hello Alice!\"})?;\n\n    println!(\"--- pat waits for response from alice\");\n    let mut pat_bad_call_handled: bool = false;\n    while !pat_bad_call_handled {\n        alice.update(Some(alice_apisets))?;\n        pat.update(None)?;\n        if let Some(response) = pat.client_next_response() {\n            match response {\n                Response::Pending { cookie } =\u003e {\n                    panic!(\"received unexpected pending, cookie: {}\", cookie);\n                }\n                Response::Success { cookie, result } =\u003e {\n                    panic!(\n                        \"received unexpected result: {:?}, cookie: {}\",\n                        result, cookie\n                    );\n                }\n                Response::Error { cookie, error_code } =\u003e {\n                    assert_eq!(sent_cookie, cookie);\n                    assert_eq!(error_code, RUNTIME_ERROR_INVALID_ARG);\n                    println!(\"--- pat received invlaid arg response\");\n                    pat_bad_call_handled = true;\n                }\n            }\n        }\n    }\n\n    //\n    // Pat calls v2 remote test::echo_1 call (which is not implemented)\n    //\n    println!(\n        \"--- pat calling test::echo_1(val: \\\"Hello Again!\\\"), should fail because not implemented\"\n    );\n    let sent_cookie = pat.client_call(\"test\", \"echo\", 1, doc! {\"val\" : \"Hello Again!\"})?;\n\n    println!(\"--- pat waits for response from alice\");\n    let mut pat_bad_call_handled: bool = false;\n    while !pat_bad_call_handled {\n        alice.update(Some(alice_apisets))?;\n        pat.update(None)?;\n        if let Some(response) = pat.client_next_response() {\n            match response {\n                Response::Pending { cookie } =\u003e {\n                    panic!(\"received unexpected pending, cookie: {}\", cookie);\n                }\n                Response::Success { cookie, result } =\u003e {\n                    panic!(\n                        \"received unexpected result: {:?}, cookie: {}\",\n                        result, cookie\n                    );\n                }\n                Response::Error { cookie, error_code } =\u003e {\n                    assert_eq!(sent_cookie, cookie);\n                    assert_eq!(error_code, RUNTIME_ERROR_NOT_IMPLEMENTED);\n                    println!(\"--- pat received not implemented response\");\n                    pat_bad_call_handled = true;\n                }\n            }\n        }\n    }\n\n    //\n    // Pat calls test::delay_echo_0 which goes through the async machinery\n    //\n    println!(\"--- pat calling test::delay_echo(val: \\\"Hello Delayed?\\\"), should succeed\");\n    let sent_cookie = pat.client_call(\"test\", \"delay_echo\", 0, doc! {\"val\" : \"Hello Delayed?\"})?;\n\n    println!(\"--- pat waits for ack from alice\");\n    let mut pat_async_call_acked: bool = false;\n    while !pat_async_call_acked {\n        alice.update(Some(alice_apisets))?;\n        pat.update(None)?;\n        if let Some(response) = pat.client_next_response() {\n            match response {\n                Response::Pending { cookie } =\u003e {\n                    assert_eq!(sent_cookie, cookie);\n                    println!(\"--- pat received pending response\");\n                    pat_async_call_acked = true;\n                }\n                Response::Error { cookie, error_code } =\u003e {\n                    panic!(\n                        \"received unexpected error: {}, cookie: {}\",\n                        error_code, cookie\n                    );\n                }\n                Response::Success { cookie, result } =\u003e {\n                    panic!(\n                        \"received unexpected sucess: {:?}, cookie: {}\",\n                        result, cookie\n                    );\n                }\n            }\n        }\n    }\n\n    println!(\"--- pat waits for alice response\");\n    let mut pat_async_call_handled: bool = false;\n    while !pat_async_call_handled {\n        alice.update(Some(alice_apisets))?;\n        pat.update(None)?;\n        if let Some(response) = pat.client_next_response() {\n            match response {\n                Response::Pending { cookie } =\u003e {\n                    panic!(\"received unexpected pending, cookie: {}\", cookie);\n                }\n                Response::Error { cookie, error_code } =\u003e {\n                    panic!(\n                        \"received unexpected error: {}, cookie: {}\",\n                        error_code, cookie\n                    );\n                }\n                Response::Success { cookie, result } =\u003e {\n                    assert_eq!(sent_cookie, cookie);\n                    if let Some(bson::Bson::String(result)) = result {\n                        assert_eq!(result, \"Hello Delayed? - Delayed!\");\n                        println!(\"--- pat received success response\");\n                        pat_async_call_handled = true;\n                    }\n                }\n            }\n        }\n    }\n\n    println!(\"--- pat calling test::sha256(data: [0x00..])\");\n    let mut args: bson::document::Document = Default::default();\n    let data = vec![0u8; DEFAULT_MAX_MESSAGE_SIZE / 2];\n    args.insert(\n        \"data\",\n        bson::Bson::Binary(bson::Binary {\n            subtype: bson::spec::BinarySubtype::Generic,\n            bytes: data,\n        }),\n    );\n\n    let cookie1 = pat.client_call(\"test\", \"sha256\", 0, args)?;\n\n    println!(\"--- pat calling test::sha256(data: [0xff..])\");\n    let mut args: bson::document::Document = Default::default();\n    let data = vec![0xFFu8; DEFAULT_MAX_MESSAGE_SIZE / 2];\n    args.insert(\n        \"data\",\n        bson::Bson::Binary(bson::Binary {\n            subtype: bson::spec::BinarySubtype::Generic,\n            bytes: data,\n        }),\n    );\n\n    let cookie2 = pat.client_call(\"test\", \"sha256\", 0, args)?;\n\n    println!(\"--- pat waits for alice responses\");\n    let mut pat_0x00_buffer_hashed: bool = false;\n    let mut pat_0xff_buffer_hashed: bool = false;\n\n    while !pat_0x00_buffer_hashed || !pat_0xff_buffer_hashed {\n        alice.update(Some(alice_apisets))?;\n        pat.update(None)?;\n        for response in pat.client_drain_responses() {\n            match response {\n                Response::Pending { cookie } =\u003e {\n                    panic!(\"received unexpected pending, cookie: {}\", cookie);\n                }\n                Response::Error { cookie, error_code } =\u003e {\n                    panic!(\n                        \"received unexpected error: {}, cookie: {}\",\n                        error_code, cookie\n                    );\n                }\n                Response::Success { cookie, result } =\u003e {\n                    println!(\"cookie: {}, result: {:?}\", cookie, result);\n                    if let Some(bson::Bson::String(result)) = result {\n                        if cookie == cookie1 {\n                            pat_0x00_buffer_hashed = true;\n                            assert_eq!(\n                                result,\n                                \"463c61ad03873aa9e82581205205acc3d3c8346c7037c43e4e241ee529f2dc27\"\n                            );\n                            println!(\"--- pat received 0x00 buffer hash\");\n                        } else if cookie == cookie2 {\n                            assert_eq!(\n                                result,\n                                \"9bd2dc706dd5251ae8fad858931585c71a1b4587aa7ecb30e15880e1b9dcda16\"\n                            );\n                            pat_0xff_buffer_hashed = true;\n                            println!(\"--- pat received 0xff buffer hash\");\n                        }\n                    }\n                }\n            }\n        }\n    }\n\n    Ok(())\n}\n","traces":[{"line":23,"address":[853104,853703],"length":1,"stats":{"Line":1}},{"line":27,"address":[853213,853351,853140],"length":1,"stats":{"Line":3}},{"line":28,"address":[853465],"length":1,"stats":{"Line":1}},{"line":30,"address":[853519],"length":1,"stats":{"Line":1}},{"line":32,"address":[853289],"length":1,"stats":{"Line":1}},{"line":37,"address":[853728],"length":1,"stats":{"Line":1}},{"line":41,"address":[853755],"length":1,"stats":{"Line":1}},{"line":45,"address":[854827,853840],"length":1,"stats":{"Line":1}},{"line":50,"address":[853967,854355,854105,853893],"length":1,"stats":{"Line":3}},{"line":51,"address":[854225],"length":1,"stats":{"Line":1}},{"line":53,"address":[854288],"length":1,"stats":{"Line":1}},{"line":54,"address":[854313],"length":1,"stats":{"Line":1}},{"line":55,"address":[854663],"length":1,"stats":{"Line":1}},{"line":57,"address":[854360],"length":1,"stats":{"Line":1}},{"line":61,"address":[854342],"length":1,"stats":{"Line":1}},{"line":63,"address":[854043],"length":1,"stats":{"Line":0}},{"line":67,"address":[854864,855782],"length":1,"stats":{"Line":1}},{"line":71,"address":[854976,854902,855114],"length":1,"stats":{"Line":2}},{"line":72,"address":[855146],"length":1,"stats":{"Line":1}},{"line":73,"address":[855163],"length":1,"stats":{"Line":1}},{"line":75,"address":[855200],"length":1,"stats":{"Line":1}},{"line":77,"address":[855222,855350],"length":1,"stats":{"Line":2}},{"line":79,"address":[855052],"length":1,"stats":{"Line":0}},{"line":85,"address":[855808],"length":1,"stats":{"Line":1}},{"line":89,"address":[857171,855840,857142],"length":1,"stats":{"Line":1}},{"line":96,"address":[856097,856173,855949,856352],"length":1,"stats":{"Line":4}},{"line":97,"address":[855980,856826,856058,856632],"length":1,"stats":{"Line":4}},{"line":98,"address":[856732,856831],"length":1,"stats":{"Line":2}},{"line":99,"address":[856064,856134,856518],"length":1,"stats":{"Line":3}},{"line":100,"address":[856378,856190,856140],"length":1,"stats":{"Line":3}},{"line":101,"address":[856200],"length":1,"stats":{"Line":0}},{"line":102,"address":[856946],"length":1,"stats":{"Line":0}},{"line":103,"address":[857036],"length":1,"stats":{"Line":0}},{"line":108,"address":[857184],"length":1,"stats":{"Line":1}},{"line":109,"address":[857201],"length":1,"stats":{"Line":1}}],"covered":30,"coverable":35},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","fuzz","fuzz_targets","fuzz_crypto.rs"],"content":"#![no_main]\n\n// tor_interface\nuse tor_interface::tor_crypto::*;\n\n// fuzzing\nuse libfuzzer_sys::fuzz_target;\nuse libfuzzer_sys::arbitrary;\nuse libfuzzer_sys::arbitrary::Arbitrary;\n\n#[derive(Arbitrary, Debug)]\nstruct CryptoData\u003c'a\u003e {\n    ed25519_public_raw: [u8; 32],\n    onion_service_id: \u0026'a str,\n    x25519_public_raw: [u8; 32],\n    message_1: \u0026'a [u8],\n    message_2: \u0026'a [u8],\n    ed25519_private_raw_1: [u8; 64],\n    ed25519_private_raw_2: [u8; 64],\n    x25519_private_raw_1: [u8; 32],\n    x25519_private_raw_2: [u8; 32],\n}\n\nfuzz_target!(|data: CryptoData| {\n\n    //\n    // ed25519 tests\n    //\n\n    // ensure random bytes don't break ed25519public from_raw\n    let _ = Ed25519PublicKey::from_raw(\u0026data.ed25519_public_raw);\n\n    // ensure random string doesn't break v3onionserviceid from_string\n    let _ = V3OnionServiceId::from_string(data.onion_service_id);\n\n    // ensure random bytes don't break x25519public from_raw\n    let _ = X25519PublicKey::from_raw(\u0026data.x25519_public_raw);\n\n    // try to build key from raw binary blob, return early if invalid\n    if let Ok(ed25519_private_1) = Ed25519PrivateKey::from_raw(\u0026data.ed25519_private_raw_1) {\n        // ensure key round-trips through keyblob representation\n        assert_eq!(Ed25519PrivateKey::from_key_blob(ed25519_private_1.to_key_blob().as_ref()).unwrap(), ed25519_private_1);\n\n        // ensure key round-trips through raw bytes representation\n        match Ed25519PrivateKey::from_raw(\u0026ed25519_private_1.to_bytes()) {\n            Ok(ed25519_private) =\u003e assert_eq!(ed25519_private, ed25519_private_1),\n            Err(err) =\u003e panic!(\"{:?}\", err),\n        }\n\n        // derive private keys public key\n        let ed25519_public_1 = Ed25519PublicKey::from_private_key(\u0026ed25519_private_1);\n\n        // compare onion service id derivation from public vs privat ekey\n        assert_eq!(V3OnionServiceId::from_private_key(\u0026ed25519_private_1), V3OnionServiceId::from_public_key(\u0026ed25519_public_1));\n        let onion_service_id_1 = V3OnionServiceId::from_public_key(\u0026ed25519_public_1);\n        // ensure service id round-trips through string representation\n        assert_eq!(V3OnionServiceId::from_string(\u0026onion_service_id_1.to_string()).unwrap(), onion_service_id_1);\n\n        // ensure public key round-trips through service id\n        assert_eq!(ed25519_public_1, Ed25519PublicKey::from_service_id(\u0026V3OnionServiceId::from_public_key(\u0026ed25519_public_1)).unwrap());\n\n        // ensure key round-trips through raw bytes representation\n        assert_eq!(ed25519_public_1, Ed25519PublicKey::from_raw(ed25519_public_1.as_bytes()).unwrap());\n\n        // sign and verify a message\n        let ed25519_signature_1 = ed25519_private_1.sign_message(data.message_1);\n        assert!(ed25519_signature_1.verify(data.message_1, \u0026ed25519_public_1));\n        // verify signature does not work for unrelated message\n        if data.message_1 != data.message_2 {\n            assert!(!ed25519_signature_1.verify(data.message_2, \u0026ed25519_public_1));\n        }\n\n        // ensure we can't verfify another key's signature\n        if data.ed25519_private_raw_1 != data.ed25519_private_raw_2 {\n            // try to build key from raw binary blob, return early if invalid\n            if let Ok(ed25519_private_2) = Ed25519PrivateKey::from_raw(\u0026data.ed25519_private_raw_2) {\n\n                // ensure key round-trips through keyblob representation\n                assert_eq!(Ed25519PrivateKey::from_key_blob(ed25519_private_2.to_key_blob().as_ref()).unwrap(), ed25519_private_2);\n\n                // ensure key round-trips through raw bytes representation\n                match Ed25519PrivateKey::from_raw(\u0026ed25519_private_2.to_bytes()) {\n                    Ok(ed25519_private) =\u003e assert_eq!(ed25519_private, ed25519_private_2),\n                    Err(err) =\u003e panic!(\"{:?}\", err),\n                }\n\n                // derive private key's public key\n                let ed25519_public_2 = Ed25519PublicKey::from_private_key(\u0026ed25519_private_2);\n\n                // compare onion service id derivation from public vs privat ekey\n                assert_eq!(V3OnionServiceId::from_private_key(\u0026ed25519_private_2), V3OnionServiceId::from_public_key(\u0026ed25519_public_2));\n                let onion_service_id_2 = V3OnionServiceId::from_public_key(\u0026ed25519_public_2);\n                // ensure service id round-trips through string representation\n                assert_eq!(V3OnionServiceId::from_string(\u0026onion_service_id_2.to_string()).unwrap(), onion_service_id_2);\n\n                // ensure public key round-trips through service id\n                assert_eq!(ed25519_public_2, Ed25519PublicKey::from_service_id(\u0026V3OnionServiceId::from_public_key(\u0026ed25519_public_2)).unwrap());\n\n                // ensure key round-trips through raw bytes representation\n                assert_eq!(ed25519_public_2, Ed25519PublicKey::from_raw(ed25519_public_2.as_bytes()).unwrap());\n\n\n                // sign and verify a message\n                let ed25519_signature_2 = ed25519_private_2.sign_message(data.message_2);\n                assert!(ed25519_signature_2.verify(data.message_2, \u0026ed25519_public_2));\n\n                // verify signature does not work for unrelated message\n                if data.message_1 != data.message_2 {\n                    assert!(!ed25519_signature_2.verify(data.message_1, \u0026ed25519_public_2));\n                }\n\n                // verify we cannot verify signatures using the wrong public keys\n                if ed25519_public_1 != ed25519_public_2 {\n                    assert!(!ed25519_signature_1.verify(data.message_1, \u0026ed25519_public_2));\n                    assert!(!ed25519_signature_2.verify(data.message_2, \u0026ed25519_public_1));\n                }\n            }\n        }\n    }\n\n    //\n    // x25519 tests\n    //\n\n    if let Ok(x25519_private_1) = X25519PrivateKey::from_raw(\u0026data.x25519_private_raw_1) {\n        // ensure round-trips through byte representation\n        assert_eq!(x25519_private_1, X25519PrivateKey::from_raw(\u0026x25519_private_1.to_bytes()).unwrap());\n        assert_eq!(data.x25519_private_raw_1, x25519_private_1.to_bytes());\n        // ensure round-trips through base64 representation\n        assert_eq!(x25519_private_1, X25519PrivateKey::from_base64(\u0026x25519_private_1.to_base64()).unwrap());\n\n        // ensure converts to e25519 without issue\n        let _ = Ed25519PrivateKey::from_private_x25519(\u0026x25519_private_1).unwrap();\n\n        let x25519_public_1 = X25519PublicKey::from_private_key(\u0026x25519_private_1);\n        // ensure round-trips through byte representation\n        assert_eq!(x25519_public_1, X25519PublicKey::from_raw(x25519_public_1.as_bytes()));\n        // ensure round-trips through base32 representation\n        assert_eq!(x25519_public_1, X25519PublicKey::from_base32(\u0026x25519_public_1.to_base32()).unwrap());\n\n        if let Ok(x25519_private_2) = X25519PrivateKey::from_raw(\u0026data.x25519_private_raw_2) {\n            // ensure round-trips through byte representation\n            assert_eq!(x25519_private_2, X25519PrivateKey::from_raw(\u0026x25519_private_2.to_bytes()).unwrap());\n            assert_eq!(data.x25519_private_raw_2, x25519_private_2.to_bytes());\n            // ensure round-trips through base64 representation\n            assert_eq!(x25519_private_2, X25519PrivateKey::from_base64(\u0026x25519_private_2.to_base64()).unwrap());\n\n            // ensure converts to e25519 without issue\n            let _ = Ed25519PrivateKey::from_private_x25519(\u0026x25519_private_2).unwrap();\n\n            let x25519_public_2 = X25519PublicKey::from_private_key(\u0026x25519_private_2);\n            // ensure round-trips through byte representation\n            assert_eq!(x25519_public_2, X25519PublicKey::from_raw(x25519_public_2.as_bytes()));\n            // ensure round-trips through base32 representation\n            assert_eq!(x25519_public_2, X25519PublicKey::from_base32(\u0026x25519_public_2.to_base32()).unwrap());\n        }\n    }\n\n\n});\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","arti_client_tor_client.rs"],"content":"// standard\nuse std::net::SocketAddr;\nuse std::ops::DerefMut;\nuse std::path::{Path, PathBuf};\nuse std::sync::atomic::{AtomicBool, Ordering};\nuse std::sync::{Arc, Mutex};\n\n//extern\nuse arti_client::config::{CfgPath, TorClientConfigBuilder};\nuse arti_client::{BootstrapBehavior, DangerouslyIntoTorAddr, IntoTorAddr, TorClient};\nuse fs_mistrust::Mistrust;\nuse tokio::io::{AsyncReadExt, AsyncWriteExt};\nuse tokio::net::{TcpListener, TcpStream};\nuse tokio::runtime;\nuse tokio_stream::StreamExt;\nuse tor_cell::relaycell::msg::Connected;\nuse tor_hscrypto::pk::HsIdKeypair;\nuse tor_hsservice::config::OnionServiceConfigBuilder;\nuse tor_hsservice::{HsIdKeypairSpecifier, HsNickname, OnionServiceBuilder, RunningOnionService};\nuse tor_keymgr::{ArtiEphemeralKeystore, KeyMgrBuilder, KeystoreSelector};\nuse tor_llcrypto::pk::ed25519::ExpandedKeypair;\nuse tor_persist::state_dir::StateDirectory;\nuse tor_proto::stream::IncomingStreamRequest;\nuse tor_rtcompat::PreferredRuntime;\n\n// internal crates\nuse crate::tor_crypto::*;\nuse crate::tor_provider;\nuse crate::tor_provider::*;\n\n/// [`ArtiClientTorClient`]-specific error type\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"not implemented\")]\n    NotImplemented(),\n\n    #[error(\"unable to bind TCP listener\")]\n    TcpListenerBindFailed(#[source] std::io::Error),\n\n    #[error(\"unable to get TCP listener's local address\")]\n    TcpListenerLocalAddrFailed(#[source] std::io::Error),\n\n    #[error(\"unable to accept connection on TCP Listener\")]\n    TcpListenerAcceptFailed(#[source] std::io::Error),\n\n    #[error(\"unable to connect to TCP listener\")]\n    TcpStreamConnectFailed(#[source] std::io::Error),\n\n    #[error(\"unable to convert tokio::TcpStream to std::net::TcpStream\")]\n    TcpStreamIntoFailed(#[source] std::io::Error),\n\n    #[error(\"arti-client config-builder error: {0}\")]\n    ArtiClientConfigBuilderError(#[source] arti_client::config::ConfigBuildError),\n\n    #[error(\"arti-client error: {0}\")]\n    ArtiClientError(#[source] arti_client::Error),\n\n    #[error(\"arti-client tor-addr error: {0}\")]\n    ArtiClientTorAddrError(#[source] arti_client::TorAddrError),\n\n    #[error(\"tor-keymgr error: {0}\")]\n    TorKeyMgrError(#[source] tor_keymgr::Error),\n\n    // TODO: the 'real' error (tor_keymgr::mgr::KeyMgrBuilderError) isn't\n    // actually defined anywhere from what I can tell\n    #[error(\"failed to build KeyMgr\")]\n    TorKeyMgrBuilderError(),\n\n    #[error(\"unexpected key found when inserting HsIdKeypair\")]\n    KeyMgrInsertionFailure(),\n\n    #[error(\"onion-service config-builder error: {0}\")]\n    OnionServiceConfigBuilderError(#[source] tor_config::ConfigBuildError),\n\n    #[error(\"tor-persist error: {0}\")]\n    TorPersistError(#[source] tor_persist::Error),\n\n    #[error(\"tor-hsservice startup error: {0}\")]\n    TorHsServiceStartupError(#[source] tor_hsservice::StartupError),\n}\n\nimpl From\u003cError\u003e for crate::tor_provider::Error {\n    fn from(error: Error) -\u003e Self {\n        crate::tor_provider::Error::Generic(error.to_string())\n    }\n}\n\n/// The `ArtiClientTorClient` is an in-process [`arti-client`](https://crates.io/crates/arti-client)-based [`TorProvider`].\n///\n///\npub struct ArtiClientTorClient {\n    tokio_runtime: Arc\u003cruntime::Runtime\u003e,\n    arti_client: TorClient\u003cPreferredRuntime\u003e,\n    state_dir: PathBuf,\n    fs_mistrust: Mistrust,\n    pending_events: Arc\u003cMutex\u003cVec\u003cTorEvent\u003e\u003e\u003e,\n}\n\n// used to forward traffic to/from arti to local tcp streams\nasync fn forward_stream\u003cR, W\u003e(alive: Arc\u003cAtomicBool\u003e, mut reader: R, mut writer: W) -\u003e ()\nwhere\n    R: AsyncReadExt + Unpin,\n    W: AsyncWriteExt + Unpin,\n{\n    // allow 100ms timeout on reads to verify writer is still good\n    let read_timeout = std::time::Duration::from_millis(100);\n    // allow additional retries in the event the other half of the pump\n    // dies; keep pumping data until our read times out 3 times\n    let mut remaining_retries = 3;\n    let mut buf = [0u8; 1024];\n\n    loop {\n        if !alive.load(Ordering::Relaxed) \u0026\u0026 remaining_retries == 0 {\n            break;\n        }\n\n        tokio::select! {\n            count = reader.read(\u0026mut buf) =\u003e match count {\n                // end of stream\n                Ok(0) =\u003e break,\n                // read N bytes\n                Ok(count) =\u003e {\n                    // forward traffic\n                    match writer.write_all(\u0026buf[0..count]).await {\n                        Ok(()) =\u003e (),\n                        Err(_err) =\u003e break,\n                    }\n                    match writer.flush().await {\n                        Ok(()) =\u003e (),\n                        Err(_err) =\u003e break,\n                    }\n                },\n                // read failed\n                Err(_err) =\u003e break,\n            },\n            _ = tokio::time::sleep(read_timeout.clone()) =\u003e match writer.flush().await {\n                Ok(()) =\u003e {\n                    // so long as our writer and reader are good, we should\n                    // allow a few additional data pump attempts\n                    if !alive.load(Ordering::Relaxed) {\n                        remaining_retries -= 1;\n                    }\n                },\n                Err(_err) =\u003e break,\n            }\n        }\n    }\n    // signal pump death\n    alive.store(false, Ordering::Relaxed);\n}\n\nimpl ArtiClientTorClient {\n    /// Construct a new `ArtiClientTorClient` which uses a [Tokio](https://crates.io/crates/tokio) runtime internally for all async operations.\n    pub fn new(\n        tokio_runtime: Arc\u003cruntime::Runtime\u003e,\n        root_data_directory: \u0026Path,\n    ) -\u003e Result\u003cSelf, Error\u003e {\n        // set custom config options\n        let mut config_builder: TorClientConfigBuilder = Default::default();\n\n        // manually set arti cache and data directories so we can have\n        // multiple concurrent instances and control where it writes\n        let mut cache_dir = PathBuf::from(root_data_directory);\n        cache_dir.push(\"cache\");\n        config_builder\n            .storage()\n            .cache_dir(CfgPath::new_literal(cache_dir));\n\n        let mut state_dir = PathBuf::from(root_data_directory);\n        state_dir.push(\"state\");\n        config_builder\n            .storage()\n            .state_dir(CfgPath::new_literal(state_dir.clone()));\n\n        // disable access to clearnet addresses and enable access to onion services\n        config_builder\n            .address_filter()\n            .allow_local_addrs(false)\n            .allow_onion_addrs(true);\n\n        let config = match config_builder.build() {\n            Ok(config) =\u003e config,\n            Err(err) =\u003e return Err(err).map_err(Error::ArtiClientConfigBuilderError),\n        };\n\n        let fs_mistrust = config.fs_mistrust().clone();\n\n        let arti_client = tokio_runtime.block_on(async {\n            TorClient::builder()\n                .config(config)\n                .bootstrap_behavior(BootstrapBehavior::Manual)\n                .create_unbootstrapped()\n                .map_err(Error::ArtiClientError)\n\n            // TODO: implement TorEvent::LogReceived events once upstream issue is resolved:\n            // https://gitlab.torproject.org/tpo/core/arti/-/issues/1356\n        })?;\n\n        let pending_events = std::vec![TorEvent::LogReceived {\n            line: \"Starting arti-client TorProvider\".to_string()\n        }];\n        let pending_events = Arc::new(Mutex::new(pending_events));\n\n        Ok(Self {\n            tokio_runtime,\n            arti_client,\n            state_dir,\n            fs_mistrust,\n            pending_events,\n        })\n    }\n}\n\nimpl TorProvider for ArtiClientTorClient {\n    fn update(\u0026mut self) -\u003e Result\u003cVec\u003cTorEvent\u003e, tor_provider::Error\u003e {\n        std::thread::sleep(std::time::Duration::from_millis(16));\n        match self.pending_events.lock() {\n            Ok(mut pending_events) =\u003e Ok(std::mem::take(pending_events.deref_mut())),\n            Err(_) =\u003e {\n                unreachable!(\"another thread panicked while holding this pending_events mutex\")\n            }\n        }\n    }\n\n    fn bootstrap(\u0026mut self) -\u003e Result\u003c(), tor_provider::Error\u003e {\n        // save progress events\n        let mut bootstrap_events = self.arti_client.bootstrap_events();\n        let pending_events = self.pending_events.clone();\n        self.tokio_runtime.spawn(async move {\n            while let Some(evt) = bootstrap_events.next().await {\n                match pending_events.lock() {\n                    Ok(mut pending_events) =\u003e {\n                        pending_events.push(TorEvent::BootstrapStatus {\n                            progress: (evt.as_frac().clamp(0.0f32, 1.0f32) * 100f32) as u32,\n                            tag: \"no-tag\".to_string(),\n                            summary: \"no summary\".to_string(),\n                        });\n                        // TODO: properly handle evt.blocked() with a new TorEvent::Error or something\n                    }\n                    Err(_) =\u003e unreachable!(\n                        \"another thread panicked while holding this pending_events mutex\"\n                    ),\n                }\n            }\n        });\n\n        // initiate bootstrap\n        let arti_client = self.arti_client.clone();\n        let pending_events = self.pending_events.clone();\n        self.tokio_runtime.spawn(async move {\n            match arti_client.bootstrap().await {\n                Ok(()) =\u003e match pending_events.lock() {\n                    Ok(mut pending_events) =\u003e {\n                        pending_events.push(TorEvent::BootstrapComplete);\n                        return;\n                    }\n                    Err(_) =\u003e unreachable!(\n                        \"another thread panicked while holding this pending_events mutex\"\n                    ),\n                },\n                Err(_err) =\u003e {\n                    // TODO: add an error event to TorEvent\n                }\n            }\n        });\n\n        Ok(())\n    }\n\n    fn add_client_auth(\n        \u0026mut self,\n        _service_id: \u0026V3OnionServiceId,\n        _client_auth: \u0026X25519PrivateKey,\n    ) -\u003e Result\u003c(), tor_provider::Error\u003e {\n        Err(Error::NotImplemented().into())\n    }\n\n    fn remove_client_auth(\n        \u0026mut self,\n        _service_id: \u0026V3OnionServiceId,\n    ) -\u003e Result\u003c(), tor_provider::Error\u003e {\n        Err(Error::NotImplemented().into())\n    }\n\n    fn connect(\n        \u0026mut self,\n        target: TargetAddr,\n        circuit: Option\u003cCircuitToken\u003e,\n    ) -\u003e Result\u003cOnionStream, tor_provider::Error\u003e {\n        // stream isolation not implemented yet\n        if circuit.is_some() {\n            return Err(Error::NotImplemented().into());\n        }\n\n        // connect to onion service\n        let arti_target = match target.clone() {\n            TargetAddr::Socket(socket_addr) =\u003e socket_addr.into_tor_addr_dangerously(),\n            TargetAddr::Domain(domain_addr) =\u003e {\n                (domain_addr.domain(), domain_addr.port()).into_tor_addr()\n            }\n            TargetAddr::OnionService(OnionAddr::V3(OnionAddrV3 {\n                service_id,\n                virt_port,\n            })) =\u003e (format!(\"{}.onion\", service_id), virt_port).into_tor_addr(),\n        }\n        .map_err(Error::ArtiClientTorAddrError)?;\n\n        let arti_client = self.arti_client.clone();\n        let data_stream = self\n            .tokio_runtime\n            .block_on(async move { arti_client.connect(arti_target).await })\n            .map_err(Error::ArtiClientError)?;\n\n        // start a task to forward traffic from returned data stream\n        // and tcp socket\n        let client_stream = self.tokio_runtime.block_on(async move {\n            let (data_reader, data_writer) = data_stream.split();\n\n            // try to bind to a local address, let OS pick our port\n            let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n            let server_listener = TcpListener::bind(socket_addr)\n                .await\n                .map_err(Error::TcpListenerBindFailed)?;\n            // await future after a client connects\n            let server_accept_future = server_listener.accept();\n            let socket_addr = server_listener\n                .local_addr()\n                .map_err(Error::TcpListenerLocalAddrFailed)?;\n\n            // client stream will ultimatley be returned from connect()\n            let client_stream = TcpStream::connect(socket_addr)\n                .await\n                .map_err(Error::TcpStreamConnectFailed)?;\n            // client has connected so now get the server's tcp stream\n            let (server_stream, _socket_addr) = server_accept_future\n                .await\n                .map_err(Error::TcpListenerAcceptFailed)?;\n            let (tcp_reader, tcp_writer) = server_stream.into_split();\n\n            // now spawn new tasks to forward traffic to/from local listener\n            let pump_alive = Arc::new(AtomicBool::new(true));\n            tokio::task::spawn({\n                let pump_alive = pump_alive.clone();\n                async move {\n                    forward_stream(pump_alive, tcp_reader, data_writer).await;\n                }\n            });\n            tokio::task::spawn(async move {\n                forward_stream(pump_alive, data_reader, tcp_writer).await;\n            });\n            Ok::\u003cTcpStream, tor_provider::Error\u003e(client_stream)\n        })?;\n\n        let stream = client_stream\n            .into_std()\n            .map_err(Error::TcpStreamIntoFailed)?;\n        Ok(OnionStream {\n            stream,\n            local_addr: None,\n            peer_addr: Some(target),\n        })\n    }\n\n    fn listener(\n        \u0026mut self,\n        private_key: \u0026Ed25519PrivateKey,\n        virt_port: u16,\n        authorized_clients: Option\u003c\u0026[X25519PublicKey]\u003e,\n    ) -\u003e Result\u003cOnionListener, tor_provider::Error\u003e {\n        // client auth is not implemented yet\n        if authorized_clients.is_some() {\n            return Err(Error::NotImplemented().into());\n        }\n\n        // try to bind to a local address, let OS pick our port\n        let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n        // TODO: make this one async too\n        let listener =\n            std::net::TcpListener::bind(socket_addr).map_err(Error::TcpListenerBindFailed)?;\n        let socket_addr = listener\n            .local_addr()\n            .map_err(Error::TcpListenerLocalAddrFailed)?;\n\n        // create a new ephemeral store for storing our onion service keys\n        let ephemeral_store: ArtiEphemeralKeystore =\n            ArtiEphemeralKeystore::new(\"ephemeral\".to_string());\n        let keymgr = match KeyMgrBuilder::default()\n            .default_store(Box::new(ephemeral_store))\n            .build()\n        {\n            Ok(keymgr) =\u003e keymgr,\n            Err(_) =\u003e return Err(Error::TorKeyMgrBuilderError().into()),\n        };\n\n        // generate a nickname to identify this onion service\n        let service_id = V3OnionServiceId::from_private_key(private_key);\n        let hs_nickname = match HsNickname::new(service_id.to_string()) {\n            Ok(nickname) =\u003e nickname,\n            Err(_) =\u003e {\n                panic!(\"v3 onion service id string representation should be a valid HsNickname\")\n            }\n        };\n\n        let hs_id_spec = HsIdKeypairSpecifier::new(hs_nickname.clone());\n        // generate a new HsIdKeypair (from an Ed25519PrivateKey)\n        // clone() isn't implemented for ExpandedKeypair \u003e:[\n        let secret_key_bytes = private_key.inner().to_secret_key_bytes();\n        let expanded_keypair = ExpandedKeypair::from_secret_key_bytes(secret_key_bytes)\n            .unwrap()\n            .into();\n\n        // write the HsIdKeypair to keymgr\n        // TODO: for now this should return Ok(None) unless we persist the ephemeral store longer-term (ie for client auth keys in the future)\n        match keymgr.insert::\u003cHsIdKeypair\u003e(expanded_keypair, \u0026hs_id_spec, KeystoreSelector::Default)\n        {\n            Ok(None) =\u003e (), // expected\n            Ok(Some(_)) =\u003e return Err(Error::KeyMgrInsertionFailure().into()),\n            Err(err) =\u003e Err(err).map_err(Error::TorKeyMgrError)?,\n        }\n\n        // create an OnionServiceConfig with the ephemeral nickname\n        let onion_service_config = match OnionServiceConfigBuilder::default()\n            .nickname(hs_nickname)\n            .build()\n        {\n            Ok(onion_service_config) =\u003e onion_service_config,\n            Err(err) =\u003e Err(err).map_err(Error::OnionServiceConfigBuilderError)?,\n        };\n\n        // create OnionService\n        let state_dir = match StateDirectory::new(self.state_dir.as_path(), \u0026self.fs_mistrust) {\n            Ok(state_dir) =\u003e state_dir,\n            Err(err) =\u003e Err(err).map_err(Error::TorPersistError)?,\n        };\n\n        let onion_service = match OnionServiceBuilder::default()\n            .config(onion_service_config)\n            .keymgr(Arc::new(keymgr))\n            .state_dir(state_dir)\n            .build()\n        {\n            Ok(onion_service) =\u003e onion_service,\n            Err(err) =\u003e Err(err).map_err(Error::TorHsServiceStartupError)?,\n        };\n\n        let onion_addr = OnionAddr::V3(OnionAddrV3::new(service_id.clone(), virt_port));\n\n        // launch the OnionService and get a Stream of RendRequest\n        let runtime = self.arti_client.runtime().clone();\n        let dirmgr = self.arti_client.dirmgr().clone().upcast_arc();\n        let hs_circ_pool = self.arti_client.hs_circ_pool().clone();\n\n        let (onion_service, mut rend_requests) = onion_service\n            .launch(runtime, dirmgr, hs_circ_pool)\n            .map_err(Error::TorHsServiceStartupError)?;\n\n        // start a task to signal onion service published\n        let pending_events = self.pending_events.clone();\n        let mut status_events = onion_service.status_events();\n        self.tokio_runtime.spawn(async move {\n            while let Some(evt) = status_events.next().await {\n                match evt.state() {\n                    tor_hsservice::status::State::Running =\u003e match pending_events.lock() {\n                        Ok(mut pending_events) =\u003e {\n                            pending_events.push(TorEvent::OnionServicePublished { service_id });\n                            return;\n                        }\n                        Err(_) =\u003e unreachable!(\n                            \"another thread panicked while holding this pending_events mutex\"\n                        ),\n                    },\n                    _ =\u003e (),\n                }\n            }\n        });\n\n        // start a task which accepts every RendRequest to get a StreamRequest\n        self.tokio_runtime.spawn(async move {\n            while let Some(request) = rend_requests.next().await {\n                let mut stream_requests = match request.accept().await {\n                    Ok(stream_requests) =\u003e stream_requests,\n                    // TODO: probably not our problem?\n                    _ =\u003e return,\n                };\n                // spawn a new task to consume the stream requsts\n                tokio::task::spawn(async move {\n                    while let Some(stream_request) = stream_requests.next().await {\n                        let should_accept =\n                            if let IncomingStreamRequest::Begin(begin) = stream_request.request() {\n                                // we only accept connections on the virt port\n                                begin.port() == virt_port\n                            } else {\n                                false\n                            };\n\n                        if should_accept {\n                            let data_stream =\n                                match stream_request.accept(Connected::new_empty()).await {\n                                    Ok(data_stream) =\u003e data_stream,\n                                    // TODO: probably not our problem\n                                    _ =\u003e continue,\n                                };\n                            let (data_reader, data_writer) = data_stream.split();\n\n                            let (tcp_reader, tcp_writer) =\n                                match TcpStream::connect(socket_addr).await {\n                                    Ok(tcp_stream) =\u003e tcp_stream.into_split(),\n                                    // TODO: possibly our problem?\n                                    _ =\u003e continue,\n                                };\n                            // now spawn new tasks to forward traffic to/from the onion listener\n\n                            let pump_alive = Arc::new(AtomicBool::new(true));\n                            // read from connected client and write to local socket\n                            tokio::task::spawn({\n                                let pump_alive = pump_alive.clone();\n                                async move {\n                                    forward_stream(pump_alive, data_reader, tcp_writer).await;\n                                }\n                            });\n                            // read from local socket and write to connected client\n                            tokio::task::spawn(async move {\n                                forward_stream(pump_alive, tcp_reader, data_writer).await;\n                            });\n                        } else {\n                            // either requesting the wrong port or the wrong type of stream request\n                            let _ = stream_request.shutdown_circuit();\n                        }\n                    }\n                });\n            }\n        });\n\n        // onion-service is torn down when `onion_service` is dropped\n        Ok(OnionListener::new::\u003cArc\u003cRunningOnionService\u003e\u003e(listener, onion_addr, onion_service, |_|{}))\n    }\n\n    fn generate_token(\u0026mut self) -\u003e CircuitToken {\n        0usize\n    }\n\n    fn release_token(\u0026mut self, _token: CircuitToken) {}\n}\n","traces":[{"line":106,"address":[],"length":0,"stats":{"Line":0}},{"line":109,"address":[],"length":0,"stats":{"Line":0}},{"line":110,"address":[],"length":0,"stats":{"Line":0}},{"line":112,"address":[],"length":0,"stats":{"Line":0}},{"line":113,"address":[],"length":0,"stats":{"Line":0}},{"line":114,"address":[],"length":0,"stats":{"Line":0}},{"line":117,"address":[],"length":0,"stats":{"Line":0}},{"line":118,"address":[],"length":0,"stats":{"Line":0}},{"line":120,"address":[],"length":0,"stats":{"Line":0}},{"line":122,"address":[],"length":0,"stats":{"Line":0}},{"line":124,"address":[],"length":0,"stats":{"Line":0}},{"line":125,"address":[],"length":0,"stats":{"Line":0}},{"line":126,"address":[],"length":0,"stats":{"Line":0}},{"line":128,"address":[],"length":0,"stats":{"Line":0}},{"line":129,"address":[],"length":0,"stats":{"Line":0}},{"line":130,"address":[],"length":0,"stats":{"Line":0}},{"line":134,"address":[],"length":0,"stats":{"Line":0}},{"line":136,"address":[],"length":0,"stats":{"Line":0}},{"line":137,"address":[],"length":0,"stats":{"Line":0}},{"line":140,"address":[],"length":0,"stats":{"Line":0}},{"line":141,"address":[],"length":0,"stats":{"Line":0}},{"line":144,"address":[],"length":0,"stats":{"Line":0}},{"line":149,"address":[],"length":0,"stats":{"Line":0}}],"covered":0,"coverable":23},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","censorship_circumvention.rs"],"content":"// standard\nuse std::net::SocketAddr;\nuse std::path::PathBuf;\nuse std::str::FromStr;\nuse std::sync::OnceLock;\n\n// extern crates\nuse regex::Regex;\n\n#[derive(Clone, Debug)]\n/// Configuration for a pluggable-transport\npub struct PluggableTransportConfig {\n    transports: Vec\u003cString\u003e,\n    path_to_binary: PathBuf,\n    options: Vec\u003cString\u003e,\n}\n\n#[derive(thiserror::Error, Debug)]\n/// Error returned on failure to construct a [`PluggableTransportConfig`]\npub enum PluggableTransportConfigError {\n    #[error(\"pluggable transport name '{0}' is invalid\")]\n    /// transport names must be a valid C identifier\n    TransportNameInvalid(String),\n    #[error(\"unable to use '{0}' as pluggable transport binary path, {1}\")]\n    /// configuration only allows aboslute paths to binaries\n    BinaryPathInvalid(String, String),\n}\n\n// per the PT spec: https://github.com/Pluggable-Transports/Pluggable-Transports-spec/blob/main/releases/PTSpecV1.0/pt-1_0.txt\nstatic TRANSPORT_PATTERN: OnceLock\u003cRegex\u003e = OnceLock::new();\nfn init_transport_pattern() -\u003e Regex {\n    Regex::new(r\"(?m)^[a-zA-Z_][a-zA-Z0-9_]*$\").unwrap()\n}\n\n/// Configuration struct for a pluggable-transport which conforms to the v1.0 pluggable-transport [specification](https://github.com/Pluggable-Transports/Pluggable-Transports-spec/blob/main/releases/PTSpecV1.0/pt-1_0.txt)\nimpl PluggableTransportConfig {\n    /// Construct a new `PluggableTransportConfig`. Each `transport` string must be a [valid C identifier](https://github.com/Pluggable-Transports/Pluggable-Transports-spec/blob/c92e59a9fa6ba11c181f4c5ec9d533eaa7d9d7f3/releases/PTSpecV1.0/pt-1_0.txt#L144) while `path_to_binary` must be an absolute path.\n    pub fn new(\n        transports: Vec\u003cString\u003e,\n        path_to_binary: PathBuf,\n    ) -\u003e Result\u003cSelf, PluggableTransportConfigError\u003e {\n        let transport_pattern = TRANSPORT_PATTERN.get_or_init(init_transport_pattern);\n        // validate each transport\n        for transport in \u0026transports {\n            if !transport_pattern.is_match(\u0026transport) {\n                return Err(PluggableTransportConfigError::TransportNameInvalid(\n                    transport.clone(),\n                ));\n            }\n        }\n\n        // pluggable transport path must be absolute so we can fix it up for individual\n        // TorProvider implementations\n        if !path_to_binary.is_absolute() {\n            return Err(PluggableTransportConfigError::BinaryPathInvalid(\n                format!(\"{:?}\", path_to_binary.display()),\n                \"must be an absolute path\".to_string(),\n            ));\n        }\n\n        Ok(Self {\n            transports,\n            path_to_binary,\n            options: Default::default(),\n        })\n    }\n\n    /// Get a reference to this `PluggableTransportConfig`'s list of transports.\n    pub fn transports(\u0026self) -\u003e \u0026Vec\u003cString\u003e {\n        \u0026self.transports\n    }\n\n    /// Get a reference to this `PluggableTransportConfig`'s `PathBuf` containing the absolute path to the pluggable-transport binary.\n    pub fn path_to_binary(\u0026self) -\u003e \u0026PathBuf {\n        \u0026self.path_to_binary\n    }\n\n    /// Get a reference to this `PluggableTransportConfig`'s list of command-line options\n    pub fn options(\u0026self) -\u003e \u0026Vec\u003cString\u003e {\n        \u0026self.options\n    }\n\n    /// Add a command-line option used to invoke this pluggable-transport.\n    pub fn add_option(\u0026mut self, arg: String) {\n        self.options.push(arg);\n    }\n}\n\n/// Configuration for a bridge line to be used with a pluggable-transport\n#[derive(Clone, Debug)]\npub struct BridgeLine {\n    transport: String,\n    address: SocketAddr,\n    fingerprint: String,\n    keyvalues: Vec\u003c(String, String)\u003e,\n}\n\n#[derive(thiserror::Error, Debug)]\n/// Error returned on failure to construct a [`BridgeLine`]\npub enum BridgeLineError {\n    #[error(\"bridge line '{0}' missing transport\")]\n    /// Provided bridge line missing transport\n    TransportMissing(String),\n\n    #[error(\"bridge line '{0}' missing address\")]\n    /// Provided bridge line missing address\n    AddressMissing(String),\n\n    #[error(\"bridge line '{0}' missing fingerprint\")]\n    /// Provided bridge line missing fingerprint\n    FingerprintMissing(String),\n\n    #[error(\"transport name '{0}' is invalid\")]\n    /// Invalid transport name (must be a valid C identifier)\n    TransportNameInvalid(String),\n\n    #[error(\"address '{0}' cannot be parsed as IP:PORT\")]\n    /// Provided bridge line's address not parseable\n    AddressParseFailed(String),\n\n    #[error(\"key=value '{0}' is invalid\")]\n    /// A key/value pair in invalid format\n    KeyValueInvalid(String),\n\n    #[error(\"bridge address port must not be 0\")]\n    /// Invalid bridge address port\n    AddressPortInvalid,\n\n    #[error(\"fingerprint '{0}' is invalid\")]\n    /// Fingerprint is not parseable (must be length 40 base16 string)\n    FingerprintInvalid(String),\n}\n\n/// A `BridgeLine` contains the information required to connect to a bridge through the means of a particular pluggable-transport (defined in a `PluggableTransportConfi`). For more information, see:\n/// - [https://tb-manual.torproject.org/bridges/](https://tb-manual.torproject.org/bridges/)\nimpl BridgeLine {\n    /// Construct a new `BridgeLine` from its constiuent parts. The `transport` argument must be a valid C identifier and must have an associated `transport` defined in an associated `PluggableTransportConfig`. The `address` must have a non-zero port. The `fingerprint` is a length 40 base16-encoded string. Finally, the keys in the `keyvalues` list must not contain space (` `) or equal (`=`) characters.\n    ///\n    /// In practice, bridge lines are distributed as entire strings so most consumers of these APIs are not likely to need this particular function.\n    pub fn new(\n        transport: String,\n        address: SocketAddr,\n        fingerprint: String,\n        keyvalues: Vec\u003c(String, String)\u003e,\n    ) -\u003e Result\u003cBridgeLine, BridgeLineError\u003e {\n        let transport_pattern = TRANSPORT_PATTERN.get_or_init(init_transport_pattern);\n\n        // transports have a particular pattern\n        if !transport_pattern.is_match(\u0026transport) {\n            return Err(BridgeLineError::TransportNameInvalid(transport));\n        }\n\n        // port can't be 0\n        if address.port() == 0 {\n            return Err(BridgeLineError::AddressPortInvalid);\n        }\n\n        static BRIDGE_FINGERPRINT_PATTERN: OnceLock\u003cRegex\u003e = OnceLock::new();\n        let bridge_fingerprint_pattern = BRIDGE_FINGERPRINT_PATTERN\n            .get_or_init(|| Regex::new(r\"(?m)^[0-9a-fA-F]{40}$\").unwrap());\n\n        // fingerprint should be a sha1 hash\n        if !bridge_fingerprint_pattern.is_match(\u0026fingerprint) {\n            return Err(BridgeLineError::FingerprintInvalid(fingerprint));\n        }\n\n        // validate key-values\n        for (key, value) in \u0026keyvalues {\n            if key.contains(' ') || key.contains('=') || key.len() == 0 {\n                return Err(BridgeLineError::KeyValueInvalid(format!(\"{key}={value}\")));\n            }\n        }\n\n        Ok(Self {\n            transport,\n            address,\n            fingerprint,\n            keyvalues,\n        })\n    }\n\n    /// Get a reference to this `BridgeLine`'s transport field.\n    pub fn transport(\u0026self) -\u003e \u0026String {\n        \u0026self.transport\n    }\n\n    /// Get a reference to this `BridgeLine`'s address field.\n    pub fn address(\u0026self) -\u003e \u0026SocketAddr {\n        \u0026self.address\n    }\n\n    /// Get a reference to this `BridgeLine`'s fingerprint field.\n    pub fn fingerprint(\u0026self) -\u003e \u0026String {\n        \u0026self.fingerprint\n    }\n\n    /// Get a reference to this `BridgeLine`'s key/values field.\n    pub fn keyvalues(\u0026self) -\u003e \u0026Vec\u003c(String, String)\u003e {\n        \u0026self.keyvalues\n    }\n\n    #[cfg(feature = \"legacy-tor-provider\")]\n    /// Serialise this `BridgeLine` to the value set via `SETCONF Bridge...` legacy c-tor control-port command.\n    pub fn as_legacy_tor_setconf_value(\u0026self) -\u003e String {\n        let transport = \u0026self.transport;\n        let address = self.address.to_string();\n        let fingerprint = self.fingerprint.to_string();\n        let keyvalues: Vec\u003cString\u003e = self\n            .keyvalues\n            .iter()\n            .map(|(key, value)| format!(\"{key}={value}\"))\n            .collect();\n        let keyvalues = keyvalues.join(\" \");\n\n        format!(\"{transport} {address} {fingerprint} {keyvalues}\")\n    }\n}\n\nimpl FromStr for BridgeLine {\n    type Err = BridgeLineError;\n    fn from_str(s: \u0026str) -\u003e Result\u003cSelf, Self::Err\u003e {\n        let mut tokens = s.split(' ');\n        // get transport name\n        let transport = if let Some(transport) = tokens.next() {\n            transport\n        } else {\n            return Err(BridgeLineError::TransportMissing(s.to_string()));\n        };\n        // get bridge address\n        let address = if let Some(address) = tokens.next() {\n            if let Ok(address) = SocketAddr::from_str(address) {\n                address\n            } else {\n                return Err(BridgeLineError::AddressParseFailed(address.to_string()));\n            }\n        } else {\n            return Err(BridgeLineError::AddressMissing(s.to_string()));\n        };\n        // get the bridge fingerprint\n        let fingerprint = if let Some(fingerprint) = tokens.next() {\n            fingerprint\n        } else {\n            return Err(BridgeLineError::FingerprintMissing(s.to_string()));\n        };\n\n        // get the bridge options\n        static BRIDGE_OPTION_PATTERN: OnceLock\u003cRegex\u003e = OnceLock::new();\n        let bridge_option_pattern = BRIDGE_OPTION_PATTERN\n            .get_or_init(|| Regex::new(r\"(?m)^(?\u003ckey\u003e[^=]+)=(?\u003cvalue\u003e.*)$\").unwrap());\n\n        let mut keyvalues: Vec\u003c(String, String)\u003e = Default::default();\n        while let Some(keyvalue) = tokens.next() {\n            if let Some(caps) = bridge_option_pattern.captures(\u0026keyvalue) {\n                let key = caps\n                    .name(\"key\")\n                    .expect(\"missing key group\")\n                    .as_str()\n                    .to_string();\n                let value = caps\n                    .name(\"value\")\n                    .expect(\"missing value group\")\n                    .as_str()\n                    .to_string();\n                keyvalues.push((key, value));\n            } else {\n                return Err(BridgeLineError::KeyValueInvalid(keyvalue.to_string()));\n            }\n        }\n\n        BridgeLine::new(\n            transport.to_string(),\n            address,\n            fingerprint.to_string(),\n            keyvalues,\n        )\n    }\n}","traces":[{"line":31,"address":[3410432],"length":1,"stats":{"Line":0}},{"line":32,"address":[1733741],"length":1,"stats":{"Line":0}},{"line":38,"address":[5559760,5560764,5561283],"length":1,"stats":{"Line":0}},{"line":42,"address":[2583041,2583153],"length":1,"stats":{"Line":0}},{"line":44,"address":[3410809,3410944],"length":1,"stats":{"Line":0}},{"line":45,"address":[5520320,5521299],"length":1,"stats":{"Line":0}},{"line":46,"address":[5521359],"length":1,"stats":{"Line":0}},{"line":47,"address":[5561068],"length":1,"stats":{"Line":0}},{"line":54,"address":[1551895,1551966],"length":1,"stats":{"Line":0}},{"line":55,"address":[2583854],"length":1,"stats":{"Line":0}},{"line":56,"address":[1734598,1734445,1734324],"length":1,"stats":{"Line":0}},{"line":57,"address":[1552387],"length":1,"stats":{"Line":0}},{"line":61,"address":[5521081],"length":1,"stats":{"Line":0}},{"line":62,"address":[3411055],"length":1,"stats":{"Line":0}},{"line":63,"address":[3411086],"length":1,"stats":{"Line":0}},{"line":64,"address":[5520477],"length":1,"stats":{"Line":0}},{"line":69,"address":[5521568],"length":1,"stats":{"Line":0}},{"line":74,"address":[5521584],"length":1,"stats":{"Line":0}},{"line":75,"address":[1553208],"length":1,"stats":{"Line":0}},{"line":79,"address":[5521600],"length":1,"stats":{"Line":0}},{"line":80,"address":[5561352],"length":1,"stats":{"Line":0}},{"line":84,"address":[3412256],"length":1,"stats":{"Line":0}},{"line":85,"address":[3412261],"length":1,"stats":{"Line":0}},{"line":140,"address":[5521648,5523884,5523856],"length":1,"stats":{"Line":0}},{"line":146,"address":[3412343,3412461],"length":1,"stats":{"Line":0}},{"line":149,"address":[1735765],"length":1,"stats":{"Line":0}},{"line":150,"address":[3412557],"length":1,"stats":{"Line":0}},{"line":154,"address":[5522091,5522130],"length":1,"stats":{"Line":0}},{"line":155,"address":[2585136],"length":1,"stats":{"Line":0}},{"line":159,"address":[1736155],"length":1,"stats":{"Line":0}},{"line":160,"address":[5545630,5545837,5545616],"length":1,"stats":{"Line":0}},{"line":163,"address":[3535927],"length":1,"stats":{"Line":0}},{"line":164,"address":[3412976],"length":1,"stats":{"Line":0}},{"line":168,"address":[2585994,2585505],"length":1,"stats":{"Line":0}},{"line":169,"address":[3413906,3413678,3413729],"length":1,"stats":{"Line":0}},{"line":170,"address":[3414235,3414090],"length":1,"stats":{"Line":0}},{"line":174,"address":[3536455],"length":1,"stats":{"Line":0}},{"line":175,"address":[5522670],"length":1,"stats":{"Line":0}},{"line":177,"address":[5522713],"length":1,"stats":{"Line":0}},{"line":178,"address":[3413396],"length":1,"stats":{"Line":0}},{"line":183,"address":[3414560],"length":1,"stats":{"Line":0}},{"line":188,"address":[1555536],"length":1,"stats":{"Line":0}},{"line":189,"address":[3537608],"length":1,"stats":{"Line":0}},{"line":193,"address":[1737888],"length":1,"stats":{"Line":0}},{"line":194,"address":[3414600],"length":1,"stats":{"Line":0}},{"line":198,"address":[5563712],"length":1,"stats":{"Line":0}},{"line":199,"address":[3537640],"length":1,"stats":{"Line":0}},{"line":204,"address":[1556669,1555584],"length":1,"stats":{"Line":0}},{"line":205,"address":[5563758],"length":1,"stats":{"Line":0}},{"line":206,"address":[3537683],"length":1,"stats":{"Line":0}},{"line":207,"address":[3537706],"length":1,"stats":{"Line":0}},{"line":208,"address":[5563851,5563927],"length":1,"stats":{"Line":0}},{"line":211,"address":[3559008,3559224,3558976,3559352],"length":1,"stats":{"Line":0}},{"line":213,"address":[3414904,3414987],"length":1,"stats":{"Line":0}},{"line":215,"address":[1738783],"length":1,"stats":{"Line":0}},{"line":221,"address":[3538784,3540964,3541405],"length":1,"stats":{"Line":0}},{"line":222,"address":[1556750],"length":1,"stats":{"Line":0}},{"line":224,"address":[2588209],"length":1,"stats":{"Line":0}},{"line":227,"address":[5525396],"length":1,"stats":{"Line":0}},{"line":230,"address":[1557124,1556902],"length":1,"stats":{"Line":0}},{"line":231,"address":[5525785,5525582],"length":1,"stats":{"Line":0}},{"line":234,"address":[1557511],"length":1,"stats":{"Line":0}},{"line":237,"address":[1557225],"length":1,"stats":{"Line":0}},{"line":240,"address":[2589063,2588841],"length":1,"stats":{"Line":0}},{"line":243,"address":[5565920],"length":1,"stats":{"Line":0}},{"line":248,"address":[3416753],"length":1,"stats":{"Line":0}},{"line":249,"address":[2135838,2135824,2136045],"length":1,"stats":{"Line":0}},{"line":251,"address":[5565883],"length":1,"stats":{"Line":0}},{"line":252,"address":[1558843,1557982,1557902],"length":1,"stats":{"Line":0}},{"line":253,"address":[2589533,2589474],"length":1,"stats":{"Line":0}},{"line":254,"address":[2589655,2589768],"length":1,"stats":{"Line":0}},{"line":259,"address":[2589872,2589948],"length":1,"stats":{"Line":0}},{"line":264,"address":[5566794],"length":1,"stats":{"Line":0}},{"line":266,"address":[2590306,2589690],"length":1,"stats":{"Line":0}},{"line":271,"address":[1740467,1741442],"length":1,"stats":{"Line":0}},{"line":273,"address":[5527522],"length":1,"stats":{"Line":0}},{"line":274,"address":[1741511],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":77},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","legacy_tor_client.rs"],"content":"// standard\nuse std::collections::BTreeMap;\nuse std::convert::From;\nuse std::default::Default;\nuse std::net::{SocketAddr, TcpListener};\nuse std::option::Option;\nuse std::path::PathBuf;\nuse std::string::ToString;\nuse std::sync::{atomic, Arc};\nuse std::time::Duration;\n\n// extern crates\nuse socks::Socks5Stream;\n\n// internal crates\nuse crate::censorship_circumvention::*;\nuse crate::legacy_tor_control_stream::*;\nuse crate::legacy_tor_controller::*;\nuse crate::legacy_tor_process::*;\nuse crate::legacy_tor_version::*;\nuse crate::proxy::*;\nuse crate::tor_crypto::*;\nuse crate::tor_provider;\nuse crate::tor_provider::*;\n\n/// [`LegacyTorClient`]-specific error type\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"failed to create LegacyTorProcess object\")]\n    LegacyTorProcessCreationFailed(#[source] crate::legacy_tor_process::Error),\n\n    #[error(\"failed to create LegacyControlStream object\")]\n    LegacyControlStreamCreationFailed(#[source] crate::legacy_tor_control_stream::Error),\n\n    #[error(\"failed to create LegacyTorController object\")]\n    LegacyTorControllerCreationFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"failed to authenticate with the tor process\")]\n    LegacyTorProcessAuthenticationFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"failed to determine the tor process version\")]\n    GetInfoVersionFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"tor process version to old; found {0} but must be at least {1}\")]\n    LegacyTorProcessTooOld(String, String),\n\n    #[error(\"failed to register for STATUS_CLIENT and HS_DESC events\")]\n    SetEventsFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"failed to delete unused onion service\")]\n    DelOnionFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"failed waiting for async events: {0}\")]\n    WaitAsyncEventsFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"failed to begin bootstrap\")]\n    SetConfDisableNetwork0Failed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"failed to setconf\")]\n    SetConfFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"failed to add client auth for onion service\")]\n    OnionClientAuthAddFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"failed to remove client auth from onion service\")]\n    OnionClientAuthRemoveFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"failed to get socks listener\")]\n    GetInfoNetListenersSocksFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"no socks listeners available to connect through\")]\n    NoSocksListenersFound(),\n\n    #[error(\"invalid circuit token\")]\n    CircuitTokenInvalid(),\n\n    #[error(\"unable to connect to socks listener\")]\n    Socks5ConnectionFailed(#[source] std::io::Error),\n\n    #[error(\"unable to bind TCP listener\")]\n    TcpListenerBindFailed(#[source] std::io::Error),\n\n    #[error(\"unable to get TCP listener's local address\")]\n    TcpListenerLocalAddrFailed(#[source] std::io::Error),\n\n    #[error(\"failed to create onion service\")]\n    AddOnionFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"tor not bootstrapped\")]\n    LegacyTorNotBootstrapped(),\n\n    #[error(\"{0}\")]\n    PluggableTransportConfigDirectoryCreationFailed(#[source] std::io::Error),\n\n    #[error(\"unable to create pluggable-transport directory because file with same name already exists: {0:?}\")]\n    PluggableTransportDirectoryNameCollision(PathBuf),\n\n    #[error(\"{0}\")]\n    PluggableTransportSymlinkRemovalFailed(#[source] std::io::Error),\n\n    #[error(\"{0}\")]\n    PluggableTransportSymlinkCreationFailed(#[source] std::io::Error),\n\n    #[error(\"pluggable transport binary name not representable as utf8: {0:?}\")]\n    PluggableTransportBinaryNameNotUtf8Representnable(std::ffi::OsString),\n\n    #[error(\"{0}\")]\n    PluggableTransportConfigError(#[source] crate::censorship_circumvention::PluggableTransportConfigError),\n\n    #[error(\"pluggable transport multiply defines '{0}' bridge transport type\")]\n    BridgeTransportTypeMultiplyDefined(String),\n\n    #[error(\"bridge transport '{0}' not supported by pluggable transport configuration\")]\n    BridgeTransportNotSupported(String),\n\n    #[error(\"not implemented\")]\n    NotImplemented(),\n}\n\nimpl From\u003cError\u003e for crate::tor_provider::Error {\n    fn from(error: Error) -\u003e Self {\n        crate::tor_provider::Error::Generic(error.to_string())\n    }\n}\n\n//\n// CircuitToken Implementation\n//\nstruct LegacyCircuitToken {\n    username: String,\n    password: String,\n}\n\nimpl LegacyCircuitToken {\n    fn new() -\u003e LegacyCircuitToken {\n        const CIRCUIT_TOKEN_USERNAME_LENGTH: usize = 32usize;\n        const CIRCUIT_TOKEN_PASSWORD_LENGTH: usize = 32usize;\n        let username = generate_password(CIRCUIT_TOKEN_USERNAME_LENGTH);\n        let password = generate_password(CIRCUIT_TOKEN_PASSWORD_LENGTH);\n\n        LegacyCircuitToken { username, password }\n    }\n}\n\nimpl Default for LegacyCircuitToken {\n    fn default() -\u003e Self {\n        Self::new()\n    }\n}\n\n//\n// LegacyTorClientConfig\n//\n\n#[derive(Clone, Debug)]\npub enum LegacyTorClientConfig {\n    BundledTor {\n        tor_bin_path: PathBuf,\n        data_directory: PathBuf,\n        proxy_settings: Option\u003cProxyConfig\u003e,\n        allowed_ports: Option\u003cVec\u003cu16\u003e\u003e,\n        pluggable_transports: Option\u003cVec\u003cPluggableTransportConfig\u003e\u003e,\n        bridge_lines: Option\u003cVec\u003cBridgeLine\u003e\u003e,\n    },\n    SystemTor {\n        tor_socks_addr: SocketAddr,\n        tor_control_addr: SocketAddr,\n        tor_control_passwd: String,\n    },\n}\n\n//\n// LegacyTorClient\n//\n\n/// A `LegacyTorClient` implements the [`TorProvider`] trait using a legacy c-tor daemon backend.\n///\n/// The tor process can either be launched and owned by `LegacyTorClient`, or it can use an already running tor-daemon. When using an already runnng tor-daemon, the [`TorProvider::bootstrap()`] automatically succeeds, presuming the connected tor-daemon has successfully bootstrapped.\n///\n/// The minimum supported c-tor is version 0.4.6.1.\npub struct LegacyTorClient {\n    daemon: Option\u003cLegacyTorProcess\u003e,\n    version: LegacyTorVersion,\n    controller: LegacyTorController,\n    bootstrapped: bool,\n    socks_listener: Option\u003cSocketAddr\u003e,\n    // list of open onion services and their is_active flag\n    onion_services: Vec\u003c(V3OnionServiceId, Arc\u003catomic::AtomicBool\u003e)\u003e,\n    // our list of circuit tokens for the tor daemon\n    circuit_token_counter: usize,\n    circuit_tokens: BTreeMap\u003cCircuitToken, LegacyCircuitToken\u003e,\n}\n\nimpl LegacyTorClient {\n    /// Construct a new `LegacyTorClient` from a [`LegacyTorClientConfig`].\n    pub fn new(config: LegacyTorClientConfig) -\u003e Result\u003cLegacyTorClient, Error\u003e {\n        let (daemon, mut controller, password, socks_listener) = match \u0026config {\n            LegacyTorClientConfig::BundledTor {\n                tor_bin_path,\n                data_directory,\n                ..\n            } =\u003e {\n                // launch tor\n                let daemon =\n                    LegacyTorProcess::new(tor_bin_path.as_path(), data_directory.as_path())\n                        .map_err(Error::LegacyTorProcessCreationFailed)?;\n                // open a control stream\n                let control_stream =\n                    LegacyControlStream::new(daemon.get_control_addr(), Duration::from_millis(16))\n                        .map_err(Error::LegacyControlStreamCreationFailed)?;\n\n                // create a controler\n                let controller = LegacyTorController::new(control_stream)\n                    .map_err(Error::LegacyTorControllerCreationFailed)?;\n\n                let password = daemon.get_password().to_string();\n                (Some(daemon), controller, password, None)\n            }\n            LegacyTorClientConfig::SystemTor {\n                tor_socks_addr,\n                tor_control_addr,\n                tor_control_passwd,\n            } =\u003e {\n                // open a control stream\n                let control_stream =\n                    LegacyControlStream::new(\u0026tor_control_addr, Duration::from_millis(16))\n                        .map_err(Error::LegacyControlStreamCreationFailed)?;\n\n                // create a controler\n                let controller = LegacyTorController::new(control_stream)\n                    .map_err(Error::LegacyTorControllerCreationFailed)?;\n\n                (\n                    None,\n                    controller,\n                    tor_control_passwd.clone(),\n                    Some(tor_socks_addr.clone()),\n                )\n            }\n        };\n\n        // authenticate\n        controller\n            .authenticate(\u0026password)\n            .map_err(Error::LegacyTorProcessAuthenticationFailed)?;\n\n        // min required version for v3 client auth (see control-spec.txt)\n        let min_required_version = LegacyTorVersion {\n            major: 0u32,\n            minor: 4u32,\n            micro: 6u32,\n            patch_level: 1u32,\n            status_tag: None,\n        };\n\n        // verify version is recent enough\n        let version = controller\n            .getinfo_version()\n            .map_err(Error::GetInfoVersionFailed)?;\n\n        if version \u003c min_required_version {\n            return Err(Error::LegacyTorProcessTooOld(\n                version.to_string(),\n                min_required_version.to_string(),\n            ));\n        }\n\n        // configure tor client\n        if let LegacyTorClientConfig::BundledTor {\n            data_directory,\n            proxy_settings,\n            allowed_ports,\n            pluggable_transports,\n            bridge_lines,\n            ..\n        } = config\n        {\n            // configure proxy\n            match proxy_settings {\n                Some(ProxyConfig::Socks4(Socks4ProxyConfig { address })) =\u003e {\n                    controller\n                        .setconf(\u0026[(\"Socks4Proxy\", address.to_string())])\n                        .map_err(Error::SetConfFailed)?;\n                }\n                Some(ProxyConfig::Socks5(Socks5ProxyConfig {\n                    address,\n                    username,\n                    password,\n                })) =\u003e {\n                    controller\n                        .setconf(\u0026[(\"Socks5Proxy\", address.to_string())])\n                        .map_err(Error::SetConfFailed)?;\n                    let username = username.unwrap_or(\"\".to_string());\n                    if !username.is_empty() {\n                        controller\n                            .setconf(\u0026[(\"Socks5ProxyUsername\", username.to_string())])\n                            .map_err(Error::SetConfFailed)?;\n                    }\n                    let password = password.unwrap_or(\"\".to_string());\n                    if !password.is_empty() {\n                        controller\n                            .setconf(\u0026[(\"Socks5ProxyPassword\", password.to_string())])\n                            .map_err(Error::SetConfFailed)?;\n                    }\n                }\n                Some(ProxyConfig::Https(HttpsProxyConfig {\n                    address,\n                    username,\n                    password,\n                })) =\u003e {\n                    controller\n                        .setconf(\u0026[(\"HTTPSProxy\", address.to_string())])\n                        .map_err(Error::SetConfFailed)?;\n                    let username = username.unwrap_or(\"\".to_string());\n                    let password = password.unwrap_or(\"\".to_string());\n                    if !username.is_empty() || !password.is_empty() {\n                        let authenticator = format!(\"{}:{}\", username, password);\n                        controller\n                            .setconf(\u0026[(\"HTTPSProxyAuthenticator\", authenticator)])\n                            .map_err(Error::SetConfFailed)?;\n                    }\n                }\n                None =\u003e (),\n            }\n            // configure firewall\n            if let Some(allowed_ports) = allowed_ports {\n                let allowed_addresses: Vec\u003cString\u003e = allowed_ports\n                    .iter()\n                    .map(|port| format!(\"*{{}}:{port}\"))\n                    .collect();\n                let allowed_addresses = allowed_addresses.join(\", \");\n                controller\n                    .setconf(\u0026[(\"ReachableAddresses\", allowed_addresses)])\n                    .map_err(Error::SetConfFailed)?;\n            }\n            // configure pluggable transports\n            let mut supported_transports: std::collections::BTreeSet\u003cString\u003e = Default::default();\n            if let Some(pluggable_transports) = pluggable_transports {\n                // Legacy tor daemon cannot be configured to use pluggable-transports which\n                // exist in paths containing spaces. To work around this, we create a known, safe\n                // path in the tor daemon's working directory, and soft-link the provided\n                // binary path to this safe location. Finally, we configure tor to use the soft-linked\n                // binary in the ClientTransportPlugin setconf call.\n\n                // create pluggable-transport directory\n                let mut pt_directory = data_directory.clone();\n                pt_directory.push(\"pluggable-transports\");\n                if !std::path::Path::exists(\u0026pt_directory) {\n                    // path does not exist so create it\n                    std::fs::create_dir(\u0026pt_directory)\n                        .map_err(Error::PluggableTransportConfigDirectoryCreationFailed)?;\n                } else if !std::path::Path::is_dir(\u0026pt_directory) {\n                    // path exists but it is not a directory\n                    return Err(Error::PluggableTransportDirectoryNameCollision(\n                        pt_directory,\n                    ));\n                }\n\n                // symlink all our pts and configure tor\n                let mut conf: Vec\u003c(\u0026str, String)\u003e = Default::default();\n                for pt_settings in \u0026pluggable_transports {\n                    // symlink absolute path of pt binary to pt_directory in tor's working\n                    // directory\n                    let path_to_binary = pt_settings.path_to_binary();\n                    let binary_name = path_to_binary\n                        .file_name()\n                        .expect(\"file_name should be absolute path\");\n                    let mut pt_symlink = pt_directory.clone();\n                    pt_symlink.push(binary_name);\n                    let binary_name = if let Some(binary_name) = binary_name.to_str() {\n                        binary_name\n                    } else {\n                        return Err(Error::PluggableTransportBinaryNameNotUtf8Representnable(\n                            binary_name.to_os_string(),\n                        ));\n                    };\n\n                    // remove any file that may exist with the same name\n                    if std::path::Path::exists(\u0026pt_symlink) {\n                        std::fs::remove_file(\u0026pt_symlink)\n                            .map_err(Error::PluggableTransportSymlinkRemovalFailed)?;\n                    }\n\n                    // create new symlink\n                    #[cfg(windows)]\n                    std::os::windows::fs::symlink_file(path_to_binary, \u0026pt_symlink)\n                        .map_err(Error::PluggableTransportSymlinkCreationFailed)?;\n                    #[cfg(unix)]\n                    std::os::unix::fs::symlink(path_to_binary, \u0026pt_symlink)\n                        .map_err(Error::PluggableTransportSymlinkCreationFailed)?;\n\n                    // verify a bridge-type support has not been defined for multiple pluggable-transports\n                    for transport in pt_settings.transports() {\n                        if supported_transports.contains(transport) {\n                            return Err(Error::BridgeTransportTypeMultiplyDefined(\n                                transport.to_string(),\n                            ));\n                        }\n                        supported_transports.insert(transport.to_string());\n                    }\n\n                    // finally construct our setconf value\n                    let transports = pt_settings.transports().join(\",\");\n                    use std::path::MAIN_SEPARATOR;\n                    let path_to_binary =\n                        format!(\"pluggable-transports{MAIN_SEPARATOR}{binary_name}\");\n                    let options = pt_settings.options().join(\" \");\n\n                    let value = format!(\"{transports} exec {path_to_binary} {options}\");\n                    conf.push((\"ClientTransportPlugin\", value));\n                }\n                controller\n                    .setconf(conf.as_slice())\n                    .map_err(Error::SetConfFailed)?;\n            }\n            // configure bridge lines\n            if let Some(bridge_lines) = bridge_lines {\n                let mut conf: Vec\u003c(\u0026str, String)\u003e = Default::default();\n                for bridge_line in \u0026bridge_lines {\n                    if !supported_transports.contains(bridge_line.transport()) {\n                        return Err(Error::BridgeTransportNotSupported(\n                            bridge_line.transport().to_string(),\n                        ));\n                    }\n                    let value = bridge_line.as_legacy_tor_setconf_value();\n                    conf.push((\"Bridge\", value));\n                }\n                conf.push((\"UseBridges\", \"1\".to_string()));\n                controller\n                    .setconf(conf.as_slice())\n                    .map_err(Error::SetConfFailed)?;\n            }\n        }\n\n        // register for STATUS_CLIENT async events\n        controller\n            .setevents(\u0026[\"STATUS_CLIENT\", \"HS_DESC\"])\n            .map_err(Error::SetEventsFailed)?;\n\n        Ok(LegacyTorClient {\n            daemon,\n            version,\n            controller,\n            bootstrapped: false,\n            socks_listener,\n            onion_services: Default::default(),\n            circuit_token_counter: 0usize,\n            circuit_tokens: Default::default(),\n        })\n    }\n\n    /// Get the version of the connected c-tor daemon.\n    pub fn version(\u0026mut self) -\u003e LegacyTorVersion {\n        self.version.clone()\n    }\n}\n\nimpl TorProvider for LegacyTorClient {\n    fn update(\u0026mut self) -\u003e Result\u003cVec\u003cTorEvent\u003e, tor_provider::Error\u003e {\n        let mut i = 0;\n        while i \u003c self.onion_services.len() {\n            // remove onion services with no active listeners\n            if !self.onion_services[i].1.load(atomic::Ordering::Relaxed) {\n                let entry = self.onion_services.swap_remove(i);\n                let service_id = entry.0;\n\n                self.controller\n                    .del_onion(\u0026service_id)\n                    .map_err(Error::DelOnionFailed)?;\n            } else {\n                i += 1;\n            }\n        }\n\n        let mut events: Vec\u003cTorEvent\u003e = Default::default();\n        for async_event in self\n            .controller\n            .wait_async_events()\n            .map_err(Error::WaitAsyncEventsFailed)?\n            .iter()\n        {\n            match async_event {\n                AsyncEvent::StatusClient {\n                    severity,\n                    action,\n                    arguments,\n                } =\u003e {\n                    if severity == \"NOTICE\" \u0026\u0026 action == \"BOOTSTRAP\" {\n                        let mut progress: u32 = 0;\n                        let mut tag: String = Default::default();\n                        let mut summary: String = Default::default();\n                        for (key, val) in arguments.iter() {\n                            match key.as_str() {\n                                \"PROGRESS\" =\u003e progress = val.parse().unwrap_or(0u32),\n                                \"TAG\" =\u003e tag = val.to_string(),\n                                \"SUMMARY\" =\u003e summary = val.to_string(),\n                                _ =\u003e {} // ignore unexpected arguments\n                            }\n                        }\n                        events.push(TorEvent::BootstrapStatus {\n                            progress,\n                            tag,\n                            summary,\n                        });\n                        if progress == 100u32 {\n                            events.push(TorEvent::BootstrapComplete);\n                            self.bootstrapped = true;\n                        }\n                    }\n                }\n                AsyncEvent::HsDesc { action, hs_address } =\u003e {\n                    if action == \"UPLOADED\" {\n                        events.push(TorEvent::OnionServicePublished {\n                            service_id: hs_address.clone(),\n                        });\n                    }\n                }\n                AsyncEvent::Unknown { lines } =\u003e {\n                    println!(\"Received Unknown Event:\");\n                    for line in lines.iter() {\n                        println!(\" {}\", line);\n                    }\n                }\n            }\n        }\n\n        if let Some(daemon) = \u0026mut self.daemon {\n            // bundled tor gives us log-lines\n            for log_line in daemon.wait_log_lines().iter_mut() {\n                events.push(TorEvent::LogReceived {\n                    line: std::mem::take(log_line),\n                });\n            }\n        } else if !self.bootstrapped {\n            // system tor needs to send a bootstrap complete event *once*\n            events.push(TorEvent::BootstrapComplete);\n            self.bootstrapped = true;\n        }\n\n        Ok(events)\n    }\n\n    fn bootstrap(\u0026mut self) -\u003e Result\u003c(), tor_provider::Error\u003e {\n        if !self.bootstrapped {\n            self.controller\n                .setconf(\u0026[(\"DisableNetwork\", \"0\".to_string())])\n                .map_err(Error::SetConfDisableNetwork0Failed)?;\n        }\n        Ok(())\n    }\n\n    fn add_client_auth(\n        \u0026mut self,\n        service_id: \u0026V3OnionServiceId,\n        client_auth: \u0026X25519PrivateKey,\n    ) -\u003e Result\u003c(), tor_provider::Error\u003e {\n        Ok(self\n            .controller\n            .onion_client_auth_add(service_id, client_auth, None, \u0026Default::default())\n            .map_err(Error::OnionClientAuthAddFailed)?)\n    }\n\n    fn remove_client_auth(\n        \u0026mut self,\n        service_id: \u0026V3OnionServiceId,\n    ) -\u003e Result\u003c(), tor_provider::Error\u003e {\n        Ok(self\n            .controller\n            .onion_client_auth_remove(service_id)\n            .map_err(Error::OnionClientAuthRemoveFailed)?)\n    }\n\n    // connect to an onion service and returns OnionStream\n    fn connect(\n        \u0026mut self,\n        target: TargetAddr,\n        circuit: Option\u003cCircuitToken\u003e,\n    ) -\u003e Result\u003cOnionStream, tor_provider::Error\u003e {\n        if !self.bootstrapped {\n            return Err(Error::LegacyTorNotBootstrapped().into());\n        }\n\n        if self.socks_listener.is_none() {\n            let mut listeners = self\n                .controller\n                .getinfo_net_listeners_socks()\n                .map_err(Error::GetInfoNetListenersSocksFailed)?;\n            if listeners.is_empty() {\n                return Err(Error::NoSocksListenersFound())?;\n            }\n            self.socks_listener = Some(listeners.swap_remove(0));\n        }\n\n        let socks_listener = match self.socks_listener {\n            Some(socks_listener) =\u003e socks_listener,\n            None =\u003e unreachable!(),\n        };\n\n        // our target\n        let socks_target = match target.clone() {\n            TargetAddr::Socket(socket_addr) =\u003e socks::TargetAddr::Ip(socket_addr),\n            TargetAddr::Domain(domain_addr) =\u003e {\n                socks::TargetAddr::Domain(domain_addr.domain().to_string(), domain_addr.port())\n            }\n            TargetAddr::OnionService(OnionAddr::V3(OnionAddrV3 {\n                service_id,\n                virt_port,\n            })) =\u003e socks::TargetAddr::Domain(format!(\"{}.onion\", service_id), virt_port),\n        };\n\n        // readwrite stream\n        let stream = match \u0026circuit {\n            None =\u003e Socks5Stream::connect(socks_listener, socks_target),\n            Some(circuit) =\u003e {\n                if let Some(circuit) = self.circuit_tokens.get(circuit) {\n                    Socks5Stream::connect_with_password(\n                        socks_listener,\n                        socks_target,\n                        \u0026circuit.username,\n                        \u0026circuit.password,\n                    )\n                } else {\n                    return Err(Error::CircuitTokenInvalid())?;\n                }\n            }\n        }\n        .map_err(Error::Socks5ConnectionFailed)?;\n\n        Ok(OnionStream {\n            stream: stream.into_inner(),\n            local_addr: None,\n            peer_addr: Some(target),\n        })\n    }\n\n    // stand up an onion service and return an LegacyOnionListener\n    fn listener(\n        \u0026mut self,\n        private_key: \u0026Ed25519PrivateKey,\n        virt_port: u16,\n        authorized_clients: Option\u003c\u0026[X25519PublicKey]\u003e,\n    ) -\u003e Result\u003cOnionListener, tor_provider::Error\u003e {\n        if !self.bootstrapped {\n            return Err(Error::LegacyTorNotBootstrapped().into());\n        }\n\n        // try to bind to a local address, let OS pick our port\n        let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n        let listener = TcpListener::bind(socket_addr).map_err(Error::TcpListenerBindFailed)?;\n        let socket_addr = listener\n            .local_addr()\n            .map_err(Error::TcpListenerLocalAddrFailed)?;\n\n        let mut flags = AddOnionFlags {\n            discard_pk: true,\n            ..Default::default()\n        };\n        if authorized_clients.is_some() {\n            flags.v3_auth = true;\n        }\n\n        let onion_addr = OnionAddr::V3(OnionAddrV3::new(\n            V3OnionServiceId::from_private_key(private_key),\n            virt_port,\n        ));\n\n        // start onion service\n        let (_, service_id) = self\n            .controller\n            .add_onion(\n                Some(private_key),\n                \u0026flags,\n                None,\n                virt_port,\n                Some(socket_addr),\n                authorized_clients,\n            )\n            .map_err(Error::AddOnionFailed)?;\n\n        let is_active = Arc::new(atomic::AtomicBool::new(true));\n        self.onion_services\n            .push((service_id, Arc::clone(\u0026is_active)));\n\n        Ok(OnionListener::new(listener, onion_addr, is_active, |is_active| {\n            is_active.store(false, atomic::Ordering::Relaxed);\n        }))\n    }\n\n    fn generate_token(\u0026mut self) -\u003e CircuitToken {\n        let new_token = self.circuit_token_counter;\n        self.circuit_token_counter += 1;\n        self.circuit_tokens\n            .insert(new_token, LegacyCircuitToken::new());\n        new_token\n    }\n\n    fn release_token(\u0026mut self, circuit_token: CircuitToken) {\n        self.circuit_tokens.remove(\u0026circuit_token);\n    }\n}\n","traces":[{"line":121,"address":[1911701,1911568],"length":1,"stats":{"Line":1}},{"line":122,"address":[3596557,3596499],"length":1,"stats":{"Line":2}},{"line":135,"address":[2489936,2490117],"length":1,"stats":{"Line":0}},{"line":138,"address":[3817341],"length":1,"stats":{"Line":0}},{"line":139,"address":[5232572],"length":1,"stats":{"Line":0}},{"line":146,"address":[2490144],"length":1,"stats":{"Line":0}},{"line":147,"address":[2050504],"length":1,"stats":{"Line":0}},{"line":196,"address":[3712991,3693792,3696303],"length":1,"stats":{"Line":2}},{"line":197,"address":[5232859,5235039,5237898],"length":1,"stats":{"Line":4}},{"line":198,"address":[5233120],"length":1,"stats":{"Line":2}},{"line":204,"address":[3694872,3694419,3696403,3694181],"length":1,"stats":{"Line":4}},{"line":206,"address":[5194040],"length":1,"stats":{"Line":0}},{"line":208,"address":[5233926,5234331,5235339,5233758],"length":1,"stats":{"Line":4}},{"line":210,"address":[3819051],"length":1,"stats":{"Line":0}},{"line":213,"address":[2051943,2052149,2052400,2053004],"length":1,"stats":{"Line":4}},{"line":214,"address":[5234612],"length":1,"stats":{"Line":0}},{"line":216,"address":[2052481,2052310],"length":1,"stats":{"Line":4}},{"line":217,"address":[2492180],"length":1,"stats":{"Line":2}},{"line":219,"address":[3818013],"length":1,"stats":{"Line":1}},{"line":225,"address":[2053464,2051009,2069617,2053120],"length":1,"stats":{"Line":2}},{"line":227,"address":[5235700],"length":1,"stats":{"Line":0}},{"line":230,"address":[3820424,3820977,3820618],"length":1,"stats":{"Line":2}},{"line":231,"address":[3697153],"length":1,"stats":{"Line":0}},{"line":234,"address":[5196321],"length":1,"stats":{"Line":1}},{"line":235,"address":[5196329],"length":1,"stats":{"Line":1}},{"line":236,"address":[5196355],"length":1,"stats":{"Line":1}},{"line":237,"address":[5196538,5196586],"length":1,"stats":{"Line":2}},{"line":243,"address":[5197197,5212613,5196918],"length":1,"stats":{"Line":2}},{"line":244,"address":[3820037],"length":1,"stats":{"Line":2}},{"line":245,"address":[2059389],"length":1,"stats":{"Line":0}},{"line":257,"address":[2509744,2494719,2494267,2494422],"length":1,"stats":{"Line":4}},{"line":259,"address":[2054899],"length":1,"stats":{"Line":0}},{"line":261,"address":[2054874,2055036],"length":1,"stats":{"Line":4}},{"line":262,"address":[5212387],"length":1,"stats":{"Line":0}},{"line":263,"address":[2059940],"length":1,"stats":{"Line":0}},{"line":264,"address":[3836836],"length":1,"stats":{"Line":0}},{"line":269,"address":[3698441],"length":1,"stats":{"Line":2}},{"line":270,"address":[2059978],"length":1,"stats":{"Line":2}},{"line":271,"address":[3698543],"length":1,"stats":{"Line":2}},{"line":272,"address":[2055205],"length":1,"stats":{"Line":2}},{"line":273,"address":[2060134],"length":1,"stats":{"Line":2}},{"line":274,"address":[2055327],"length":1,"stats":{"Line":2}},{"line":279,"address":[2055388,2055498],"length":1,"stats":{"Line":2}},{"line":280,"address":[2055544],"length":1,"stats":{"Line":0}},{"line":281,"address":[2495930,2496152,2495981],"length":1,"stats":{"Line":0}},{"line":282,"address":[5237964,5238386],"length":1,"stats":{"Line":0}},{"line":283,"address":[3823642,3823313,3823437],"length":1,"stats":{"Line":0}},{"line":285,"address":[3699018],"length":1,"stats":{"Line":0}},{"line":290,"address":[3824123,3823901,3823952],"length":1,"stats":{"Line":0}},{"line":291,"address":[3822922,3823765],"length":1,"stats":{"Line":0}},{"line":292,"address":[5239248,5239124,5240898],"length":1,"stats":{"Line":0}},{"line":293,"address":[5240876,5239368],"length":1,"stats":{"Line":0}},{"line":294,"address":[2062052,2062117],"length":1,"stats":{"Line":0}},{"line":295,"address":[5200152,5200101,5200326],"length":1,"stats":{"Line":0}},{"line":296,"address":[3824411,3824493],"length":1,"stats":{"Line":0}},{"line":297,"address":[5239976,5240096,5239852],"length":1,"stats":{"Line":0}},{"line":299,"address":[2063366,2062649,2062146],"length":1,"stats":{"Line":0}},{"line":300,"address":[5240237,5240302],"length":1,"stats":{"Line":0}},{"line":301,"address":[3701738,3701564,3701513],"length":1,"stats":{"Line":0}},{"line":302,"address":[5200580,5200609],"length":1,"stats":{"Line":0}},{"line":303,"address":[2063132,2063252,2063008],"length":1,"stats":{"Line":0}},{"line":306,"address":[3823056],"length":1,"stats":{"Line":0}},{"line":311,"address":[5201564,5201786,5201615],"length":1,"stats":{"Line":0}},{"line":312,"address":[2495720,2498580],"length":1,"stats":{"Line":0}},{"line":313,"address":[2058824,2067006,2058936],"length":1,"stats":{"Line":0}},{"line":314,"address":[3710835,3702583],"length":1,"stats":{"Line":0}},{"line":315,"address":[3826507,3834573],"length":1,"stats":{"Line":0}},{"line":316,"address":[3703110,3702919,3702984],"length":1,"stats":{"Line":0}},{"line":317,"address":[5242248],"length":1,"stats":{"Line":0}},{"line":318,"address":[2059994,2060203,2060057],"length":1,"stats":{"Line":0}},{"line":319,"address":[2064897],"length":1,"stats":{"Line":0}},{"line":320,"address":[3703796,3703676,3703552],"length":1,"stats":{"Line":0}},{"line":326,"address":[3822594,3827733],"length":1,"stats":{"Line":2}},{"line":327,"address":[2065501,2065618],"length":1,"stats":{"Line":0}},{"line":329,"address":[3376080,3376305,3376208],"length":1,"stats":{"Line":0}},{"line":331,"address":[5243211,5243306],"length":1,"stats":{"Line":0}},{"line":332,"address":[5203952,5203781,5203730],"length":1,"stats":{"Line":0}},{"line":333,"address":[2060767],"length":1,"stats":{"Line":0}},{"line":334,"address":[3704787,3704505,3704629],"length":1,"stats":{"Line":0}},{"line":337,"address":[3827808],"length":1,"stats":{"Line":2}},{"line":338,"address":[3828607],"length":1,"stats":{"Line":2}},{"line":346,"address":[2061410,2061319],"length":1,"stats":{"Line":0}},{"line":347,"address":[2501425],"length":1,"stats":{"Line":0}},{"line":348,"address":[3705121],"length":1,"stats":{"Line":0}},{"line":350,"address":[2061568,2061779,2061633],"length":1,"stats":{"Line":0}},{"line":351,"address":[2066846],"length":1,"stats":{"Line":0}},{"line":352,"address":[5244198,5244461],"length":1,"stats":{"Line":0}},{"line":354,"address":[2501968],"length":1,"stats":{"Line":0}},{"line":355,"address":[3829288],"length":1,"stats":{"Line":0}},{"line":360,"address":[5204560],"length":1,"stats":{"Line":0}},{"line":361,"address":[2067180,2067275,2067398],"length":1,"stats":{"Line":0}},{"line":364,"address":[5244910,5245293],"length":1,"stats":{"Line":0}},{"line":365,"address":[5245301],"length":1,"stats":{"Line":0}},{"line":368,"address":[2062824],"length":1,"stats":{"Line":0}},{"line":369,"address":[2068034],"length":1,"stats":{"Line":0}},{"line":370,"address":[2503009],"length":1,"stats":{"Line":0}},{"line":371,"address":[2063038],"length":1,"stats":{"Line":0}},{"line":373,"address":[3709085],"length":1,"stats":{"Line":0}},{"line":374,"address":[5245788],"length":1,"stats":{"Line":0}},{"line":379,"address":[2063135,2063062],"length":1,"stats":{"Line":0}},{"line":380,"address":[3706903,3709075,3707086],"length":1,"stats":{"Line":0}},{"line":381,"address":[3707022],"length":1,"stats":{"Line":0}},{"line":389,"address":[2063408,2063178,2065310,2063559],"length":1,"stats":{"Line":0}},{"line":390,"address":[3830990],"length":1,"stats":{"Line":0}},{"line":393,"address":[3707331,3707203,3707489],"length":1,"stats":{"Line":0}},{"line":394,"address":[2063774,2065097],"length":1,"stats":{"Line":0}},{"line":395,"address":[3832708],"length":1,"stats":{"Line":0}},{"line":396,"address":[2065142],"length":1,"stats":{"Line":0}},{"line":399,"address":[3832668,3832638],"length":1,"stats":{"Line":0}},{"line":403,"address":[2069038,2068958],"length":1,"stats":{"Line":0}},{"line":405,"address":[3707882],"length":1,"stats":{"Line":0}},{"line":407,"address":[2064337,2064276],"length":1,"stats":{"Line":0}},{"line":409,"address":[3832291],"length":1,"stats":{"Line":0}},{"line":410,"address":[5207916],"length":1,"stats":{"Line":0}},{"line":412,"address":[3829748,3829926,3830045],"length":1,"stats":{"Line":0}},{"line":413,"address":[5244851],"length":1,"stats":{"Line":0}},{"line":414,"address":[2062423],"length":1,"stats":{"Line":0}},{"line":417,"address":[5248237,5243921],"length":1,"stats":{"Line":2}},{"line":418,"address":[5248277],"length":1,"stats":{"Line":0}},{"line":419,"address":[3709386,3709466,3709575],"length":1,"stats":{"Line":0}},{"line":420,"address":[3833771,3833356],"length":1,"stats":{"Line":0}},{"line":421,"address":[5209352],"length":1,"stats":{"Line":0}},{"line":422,"address":[3710049,3710105],"length":1,"stats":{"Line":0}},{"line":425,"address":[3710070],"length":1,"stats":{"Line":0}},{"line":426,"address":[5249226],"length":1,"stats":{"Line":0}},{"line":428,"address":[5248524,5248591],"length":1,"stats":{"Line":0}},{"line":429,"address":[2066155,2065949,2066115],"length":1,"stats":{"Line":0}},{"line":430,"address":[2065906],"length":1,"stats":{"Line":0}},{"line":431,"address":[3709870],"length":1,"stats":{"Line":0}},{"line":436,"address":[3836831,3822556,3835247,3835623],"length":1,"stats":{"Line":4}},{"line":438,"address":[3711799],"length":1,"stats":{"Line":0}},{"line":440,"address":[5211228],"length":1,"stats":{"Line":2}},{"line":441,"address":[5250547],"length":1,"stats":{"Line":2}},{"line":442,"address":[2073163],"length":1,"stats":{"Line":2}},{"line":443,"address":[5250707],"length":1,"stats":{"Line":2}},{"line":446,"address":[3711769],"length":1,"stats":{"Line":2}},{"line":448,"address":[2508320],"length":1,"stats":{"Line":2}},{"line":453,"address":[3838176],"length":1,"stats":{"Line":0}},{"line":454,"address":[5213665],"length":1,"stats":{"Line":0}},{"line":459,"address":[2510848,2514763,2512398],"length":1,"stats":{"Line":2}},{"line":460,"address":[2070455],"length":1,"stats":{"Line":2}},{"line":461,"address":[2076027],"length":1,"stats":{"Line":2}},{"line":463,"address":[2070579,2074634],"length":1,"stats":{"Line":4}},{"line":464,"address":[2079888],"length":1,"stats":{"Line":0}},{"line":465,"address":[3842200],"length":1,"stats":{"Line":0}},{"line":467,"address":[2515157,2512478,2510879,2514986,2514904],"length":1,"stats":{"Line":2}},{"line":469,"address":[2074517],"length":1,"stats":{"Line":0}},{"line":471,"address":[5257503,5257799,5257812],"length":1,"stats":{"Line":4}},{"line":475,"address":[5213816],"length":1,"stats":{"Line":2}},{"line":476,"address":[2511141,2511001,2511484,2511677,2511395],"length":1,"stats":{"Line":8}},{"line":479,"address":[3838707],"length":1,"stats":{"Line":0}},{"line":482,"address":[5254293],"length":1,"stats":{"Line":2}},{"line":483,"address":[2072050],"length":1,"stats":{"Line":2}},{"line":488,"address":[5216006,5216729,5215443],"length":1,"stats":{"Line":6}},{"line":489,"address":[2078320],"length":1,"stats":{"Line":2}},{"line":490,"address":[3840611],"length":1,"stats":{"Line":2}},{"line":491,"address":[2513242],"length":1,"stats":{"Line":2}},{"line":492,"address":[3840690,3840779,3841138],"length":1,"stats":{"Line":6}},{"line":493,"address":[2078907,2079017],"length":1,"stats":{"Line":4}},{"line":494,"address":[5256592,5257047,5256521],"length":1,"stats":{"Line":6}},{"line":495,"address":[3841658,3841348,3841400,3841452],"length":1,"stats":{"Line":8}},{"line":496,"address":[5216938,5216888],"length":1,"stats":{"Line":4}},{"line":500,"address":[3841032],"length":1,"stats":{"Line":2}},{"line":501,"address":[2078673],"length":1,"stats":{"Line":2}},{"line":502,"address":[5256168],"length":1,"stats":{"Line":2}},{"line":503,"address":[2078720],"length":1,"stats":{"Line":2}},{"line":505,"address":[5216749,5216668],"length":1,"stats":{"Line":4}},{"line":506,"address":[2513830],"length":1,"stats":{"Line":2}},{"line":507,"address":[3841270],"length":1,"stats":{"Line":2}},{"line":511,"address":[5255231],"length":1,"stats":{"Line":2}},{"line":512,"address":[5257200,5255259],"length":1,"stats":{"Line":4}},{"line":513,"address":[5257232],"length":1,"stats":{"Line":2}},{"line":514,"address":[2079737],"length":1,"stats":{"Line":2}},{"line":518,"address":[2071978],"length":1,"stats":{"Line":0}},{"line":519,"address":[2512508,2512703],"length":1,"stats":{"Line":0}},{"line":520,"address":[2512730],"length":1,"stats":{"Line":0}},{"line":521,"address":[3840453],"length":1,"stats":{"Line":0}},{"line":527,"address":[2076889],"length":1,"stats":{"Line":2}},{"line":529,"address":[2076997,2077285,2076964,2077092],"length":1,"stats":{"Line":8}},{"line":530,"address":[3715942],"length":1,"stats":{"Line":2}},{"line":531,"address":[3715813],"length":1,"stats":{"Line":2}},{"line":534,"address":[2511875,2512457],"length":1,"stats":{"Line":2}},{"line":536,"address":[3716023],"length":1,"stats":{"Line":1}},{"line":537,"address":[2077554],"length":1,"stats":{"Line":1}},{"line":540,"address":[5215072],"length":1,"stats":{"Line":2}},{"line":543,"address":[2515724,2515248],"length":1,"stats":{"Line":2}},{"line":544,"address":[2074686],"length":1,"stats":{"Line":2}},{"line":545,"address":[3718886,3719287,3719068,3719143],"length":1,"stats":{"Line":6}},{"line":546,"address":[2080395],"length":1,"stats":{"Line":2}},{"line":547,"address":[3719099,3719211,3719313],"length":1,"stats":{"Line":2}},{"line":549,"address":[2515464],"length":1,"stats":{"Line":2}},{"line":552,"address":[3843526,3843494,3843136],"length":1,"stats":{"Line":2}},{"line":557,"address":[2515977,2515930,2515792,2516084],"length":1,"stats":{"Line":6}},{"line":559,"address":[3719585,3719440,3719747],"length":1,"stats":{"Line":4}},{"line":560,"address":[3719672],"length":1,"stats":{"Line":0}},{"line":563,"address":[5219008],"length":1,"stats":{"Line":1}},{"line":567,"address":[2081414,2081280],"length":1,"stats":{"Line":1}},{"line":570,"address":[3719899],"length":1,"stats":{"Line":0}},{"line":574,"address":[5258944,5262130,5262637],"length":1,"stats":{"Line":2}},{"line":579,"address":[3843791],"length":1,"stats":{"Line":2}},{"line":580,"address":[5259040,5259171],"length":1,"stats":{"Line":0}},{"line":583,"address":[2516637,2516502],"length":1,"stats":{"Line":4}},{"line":584,"address":[5222888,5219801,5220261,5219549],"length":1,"stats":{"Line":2}},{"line":587,"address":[2076240],"length":1,"stats":{"Line":0}},{"line":588,"address":[2082137,2081956],"length":1,"stats":{"Line":4}},{"line":589,"address":[3723654,3720686,3723454],"length":1,"stats":{"Line":0}},{"line":591,"address":[2076402,2076529],"length":1,"stats":{"Line":4}},{"line":594,"address":[2076014],"length":1,"stats":{"Line":2}},{"line":595,"address":[2082428],"length":1,"stats":{"Line":2}},{"line":600,"address":[3844738],"length":1,"stats":{"Line":2}},{"line":601,"address":[5220263],"length":1,"stats":{"Line":0}},{"line":602,"address":[3721345],"length":1,"stats":{"Line":0}},{"line":603,"address":[5220609,5220928],"length":1,"stats":{"Line":0}},{"line":605,"address":[5220444],"length":1,"stats":{"Line":2}},{"line":612,"address":[5222395,5222107,5220641,5221298,5221792],"length":1,"stats":{"Line":8}},{"line":613,"address":[2518448,2518237],"length":1,"stats":{"Line":4}},{"line":614,"address":[3845744],"length":1,"stats":{"Line":0}},{"line":615,"address":[5221232,5221333],"length":1,"stats":{"Line":0}},{"line":618,"address":[2077846],"length":1,"stats":{"Line":0}},{"line":619,"address":[5221455],"length":1,"stats":{"Line":0}},{"line":620,"address":[2078108],"length":1,"stats":{"Line":0}},{"line":623,"address":[3846003,3846974],"length":1,"stats":{"Line":0}},{"line":627,"address":[5222043],"length":1,"stats":{"Line":1}},{"line":629,"address":[3846771],"length":1,"stats":{"Line":2}},{"line":630,"address":[3722721],"length":1,"stats":{"Line":2}},{"line":631,"address":[2084441],"length":1,"stats":{"Line":2}},{"line":632,"address":[3722963],"length":1,"stats":{"Line":2}},{"line":637,"address":[3725771,3725813,3723680],"length":1,"stats":{"Line":2}},{"line":643,"address":[5262743],"length":1,"stats":{"Line":2}},{"line":644,"address":[2079456],"length":1,"stats":{"Line":0}},{"line":648,"address":[3723883],"length":1,"stats":{"Line":2}},{"line":649,"address":[2085727,2085497,2085671],"length":1,"stats":{"Line":4}},{"line":650,"address":[2079868,2080011,2080183,2081396],"length":1,"stats":{"Line":4}},{"line":652,"address":[5263448],"length":1,"stats":{"Line":0}},{"line":658,"address":[5263731,5263666],"length":1,"stats":{"Line":4}},{"line":659,"address":[3724747],"length":1,"stats":{"Line":2}},{"line":662,"address":[5223997],"length":1,"stats":{"Line":2}},{"line":663,"address":[5223960],"length":1,"stats":{"Line":2}},{"line":668,"address":[3848690,3849540,3849094],"length":1,"stats":{"Line":2}},{"line":671,"address":[5263856],"length":1,"stats":{"Line":2}},{"line":673,"address":[3724888],"length":1,"stats":{"Line":2}},{"line":675,"address":[2521282],"length":1,"stats":{"Line":2}},{"line":678,"address":[3849011],"length":1,"stats":{"Line":2}},{"line":680,"address":[5224600],"length":1,"stats":{"Line":2}},{"line":681,"address":[2521855,2522013],"length":1,"stats":{"Line":4}},{"line":682,"address":[2081101,2081164],"length":1,"stats":{"Line":4}},{"line":684,"address":[3725648],"length":1,"stats":{"Line":4}},{"line":685,"address":[3376334,3376392],"length":1,"stats":{"Line":4}},{"line":689,"address":[3849616],"length":1,"stats":{"Line":0}},{"line":690,"address":[5225108],"length":1,"stats":{"Line":0}},{"line":691,"address":[3725896,3726005],"length":1,"stats":{"Line":0}},{"line":692,"address":[3849694,3849725],"length":1,"stats":{"Line":0}},{"line":693,"address":[2087433,2087469],"length":1,"stats":{"Line":0}},{"line":697,"address":[2081616],"length":1,"stats":{"Line":0}},{"line":698,"address":[2087540],"length":1,"stats":{"Line":0}}],"covered":124,"coverable":255},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","legacy_tor_control_stream.rs"],"content":"// standard\nuse std::collections::VecDeque;\nuse std::default::Default;\nuse std::io::{ErrorKind, Read, Write};\nuse std::net::{SocketAddr, TcpStream};\nuse std::option::Option;\nuse std::string::ToString;\nuse std::time::Duration;\n\n// extern crates\nuse regex::Regex;\n\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"control stream read timeout must not be zero\")]\n    ReadTimeoutZero(),\n\n    #[error(\"could not connect to control port\")]\n    CreationFailed(#[source] std::io::Error),\n\n    #[error(\"configure control port socket failed\")]\n    ConfigurationFailed(#[source] std::io::Error),\n\n    #[error(\"control port parsing regex creation failed\")]\n    ParsingRegexCreationFailed(#[source] regex::Error),\n\n    #[error(\"control port stream read failure\")]\n    ReadFailed(#[source] std::io::Error),\n\n    #[error(\"control port stream closed by remote\")]\n    ClosedByRemote(),\n\n    #[error(\"received control port response invalid utf8\")]\n    InvalidResponse(#[source] std::str::Utf8Error),\n\n    #[error(\"failed to parse control port reply: {0}\")]\n    ReplyParseFailed(String),\n\n    #[error(\"control port stream write failure\")]\n    WriteFailed(#[source] std::io::Error),\n}\n\npub(crate) struct LegacyControlStream {\n    stream: TcpStream,\n    closed_by_remote: bool,\n    pending_data: Vec\u003cu8\u003e,\n    pending_lines: VecDeque\u003cString\u003e,\n    pending_reply: Vec\u003cString\u003e,\n    reading_multiline_value: bool,\n    // regexes used to parse control port responses\n    single_line_data: Regex,\n    multi_line_data: Regex,\n    end_reply_line: Regex,\n}\n\ntype StatusCode = u32;\npub(crate) struct Reply {\n    pub status_code: StatusCode,\n    pub reply_lines: Vec\u003cString\u003e,\n}\n\nimpl LegacyControlStream {\n    pub fn new(addr: \u0026SocketAddr, read_timeout: Duration) -\u003e Result\u003cLegacyControlStream, Error\u003e {\n        if read_timeout.is_zero() {\n            return Err(Error::ReadTimeoutZero());\n        }\n\n        let stream = TcpStream::connect(addr).map_err(Error::CreationFailed)?;\n        stream\n            .set_read_timeout(Some(read_timeout))\n            .map_err(Error::ConfigurationFailed)?;\n\n        // pre-allocate a kilobyte for the read buffer\n        const READ_BUFFER_SIZE: usize = 1024;\n        let pending_data = Vec::with_capacity(READ_BUFFER_SIZE);\n\n        let single_line_data =\n            Regex::new(r\"^\\d\\d\\d-.*\").map_err(Error::ParsingRegexCreationFailed)?;\n        let multi_line_data =\n            Regex::new(r\"^\\d\\d\\d+.*\").map_err(Error::ParsingRegexCreationFailed)?;\n        let end_reply_line =\n            Regex::new(r\"^\\d\\d\\d .*\").map_err(Error::ParsingRegexCreationFailed)?;\n\n        Ok(LegacyControlStream {\n            stream,\n            closed_by_remote: false,\n            pending_data,\n            pending_lines: Default::default(),\n            pending_reply: Default::default(),\n            reading_multiline_value: false,\n            // regex\n            single_line_data,\n            multi_line_data,\n            end_reply_line,\n        })\n    }\n\n    #[cfg(test)]\n    pub(crate) fn closed_by_remote(\u0026mut self) -\u003e bool {\n        self.closed_by_remote\n    }\n\n    fn read_line(\u0026mut self) -\u003e Result\u003cOption\u003cString\u003e, Error\u003e {\n        // read pending bytes from stream until we have a line to return\n        while self.pending_lines.is_empty() {\n            let byte_count = self.pending_data.len();\n            match self.stream.read_to_end(\u0026mut self.pending_data) {\n                Err(err) =\u003e {\n                    if err.kind() == ErrorKind::WouldBlock || err.kind() == ErrorKind::TimedOut {\n                        if byte_count == self.pending_data.len() {\n                            return Ok(None);\n                        }\n                    } else {\n                        return Err(Error::ReadFailed(err));\n                    }\n                }\n                Ok(0usize) =\u003e {\n                    self.closed_by_remote = true;\n                    return Err(Error::ClosedByRemote());\n                }\n                Ok(_count) =\u003e (),\n            }\n\n            // split our read buffer into individual lines\n            let mut begin = 0;\n            for index in 1..self.pending_data.len() {\n                if self.pending_data[index - 1] == b'\\r' \u0026\u0026 self.pending_data[index] == b'\\n' {\n                    let end = index - 1;\n                    // view into byte vec of just the found line\n                    let line_view: \u0026[u8] = \u0026self.pending_data[begin..end];\n                    // convert to string\n                    let line_string =\n                        std::str::from_utf8(line_view).map_err(Error::InvalidResponse)?;\n\n                    // save in pending list\n                    self.pending_lines.push_back(line_string.to_string());\n                    // update begin (and skip over \\r\\n)\n                    begin = end + 2;\n                }\n            }\n            // leave any leftover bytes in the buffer for the next call\n            self.pending_data.drain(0..begin);\n        }\n\n        Ok(self.pending_lines.pop_front())\n    }\n\n    pub fn read_reply(\u0026mut self) -\u003e Result\u003cOption\u003cReply\u003e, Error\u003e {\n        loop {\n            let current_line = match self.read_line()? {\n                Some(line) =\u003e line,\n                None =\u003e return Ok(None),\n            };\n\n            // make sure the status code matches (if we are not in the\n            // middle of a multi-line read\n            if let Some(first_line) = self.pending_reply.first() {\n                if !self.reading_multiline_value {\n                    let first_status_code = \u0026first_line[0..3];\n                    let current_status_code = \u0026current_line[0..3];\n                    if first_status_code != current_status_code {\n                        return Err(Error::ReplyParseFailed(format!(\n                            \"mismatched status codes, {} != {}\",\n                            first_status_code, current_status_code\n                        )));\n                    }\n                }\n            }\n\n            // end of a response\n            if self.end_reply_line.is_match(\u0026current_line) {\n                if self.reading_multiline_value {\n                    return Err(Error::ReplyParseFailed(\n                        \"found multi-line end reply but not reading a multi-line reply\".to_string(),\n                    ));\n                }\n                self.pending_reply.push(current_line);\n                break;\n            // single line data from getinfo and friends\n            } else if self.single_line_data.is_match(\u0026current_line) {\n                if self.reading_multiline_value {\n                    return Err(Error::ReplyParseFailed(\n                        \"found single-line reply but still reading a multi-line reply\".to_string(),\n                    ));\n                }\n                self.pending_reply.push(current_line);\n            // begin of multiline data from getinfo and friends\n            } else if self.multi_line_data.is_match(\u0026current_line) {\n                if self.reading_multiline_value {\n                    return Err(Error::ReplyParseFailed(\n                        \"found multi-line start reply but still reading a multi-line reply\"\n                            .to_string(),\n                    ));\n                }\n                self.pending_reply.push(current_line);\n                self.reading_multiline_value = true;\n            // multiline data to be squashed to a single entry\n            } else {\n                if !self.reading_multiline_value {\n                    return Err(Error::ReplyParseFailed(\n                        \"found a multi-line intermediate reply but not reading a multi-line reply\"\n                            .to_string(),\n                    ));\n                }\n                // don't bother writing the end of multiline token\n                if current_line == \".\" {\n                    self.reading_multiline_value = false;\n                } else {\n                    let multiline = match self.pending_reply.last_mut() {\n                        Some(multiline) =\u003e multiline,\n                        // if our logic here is right, then\n                        // self.reading_multiline_value == !self.pending_reply.is_empty()\n                        // should always be true regardless of the data received\n                        // from the control port\n                        None =\u003e unreachable!(),\n                    };\n                    multiline.push('\\n');\n                    multiline.push_str(\u0026current_line);\n                }\n            }\n        }\n\n        // take ownership of the reply lines\n        let mut reply_lines: Vec\u003cString\u003e = Default::default();\n        std::mem::swap(\u0026mut self.pending_reply, \u0026mut reply_lines);\n\n        // parse out the response code for easier matching\n        let status_code_string = match reply_lines.first() {\n            Some(line) =\u003e line[0..3].to_string(),\n            // the lines have already been parsed+validated in the above loop\n            None =\u003e unreachable!(),\n        };\n        let status_code: u32 = match status_code_string.parse() {\n            Ok(status_code) =\u003e status_code,\n            Err(_) =\u003e {\n                return Err(Error::ReplyParseFailed(format!(\n                    \"unable to parse '{}' as status code\",\n                    status_code_string\n                )))\n            }\n        };\n\n        // strip the redundant status code from start of lines\n        for line in reply_lines.iter_mut() {\n            if line.starts_with(\u0026status_code_string) {\n                *line = line[4..].to_string();\n            }\n        }\n\n        Ok(Some(Reply {\n            status_code,\n            reply_lines,\n        }))\n    }\n\n    pub fn write(\u0026mut self, cmd: \u0026str) -\u003e Result\u003c(), Error\u003e {\n        if let Err(err) = write!(self.stream, \"{}\\r\\n\", cmd) {\n            self.closed_by_remote = true;\n            return Err(Error::WriteFailed(err));\n        }\n        Ok(())\n    }\n}\n","traces":[{"line":63,"address":[5666297,5663904,5666128],"length":1,"stats":{"Line":3}},{"line":64,"address":[2684567],"length":1,"stats":{"Line":3}},{"line":65,"address":[3637442],"length":1,"stats":{"Line":0}},{"line":68,"address":[3637592,3637354,3637505],"length":1,"stats":{"Line":6}},{"line":69,"address":[2684963,2684550,2686906,2684800,2685096],"length":1,"stats":{"Line":9}},{"line":70,"address":[5664152],"length":1,"stats":{"Line":3}},{"line":71,"address":[1830024],"length":1,"stats":{"Line":0}},{"line":75,"address":[2685035],"length":1,"stats":{"Line":3}},{"line":77,"address":[5624837,5626493,5624765,5625002],"length":1,"stats":{"Line":4}},{"line":79,"address":[1830294,1830600,1831800,1830435],"length":1,"stats":{"Line":6}},{"line":81,"address":[1830564,1830705,1830921],"length":1,"stats":{"Line":6}},{"line":84,"address":[3639075],"length":1,"stats":{"Line":3}},{"line":85,"address":[1830838],"length":1,"stats":{"Line":3}},{"line":87,"address":[1830857],"length":1,"stats":{"Line":3}},{"line":88,"address":[3638689],"length":1,"stats":{"Line":3}},{"line":89,"address":[5625698],"length":1,"stats":{"Line":3}},{"line":92,"address":[1831091],"length":1,"stats":{"Line":3}},{"line":93,"address":[5665571],"length":1,"stats":{"Line":3}},{"line":94,"address":[5665635],"length":1,"stats":{"Line":3}},{"line":99,"address":[1763120],"length":1,"stats":{"Line":1}},{"line":100,"address":[1763125],"length":1,"stats":{"Line":1}},{"line":103,"address":[1833365,1831920],"length":1,"stats":{"Line":3}},{"line":105,"address":[5626622],"length":1,"stats":{"Line":3}},{"line":106,"address":[3516823],"length":1,"stats":{"Line":3}},{"line":107,"address":[5666544,5666495],"length":1,"stats":{"Line":4}},{"line":108,"address":[3516906],"length":1,"stats":{"Line":3}},{"line":109,"address":[3517227,3516929,3517140],"length":1,"stats":{"Line":6}},{"line":110,"address":[1832436,1832616],"length":1,"stats":{"Line":6}},{"line":111,"address":[1763879],"length":1,"stats":{"Line":3}},{"line":114,"address":[5666923],"length":1,"stats":{"Line":0}},{"line":118,"address":[5626857],"length":1,"stats":{"Line":0}},{"line":119,"address":[1832192],"length":1,"stats":{"Line":0}},{"line":121,"address":[3517024],"length":1,"stats":{"Line":1}},{"line":125,"address":[2687314],"length":1,"stats":{"Line":3}},{"line":126,"address":[2687753,2687326,2687844],"length":1,"stats":{"Line":9}},{"line":127,"address":[3640617,3641110],"length":1,"stats":{"Line":6}},{"line":128,"address":[3517863,3517697],"length":1,"stats":{"Line":3}},{"line":130,"address":[1832969],"length":1,"stats":{"Line":3}},{"line":132,"address":[5667425,5667631,5667532],"length":1,"stats":{"Line":6}},{"line":136,"address":[5667564],"length":1,"stats":{"Line":3}},{"line":138,"address":[1764547,1764419,1764534],"length":1,"stats":{"Line":6}},{"line":142,"address":[3640551],"length":1,"stats":{"Line":3}},{"line":145,"address":[1763213],"length":1,"stats":{"Line":3}},{"line":148,"address":[3645622,3641184],"length":1,"stats":{"Line":3}},{"line":149,"address":[1833431,1836041],"length":1,"stats":{"Line":6}},{"line":150,"address":[1833455],"length":1,"stats":{"Line":3}},{"line":151,"address":[3641585],"length":1,"stats":{"Line":3}},{"line":152,"address":[1764940],"length":1,"stats":{"Line":3}},{"line":157,"address":[1765095,1765196],"length":1,"stats":{"Line":6}},{"line":158,"address":[2689102],"length":1,"stats":{"Line":3}},{"line":159,"address":[3641927],"length":1,"stats":{"Line":3}},{"line":160,"address":[5668626],"length":1,"stats":{"Line":3}},{"line":161,"address":[3642085],"length":1,"stats":{"Line":3}},{"line":162,"address":[5668979,5669124],"length":1,"stats":{"Line":0}},{"line":171,"address":[3519634,3518847],"length":1,"stats":{"Line":6}},{"line":172,"address":[2689992],"length":1,"stats":{"Line":3}},{"line":173,"address":[5632551],"length":1,"stats":{"Line":0}},{"line":174,"address":[3521029],"length":1,"stats":{"Line":0}},{"line":177,"address":[5630870],"length":1,"stats":{"Line":3}},{"line":180,"address":[2690034,2689941],"length":1,"stats":{"Line":6}},{"line":181,"address":[3519848],"length":1,"stats":{"Line":3}},{"line":182,"address":[1767276],"length":1,"stats":{"Line":0}},{"line":183,"address":[2691041],"length":1,"stats":{"Line":0}},{"line":186,"address":[5630610,5630700],"length":1,"stats":{"Line":6}},{"line":188,"address":[5669538,5669445,5670213],"length":1,"stats":{"Line":3}},{"line":189,"address":[3642968],"length":1,"stats":{"Line":1}},{"line":190,"address":[5630482],"length":1,"stats":{"Line":0}},{"line":191,"address":[5630427],"length":1,"stats":{"Line":0}},{"line":195,"address":[5670108],"length":1,"stats":{"Line":1}},{"line":196,"address":[3520558],"length":1,"stats":{"Line":1}},{"line":199,"address":[2690197],"length":1,"stats":{"Line":1}},{"line":200,"address":[3643053],"length":1,"stats":{"Line":0}},{"line":201,"address":[3642986],"length":1,"stats":{"Line":0}},{"line":206,"address":[2690261,2690428,2690488],"length":1,"stats":{"Line":3}},{"line":207,"address":[5669857],"length":1,"stats":{"Line":1}},{"line":209,"address":[1835402,1835469],"length":1,"stats":{"Line":2}},{"line":210,"address":[5669979],"length":1,"stats":{"Line":1}},{"line":217,"address":[2690632],"length":1,"stats":{"Line":1}},{"line":218,"address":[1766815],"length":1,"stats":{"Line":1}},{"line":224,"address":[1836299],"length":1,"stats":{"Line":3}},{"line":225,"address":[3521116],"length":1,"stats":{"Line":3}},{"line":228,"address":[5631076],"length":1,"stats":{"Line":3}},{"line":229,"address":[3644344],"length":1,"stats":{"Line":3}},{"line":233,"address":[3521495,3521418],"length":1,"stats":{"Line":6}},{"line":234,"address":[1836790],"length":1,"stats":{"Line":3}},{"line":236,"address":[5671996,5672125],"length":1,"stats":{"Line":0}},{"line":244,"address":[5671378,5671699,5671224],"length":1,"stats":{"Line":9}},{"line":245,"address":[1837304,1837355,1837575],"length":1,"stats":{"Line":9}},{"line":246,"address":[5632068],"length":1,"stats":{"Line":3}},{"line":250,"address":[3521930],"length":1,"stats":{"Line":3}},{"line":252,"address":[3644914],"length":1,"stats":{"Line":3}},{"line":256,"address":[1769184],"length":1,"stats":{"Line":3}},{"line":257,"address":[1838185,1838072],"length":1,"stats":{"Line":6}},{"line":258,"address":[1769455],"length":1,"stats":{"Line":1}},{"line":259,"address":[2693351],"length":1,"stats":{"Line":1}},{"line":261,"address":[1838396],"length":1,"stats":{"Line":3}}],"covered":81,"coverable":96},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","legacy_tor_controller.rs"],"content":"// standard\nuse std::default::Default;\nuse std::net::SocketAddr;\nuse std::option::Option;\n#[cfg(test)]\nuse std::path::Path;\nuse std::str::FromStr;\nuse std::string::ToString;\n#[cfg(test)]\nuse std::time::{Duration, Instant};\n\n// extern crates\nuse regex::Regex;\n#[cfg(test)]\nuse serial_test::serial;\n\n// internal crates\nuse crate::legacy_tor_control_stream::*;\n#[cfg(test)]\nuse crate::legacy_tor_process::*;\nuse crate::legacy_tor_version::*;\nuse crate::tor_crypto::*;\n\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"response regex creation failed\")]\n    ParsingRegexCreationFailed(#[source] regex::Error),\n\n    #[error(\"control stream read reply failed\")]\n    ReadReplyFailed(#[source] crate::legacy_tor_control_stream::Error),\n\n    #[error(\"unexpected synchronous reply recieved\")]\n    UnexpectedSynchonousReplyReceived(),\n\n    #[error(\"control stream write command failed\")]\n    WriteCommandFailed(#[source] crate::legacy_tor_control_stream::Error),\n\n    #[error(\"invalid command arguments: {0}\")]\n    InvalidCommandArguments(String),\n\n    #[error(\"command failed: {0} {}\", .1.join(\"\\n\"))]\n    CommandFailed(u32, Vec\u003cString\u003e),\n\n    #[error(\"failed to parse command reply: {0}\")]\n    CommandReplyParseFailed(String),\n\n    #[error(\"failed to parse received tor version\")]\n    TorVersionParseFailed(#[source] crate::legacy_tor_version::Error),\n}\n\n// Per-command data\n#[derive(Default)]\npub(crate) struct AddOnionFlags {\n    pub discard_pk: bool,\n    pub detach: bool,\n    pub v3_auth: bool,\n    pub non_anonymous: bool,\n    pub max_streams_close_circuit: bool,\n}\n\n#[derive(Default)]\npub(crate) struct OnionClientAuthAddFlags {\n    pub permanent: bool,\n}\n\npub(crate) enum AsyncEvent {\n    Unknown {\n        lines: Vec\u003cString\u003e,\n    },\n    StatusClient {\n        severity: String,\n        action: String,\n        arguments: Vec\u003c(String, String)\u003e,\n    },\n    HsDesc {\n        action: String,\n        hs_address: V3OnionServiceId,\n    },\n}\n\npub(crate) struct LegacyTorController {\n    // underlying control stream\n    control_stream: LegacyControlStream,\n    // list of async replies to be handled\n    async_replies: Vec\u003cReply\u003e,\n    // regex for parsing events\n    status_event_pattern: Regex,\n    status_event_argument_pattern: Regex,\n    hs_desc_pattern: Regex,\n}\n\nfn quoted_string(string: \u0026str) -\u003e String {\n    // replace \\ with \\\\ and \" with \\\"\n    // see: https://spec.torproject.org/control-spec/message-format.html?highlight=QuotedString#description-format\n    string.replace(\"\\\\\", \"\\\\\\\\\").replace(\"\\\"\", \"\\\\\\\"\")\n}\n\nimpl LegacyTorController {\n    pub fn new(control_stream: LegacyControlStream) -\u003e Result\u003cLegacyTorController, Error\u003e {\n        let status_event_pattern =\n            Regex::new(r#\"^STATUS_CLIENT (?P\u003cseverity\u003eNOTICE|WARN|ERR) (?P\u003caction\u003e[A-Za-z]+)\"#)\n                .map_err(Error::ParsingRegexCreationFailed)?;\n        let status_event_argument_pattern =\n            Regex::new(r#\"(?P\u003ckey\u003e[A-Z]+)=(?P\u003cvalue\u003e[A-Za-z0-9_]+|\"[^\"]+\")\"#)\n                .map_err(Error::ParsingRegexCreationFailed)?;\n        let hs_desc_pattern = Regex::new(\n            r#\"HS_DESC (?P\u003caction\u003eREQUESTED|UPLOAD|RECEIVED|UPLOADED|IGNORE|FAILED|CREATED) (?P\u003chsaddress\u003e[a-z2-7]{56})\"#\n        ).map_err(Error::ParsingRegexCreationFailed)?;\n\n        Ok(LegacyTorController {\n            control_stream,\n            async_replies: Default::default(),\n            // regex\n            status_event_pattern,\n            status_event_argument_pattern,\n            hs_desc_pattern,\n        })\n    }\n\n    // return curently available events, does not block waiting\n    // for an event\n    fn wait_async_replies(\u0026mut self) -\u003e Result\u003cVec\u003cReply\u003e, Error\u003e {\n        let mut replies: Vec\u003cReply\u003e = Default::default();\n        // take any previously received async replies\n        std::mem::swap(\u0026mut self.async_replies, \u0026mut replies);\n\n        // and keep consuming until none are available\n        loop {\n            if let Some(reply) = self\n                .control_stream\n                .read_reply()\n                .map_err(Error::ReadReplyFailed)?\n            {\n                replies.push(reply);\n            } else {\n                // no more replies immediately available so return\n                return Ok(replies);\n            }\n        }\n    }\n\n    fn reply_to_event(\u0026self, reply: \u0026mut Reply) -\u003e Result\u003cAsyncEvent, Error\u003e {\n        if reply.status_code != 650u32 {\n            return Err(Error::UnexpectedSynchonousReplyReceived());\n        }\n\n        // not sure this is what we want but yolo\n        let reply_text = reply.reply_lines.join(\" \");\n        if let Some(caps) = self.status_event_pattern.captures(\u0026reply_text) {\n            let severity = match caps.name(\"severity\") {\n                Some(severity) =\u003e severity.as_str(),\n                None =\u003e unreachable!(),\n            };\n            let action = match caps.name(\"action\") {\n                Some(action) =\u003e action.as_str(),\n                None =\u003e unreachable!(),\n            };\n\n            let mut arguments: Vec\u003c(String, String)\u003e = Default::default();\n            for caps in self\n                .status_event_argument_pattern\n                .captures_iter(\u0026reply_text)\n            {\n                let key = match caps.name(\"key\") {\n                    Some(key) =\u003e key.as_str(),\n                    None =\u003e unreachable!(),\n                };\n                let value = {\n                    let value = match caps.name(\"value\") {\n                        Some(value) =\u003e value.as_str(),\n                        None =\u003e unreachable!(),\n                    };\n                    if value.starts_with('\\\"') \u0026\u0026 value.ends_with('\\\"') {\n                        \u0026value[1..value.len() - 1]\n                    } else {\n                        value\n                    }\n                };\n                arguments.push((key.to_string(), value.to_string()));\n            }\n\n            return Ok(AsyncEvent::StatusClient {\n                severity: severity.to_string(),\n                action: action.to_string(),\n                arguments,\n            });\n        }\n\n        if let Some(caps) = self.hs_desc_pattern.captures(\u0026reply_text) {\n            let action = match caps.name(\"action\") {\n                Some(action) =\u003e action.as_str(),\n                None =\u003e unreachable!(),\n            };\n            let hs_address = match caps.name(\"hsaddress\") {\n                Some(hs_address) =\u003e hs_address.as_str(),\n                None =\u003e unreachable!(),\n            };\n\n            if let Ok(hs_address) = V3OnionServiceId::from_string(hs_address) {\n                return Ok(AsyncEvent::HsDesc {\n                    action: action.to_string(),\n                    hs_address,\n                });\n            }\n        }\n\n        // no luck parsing reply, just return full text\n        let mut reply_lines: Vec\u003cString\u003e = Default::default();\n        std::mem::swap(\u0026mut reply_lines, \u0026mut reply.reply_lines);\n\n        Ok(AsyncEvent::Unknown { lines: reply_lines })\n    }\n\n    pub fn wait_async_events(\u0026mut self) -\u003e Result\u003cVec\u003cAsyncEvent\u003e, Error\u003e {\n        let mut async_replies = self.wait_async_replies()?;\n        let mut async_events: Vec\u003cAsyncEvent\u003e = Default::default();\n\n        for reply in async_replies.iter_mut() {\n            async_events.push(self.reply_to_event(reply)?);\n        }\n\n        Ok(async_events)\n    }\n\n    // wait for a sync reply, save off async replies for later\n    fn wait_sync_reply(\u0026mut self) -\u003e Result\u003cReply, Error\u003e {\n        loop {\n            if let Some(reply) = self\n                .control_stream\n                .read_reply()\n                .map_err(Error::ReadReplyFailed)?\n            {\n                match reply.status_code {\n                    650u32 =\u003e self.async_replies.push(reply),\n                    _ =\u003e return Ok(reply),\n                }\n            }\n        }\n    }\n\n    fn write_command(\u0026mut self, text: \u0026str) -\u003e Result\u003cReply, Error\u003e {\n        self.control_stream\n            .write(text)\n            .map_err(Error::WriteCommandFailed)?;\n        self.wait_sync_reply()\n    }\n\n    //\n    // Tor Commands\n    //\n    // The section where we can find the specification in control-spec.txt\n    // for the underlying command is listed in parentheses\n    //\n    // Each of these command wrapper methods block until completion\n    //\n\n    // SETCONF (3.1)\n    fn setconf_cmd(\u0026mut self, key_values: \u0026[(\u0026str, String)]) -\u003e Result\u003cReply, Error\u003e {\n        if key_values.is_empty() {\n            return Err(Error::InvalidCommandArguments(\n                \"SETCONF key-value pairs list must not be empty\".to_string(),\n            ));\n        }\n        let mut command_buffer = vec![\"SETCONF\".to_string()];\n\n        for (key, value) in key_values.iter() {\n            command_buffer.push(format!(\"{}=\\\"{}\\\"\", key, quoted_string(value.trim())));\n        }\n        let command = command_buffer.join(\" \");\n\n        self.write_command(\u0026command)\n    }\n\n    // GETCONF (3.3)\n    #[cfg(test)]\n    fn getconf_cmd(\u0026mut self, keywords: \u0026[\u0026str]) -\u003e Result\u003cReply, Error\u003e {\n        if keywords.is_empty() {\n            return Err(Error::InvalidCommandArguments(\n                \"GETCONF keywords list must not be empty\".to_string(),\n            ));\n        }\n        let command = format!(\"GETCONF {}\", keywords.join(\" \"));\n\n        self.write_command(\u0026command)\n    }\n\n    // SETEVENTS (3.4)\n    fn setevents_cmd(\u0026mut self, event_codes: \u0026[\u0026str]) -\u003e Result\u003cReply, Error\u003e {\n        if event_codes.is_empty() {\n            return Err(Error::InvalidCommandArguments(\n                \"SETEVENTS event codes list mut not be empty\".to_string(),\n            ));\n        }\n        let command = format!(\"SETEVENTS {}\", event_codes.join(\" \"));\n\n        self.write_command(\u0026command)\n    }\n\n    // AUTHENTICATE (3.5)\n    fn authenticate_cmd(\u0026mut self, password: \u0026str) -\u003e Result\u003cReply, Error\u003e {\n        let command = format!(\"AUTHENTICATE \\\"{}\\\"\", quoted_string(password));\n\n        self.write_command(\u0026command)\n    }\n\n    // GETINFO (3.9)\n    fn getinfo_cmd(\u0026mut self, keywords: \u0026[\u0026str]) -\u003e Result\u003cReply, Error\u003e {\n        if keywords.is_empty() {\n            return Err(Error::InvalidCommandArguments(\n                \"GETINFO keywords list must not be empty\".to_string(),\n            ));\n        }\n        let command = format!(\"GETINFO {}\", keywords.join(\" \"));\n\n        self.write_command(\u0026command)\n    }\n\n    // ADD_ONION (3.27)\n    fn add_onion_cmd(\n        \u0026mut self,\n        key: Option\u003c\u0026Ed25519PrivateKey\u003e,\n        flags: \u0026AddOnionFlags,\n        max_streams: Option\u003cu16\u003e,\n        virt_port: u16,\n        target: Option\u003cSocketAddr\u003e,\n        client_auth: Option\u003c\u0026[X25519PublicKey]\u003e,\n    ) -\u003e Result\u003cReply, Error\u003e {\n        let mut command_buffer = vec![\"ADD_ONION\".to_string()];\n\n        // set our key or request a new one\n        if let Some(key) = key {\n            command_buffer.push(key.to_key_blob());\n        } else {\n            command_buffer.push(\"NEW:ED25519-V3\".to_string());\n        }\n\n        // set our flags\n        let mut flag_buffer: Vec\u003c\u0026str\u003e = Default::default();\n        if flags.discard_pk {\n            flag_buffer.push(\"DiscardPK\");\n        }\n        if flags.detach {\n            flag_buffer.push(\"Detach\");\n        }\n        if flags.v3_auth {\n            flag_buffer.push(\"V3Auth\");\n        }\n        if flags.non_anonymous {\n            flag_buffer.push(\"NonAnonymous\");\n        }\n        if flags.max_streams_close_circuit {\n            flag_buffer.push(\"MaxStreamsCloseCircuit\");\n        }\n\n        if !flag_buffer.is_empty() {\n            command_buffer.push(format!(\"Flags={}\", flag_buffer.join(\",\")));\n        }\n\n        // set max concurrent streams\n        if let Some(max_streams) = max_streams {\n            command_buffer.push(format!(\"MaxStreams={}\", max_streams));\n        }\n\n        // set our onion service target\n        if let Some(target) = target {\n            command_buffer.push(format!(\"Port={},{}\", virt_port, target));\n        } else {\n            command_buffer.push(format!(\"Port={}\", virt_port));\n        }\n        // setup client auth\n        if let Some(client_auth) = client_auth {\n            for key in client_auth.iter() {\n                command_buffer.push(format!(\"ClientAuthV3={}\", key.to_base32()));\n            }\n        }\n\n        // finally send the command\n        let command = command_buffer.join(\" \");\n\n        self.write_command(\u0026command)\n    }\n\n    // DEL_ONION (3.38)\n    fn del_onion_cmd(\u0026mut self, service_id: \u0026V3OnionServiceId) -\u003e Result\u003cReply, Error\u003e {\n        let command = format!(\"DEL_ONION {}\", service_id);\n\n        self.write_command(\u0026command)\n    }\n\n    // ONION_CLIENT_AUTH_ADD (3.30)\n    fn onion_client_auth_add_cmd(\n        \u0026mut self,\n        service_id: \u0026V3OnionServiceId,\n        private_key: \u0026X25519PrivateKey,\n        client_name: Option\u003cString\u003e,\n        flags: \u0026OnionClientAuthAddFlags,\n    ) -\u003e Result\u003cReply, Error\u003e {\n        let mut command_buffer = vec![\"ONION_CLIENT_AUTH_ADD\".to_string()];\n\n        // set the onion service id\n        command_buffer.push(service_id.to_string());\n\n        // set our client's private key\n        command_buffer.push(format!(\"x25519:{}\", private_key.to_base64()));\n\n        if let Some(client_name) = client_name {\n            command_buffer.push(format!(\"ClientName={}\", client_name));\n        }\n\n        if flags.permanent {\n            command_buffer.push(\"Flags=Permanent\".to_string());\n        }\n\n        // finally send command\n        let command = command_buffer.join(\" \");\n\n        self.write_command(\u0026command)\n    }\n\n    // ONION_CLIENT_AUTH_REMOVE (3.31)\n    fn onion_client_auth_remove_cmd(\n        \u0026mut self,\n        service_id: \u0026V3OnionServiceId,\n    ) -\u003e Result\u003cReply, Error\u003e {\n        let command = format!(\"ONION_CLIENT_AUTH_REMOVE {}\", service_id);\n\n        self.write_command(\u0026command)\n    }\n\n    //\n    // Public high-level typesafe command method wrappers\n    //\n\n    pub fn setconf(\u0026mut self, key_values: \u0026[(\u0026str, String)]) -\u003e Result\u003c(), Error\u003e {\n        let reply = self.setconf_cmd(key_values)?;\n\n        match reply.status_code {\n            250u32 =\u003e Ok(()),\n            code =\u003e Err(Error::CommandFailed(code, reply.reply_lines)),\n        }\n    }\n\n    #[cfg(test)]\n    pub fn getconf(\u0026mut self, keywords: \u0026[\u0026str]) -\u003e Result\u003cVec\u003c(String, String)\u003e, Error\u003e {\n        let reply = self.getconf_cmd(keywords)?;\n\n        match reply.status_code {\n            250u32 =\u003e {\n                let mut key_values: Vec\u003c(String, String)\u003e = Default::default();\n                for line in reply.reply_lines {\n                    match line.find('=') {\n                        Some(index) =\u003e key_values\n                            .push((line[0..index].to_string(), line[index + 1..].to_string())),\n                        None =\u003e key_values.push((line, String::new())),\n                    }\n                }\n                Ok(key_values)\n            }\n            code =\u003e Err(Error::CommandFailed(code, reply.reply_lines)),\n        }\n    }\n\n    pub fn setevents(\u0026mut self, events: \u0026[\u0026str]) -\u003e Result\u003c(), Error\u003e {\n        let reply = self.setevents_cmd(events)?;\n\n        match reply.status_code {\n            250u32 =\u003e Ok(()),\n            code =\u003e Err(Error::CommandFailed(code, reply.reply_lines)),\n        }\n    }\n\n    pub fn authenticate(\u0026mut self, password: \u0026str) -\u003e Result\u003c(), Error\u003e {\n        let reply = self.authenticate_cmd(password)?;\n\n        match reply.status_code {\n            250u32 =\u003e Ok(()),\n            code =\u003e Err(Error::CommandFailed(code, reply.reply_lines)),\n        }\n    }\n\n    pub fn getinfo(\u0026mut self, keywords: \u0026[\u0026str]) -\u003e Result\u003cVec\u003c(String, String)\u003e, Error\u003e {\n        let reply = self.getinfo_cmd(keywords)?;\n\n        match reply.status_code {\n            250u32 =\u003e {\n                let mut key_values: Vec\u003c(String, String)\u003e = Default::default();\n                for line in reply.reply_lines {\n                    match line.find('=') {\n                        Some(index) =\u003e key_values\n                            .push((line[0..index].to_string(), line[index + 1..].to_string())),\n                        None =\u003e {\n                            if line != \"OK\" {\n                                key_values.push((line, String::new()))\n                            }\n                        }\n                    }\n                }\n                Ok(key_values)\n            }\n            code =\u003e Err(Error::CommandFailed(code, reply.reply_lines)),\n        }\n    }\n\n    pub fn add_onion(\n        \u0026mut self,\n        key: Option\u003c\u0026Ed25519PrivateKey\u003e,\n        flags: \u0026AddOnionFlags,\n        max_streams: Option\u003cu16\u003e,\n        virt_port: u16,\n        target: Option\u003cSocketAddr\u003e,\n        client_auth: Option\u003c\u0026[X25519PublicKey]\u003e,\n    ) -\u003e Result\u003c(Option\u003cEd25519PrivateKey\u003e, V3OnionServiceId), Error\u003e {\n        let reply = self.add_onion_cmd(key, flags, max_streams, virt_port, target, client_auth)?;\n\n        let mut private_key: Option\u003cEd25519PrivateKey\u003e = None;\n        let mut service_id: Option\u003cV3OnionServiceId\u003e = None;\n\n        match reply.status_code {\n            250u32 =\u003e {\n                for line in reply.reply_lines {\n                    if let Some(mut index) = line.find(\"ServiceID=\") {\n                        if service_id.is_some() {\n                            return Err(Error::CommandReplyParseFailed(\n                                \"received duplicate ServiceID entries\".to_string(),\n                            ));\n                        }\n                        index += \"ServiceId=\".len();\n                        let service_id_string = \u0026line[index..];\n                        service_id = match V3OnionServiceId::from_string(service_id_string) {\n                            Ok(service_id) =\u003e Some(service_id),\n                            Err(_) =\u003e {\n                                return Err(Error::CommandReplyParseFailed(format!(\n                                    \"could not parse '{}' as V3OnionServiceId\",\n                                    service_id_string\n                                )))\n                            }\n                        }\n                    } else if let Some(mut index) = line.find(\"PrivateKey=\") {\n                        if private_key.is_some() {\n                            return Err(Error::CommandReplyParseFailed(\n                                \"received duplicate PrivateKey entries\".to_string(),\n                            ));\n                        }\n                        index += \"PrivateKey=\".len();\n                        let key_blob_string = \u0026line[index..];\n                        private_key = match Ed25519PrivateKey::from_key_blob_legacy(key_blob_string)\n                        {\n                            Ok(private_key) =\u003e Some(private_key),\n                            Err(_) =\u003e {\n                                return Err(Error::CommandReplyParseFailed(format!(\n                                    \"could not parse {} as Ed25519PrivateKey\",\n                                    key_blob_string\n                                )))\n                            }\n                        };\n                    } else if line.contains(\"ClientAuthV3=\") {\n                        if client_auth.unwrap_or_default().is_empty() {\n                            return Err(Error::CommandReplyParseFailed(\n                                \"recieved unexpected ClientAuthV3 keys\".to_string(),\n                            ));\n                        }\n                    } else if !line.contains(\"OK\") {\n                        return Err(Error::CommandReplyParseFailed(format!(\n                            \"received unexpected reply line '{}'\",\n                            line\n                        )));\n                    }\n                }\n            }\n            code =\u003e return Err(Error::CommandFailed(code, reply.reply_lines)),\n        }\n\n        if flags.discard_pk {\n            if private_key.is_some() {\n                return Err(Error::CommandReplyParseFailed(\n                    \"PrivateKey response should have been discard\".to_string(),\n                ));\n            }\n        } else if private_key.is_none() {\n            return Err(Error::CommandReplyParseFailed(\n                \"did not receive a PrivateKey\".to_string(),\n            ));\n        }\n\n        match service_id {\n            Some(service_id) =\u003e Ok((private_key, service_id)),\n            None =\u003e Err(Error::CommandReplyParseFailed(\n                \"did not receive a ServiceID\".to_string(),\n            )),\n        }\n    }\n\n    pub fn del_onion(\u0026mut self, service_id: \u0026V3OnionServiceId) -\u003e Result\u003c(), Error\u003e {\n        let reply = self.del_onion_cmd(service_id)?;\n\n        match reply.status_code {\n            250u32 =\u003e Ok(()),\n            code =\u003e Err(Error::CommandFailed(code, reply.reply_lines)),\n        }\n    }\n\n    // more specific encapulsation of specific command invocations\n\n    pub fn getinfo_net_listeners_socks(\u0026mut self) -\u003e Result\u003cVec\u003cSocketAddr\u003e, Error\u003e {\n        let response = self.getinfo(\u0026[\"net/listeners/socks\"])?;\n        for (key, value) in response.iter() {\n            if key.as_str() == \"net/listeners/socks\" {\n                if value.is_empty() {\n                    return Ok(Default::default());\n                }\n                // get our list of double-quoted strings\n                let listeners: Vec\u003c\u0026str\u003e = value.split(' ').collect();\n                let mut result: Vec\u003cSocketAddr\u003e = Default::default();\n                for socket_addr in listeners.iter() {\n                    if !socket_addr.starts_with('\\\"') || !socket_addr.ends_with('\\\"') {\n                        return Err(Error::CommandReplyParseFailed(format!(\n                            \"could not parse '{}' as socket address\",\n                            socket_addr\n                        )));\n                    }\n\n                    // remove leading/trailing double quote\n                    let stripped = \u0026socket_addr[1..socket_addr.len() - 1];\n                    result.push(match SocketAddr::from_str(stripped) {\n                        Ok(result) =\u003e result,\n                        Err(_) =\u003e {\n                            return Err(Error::CommandReplyParseFailed(format!(\n                                \"could not parse '{}' as socket address\",\n                                socket_addr\n                            )))\n                        }\n                    });\n                }\n                return Ok(result);\n            }\n        }\n        Err(Error::CommandReplyParseFailed(\n            \"reply did not find a 'net/listeners/socks' key/value\".to_string(),\n        ))\n    }\n\n    pub fn getinfo_version(\u0026mut self) -\u003e Result\u003cLegacyTorVersion, Error\u003e {\n        let response = self.getinfo(\u0026[\"version\"])?;\n        for (key, value) in response.iter() {\n            if key.as_str() == \"version\" {\n                return LegacyTorVersion::from_str(value).map_err(Error::TorVersionParseFailed);\n            }\n        }\n        Err(Error::CommandReplyParseFailed(\n            \"did not find a 'version' key/value\".to_string(),\n        ))\n    }\n\n    pub fn onion_client_auth_add(\n        \u0026mut self,\n        service_id: \u0026V3OnionServiceId,\n        private_key: \u0026X25519PrivateKey,\n        client_name: Option\u003cString\u003e,\n        flags: \u0026OnionClientAuthAddFlags,\n    ) -\u003e Result\u003c(), Error\u003e {\n        let reply = self.onion_client_auth_add_cmd(service_id, private_key, client_name, flags)?;\n\n        match reply.status_code {\n            250u32..=252u32 =\u003e Ok(()),\n            code =\u003e Err(Error::CommandFailed(code, reply.reply_lines)),\n        }\n    }\n\n    #[allow(dead_code)]\n    pub fn onion_client_auth_remove(\u0026mut self, service_id: \u0026V3OnionServiceId) -\u003e Result\u003c(), Error\u003e {\n        let reply = self.onion_client_auth_remove_cmd(service_id)?;\n\n        match reply.status_code {\n            250u32..=251u32 =\u003e Ok(()),\n            code =\u003e Err(Error::CommandFailed(code, reply.reply_lines)),\n        }\n    }\n}\n\n#[test]\n#[serial]\nfn test_tor_controller() -\u003e anyhow::Result\u003c()\u003e {\n    let tor_path = which::which(format!(\"tor{}\", std::env::consts::EXE_SUFFIX))?;\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_tor_controller\");\n    let tor_process = LegacyTorProcess::new(\u0026tor_path, \u0026data_path)?;\n\n    // create a scope to ensure tor_controller is dropped\n    {\n        let control_stream =\n            LegacyControlStream::new(tor_process.get_control_addr(), Duration::from_millis(16))?;\n\n        // create a tor controller and send authentication command\n        let mut tor_controller = LegacyTorController::new(control_stream)?;\n        tor_controller.authenticate_cmd(tor_process.get_password())?;\n        assert!(\n            tor_controller\n                .authenticate_cmd(\"invalid password\")?\n                .status_code\n                == 515u32\n        );\n\n        // tor controller should have shutdown the connection after failed authentication\n        assert!(\n            tor_controller\n                .authenticate_cmd(tor_process.get_password())\n                .is_err(),\n            \"expected failure due to closed connection\"\n        );\n        assert!(tor_controller.control_stream.closed_by_remote());\n    }\n    // now create a second controller\n    {\n        let control_stream =\n            LegacyControlStream::new(tor_process.get_control_addr(), Duration::from_millis(16))?;\n\n        // create a tor controller and send authentication command\n        // all async events are just printed to stdout\n        let mut tor_controller = LegacyTorController::new(control_stream)?;\n        tor_controller.authenticate(tor_process.get_password())?;\n\n        // ensure everything is matching our default_torrc settings\n        let vals = tor_controller.getconf(\u0026[\"SocksPort\", \"AvoidDiskWrites\", \"DisableNetwork\"])?;\n        for (key, value) in vals.iter() {\n            let expected = match key.as_str() {\n                \"SocksPort\" =\u003e \"auto\",\n                \"AvoidDiskWrites\" =\u003e \"1\",\n                \"DisableNetwork\" =\u003e \"1\",\n                _ =\u003e panic!(\"unexpected returned key: {}\", key),\n            };\n            assert!(value == expected);\n        }\n\n        let vals = tor_controller.getinfo(\u0026[\"version\", \"config-file\", \"config-text\"])?;\n        let mut expected_torrc_path = data_path.clone();\n        expected_torrc_path.push(\"torrc\");\n        let mut expected_control_port_path = data_path.clone();\n        expected_control_port_path.push(\"control_port\");\n        for (key, value) in vals.iter() {\n            match key.as_str() {\n                \"version\" =\u003e assert!(Regex::new(r\"\\d+\\.\\d+\\.\\d+\\.\\d+\")?.is_match(\u0026value)),\n                \"config-file\" =\u003e assert!(Path::new(\u0026value) == expected_torrc_path),\n                \"config-text\" =\u003e assert!(\n                    value.to_string()\n                        == format!(\n                            \"\\nControlPort auto\\nControlPortWriteToFile {}\\nDataDirectory {}\",\n                            expected_control_port_path.display(),\n                            data_path.display()\n                        )\n                ),\n                _ =\u003e panic!(\"unexpected returned key: {}\", key),\n            }\n        }\n\n        tor_controller.setevents(\u0026[\"STATUS_CLIENT\"])?;\n        // begin bootstrap\n        tor_controller.setconf(\u0026[(\"DisableNetwork\", \"0\".to_string())])?;\n\n        // add an onoin service\n        let (private_key, service_id) =\n            match tor_controller.add_onion(None, \u0026Default::default(), None, 22, None, None)? {\n                (Some(private_key), service_id) =\u003e (private_key, service_id),\n                _ =\u003e panic!(\"add_onion did not return expected values\"),\n            };\n        println!(\"private_key: {}\", private_key.to_key_blob());\n        println!(\"service_id: {}\", service_id.to_string());\n\n        assert!(\n            tor_controller\n                .del_onion(\u0026V3OnionServiceId::from_string(\n                    \"6l62fw7tqctlu5fesdqukvpoxezkaxbzllrafa2ve6ewuhzphxczsjyd\"\n                )?)\n                .is_err(),\n            \"deleting unknown onion should have failed\"\n        );\n\n        // delete our new onion\n        tor_controller.del_onion(\u0026service_id)?;\n\n        println!(\"listeners: \");\n        for sock_addr in tor_controller.getinfo_net_listeners_socks()?.iter() {\n            println!(\" {}\", sock_addr);\n        }\n\n        // print our event names available to tor\n        for (key, value) in tor_controller.getinfo(\u0026[\"events/names\"])?.iter() {\n            println!(\"{} : {}\", key, value);\n        }\n\n        let stop_time = Instant::now() + std::time::Duration::from_secs(5);\n        while stop_time \u003e Instant::now() {\n            for async_event in tor_controller.wait_async_events()?.iter() {\n                match async_event {\n                    AsyncEvent::Unknown { lines } =\u003e {\n                        println!(\"Unknown: {}\", lines.join(\"\\n\"));\n                    }\n                    AsyncEvent::StatusClient {\n                        severity,\n                        action,\n                        arguments,\n                    } =\u003e {\n                        println!(\"STATUS_CLIENT severity={}, action={}\", severity, action);\n                        for (key, value) in arguments.iter() {\n                            println!(\" {}='{}'\", key, value);\n                        }\n                    }\n                    AsyncEvent::HsDesc { action, hs_address } =\u003e {\n                        println!(\n                            \"HS_DESC action={}, hsaddress={}\",\n                            action,\n                            hs_address.to_string()\n                        );\n                    }\n                }\n            }\n        }\n    }\n    Ok(())\n}\n","traces":[{"line":92,"address":[5586224,5586428],"length":1,"stats":{"Line":3}},{"line":95,"address":[5586366,5586248],"length":1,"stats":{"Line":6}},{"line":99,"address":[5587927,5588010,5586448],"length":1,"stats":{"Line":3}},{"line":100,"address":[5546726],"length":1,"stats":{"Line":4}},{"line":102,"address":[5586713],"length":1,"stats":{"Line":0}},{"line":103,"address":[3560053,3560425,3560198,3561369],"length":1,"stats":{"Line":6}},{"line":105,"address":[5587001],"length":1,"stats":{"Line":0}},{"line":110,"address":[3437977],"length":1,"stats":{"Line":3}},{"line":111,"address":[5587270],"length":1,"stats":{"Line":3}},{"line":112,"address":[3560676],"length":1,"stats":{"Line":3}},{"line":114,"address":[1755653],"length":1,"stats":{"Line":3}},{"line":115,"address":[3437849],"length":1,"stats":{"Line":3}},{"line":116,"address":[5547817],"length":1,"stats":{"Line":3}},{"line":122,"address":[3561424,3562053,3562082],"length":1,"stats":{"Line":3}},{"line":123,"address":[3438429],"length":1,"stats":{"Line":3}},{"line":125,"address":[1776134,1776189],"length":1,"stats":{"Line":6}},{"line":129,"address":[5588461,5588641,5588196],"length":1,"stats":{"Line":3}},{"line":132,"address":[3561798],"length":1,"stats":{"Line":0}},{"line":134,"address":[5548880,5548772],"length":1,"stats":{"Line":6}},{"line":137,"address":[3438896],"length":1,"stats":{"Line":3}},{"line":142,"address":[1776704,1778419,1780695],"length":1,"stats":{"Line":3}},{"line":143,"address":[5588775],"length":1,"stats":{"Line":3}},{"line":144,"address":[3562287],"length":1,"stats":{"Line":0}},{"line":148,"address":[5549056],"length":1,"stats":{"Line":3}},{"line":149,"address":[1757074,1757254],"length":1,"stats":{"Line":6}},{"line":150,"address":[2612508,2612407],"length":1,"stats":{"Line":6}},{"line":151,"address":[5589319],"length":1,"stats":{"Line":3}},{"line":154,"address":[5549694],"length":1,"stats":{"Line":3}},{"line":155,"address":[3562911],"length":1,"stats":{"Line":3}},{"line":159,"address":[1777644],"length":1,"stats":{"Line":3}},{"line":160,"address":[1758135,1758180,1758008,1757887],"length":1,"stats":{"Line":12}},{"line":162,"address":[2612949],"length":1,"stats":{"Line":3}},{"line":164,"address":[5590500,5590052],"length":1,"stats":{"Line":6}},{"line":165,"address":[3563938],"length":1,"stats":{"Line":3}},{"line":169,"address":[1758887],"length":1,"stats":{"Line":3}},{"line":170,"address":[1778748],"length":1,"stats":{"Line":3}},{"line":173,"address":[3564553,3564266,3564331],"length":1,"stats":{"Line":9}},{"line":174,"address":[2614261,2614309],"length":1,"stats":{"Line":6}},{"line":176,"address":[5590939],"length":1,"stats":{"Line":3}},{"line":179,"address":[3564425,3564558],"length":1,"stats":{"Line":6}},{"line":182,"address":[5590236],"length":1,"stats":{"Line":3}},{"line":183,"address":[5550370],"length":1,"stats":{"Line":3}},{"line":184,"address":[2613393],"length":1,"stats":{"Line":3}},{"line":185,"address":[3563580],"length":1,"stats":{"Line":3}},{"line":189,"address":[2614626],"length":1,"stats":{"Line":2}},{"line":190,"address":[1779648,1779534],"length":1,"stats":{"Line":4}},{"line":191,"address":[5591742],"length":1,"stats":{"Line":2}},{"line":194,"address":[5591841],"length":1,"stats":{"Line":2}},{"line":195,"address":[3442290],"length":1,"stats":{"Line":2}},{"line":199,"address":[3565397],"length":1,"stats":{"Line":2}},{"line":200,"address":[5592221],"length":1,"stats":{"Line":2}},{"line":201,"address":[3565516],"length":1,"stats":{"Line":2}},{"line":208,"address":[5552739],"length":1,"stats":{"Line":0}},{"line":209,"address":[3565905],"length":1,"stats":{"Line":0}},{"line":211,"address":[3565976],"length":1,"stats":{"Line":0}},{"line":214,"address":[5553941,5553024],"length":1,"stats":{"Line":3}},{"line":215,"address":[5592926,5592798],"length":1,"stats":{"Line":3}},{"line":216,"address":[3443259],"length":1,"stats":{"Line":3}},{"line":218,"address":[5593021,5593098,5593353],"length":1,"stats":{"Line":9}},{"line":219,"address":[5553653,5553633],"length":1,"stats":{"Line":6}},{"line":222,"address":[3566621],"length":1,"stats":{"Line":3}},{"line":226,"address":[3567088],"length":1,"stats":{"Line":3}},{"line":227,"address":[2617512,2616989],"length":1,"stats":{"Line":6}},{"line":228,"address":[5554009,5554260],"length":1,"stats":{"Line":3}},{"line":231,"address":[5554232],"length":1,"stats":{"Line":0}},{"line":233,"address":[2617338],"length":1,"stats":{"Line":3}},{"line":234,"address":[3567519],"length":1,"stats":{"Line":2}},{"line":235,"address":[3567547],"length":1,"stats":{"Line":3}},{"line":241,"address":[5594288],"length":1,"stats":{"Line":3}},{"line":242,"address":[1762518,1762651],"length":1,"stats":{"Line":4}},{"line":244,"address":[2617663],"length":1,"stats":{"Line":1}},{"line":245,"address":[1762616],"length":1,"stats":{"Line":3}},{"line":258,"address":[3444832,3446347,3445830],"length":1,"stats":{"Line":3}},{"line":259,"address":[3444919],"length":1,"stats":{"Line":3}},{"line":260,"address":[5554919],"length":1,"stats":{"Line":0}},{"line":261,"address":[3444982],"length":1,"stats":{"Line":0}},{"line":264,"address":[2617835,2619256,2617993,2618157],"length":1,"stats":{"Line":3}},{"line":266,"address":[2618232,2618131,2618377],"length":1,"stats":{"Line":9}},{"line":267,"address":[5555748,5556219,5555927],"length":1,"stats":{"Line":6}},{"line":269,"address":[5555551,5555353],"length":1,"stats":{"Line":6}},{"line":271,"address":[5595422,5595335],"length":1,"stats":{"Line":6}},{"line":276,"address":[1784590,1783904],"length":1,"stats":{"Line":1}},{"line":277,"address":[1783976],"length":1,"stats":{"Line":1}},{"line":278,"address":[1784168],"length":1,"stats":{"Line":0}},{"line":279,"address":[1784141],"length":1,"stats":{"Line":0}},{"line":282,"address":[1784000,1784226],"length":1,"stats":{"Line":1}},{"line":284,"address":[1784556,1784478],"length":1,"stats":{"Line":2}},{"line":288,"address":[1784624,1785310],"length":1,"stats":{"Line":3}},{"line":289,"address":[3446440],"length":1,"stats":{"Line":3}},{"line":290,"address":[1764489],"length":1,"stats":{"Line":0}},{"line":291,"address":[3569630],"length":1,"stats":{"Line":0}},{"line":294,"address":[3569715,3569488],"length":1,"stats":{"Line":3}},{"line":296,"address":[5556847,5556925],"length":1,"stats":{"Line":6}},{"line":300,"address":[2619984,2620509],"length":1,"stats":{"Line":3}},{"line":301,"address":[5596933,5596808],"length":1,"stats":{"Line":3}},{"line":303,"address":[1765363,1765438],"length":1,"stats":{"Line":6}},{"line":307,"address":[2620544,2621231],"length":1,"stats":{"Line":3}},{"line":308,"address":[5557624],"length":1,"stats":{"Line":3}},{"line":309,"address":[1765769],"length":1,"stats":{"Line":0}},{"line":310,"address":[5557790],"length":1,"stats":{"Line":0}},{"line":313,"address":[3570768,3570995],"length":1,"stats":{"Line":3}},{"line":315,"address":[1786478,1786556],"length":1,"stats":{"Line":6}},{"line":319,"address":[1787966,1789897,1786624],"length":1,"stats":{"Line":3}},{"line":328,"address":[3574747,3571761,3571551],"length":1,"stats":{"Line":3}},{"line":331,"address":[3448701,3448758],"length":1,"stats":{"Line":5}},{"line":332,"address":[5598422,5598512],"length":1,"stats":{"Line":4}},{"line":334,"address":[2621689,2621808],"length":1,"stats":{"Line":2}},{"line":338,"address":[5558797],"length":1,"stats":{"Line":3}},{"line":339,"address":[1787189],"length":1,"stats":{"Line":3}},{"line":340,"address":[5558943,5558868],"length":1,"stats":{"Line":4}},{"line":342,"address":[5558860],"length":1,"stats":{"Line":3}},{"line":343,"address":[1766910],"length":1,"stats":{"Line":0}},{"line":345,"address":[1787281],"length":1,"stats":{"Line":3}},{"line":346,"address":[3449100],"length":1,"stats":{"Line":2}},{"line":348,"address":[3572116],"length":1,"stats":{"Line":3}},{"line":349,"address":[5559050],"length":1,"stats":{"Line":0}},{"line":351,"address":[1766994],"length":1,"stats":{"Line":3}},{"line":352,"address":[5598850],"length":1,"stats":{"Line":0}},{"line":355,"address":[5559083,5559143],"length":1,"stats":{"Line":6}},{"line":356,"address":[2622203,2622623,2622141,2622347],"length":1,"stats":{"Line":6}},{"line":360,"address":[1767130,1767624],"length":1,"stats":{"Line":3}},{"line":361,"address":[2622951,2622830],"length":1,"stats":{"Line":0}},{"line":365,"address":[3449904,3450095],"length":1,"stats":{"Line":5}},{"line":366,"address":[1788823,1788686],"length":1,"stats":{"Line":4}},{"line":368,"address":[3573828,3573707],"length":1,"stats":{"Line":2}},{"line":371,"address":[3573860,3573669],"length":1,"stats":{"Line":5}},{"line":372,"address":[1768787,1768724],"length":1,"stats":{"Line":4}},{"line":373,"address":[2624091,2624367,2623960],"length":1,"stats":{"Line":4}},{"line":378,"address":[1789704,1789092],"length":1,"stats":{"Line":6}},{"line":380,"address":[1789744,1789826],"length":1,"stats":{"Line":6}},{"line":384,"address":[5601376,5601675],"length":1,"stats":{"Line":1}},{"line":385,"address":[2624727],"length":1,"stats":{"Line":1}},{"line":387,"address":[1769852,1769777],"length":1,"stats":{"Line":2}},{"line":391,"address":[3452064,3453731,3453386],"length":1,"stats":{"Line":2}},{"line":398,"address":[3575162,3575271,3576740],"length":1,"stats":{"Line":4}},{"line":401,"address":[3575521,3575461],"length":1,"stats":{"Line":4}},{"line":404,"address":[1770382,1770513,1770789],"length":1,"stats":{"Line":4}},{"line":406,"address":[2625858],"length":1,"stats":{"Line":2}},{"line":407,"address":[1791395,1791516],"length":1,"stats":{"Line":0}},{"line":410,"address":[3453161],"length":1,"stats":{"Line":2}},{"line":411,"address":[3453421],"length":1,"stats":{"Line":0}},{"line":415,"address":[2626380,2626291],"length":1,"stats":{"Line":4}},{"line":417,"address":[1771380,1771459],"length":1,"stats":{"Line":4}},{"line":421,"address":[5563664,5563963],"length":1,"stats":{"Line":1}},{"line":425,"address":[5603511],"length":1,"stats":{"Line":1}},{"line":427,"address":[2626924,2626849],"length":1,"stats":{"Line":2}},{"line":434,"address":[1792272],"length":1,"stats":{"Line":3}},{"line":435,"address":[2627213,2627033],"length":1,"stats":{"Line":3}},{"line":437,"address":[5564209],"length":1,"stats":{"Line":3}},{"line":438,"address":[2627280],"length":1,"stats":{"Line":3}},{"line":439,"address":[5604048],"length":1,"stats":{"Line":0}},{"line":444,"address":[1792768,1794127,1794450],"length":1,"stats":{"Line":1}},{"line":445,"address":[1792809,1793024],"length":1,"stats":{"Line":1}},{"line":447,"address":[1793012],"length":1,"stats":{"Line":1}},{"line":449,"address":[1793096],"length":1,"stats":{"Line":1}},{"line":450,"address":[1794404,1793570,1793520,1793393,1793299],"length":1,"stats":{"Line":5}},{"line":451,"address":[1793618,1793797],"length":1,"stats":{"Line":2}},{"line":452,"address":[1793915,1794384],"length":1,"stats":{"Line":2}},{"line":453,"address":[1794154,1793936],"length":1,"stats":{"Line":2}},{"line":454,"address":[1793860,1793975],"length":1,"stats":{"Line":0}},{"line":457,"address":[1793643],"length":1,"stats":{"Line":1}},{"line":459,"address":[1793111],"length":1,"stats":{"Line":0}},{"line":463,"address":[1772448],"length":1,"stats":{"Line":3}},{"line":464,"address":[1772489,1772669],"length":1,"stats":{"Line":3}},{"line":466,"address":[3577825],"length":1,"stats":{"Line":3}},{"line":467,"address":[3577904],"length":1,"stats":{"Line":3}},{"line":468,"address":[1794798],"length":1,"stats":{"Line":0}},{"line":472,"address":[5604736],"length":1,"stats":{"Line":3}},{"line":473,"address":[3578333,3578153],"length":1,"stats":{"Line":3}},{"line":475,"address":[3455297],"length":1,"stats":{"Line":3}},{"line":476,"address":[5605024],"length":1,"stats":{"Line":3}},{"line":477,"address":[1795294],"length":1,"stats":{"Line":0}},{"line":481,"address":[1797229,1796904,1795488],"length":1,"stats":{"Line":3}},{"line":482,"address":[3455625,3455850],"length":1,"stats":{"Line":3}},{"line":484,"address":[1795738],"length":1,"stats":{"Line":3}},{"line":486,"address":[3455915],"length":1,"stats":{"Line":3}},{"line":487,"address":[2629326,2630215,2629032,2629137,2629272],"length":1,"stats":{"Line":15}},{"line":488,"address":[5566382,5566561],"length":1,"stats":{"Line":6}},{"line":489,"address":[3456746,3457279],"length":1,"stats":{"Line":6}},{"line":490,"address":[1774623,1774915],"length":1,"stats":{"Line":6}},{"line":492,"address":[1774668,1774576],"length":1,"stats":{"Line":6}},{"line":493,"address":[1774693],"length":1,"stats":{"Line":0}},{"line":498,"address":[1774359],"length":1,"stats":{"Line":3}},{"line":500,"address":[1795840],"length":1,"stats":{"Line":0}},{"line":504,"address":[1802453,1797280,1800384],"length":1,"stats":{"Line":3}},{"line":513,"address":[2630442,2630788],"length":1,"stats":{"Line":3}},{"line":515,"address":[5607494],"length":1,"stats":{"Line":3}},{"line":516,"address":[1797737],"length":1,"stats":{"Line":3}},{"line":518,"address":[5607522],"length":1,"stats":{"Line":3}},{"line":520,"address":[5568156,5568345,5568291,5567856],"length":1,"stats":{"Line":12}},{"line":521,"address":[5608129,5609021],"length":1,"stats":{"Line":6}},{"line":522,"address":[1777394,1777327],"length":1,"stats":{"Line":6}},{"line":523,"address":[3583618],"length":1,"stats":{"Line":0}},{"line":524,"address":[3582595],"length":1,"stats":{"Line":0}},{"line":527,"address":[5609257,5609344,5609192],"length":1,"stats":{"Line":6}},{"line":528,"address":[3459732,3459646],"length":1,"stats":{"Line":6}},{"line":529,"address":[5609428,5609653],"length":1,"stats":{"Line":6}},{"line":530,"address":[1777725],"length":1,"stats":{"Line":3}},{"line":532,"address":[3583295,3583424],"length":1,"stats":{"Line":0}},{"line":538,"address":[3583520,3583560,3583246,3583093,3583735,3582529],"length":1,"stats":{"Line":9}},{"line":539,"address":[2633705,2633772],"length":1,"stats":{"Line":2}},{"line":540,"address":[1779719],"length":1,"stats":{"Line":0}},{"line":541,"address":[3583933],"length":1,"stats":{"Line":0}},{"line":544,"address":[5570932,5570786,5570851],"length":1,"stats":{"Line":2}},{"line":545,"address":[5570888,5570963],"length":1,"stats":{"Line":2}},{"line":546,"address":[5571167,5571362,5571011,5571304],"length":1,"stats":{"Line":3}},{"line":548,"address":[3461181],"length":1,"stats":{"Line":1}},{"line":550,"address":[1801491,1801362],"length":1,"stats":{"Line":0}},{"line":556,"address":[5611628,5610491],"length":1,"stats":{"Line":6}},{"line":557,"address":[1801837,1802254],"length":1,"stats":{"Line":4}},{"line":558,"address":[2635442],"length":1,"stats":{"Line":0}},{"line":559,"address":[5612159],"length":1,"stats":{"Line":0}},{"line":562,"address":[5611740,5611673],"length":1,"stats":{"Line":6}},{"line":563,"address":[5612020,5611891],"length":1,"stats":{"Line":0}},{"line":570,"address":[5567934],"length":1,"stats":{"Line":0}},{"line":573,"address":[5568419],"length":1,"stats":{"Line":3}},{"line":574,"address":[3458546,3458775],"length":1,"stats":{"Line":4}},{"line":575,"address":[1799043],"length":1,"stats":{"Line":0}},{"line":576,"address":[2631680],"length":1,"stats":{"Line":0}},{"line":579,"address":[1776376,1776438],"length":1,"stats":{"Line":2}},{"line":580,"address":[1798489],"length":1,"stats":{"Line":0}},{"line":581,"address":[3458615],"length":1,"stats":{"Line":0}},{"line":585,"address":[3458588],"length":1,"stats":{"Line":3}},{"line":586,"address":[2631740],"length":1,"stats":{"Line":3}},{"line":587,"address":[1776859],"length":1,"stats":{"Line":0}},{"line":588,"address":[1776670],"length":1,"stats":{"Line":0}},{"line":593,"address":[2635632],"length":1,"stats":{"Line":1}},{"line":594,"address":[3462768,3462948],"length":1,"stats":{"Line":1}},{"line":596,"address":[1780792],"length":1,"stats":{"Line":1}},{"line":597,"address":[1780869],"length":1,"stats":{"Line":1}},{"line":598,"address":[5572932],"length":1,"stats":{"Line":1}},{"line":604,"address":[3586240,3588784,3588723],"length":1,"stats":{"Line":3}},{"line":605,"address":[5573330,5573151],"length":1,"stats":{"Line":3}},{"line":606,"address":[2636287,2636442,2636643],"length":1,"stats":{"Line":9}},{"line":607,"address":[1781647,1781801],"length":1,"stats":{"Line":6}},{"line":608,"address":[5573922],"length":1,"stats":{"Line":3}},{"line":609,"address":[3464073,3465716],"length":1,"stats":{"Line":0}},{"line":612,"address":[3587077,3587132],"length":1,"stats":{"Line":6}},{"line":613,"address":[2637055],"length":1,"stats":{"Line":3}},{"line":614,"address":[2637458,2637118,2637206],"length":1,"stats":{"Line":9}},{"line":615,"address":[5614284,5614402,5614226],"length":1,"stats":{"Line":9}},{"line":616,"address":[5614490,5614619],"length":1,"stats":{"Line":0}},{"line":623,"address":[5614450,5614706],"length":1,"stats":{"Line":6}},{"line":624,"address":[3465247,3465418,3465170],"length":1,"stats":{"Line":9}},{"line":625,"address":[2638111],"length":1,"stats":{"Line":3}},{"line":627,"address":[1783279,1783408],"length":1,"stats":{"Line":0}},{"line":634,"address":[5614110],"length":1,"stats":{"Line":3}},{"line":637,"address":[3463822],"length":1,"stats":{"Line":0}},{"line":638,"address":[1803458],"length":1,"stats":{"Line":0}},{"line":642,"address":[2639490,2638672],"length":1,"stats":{"Line":2}},{"line":643,"address":[1805657,1805497],"length":1,"stats":{"Line":2}},{"line":644,"address":[1783793,1783933,1784104],"length":1,"stats":{"Line":6}},{"line":645,"address":[5576345,5576193],"length":1,"stats":{"Line":4}},{"line":646,"address":[3466505],"length":1,"stats":{"Line":2}},{"line":649,"address":[2639207],"length":1,"stats":{"Line":0}},{"line":650,"address":[3466221],"length":1,"stats":{"Line":0}},{"line":654,"address":[1784480],"length":1,"stats":{"Line":2}},{"line":661,"address":[1806524,1806336],"length":1,"stats":{"Line":2}},{"line":664,"address":[3589868,3590094],"length":1,"stats":{"Line":4}},{"line":665,"address":[1806588],"length":1,"stats":{"Line":0}},{"line":670,"address":[5577056],"length":1,"stats":{"Line":1}},{"line":671,"address":[1785229,1785040],"length":1,"stats":{"Line":1}},{"line":674,"address":[3467582,3467356],"length":1,"stats":{"Line":2}},{"line":675,"address":[1785294],"length":1,"stats":{"Line":0}}],"covered":210,"coverable":264},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","legacy_tor_process.rs"],"content":"// standard\nuse std::default::Default;\nuse std::fs;\nuse std::fs::File;\nuse std::io::{BufRead, BufReader, Read, Write};\nuse std::net::SocketAddr;\nuse std::ops::Drop;\nuse std::path::Path;\nuse std::process;\nuse std::process::{Child, ChildStdout, Command, Stdio};\nuse std::str::FromStr;\nuse std::string::ToString;\nuse std::sync::{Arc, Mutex};\nuse std::time::{Duration, Instant};\n\n// extern crates\nuse data_encoding::HEXUPPER;\nuse rand::rngs::OsRng;\nuse rand::RngCore;\nuse sha1::{Digest, Sha1};\n\n// internal crates\nuse crate::tor_crypto::generate_password;\n\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"failed to read control port file\")]\n    ControlPortFileReadFailed(#[source] std::io::Error),\n\n    #[error(\"provided control port file '{0}' larger than expected ({1} bytes)\")]\n    ControlPortFileTooLarge(String, u64),\n\n    #[error(\"failed to parse '{0}' as control port file\")]\n    ControlPortFileContentsInvalid(String),\n\n    #[error(\"provided tor bin path '{0}' must be an absolute path\")]\n    TorBinPathNotAbsolute(String),\n\n    #[error(\"provided data directory '{0}' must be an absolute path\")]\n    TorDataDirectoryPathNotAbsolute(String),\n\n    #[error(\"failed to create data directory\")]\n    DataDirectoryCreationFailed(#[source] std::io::Error),\n\n    #[error(\"file exists in provided data directory path '{0}'\")]\n    DataDirectoryPathExistsAsFile(String),\n\n    #[error(\"failed to create default_torrc file\")]\n    DefaultTorrcFileCreationFailed(#[source] std::io::Error),\n\n    #[error(\"failed to write default_torrc file\")]\n    DefaultTorrcFileWriteFailed(#[source] std::io::Error),\n\n    #[error(\"failed to create torrc file\")]\n    TorrcFileCreationFailed(#[source] std::io::Error),\n\n    #[error(\"failed to remove control_port file\")]\n    ControlPortFileDeleteFailed(#[source] std::io::Error),\n\n    #[error(\"failed to start legacy tor process\")]\n    LegacyTorProcessStartFailed(#[source] std::io::Error),\n\n    #[error(\"failed to read control addr from control_file '{0}'\")]\n    ControlPortFileMissing(String),\n\n    #[error(\"unable to take legacy tor process stdout\")]\n    LegacyTorProcessStdoutTakeFailed(),\n\n    #[error(\"failed to spawn tor process stdout read thread\")]\n    StdoutReadThreadSpawnFailed(#[source] std::io::Error),\n}\n\nfn read_control_port_file(control_port_file: \u0026Path) -\u003e Result\u003cSocketAddr, Error\u003e {\n    // open file\n    let mut file = File::open(control_port_file).map_err(Error::ControlPortFileReadFailed)?;\n\n    // bail if the file is larger than expected\n    let metadata = file.metadata().map_err(Error::ControlPortFileReadFailed)?;\n    if metadata.len() \u003e= 1024 {\n        return Err(Error::ControlPortFileTooLarge(\n            format!(\"{}\", control_port_file.display()),\n            metadata.len(),\n        ));\n    }\n\n    // read contents to string\n    let mut contents = String::new();\n    file.read_to_string(\u0026mut contents)\n        .map_err(Error::ControlPortFileReadFailed)?;\n\n    if contents.starts_with(\"PORT=\") {\n        let addr_string = \u0026contents.trim_end()[\"PORT=\".len()..];\n        if let Ok(addr) = SocketAddr::from_str(addr_string) {\n            return Ok(addr);\n        }\n    }\n    Err(Error::ControlPortFileContentsInvalid(format!(\n        \"{}\",\n        control_port_file.display()\n    )))\n}\n\n// Encapsulates the tor daemon process\npub(crate) struct LegacyTorProcess {\n    control_addr: SocketAddr,\n    process: Child,\n    password: String,\n    // stdout data\n    stdout_lines: Arc\u003cMutex\u003cVec\u003cString\u003e\u003e\u003e,\n}\n\nimpl LegacyTorProcess {\n    const S2K_RFC2440_SPECIFIER_LEN: usize = 9;\n\n    fn hash_tor_password_with_salt(\n        salt: \u0026[u8; Self::S2K_RFC2440_SPECIFIER_LEN],\n        password: \u0026str,\n    ) -\u003e String {\n        assert_eq!(salt[Self::S2K_RFC2440_SPECIFIER_LEN - 1], 0x60);\n\n        // tor-specific rfc 2440 constants\n        const EXPBIAS: u8 = 6u8;\n        const C: u8 = 0x60; // salt[S2K_RFC2440_SPECIFIER_LEN - 1]\n        const COUNT: usize = (16usize + ((C \u0026 15u8) as usize)) \u003c\u003c ((C \u003e\u003e 4) + EXPBIAS);\n\n        // squash together our hash input\n        let mut input: Vec\u003cu8\u003e = Default::default();\n        // append salt (sans the 'C' constant')\n        input.extend_from_slice(\u0026salt[0..Self::S2K_RFC2440_SPECIFIER_LEN - 1]);\n        // append password bytes\n        input.extend_from_slice(password.as_bytes());\n\n        let input = input.as_slice();\n        let input_len = input.len();\n\n        let mut sha1 = Sha1::new();\n        let mut count = COUNT;\n        while count \u003e 0 {\n            if count \u003e input_len {\n                sha1.update(input);\n                count -= input_len;\n            } else {\n                sha1.update(\u0026input[0..count]);\n                break;\n            }\n        }\n\n        let key = sha1.finalize();\n\n        let mut hash = \"16:\".to_string();\n        HEXUPPER.encode_append(salt, \u0026mut hash);\n        HEXUPPER.encode_append(\u0026key, \u0026mut hash);\n\n        hash\n    }\n\n    fn hash_tor_password(password: \u0026str) -\u003e String {\n        let mut salt = [0x00u8; Self::S2K_RFC2440_SPECIFIER_LEN];\n        OsRng.fill_bytes(\u0026mut salt);\n        salt[Self::S2K_RFC2440_SPECIFIER_LEN - 1] = 0x60u8;\n\n        Self::hash_tor_password_with_salt(\u0026salt, password)\n    }\n\n    pub fn get_control_addr(\u0026self) -\u003e \u0026SocketAddr {\n        \u0026self.control_addr\n    }\n\n    pub fn get_password(\u0026self) -\u003e \u0026String {\n        \u0026self.password\n    }\n\n    pub fn new(tor_bin_path: \u0026Path, data_directory: \u0026Path) -\u003e Result\u003cLegacyTorProcess, Error\u003e {\n        if tor_bin_path.is_relative() {\n            return Err(Error::TorBinPathNotAbsolute(format!(\n                \"{}\",\n                tor_bin_path.display()\n            )));\n        }\n        if data_directory.is_relative() {\n            return Err(Error::TorDataDirectoryPathNotAbsolute(format!(\n                \"{}\",\n                data_directory.display()\n            )));\n        }\n\n        // create data directory if it doesn't exist\n        if !data_directory.exists() {\n            fs::create_dir_all(data_directory).map_err(Error::DataDirectoryCreationFailed)?;\n        } else if data_directory.is_file() {\n            return Err(Error::DataDirectoryPathExistsAsFile(format!(\n                \"{}\",\n                data_directory.display()\n            )));\n        }\n\n        // construct paths to torrc files\n        let default_torrc = data_directory.join(\"default_torrc\");\n        let torrc = data_directory.join(\"torrc\");\n        let control_port_file = data_directory.join(\"control_port\");\n\n        // TODO: should we nuke the existing torrc between runs? Do we want\n        // users setting custom nonsense in there?\n        // construct default torrc\n        //  - daemon determines socks port\n        //  - minimize writes to disk\n        //  - start with network disabled by default\n        if !default_torrc.exists() {\n            const DEFAULT_TORRC_CONTENT: \u0026str = \"SocksPort auto\\n\\\n            AvoidDiskWrites 1\\n\\\n            DisableNetwork 1\\n\";\n\n            let mut default_torrc_file =\n                File::create(\u0026default_torrc).map_err(Error::DefaultTorrcFileCreationFailed)?;\n            default_torrc_file\n                .write_all(DEFAULT_TORRC_CONTENT.as_bytes())\n                .map_err(Error::DefaultTorrcFileWriteFailed)?;\n        }\n\n        // create empty torrc for user\n        if !torrc.exists() {\n            let _ = File::create(\u0026torrc).map_err(Error::TorrcFileCreationFailed)?;\n        }\n\n        // remove any existing control_port_file\n        if control_port_file.exists() {\n            fs::remove_file(\u0026control_port_file).map_err(Error::ControlPortFileDeleteFailed)?;\n        }\n\n        const CONTROL_PORT_PASSWORD_LENGTH: usize = 32usize;\n        let password = generate_password(CONTROL_PORT_PASSWORD_LENGTH);\n        let password_hash = Self::hash_tor_password(\u0026password);\n\n        let mut process = Command::new(tor_bin_path.as_os_str())\n            .stdout(Stdio::piped())\n            .stdin(Stdio::null())\n            .stderr(Stdio::null())\n            // set working directory to data directory\n            .current_dir(data_directory)\n            // point to our above written torrc file\n            .arg(\"--defaults-torrc\")\n            .arg(default_torrc)\n            // location of torrc\n            .arg(\"--torrc-file\")\n            .arg(torrc)\n            // root data directory\n            .arg(\"DataDirectory\")\n            .arg(data_directory)\n            // daemon will assign us a port, and we will\n            // read it from the control port file\n            .arg(\"ControlPort\")\n            .arg(\"auto\")\n            // control port file destination\n            .arg(\"ControlPortWriteToFile\")\n            .arg(control_port_file.clone())\n            // use password authentication to prevent other apps\n            // from modifying our daemon's settings\n            .arg(\"HashedControlPassword\")\n            .arg(password_hash)\n            // tor process will shut down after this process shuts down\n            // to avoid orphaned tor daemon\n            .arg(\"__OwningControllerProcess\")\n            .arg(process::id().to_string())\n            .spawn()\n            .map_err(Error::LegacyTorProcessStartFailed)?;\n\n        let mut control_addr = None;\n        let start = Instant::now();\n\n        // try and read the control port from the control port file\n        // or abort after 5 seconds\n        // TODO: make this timeout configurable?\n        while control_addr.is_none() \u0026\u0026 start.elapsed() \u003c Duration::from_secs(5) {\n            if control_port_file.exists() {\n                control_addr = Some(read_control_port_file(control_port_file.as_path())?);\n                fs::remove_file(\u0026control_port_file).map_err(Error::ControlPortFileDeleteFailed)?;\n            }\n        }\n\n        let control_addr = match control_addr {\n            Some(control_addr) =\u003e control_addr,\n            None =\u003e {\n                return Err(Error::ControlPortFileMissing(format!(\n                    \"{}\",\n                    control_port_file.display()\n                )))\n            }\n        };\n\n        let stdout_lines: Arc\u003cMutex\u003cVec\u003cString\u003e\u003e\u003e = Default::default();\n\n        {\n            let stdout_lines = Arc::downgrade(\u0026stdout_lines);\n            let stdout = BufReader::new(match process.stdout.take() {\n                Some(stdout) =\u003e stdout,\n                None =\u003e return Err(Error::LegacyTorProcessStdoutTakeFailed()),\n            });\n\n            std::thread::Builder::new()\n                .name(\"tor_stdout_reader\".to_string())\n                .spawn(move || {\n                    LegacyTorProcess::read_stdout_task(\u0026stdout_lines, stdout);\n                })\n                .map_err(Error::StdoutReadThreadSpawnFailed)?;\n        }\n\n        Ok(LegacyTorProcess {\n            control_addr,\n            process,\n            password,\n            stdout_lines,\n        })\n    }\n\n    fn read_stdout_task(\n        stdout_lines: \u0026std::sync::Weak\u003cMutex\u003cVec\u003cString\u003e\u003e\u003e,\n        mut stdout: BufReader\u003cChildStdout\u003e,\n    ) {\n        while let Some(stdout_lines) = stdout_lines.upgrade() {\n            let mut line = String::default();\n            // read line\n            if stdout.read_line(\u0026mut line).is_ok() {\n                // remove trailing '\\n'\n                line.pop();\n                // then acquire the lock on the line buffer\n                let mut stdout_lines = match stdout_lines.lock() {\n                    Ok(stdout_lines) =\u003e stdout_lines,\n                    Err(_) =\u003e unreachable!(),\n                };\n                stdout_lines.push(line);\n            }\n        }\n    }\n\n    pub fn wait_log_lines(\u0026mut self) -\u003e Vec\u003cString\u003e {\n        let mut lines = match self.stdout_lines.lock() {\n            Ok(lines) =\u003e lines,\n            Err(_) =\u003e unreachable!(),\n        };\n        std::mem::take(\u0026mut lines)\n    }\n}\n\nimpl Drop for LegacyTorProcess {\n    fn drop(\u0026mut self) {\n        let _ = self.process.kill();\n    }\n}\n\n#[test]\nfn test_password_hash() -\u003e Result\u003c(), anyhow::Error\u003e {\n    let salt1: [u8; LegacyTorProcess::S2K_RFC2440_SPECIFIER_LEN] = [\n        0xbeu8, 0x2au8, 0x25u8, 0x1du8, 0xe6u8, 0x2cu8, 0xb2u8, 0x7au8, 0x60u8,\n    ];\n    let hash1 = LegacyTorProcess::hash_tor_password_with_salt(\u0026salt1, \"abcdefghijklmnopqrstuvwxyz\");\n    assert_eq!(\n        hash1,\n        \"16:BE2A251DE62CB27A60AC9178A937990E8ED0AB662FA82A5C7DE3EBB23A\"\n    );\n\n    let salt2: [u8; LegacyTorProcess::S2K_RFC2440_SPECIFIER_LEN] = [\n        0x36u8, 0x73u8, 0x0eu8, 0xefu8, 0xd1u8, 0x8cu8, 0x60u8, 0xd6u8, 0x60u8,\n    ];\n    let hash2 = LegacyTorProcess::hash_tor_password_with_salt(\u0026salt2, \"password\");\n    assert_eq!(\n        hash2,\n        \"16:36730EEFD18C60D66052E7EA535438761C0928D316EEA56A190C99B50A\"\n    );\n\n    // ensure same password is hashed to different things\n    assert_ne!(\n        LegacyTorProcess::hash_tor_password(\"password\"),\n        LegacyTorProcess::hash_tor_password(\"password\")\n    );\n\n    Ok(())\n}\n","traces":[{"line":73,"address":[1887825,1885520,1887356],"length":1,"stats":{"Line":3}},{"line":75,"address":[5721855,5721703],"length":1,"stats":{"Line":3}},{"line":78,"address":[1885861,1887820,1886068,1885689],"length":1,"stats":{"Line":6}},{"line":79,"address":[5722265,5722173],"length":1,"stats":{"Line":6}},{"line":80,"address":[2743417],"length":1,"stats":{"Line":0}},{"line":81,"address":[5723635,5723509,5722304],"length":1,"stats":{"Line":0}},{"line":82,"address":[1887636],"length":1,"stats":{"Line":0}},{"line":87,"address":[1629173],"length":1,"stats":{"Line":3}},{"line":88,"address":[3571073,3570970,3571235,3572103],"length":1,"stats":{"Line":6}},{"line":89,"address":[5722563],"length":1,"stats":{"Line":0}},{"line":91,"address":[5682794,5682890],"length":1,"stats":{"Line":6}},{"line":92,"address":[2742299],"length":1,"stats":{"Line":3}},{"line":93,"address":[2742456],"length":1,"stats":{"Line":3}},{"line":94,"address":[3694657],"length":1,"stats":{"Line":3}},{"line":97,"address":[5683461,5683590],"length":1,"stats":{"Line":0}},{"line":99,"address":[5722687,5723079],"length":1,"stats":{"Line":0}},{"line":115,"address":[3574026,3572608,3574100],"length":1,"stats":{"Line":3}},{"line":119,"address":[1887908],"length":1,"stats":{"Line":3}},{"line":127,"address":[1888024],"length":1,"stats":{"Line":3}},{"line":129,"address":[1631053,1631144],"length":1,"stats":{"Line":6}},{"line":131,"address":[1631212],"length":1,"stats":{"Line":3}},{"line":133,"address":[5684608],"length":1,"stats":{"Line":3}},{"line":134,"address":[2744007],"length":1,"stats":{"Line":3}},{"line":136,"address":[1888303],"length":1,"stats":{"Line":3}},{"line":137,"address":[1888322],"length":1,"stats":{"Line":3}},{"line":138,"address":[5725435,5724462],"length":1,"stats":{"Line":6}},{"line":139,"address":[3573264],"length":1,"stats":{"Line":3}},{"line":140,"address":[1631765],"length":1,"stats":{"Line":3}},{"line":141,"address":[2744984,2745024],"length":1,"stats":{"Line":3}},{"line":143,"address":[2744232,2744498],"length":1,"stats":{"Line":6}},{"line":148,"address":[5684733],"length":1,"stats":{"Line":3}},{"line":150,"address":[1888810],"length":1,"stats":{"Line":3}},{"line":151,"address":[3573613],"length":1,"stats":{"Line":3}},{"line":152,"address":[5685469,5685395],"length":1,"stats":{"Line":3}},{"line":154,"address":[3696985],"length":1,"stats":{"Line":3}},{"line":157,"address":[3574128],"length":1,"stats":{"Line":3}},{"line":158,"address":[5725522],"length":1,"stats":{"Line":3}},{"line":159,"address":[1632403],"length":1,"stats":{"Line":3}},{"line":160,"address":[1889447],"length":1,"stats":{"Line":3}},{"line":162,"address":[2745164],"length":1,"stats":{"Line":3}},{"line":165,"address":[1632464],"length":1,"stats":{"Line":3}},{"line":166,"address":[1889480],"length":1,"stats":{"Line":3}},{"line":169,"address":[3697280],"length":1,"stats":{"Line":3}},{"line":173,"address":[3699955,3704867,3697296],"length":1,"stats":{"Line":3}},{"line":174,"address":[2745325],"length":1,"stats":{"Line":3}},{"line":175,"address":[5726117,5725979],"length":1,"stats":{"Line":0}},{"line":177,"address":[3697512],"length":1,"stats":{"Line":0}},{"line":180,"address":[3574454],"length":1,"stats":{"Line":3}},{"line":181,"address":[1633432,1633294],"length":1,"stats":{"Line":0}},{"line":183,"address":[1890171],"length":1,"stats":{"Line":0}},{"line":188,"address":[1890137],"length":1,"stats":{"Line":3}},{"line":189,"address":[3575356,3575593],"length":1,"stats":{"Line":3}},{"line":190,"address":[2746401],"length":1,"stats":{"Line":0}},{"line":191,"address":[5687457,5687595],"length":1,"stats":{"Line":0}},{"line":193,"address":[3575710],"length":1,"stats":{"Line":0}},{"line":198,"address":[3575487],"length":1,"stats":{"Line":3}},{"line":199,"address":[2746501,2747112],"length":1,"stats":{"Line":6}},{"line":200,"address":[5687792],"length":1,"stats":{"Line":3}},{"line":208,"address":[5727694,5727614],"length":1,"stats":{"Line":6}},{"line":213,"address":[2747305,2747513,2747884,2747366],"length":1,"stats":{"Line":6}},{"line":215,"address":[3699705,3699888],"length":1,"stats":{"Line":3}},{"line":216,"address":[3576674],"length":1,"stats":{"Line":3}},{"line":217,"address":[5688448],"length":1,"stats":{"Line":0}},{"line":221,"address":[5727756,5728318],"length":1,"stats":{"Line":6}},{"line":222,"address":[5688601,5688662],"length":1,"stats":{"Line":6}},{"line":226,"address":[1635192,1635421],"length":1,"stats":{"Line":6}},{"line":227,"address":[2748259,2752682],"length":1,"stats":{"Line":0}},{"line":231,"address":[3577305],"length":1,"stats":{"Line":3}},{"line":232,"address":[1635648,1635739],"length":1,"stats":{"Line":6}},{"line":234,"address":[5729169,5729301,5729564,5730312,5728994,5729821,5729239,5729450,5729074,5729935,5730068],"length":1,"stats":{"Line":30}},{"line":235,"address":[5689349],"length":1,"stats":{"Line":3}},{"line":236,"address":[5689452],"length":1,"stats":{"Line":3}},{"line":237,"address":[1893130],"length":1,"stats":{"Line":3}},{"line":242,"address":[3578050],"length":1,"stats":{"Line":3}},{"line":245,"address":[1636264],"length":1,"stats":{"Line":3}},{"line":255,"address":[3578446],"length":1,"stats":{"Line":3}},{"line":259,"address":[1893767],"length":1,"stats":{"Line":3}},{"line":263,"address":[5730001],"length":1,"stats":{"Line":3}},{"line":265,"address":[3577754,3578893,3581697],"length":1,"stats":{"Line":3}},{"line":267,"address":[3702049],"length":1,"stats":{"Line":3}},{"line":268,"address":[5730395],"length":1,"stats":{"Line":3}},{"line":273,"address":[3579165,3579091],"length":1,"stats":{"Line":6}},{"line":274,"address":[1894552,1896430],"length":1,"stats":{"Line":6}},{"line":275,"address":[2752174,2752606,2752384],"length":1,"stats":{"Line":3}},{"line":276,"address":[5725709,5732768,5732866],"length":1,"stats":{"Line":9}},{"line":280,"address":[3579130],"length":1,"stats":{"Line":3}},{"line":281,"address":[2750309],"length":1,"stats":{"Line":3}},{"line":283,"address":[3579708,3579579],"length":1,"stats":{"Line":0}},{"line":285,"address":[5730786,5730708],"length":1,"stats":{"Line":0}},{"line":290,"address":[3702421,3702886],"length":1,"stats":{"Line":6}},{"line":293,"address":[2750814,2750887],"length":1,"stats":{"Line":6}},{"line":294,"address":[5731384,5731319,5731519],"length":1,"stats":{"Line":9}},{"line":295,"address":[1895377],"length":1,"stats":{"Line":3}},{"line":296,"address":[2751008],"length":1,"stats":{"Line":0}},{"line":299,"address":[3580342,3580221,3580473,3580720,3581068],"length":1,"stats":{"Line":9}},{"line":300,"address":[3704146,3703293,3703409],"length":1,"stats":{"Line":6}},{"line":301,"address":[3772944,3773040],"length":1,"stats":{"Line":6}},{"line":302,"address":[5706457],"length":1,"stats":{"Line":3}},{"line":304,"address":[1638657],"length":1,"stats":{"Line":3}},{"line":307,"address":[2751789],"length":1,"stats":{"Line":3}},{"line":309,"address":[3580773],"length":1,"stats":{"Line":3}},{"line":310,"address":[3580805],"length":1,"stats":{"Line":3}},{"line":311,"address":[3580837],"length":1,"stats":{"Line":3}},{"line":315,"address":[1640544,1640649,1639808],"length":1,"stats":{"Line":3}},{"line":319,"address":[3705012,3704937],"length":1,"stats":{"Line":6}},{"line":320,"address":[5693650],"length":1,"stats":{"Line":3}},{"line":322,"address":[3705212,3705130],"length":1,"stats":{"Line":6}},{"line":324,"address":[1897554],"length":1,"stats":{"Line":3}},{"line":326,"address":[2753273],"length":1,"stats":{"Line":3}},{"line":327,"address":[5733745],"length":1,"stats":{"Line":3}},{"line":330,"address":[1640437,1640370],"length":1,"stats":{"Line":6}},{"line":335,"address":[1898048,1898300],"length":1,"stats":{"Line":2}},{"line":336,"address":[3705872],"length":1,"stats":{"Line":2}},{"line":337,"address":[2753824],"length":1,"stats":{"Line":2}},{"line":340,"address":[1640816,1640878],"length":1,"stats":{"Line":4}},{"line":345,"address":[2581568],"length":1,"stats":{"Line":3}},{"line":346,"address":[1732521],"length":1,"stats":{"Line":3}}],"covered":99,"coverable":117},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","legacy_tor_version.rs"],"content":"// standard\nuse std::cmp::Ordering;\nuse std::option::Option;\nuse std::str::FromStr;\nuse std::string::ToString;\n\n/// `LegacyTorVersion`-specific error type\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"{}\", .0)]\n    ParseError(String),\n}\n\n/// Type representing a legacy c-tor daemon's version number. This version conforms c-tor's [version-spec](https://spec.torproject.org/version-spec.htm).\n#[derive(Clone)]\npub struct LegacyTorVersion {\n    pub(crate) major: u32,\n    pub(crate) minor: u32,\n    pub(crate) micro: u32,\n    pub(crate) patch_level: u32,\n    pub(crate) status_tag: Option\u003cString\u003e,\n}\n\nimpl LegacyTorVersion {\n    fn status_tag_pattern_is_match(status_tag: \u0026str) -\u003e bool {\n        if status_tag.is_empty() {\n            return false;\n        }\n\n        for c in status_tag.chars() {\n            if c.is_whitespace() {\n                return false;\n            }\n        }\n        true\n    }\n\n    /// Construct a new `LegacyTorVersion` object.\n    pub fn new(\n        major: u32,\n        minor: u32,\n        micro: u32,\n        patch_level: Option\u003cu32\u003e,\n        status_tag: Option\u003c\u0026str\u003e,\n    ) -\u003e Result\u003cLegacyTorVersion, Error\u003e {\n        let status_tag = if let Some(status_tag) = status_tag {\n            if Self::status_tag_pattern_is_match(status_tag) {\n                Some(status_tag.to_string())\n            } else {\n                return Err(Error::ParseError(\n                    \"tor version status tag may not be empty or contain white-space\".to_string(),\n                ));\n            }\n        } else {\n            None\n        };\n\n        Ok(LegacyTorVersion {\n            major,\n            minor,\n            micro,\n            patch_level: patch_level.unwrap_or(0u32),\n            status_tag,\n        })\n    }\n}\n\nimpl FromStr for LegacyTorVersion {\n    type Err = Error;\n\n    fn from_str(s: \u0026str) -\u003e Result\u003cLegacyTorVersion, Self::Err\u003e {\n        // MAJOR.MINOR.MICRO[.PATCHLEVEL][-STATUS_TAG][ (EXTRA_INFO)]*\n        let mut tokens = s.split(' ');\n        let (major, minor, micro, patch_level, status_tag) =\n            if let Some(version_status_tag) = tokens.next() {\n                let mut tokens = version_status_tag.split('-');\n                let (major, minor, micro, patch_level) = if let Some(version) = tokens.next() {\n                    let mut tokens = version.split('.');\n                    let major: u32 = if let Some(major) = tokens.next() {\n                        match major.parse() {\n                            Ok(major) =\u003e major,\n                            Err(_) =\u003e {\n                                return Err(Error::ParseError(format!(\n                                    \"failed to parse '{}' as MAJOR portion of tor version\",\n                                    major\n                                )))\n                            }\n                        }\n                    } else {\n                        return Err(Error::ParseError(\n                            \"failed to find MAJOR portion of tor version\".to_string(),\n                        ));\n                    };\n                    let minor: u32 = if let Some(minor) = tokens.next() {\n                        match minor.parse() {\n                            Ok(minor) =\u003e minor,\n                            Err(_) =\u003e {\n                                return Err(Error::ParseError(format!(\n                                    \"failed to parse '{}' as MINOR portion of tor version\",\n                                    minor\n                                )))\n                            }\n                        }\n                    } else {\n                        return Err(Error::ParseError(\n                            \"failed to find MINOR portion of tor version\".to_string(),\n                        ));\n                    };\n                    let micro: u32 = if let Some(micro) = tokens.next() {\n                        match micro.parse() {\n                            Ok(micro) =\u003e micro,\n                            Err(_) =\u003e {\n                                return Err(Error::ParseError(format!(\n                                    \"failed to parse '{}' as MICRO portion of tor version\",\n                                    micro\n                                )))\n                            }\n                        }\n                    } else {\n                        return Err(Error::ParseError(\n                            \"failed to find MICRO portion of tor version\".to_string(),\n                        ));\n                    };\n                    let patch_level: u32 = if let Some(patch_level) = tokens.next() {\n                        match patch_level.parse() {\n                            Ok(patch_level) =\u003e patch_level,\n                            Err(_) =\u003e {\n                                return Err(Error::ParseError(format!(\n                                    \"failed to parse '{}' as PATCHLEVEL portion of tor version\",\n                                    patch_level\n                                )))\n                            }\n                        }\n                    } else {\n                        0u32\n                    };\n                    (major, minor, micro, patch_level)\n                } else {\n                    // if there were '-' the previous next() would have returned the enire string\n                    unreachable!();\n                };\n                let status_tag = tokens.next().map(|status_tag| status_tag.to_string());\n\n                (major, minor, micro, patch_level, status_tag)\n            } else {\n                // if there were no ' ' character the previou snext() would have returned the enire string\n                unreachable!();\n            };\n        for extra_info in tokens {\n            if !extra_info.starts_with('(') || !extra_info.ends_with(')') {\n                return Err(Error::ParseError(format!(\n                    \"failed to parse '{}' as [ (EXTRA_INFO)]\",\n                    extra_info\n                )));\n            }\n        }\n        LegacyTorVersion::new(\n            major,\n            minor,\n            micro,\n            Some(patch_level),\n            status_tag.as_deref(),\n        )\n    }\n}\n\nimpl ToString for LegacyTorVersion {\n    fn to_string(\u0026self) -\u003e String {\n        match \u0026self.status_tag {\n            Some(status_tag) =\u003e format!(\n                \"{}.{}.{}.{}-{}\",\n                self.major, self.minor, self.micro, self.patch_level, status_tag\n            ),\n            None =\u003e format!(\n                \"{}.{}.{}.{}\",\n                self.major, self.minor, self.micro, self.patch_level\n            ),\n        }\n    }\n}\n\nimpl PartialEq for LegacyTorVersion {\n    fn eq(\u0026self, other: \u0026Self) -\u003e bool {\n        self.major == other.major\n            \u0026\u0026 self.minor == other.minor\n            \u0026\u0026 self.micro == other.micro\n            \u0026\u0026 self.patch_level == other.patch_level\n            \u0026\u0026 self.status_tag == other.status_tag\n    }\n}\n\nimpl PartialOrd for LegacyTorVersion {\n    fn partial_cmp(\u0026self, other: \u0026Self) -\u003e Option\u003cOrdering\u003e {\n        if let Some(order) = self.major.partial_cmp(\u0026other.major) {\n            if order != Ordering::Equal {\n                return Some(order);\n            }\n        }\n\n        if let Some(order) = self.minor.partial_cmp(\u0026other.minor) {\n            if order != Ordering::Equal {\n                return Some(order);\n            }\n        }\n\n        if let Some(order) = self.micro.partial_cmp(\u0026other.micro) {\n            if order != Ordering::Equal {\n                return Some(order);\n            }\n        }\n\n        if let Some(order) = self.patch_level.partial_cmp(\u0026other.patch_level) {\n            if order != Ordering::Equal {\n                return Some(order);\n            }\n        }\n\n        // version-spect.txt *does* say that we should compare tags lexicgraphically\n        // if all of the version numbers are the same when comparing, but we are\n        // going to diverge here and say we can only compare tags for equality.\n        //\n        // In practice we will be comparing tor daemon tags against tagless (stable)\n        // versions so this shouldn't be an issue\n\n        if self.status_tag == other.status_tag {\n            return Some(Ordering::Equal);\n        }\n\n        None\n    }\n}\n\n#[test]\nfn test_version() -\u003e anyhow::Result\u003c()\u003e {\n    assert!(LegacyTorVersion::from_str(\"1.2.3\")? == LegacyTorVersion::new(1, 2, 3, None, None)?);\n    assert!(\n        LegacyTorVersion::from_str(\"1.2.3.4\")? == LegacyTorVersion::new(1, 2, 3, Some(4), None)?\n    );\n    assert!(\n        LegacyTorVersion::from_str(\"1.2.3-test\")?\n            == LegacyTorVersion::new(1, 2, 3, None, Some(\"test\"))?\n    );\n    assert!(\n        LegacyTorVersion::from_str(\"1.2.3.4-test\")?\n            == LegacyTorVersion::new(1, 2, 3, Some(4), Some(\"test\"))?\n    );\n    assert!(\n        LegacyTorVersion::from_str(\"1.2.3 (extra_info)\")?\n            == LegacyTorVersion::new(1, 2, 3, None, None)?\n    );\n    assert!(\n        LegacyTorVersion::from_str(\"1.2.3.4 (extra_info)\")?\n            == LegacyTorVersion::new(1, 2, 3, Some(4), None)?\n    );\n    assert!(\n        LegacyTorVersion::from_str(\"1.2.3.4-tag (extra_info)\")?\n            == LegacyTorVersion::new(1, 2, 3, Some(4), Some(\"tag\"))?\n    );\n\n    assert!(\n        LegacyTorVersion::from_str(\"1.2.3.4-tag (extra_info) (extra_info)\")?\n            == LegacyTorVersion::new(1, 2, 3, Some(4), Some(\"tag\"))?\n    );\n\n    assert!(LegacyTorVersion::new(1, 2, 3, Some(4), Some(\"spaced tag\")).is_err());\n    assert!(LegacyTorVersion::new(1, 2, 3, Some(4), Some(\"\" /* empty tag */)).is_err());\n    assert!(LegacyTorVersion::from_str(\"\").is_err());\n    assert!(LegacyTorVersion::from_str(\"1.2\").is_err());\n    assert!(LegacyTorVersion::from_str(\"1.2-foo\").is_err());\n    assert!(LegacyTorVersion::from_str(\"1.2.3.4-foo bar\").is_err());\n    assert!(LegacyTorVersion::from_str(\"1.2.3.4-foo bar (extra_info)\").is_err());\n    assert!(LegacyTorVersion::from_str(\"1.2.3.4-foo (extra_info) badtext\").is_err());\n    assert!(\n        LegacyTorVersion::new(0, 0, 0, Some(0), None)?\n            \u003c LegacyTorVersion::new(1, 0, 0, Some(0), None)?\n    );\n    assert!(\n        LegacyTorVersion::new(0, 0, 0, Some(0), None)?\n            \u003c LegacyTorVersion::new(0, 1, 0, Some(0), None)?\n    );\n    assert!(\n        LegacyTorVersion::new(0, 0, 0, Some(0), None)?\n            \u003c LegacyTorVersion::new(0, 0, 1, Some(0), None)?\n    );\n\n    // ensure status tags make comparison between equal versions (apart from\n    // tags) unknowable\n    let zero_version = LegacyTorVersion::new(0, 0, 0, Some(0), None)?;\n    let zero_version_tag = LegacyTorVersion::new(0, 0, 0, Some(0), Some(\"tag\"))?;\n\n    assert!(!(zero_version \u003c zero_version_tag));\n    assert!(!(zero_version \u003c= zero_version_tag));\n    assert!(!(zero_version \u003e zero_version_tag));\n    assert!(!(zero_version \u003e= zero_version_tag));\n\n    Ok(())\n}\n","traces":[{"line":25,"address":[1871568],"length":1,"stats":{"Line":1}},{"line":26,"address":[1480247],"length":1,"stats":{"Line":1}},{"line":27,"address":[1480294],"length":1,"stats":{"Line":1}},{"line":30,"address":[2727163,2727117,2727081],"length":1,"stats":{"Line":3}},{"line":31,"address":[2727171],"length":1,"stats":{"Line":1}},{"line":32,"address":[3679516],"length":1,"stats":{"Line":1}},{"line":35,"address":[5707572],"length":1,"stats":{"Line":1}},{"line":39,"address":[5667888,5668506],"length":1,"stats":{"Line":3}},{"line":46,"address":[2727594,2727318,2727410],"length":1,"stats":{"Line":7}},{"line":47,"address":[5707796],"length":1,"stats":{"Line":1}},{"line":48,"address":[5668226],"length":1,"stats":{"Line":1}},{"line":50,"address":[1871973],"length":1,"stats":{"Line":1}},{"line":51,"address":[3556711],"length":1,"stats":{"Line":1}},{"line":55,"address":[1871923],"length":1,"stats":{"Line":3}},{"line":58,"address":[1872263],"length":1,"stats":{"Line":3}},{"line":62,"address":[1480801],"length":1,"stats":{"Line":3}},{"line":63,"address":[3680016],"length":1,"stats":{"Line":3}},{"line":71,"address":[5712386,5708272],"length":1,"stats":{"Line":3}},{"line":73,"address":[5668561],"length":1,"stats":{"Line":3}},{"line":74,"address":[5711392],"length":1,"stats":{"Line":3}},{"line":76,"address":[3680313],"length":1,"stats":{"Line":3}},{"line":77,"address":[5668776,5668684,5671463],"length":1,"stats":{"Line":9}},{"line":78,"address":[1872664],"length":1,"stats":{"Line":3}},{"line":79,"address":[5708571,5708663],"length":1,"stats":{"Line":6}},{"line":80,"address":[1872807],"length":1,"stats":{"Line":3}},{"line":81,"address":[3680804],"length":1,"stats":{"Line":3}},{"line":83,"address":[1481863,1481998],"length":1,"stats":{"Line":2}},{"line":90,"address":[3557678],"length":1,"stats":{"Line":0}},{"line":91,"address":[3557648],"length":1,"stats":{"Line":0}},{"line":94,"address":[1482100,1481685],"length":1,"stats":{"Line":6}},{"line":95,"address":[5709365],"length":1,"stats":{"Line":3}},{"line":96,"address":[5709570],"length":1,"stats":{"Line":3}},{"line":98,"address":[1873878,1874013],"length":1,"stats":{"Line":0}},{"line":105,"address":[1873580],"length":1,"stats":{"Line":0}},{"line":106,"address":[3681342],"length":1,"stats":{"Line":0}},{"line":109,"address":[5710003,5709588],"length":1,"stats":{"Line":6}},{"line":110,"address":[1482801],"length":1,"stats":{"Line":3}},{"line":111,"address":[1483005],"length":1,"stats":{"Line":3}},{"line":113,"address":[3559451,3559316],"length":1,"stats":{"Line":0}},{"line":120,"address":[5670394],"length":1,"stats":{"Line":1}},{"line":121,"address":[5670364],"length":1,"stats":{"Line":1}},{"line":124,"address":[1483023,1483572,1483546,1483438],"length":1,"stats":{"Line":10}},{"line":125,"address":[1483470],"length":1,"stats":{"Line":3}},{"line":126,"address":[3559667],"length":1,"stats":{"Line":3}},{"line":128,"address":[1483822,1483687],"length":1,"stats":{"Line":0}},{"line":135,"address":[1874883],"length":1,"stats":{"Line":1}},{"line":137,"address":[5711172],"length":1,"stats":{"Line":3}},{"line":142,"address":[1875391],"length":1,"stats":{"Line":5}},{"line":144,"address":[1875444],"length":1,"stats":{"Line":3}},{"line":149,"address":[5671752,5671913,5672074],"length":1,"stats":{"Line":7}},{"line":150,"address":[1484725,1484843,1484606],"length":1,"stats":{"Line":3}},{"line":151,"address":[1484896,1485022],"length":1,"stats":{"Line":2}},{"line":161,"address":[2731355],"length":1,"stats":{"Line":3}},{"line":162,"address":[5711789],"length":1,"stats":{"Line":3}},{"line":168,"address":[5672672],"length":1,"stats":{"Line":0}},{"line":169,"address":[3561326],"length":1,"stats":{"Line":0}},{"line":170,"address":[1877292,1877385,1877669,1877478,1877194],"length":1,"stats":{"Line":0}},{"line":174,"address":[3684482,3684389,3684575,3684976,3684668,3684758],"length":1,"stats":{"Line":0}},{"line":183,"address":[5713808],"length":1,"stats":{"Line":1}},{"line":184,"address":[2733415],"length":1,"stats":{"Line":1}},{"line":185,"address":[5713855],"length":1,"stats":{"Line":1}},{"line":186,"address":[1486608],"length":1,"stats":{"Line":1}},{"line":187,"address":[1878001],"length":1,"stats":{"Line":1}},{"line":188,"address":[3562786],"length":1,"stats":{"Line":1}},{"line":193,"address":[5713936],"length":1,"stats":{"Line":3}},{"line":194,"address":[1486696],"length":1,"stats":{"Line":3}},{"line":195,"address":[5714007],"length":1,"stats":{"Line":3}},{"line":196,"address":[5714080],"length":1,"stats":{"Line":1}},{"line":200,"address":[5714039,5714097],"length":1,"stats":{"Line":6}},{"line":201,"address":[1878217],"length":1,"stats":{"Line":3}},{"line":202,"address":[1878290],"length":1,"stats":{"Line":1}},{"line":206,"address":[3563068,3563017],"length":1,"stats":{"Line":6}},{"line":207,"address":[2733780],"length":1,"stats":{"Line":3}},{"line":208,"address":[3563149],"length":1,"stats":{"Line":1}},{"line":212,"address":[1878340,1878394],"length":1,"stats":{"Line":6}},{"line":213,"address":[5674546],"length":1,"stats":{"Line":3}},{"line":214,"address":[1487069],"length":1,"stats":{"Line":2}},{"line":225,"address":[2733906],"length":1,"stats":{"Line":1}},{"line":226,"address":[1878469],"length":1,"stats":{"Line":0}},{"line":229,"address":[1878459],"length":1,"stats":{"Line":1}}],"covered":68,"coverable":80},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","lib.rs"],"content":"#![doc = include_str!(\"../README.md\")]\n\n/// Implementation of an in-process [`arti-client`](https://crates.io/crates/arti-client)-based `TorProvider`\n#[cfg(feature = \"arti-client-tor-provider\")]\npub mod arti_client_tor_client;\n#[cfg(feature = \"legacy-tor-provider\")]\n/// Censorship circumvention configuration for pluggable-transports and bridge settings\npub mod censorship_circumvention;\n/// Implementation of an out-of-process legacy [c-tor daemon](https://gitlab.torproject.org/tpo/core/tor)-based `TorProvider`\n#[cfg(feature = \"legacy-tor-provider\")]\npub mod legacy_tor_client;\n#[cfg(feature = \"legacy-tor-provider\")]\nmod legacy_tor_control_stream;\n#[cfg(feature = \"legacy-tor-provider\")]\nmod legacy_tor_controller;\n#[cfg(feature = \"legacy-tor-provider\")]\nmod legacy_tor_process;\n/// Legacy c-tor daemon version.\n#[cfg(feature = \"legacy-tor-provider\")]\npub mod legacy_tor_version;\n/// Implementation of a local, in-process, mock `TorProvider` for testing.\n#[cfg(feature = \"mock-tor-provider\")]\npub mod mock_tor_client;\n#[cfg(feature = \"legacy-tor-provider\")]\n/// Proxy settings\npub mod proxy;\n/// Tor-specific cryptographic primitives, operations, and conversion functions.\npub mod tor_crypto;\n/// Traits and types for connecting to the Tor Network.\npub mod tor_provider;\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","mock_tor_client.rs"],"content":"// standard\nuse std::collections::BTreeMap;\nuse std::net::{SocketAddr, TcpListener, TcpStream};\nuse std::sync::{atomic, Arc, Mutex};\n\n// internal crates\nuse crate::tor_crypto::*;\nuse crate::tor_provider;\nuse crate::tor_provider::*;\n\n\n/// [`MockTorClient`]-specific error type\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"client not bootstrapped\")]\n    ClientNotBootstrapped(),\n\n    #[error(\"client already bootstrapped\")]\n    ClientAlreadyBootstrapped(),\n\n    #[error(\"onion service not found: {}\", .0)]\n    OnionServiceNotFound(OnionAddr),\n\n    #[error(\"onion service not published: {}\", .0)]\n    OnionServiceNotPublished(OnionAddr),\n\n    #[error(\"onion service requires onion auth\")]\n    OnionServiceRequiresOnionAuth(),\n\n    #[error(\"provided onion auth key invalid\")]\n    OnionServiceAuthInvalid(),\n\n    #[error(\"unable to bind TCP listener\")]\n    TcpListenerBindFailed(#[source] std::io::Error),\n\n    #[error(\"unable to get TCP listener's local adress\")]\n    TcpListenerLocalAddrFailed(#[source] std::io::Error),\n\n    #[error(\"unable to connect to {}\", .0)]\n    ConnectFailed(TargetAddr),\n\n    #[error(\"not implemented\")]\n    NotImplemented(),\n}\n\nimpl From\u003cError\u003e for crate::tor_provider::Error {\n    fn from(error: Error) -\u003e Self {\n        crate::tor_provider::Error::Generic(error.to_string())\n    }\n}\n\nstruct MockTorNetwork {\n    onion_services: Option\u003cBTreeMap\u003cOnionAddr, (Vec\u003cX25519PublicKey\u003e, SocketAddr)\u003e\u003e,\n}\n\nimpl MockTorNetwork {\n    const fn new() -\u003e MockTorNetwork {\n        MockTorNetwork {\n            onion_services: None,\n        }\n    }\n\n    fn connect_to_onion(\n        \u0026mut self,\n        service_id: \u0026V3OnionServiceId,\n        virt_port: u16,\n        client_auth: Option\u003c\u0026X25519PublicKey\u003e,\n    ) -\u003e Result\u003cOnionStream, Error\u003e {\n        let onion_addr = OnionAddr::V3(OnionAddrV3::new(service_id.clone(), virt_port));\n\n        match \u0026mut self.onion_services {\n            Some(onion_services) =\u003e {\n                if let Some((client_auth_keys, socket_addr)) = onion_services.get(\u0026onion_addr) {\n                    match (client_auth_keys.len(), client_auth) {\n                        (0, None) =\u003e (),\n                        (_, None) =\u003e return Err(Error::OnionServiceRequiresOnionAuth()),\n                        (0, Some(_)) =\u003e return Err(Error::OnionServiceAuthInvalid()),\n                        (_, Some(client_auth)) =\u003e {\n                            if !client_auth_keys.contains(client_auth) {\n                                return Err(Error::OnionServiceAuthInvalid());\n                            }\n                        }\n                    }\n\n                    if let Ok(stream) = TcpStream::connect(socket_addr) {\n                        Ok(OnionStream {\n                            stream,\n                            local_addr: None,\n                            peer_addr: Some(TargetAddr::OnionService(onion_addr)),\n                        })\n                    } else {\n                        Err(Error::OnionServiceNotFound(onion_addr))\n                    }\n                } else {\n                    Err(Error::OnionServiceNotPublished(onion_addr))\n                }\n            }\n            None =\u003e Err(Error::OnionServiceNotPublished(onion_addr)),\n        }\n    }\n\n    fn start_onion(\n        \u0026mut self,\n        service_id: V3OnionServiceId,\n        virt_port: u16,\n        client_auth_keys: Vec\u003cX25519PublicKey\u003e,\n        address: SocketAddr,\n    ) {\n        let onion_addr = OnionAddr::V3(OnionAddrV3::new(service_id, virt_port));\n        match \u0026mut self.onion_services {\n            Some(onion_services) =\u003e {\n                onion_services.insert(onion_addr, (client_auth_keys, address));\n            }\n            None =\u003e {\n                let mut onion_services = BTreeMap::new();\n                onion_services.insert(onion_addr, (client_auth_keys, address));\n                self.onion_services = Some(onion_services);\n            }\n        }\n    }\n\n    fn stop_onion(\u0026mut self, onion_addr: \u0026OnionAddr) {\n        if let Some(onion_services) = \u0026mut self.onion_services {\n            onion_services.remove(onion_addr);\n        }\n    }\n}\n\nstatic MOCK_TOR_NETWORK: Mutex\u003cMockTorNetwork\u003e = Mutex::new(MockTorNetwork::new());\n\n/// A mock `TorProvider` implementation for testing.\n///\n/// `MockTorClient` implements the [`TorProvider`] trait. It creates a fake, in-process Tor Network using local socekts and listeners. No actual traffic ever leaves the local host.\n///\n/// Mock onion-services can be created, connected to, and communiccated with. Connecting to clearnet targets always succeeds by connecting to single local endpoint, but will never send any traffic to connecting clients.\npub struct MockTorClient {\n    events: Vec\u003cTorEvent\u003e,\n    bootstrapped: bool,\n    client_auth_keys: BTreeMap\u003cV3OnionServiceId, X25519PublicKey\u003e,\n    onion_services: Vec\u003c(OnionAddr, Arc\u003catomic::AtomicBool\u003e)\u003e,\n    loopback: TcpListener,\n}\n\nimpl MockTorClient {\n    /// Construt a new `MockTorClient`.\n    pub fn new() -\u003e MockTorClient {\n        let mut events: Vec\u003cTorEvent\u003e = Default::default();\n        let line = \"[notice] MockTorClient running\".to_string();\n        events.push(TorEvent::LogReceived { line });\n\n        let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n        let listener = TcpListener::bind(socket_addr).expect(\"tcplistener bind failed\");\n\n        MockTorClient {\n            events,\n            bootstrapped: false,\n            client_auth_keys: Default::default(),\n            onion_services: Default::default(),\n            loopback: listener,\n        }\n    }\n}\n\nimpl Default for MockTorClient {\n    fn default() -\u003e Self {\n        Self::new()\n    }\n}\n\nimpl TorProvider for MockTorClient {\n    fn update(\u0026mut self) -\u003e Result\u003cVec\u003cTorEvent\u003e, tor_provider::Error\u003e {\n        match MOCK_TOR_NETWORK.lock() {\n            Ok(mut mock_tor_network) =\u003e {\n                let mut i = 0;\n                while i \u003c self.onion_services.len() {\n                    // remove onion services with no active listeners\n                    if !self.onion_services[i].1.load(atomic::Ordering::Relaxed) {\n                        let entry = self.onion_services.swap_remove(i);\n                        let onion_addr = entry.0;\n                        mock_tor_network.stop_onion(\u0026onion_addr);\n                    } else {\n                        i += 1;\n                    }\n                }\n            }\n            Err(_) =\u003e unreachable!(\"another thread panicked while holding mock tor network's lock\"),\n        }\n\n        Ok(std::mem::take(\u0026mut self.events))\n    }\n\n    fn bootstrap(\u0026mut self) -\u003e Result\u003c(), tor_provider::Error\u003e {\n        if self.bootstrapped {\n            Err(Error::ClientAlreadyBootstrapped())?\n        } else {\n            self.events.push(TorEvent::BootstrapStatus {\n                progress: 0u32,\n                tag: \"start\".to_string(),\n                summary: \"bootstrapping started\".to_string(),\n            });\n            self.events.push(TorEvent::BootstrapStatus {\n                progress: 50u32,\n                tag: \"middle\".to_string(),\n                summary: \"bootstrapping continues\".to_string(),\n            });\n            self.events.push(TorEvent::BootstrapStatus {\n                progress: 100u32,\n                tag: \"finished\".to_string(),\n                summary: \"bootstrapping completed\".to_string(),\n            });\n            self.events.push(TorEvent::BootstrapComplete);\n            self.bootstrapped = true;\n            Ok(())\n        }\n    }\n\n    fn add_client_auth(\n        \u0026mut self,\n        service_id: \u0026V3OnionServiceId,\n        client_auth: \u0026X25519PrivateKey,\n    ) -\u003e Result\u003c(), tor_provider::Error\u003e {\n        let client_auth_public = X25519PublicKey::from_private_key(client_auth);\n        if let Some(key) = self.client_auth_keys.get_mut(service_id) {\n            *key = client_auth_public;\n        } else {\n            self.client_auth_keys\n                .insert(service_id.clone(), client_auth_public);\n        }\n        Ok(())\n    }\n\n    fn remove_client_auth(\n        \u0026mut self,\n        service_id: \u0026V3OnionServiceId,\n    ) -\u003e Result\u003c(), tor_provider::Error\u003e {\n        self.client_auth_keys.remove(service_id);\n        Ok(())\n    }\n\n    fn connect(\n        \u0026mut self,\n        target: TargetAddr,\n        _circuit: Option\u003cCircuitToken\u003e,\n    ) -\u003e Result\u003cOnionStream, tor_provider::Error\u003e {\n        let (service_id, virt_port) = match target {\n            TargetAddr::OnionService(OnionAddr::V3(OnionAddrV3 {\n                service_id,\n                virt_port,\n            })) =\u003e (service_id, virt_port),\n            target_address =\u003e {\n                if let Ok(stream) = TcpStream::connect(\n                    self.loopback\n                        .local_addr()\n                        .expect(\"loopback local_addr failed\"),\n                ) {\n                    return Ok(OnionStream {\n                        stream,\n                        local_addr: None,\n                        peer_addr: Some(target_address),\n                    });\n                } else {\n                    return Err(Error::ConnectFailed(target_address).into());\n                }\n            }\n        };\n        let client_auth = self.client_auth_keys.get(\u0026service_id);\n\n        match MOCK_TOR_NETWORK.lock() {\n            Ok(mut mock_tor_network) =\u003e {\n                Ok(mock_tor_network.connect_to_onion(\u0026service_id, virt_port, client_auth)?)\n            }\n            Err(_) =\u003e unreachable!(\"another thread panicked while holding mock tor network's lock\"),\n        }\n    }\n\n    fn listener(\n        \u0026mut self,\n        private_key: \u0026Ed25519PrivateKey,\n        virt_port: u16,\n        authorized_clients: Option\u003c\u0026[X25519PublicKey]\u003e,\n    ) -\u003e Result\u003cOnionListener, tor_provider::Error\u003e {\n        // convert inputs to relevant types\n        let service_id = V3OnionServiceId::from_private_key(private_key);\n        let onion_addr = OnionAddr::V3(OnionAddrV3::new(service_id.clone(), virt_port));\n        let authorized_clients: Vec\u003cX25519PublicKey\u003e = match authorized_clients {\n            Some(keys) =\u003e keys.into(),\n            None =\u003e Default::default(),\n        };\n\n        // try to bind to a local address, let OS pick our port\n        let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n        let listener = TcpListener::bind(socket_addr).map_err(Error::TcpListenerBindFailed)?;\n        let socket_addr = listener\n            .local_addr()\n            .map_err(Error::TcpListenerLocalAddrFailed)?;\n\n        // register the onion service with the mock tor network\n        match MOCK_TOR_NETWORK.lock() {\n            Ok(mut mock_tor_network) =\u003e mock_tor_network.start_onion(\n                service_id.clone(),\n                virt_port,\n                authorized_clients,\n                socket_addr,\n            ),\n            Err(_) =\u003e unreachable!(\"another thread panicked while holding mock tor network's lock\"),\n        }\n\n        // init flag for signaling when listener goes out of scope so we can tear down onion service\n        let is_active = Arc::new(atomic::AtomicBool::new(true));\n        self.onion_services\n            .push((onion_addr.clone(), Arc::clone(\u0026is_active)));\n\n        // onion service published event\n        self.events\n            .push(TorEvent::OnionServicePublished { service_id });\n\n\n        Ok(OnionListener::new(listener, onion_addr, is_active, |is_active| {\n            is_active.store(false, atomic::Ordering::Relaxed);\n        }))\n    }\n\n    fn generate_token(\u0026mut self) -\u003e CircuitToken {\n        0usize\n    }\n\n    fn release_token(\u0026mut self, _token: CircuitToken) {}\n}\n\nimpl Drop for MockTorClient {\n    fn drop(\u0026mut self) {\n        // remove all our onion services\n        match MOCK_TOR_NETWORK.lock() {\n            Ok(mut mock_tor_network) =\u003e {\n                for entry in self.onion_services.iter() {\n                    let onion_addr = \u0026entry.0;\n                    mock_tor_network.stop_onion(onion_addr);\n                }\n            }\n            Err(_) =\u003e unreachable!(\"another thread panicked while holding mock tor network's lock\"),\n        }\n    }\n}\n","traces":[{"line":47,"address":[5708853,5708720],"length":1,"stats":{"Line":1}},{"line":48,"address":[1911747,1911805],"length":1,"stats":{"Line":2}},{"line":57,"address":[3866208],"length":1,"stats":{"Line":0}},{"line":63,"address":[5250880],"length":1,"stats":{"Line":2}},{"line":69,"address":[2531615],"length":1,"stats":{"Line":2}},{"line":71,"address":[3742654],"length":1,"stats":{"Line":2}},{"line":72,"address":[3742738],"length":1,"stats":{"Line":2}},{"line":73,"address":[5251357,5251197,5251134,5251995],"length":1,"stats":{"Line":6}},{"line":74,"address":[3742978,3743136,3742859],"length":1,"stats":{"Line":6}},{"line":76,"address":[2532132],"length":1,"stats":{"Line":1}},{"line":77,"address":[2532192],"length":1,"stats":{"Line":0}},{"line":78,"address":[3866961],"length":1,"stats":{"Line":2}},{"line":79,"address":[2532262],"length":1,"stats":{"Line":2}},{"line":80,"address":[2116090],"length":1,"stats":{"Line":0}},{"line":85,"address":[2532531,2532083,2532342],"length":1,"stats":{"Line":6}},{"line":86,"address":[1458951],"length":1,"stats":{"Line":2}},{"line":88,"address":[2532368],"length":1,"stats":{"Line":2}},{"line":89,"address":[5291466],"length":1,"stats":{"Line":2}},{"line":92,"address":[2532533],"length":1,"stats":{"Line":0}},{"line":95,"address":[5251286],"length":1,"stats":{"Line":0}},{"line":98,"address":[3866420],"length":1,"stats":{"Line":0}},{"line":102,"address":[5252831,5252859,5252032],"length":1,"stats":{"Line":2}},{"line":109,"address":[3743689,3743773],"length":1,"stats":{"Line":4}},{"line":110,"address":[5291926],"length":1,"stats":{"Line":2}},{"line":111,"address":[5252225],"length":1,"stats":{"Line":2}},{"line":112,"address":[2532893,2533496],"length":1,"stats":{"Line":4}},{"line":115,"address":[2532844],"length":1,"stats":{"Line":2}},{"line":116,"address":[3744159,3743984],"length":1,"stats":{"Line":4}},{"line":117,"address":[3744183],"length":1,"stats":{"Line":2}},{"line":122,"address":[3744512],"length":1,"stats":{"Line":2}},{"line":123,"address":[2533576],"length":1,"stats":{"Line":2}},{"line":124,"address":[3868321],"length":1,"stats":{"Line":2}},{"line":146,"address":[3869054,3868352,3869085],"length":1,"stats":{"Line":2}},{"line":147,"address":[2117441],"length":1,"stats":{"Line":2}},{"line":148,"address":[3868399],"length":1,"stats":{"Line":2}},{"line":149,"address":[2117536],"length":1,"stats":{"Line":2}},{"line":151,"address":[1460246],"length":1,"stats":{"Line":2}},{"line":152,"address":[3744878],"length":1,"stats":{"Line":2}},{"line":157,"address":[2117856],"length":1,"stats":{"Line":2}},{"line":158,"address":[3868847],"length":1,"stats":{"Line":2}},{"line":165,"address":[1460816],"length":1,"stats":{"Line":1}},{"line":166,"address":[2118200],"length":1,"stats":{"Line":1}},{"line":171,"address":[2534432,2535111,2535215],"length":1,"stats":{"Line":2}},{"line":172,"address":[1460878],"length":1,"stats":{"Line":2}},{"line":173,"address":[2534488],"length":1,"stats":{"Line":2}},{"line":174,"address":[1460923],"length":1,"stats":{"Line":2}},{"line":175,"address":[2534529,2534607,2534517],"length":1,"stats":{"Line":6}},{"line":177,"address":[5253977,5254163,5254474],"length":1,"stats":{"Line":6}},{"line":178,"address":[5254230],"length":1,"stats":{"Line":0}},{"line":179,"address":[3869662],"length":1,"stats":{"Line":0}},{"line":180,"address":[2535006,2535082],"length":1,"stats":{"Line":0}},{"line":182,"address":[5254258,5254479,5254469],"length":1,"stats":{"Line":4}},{"line":189,"address":[5293808],"length":1,"stats":{"Line":3}},{"line":192,"address":[5295153,5294336],"length":1,"stats":{"Line":2}},{"line":193,"address":[5294366,5295225],"length":1,"stats":{"Line":2}},{"line":194,"address":[1462460,1461720,1462512],"length":1,"stats":{"Line":0}},{"line":196,"address":[2535466],"length":1,"stats":{"Line":3}},{"line":198,"address":[3746244],"length":1,"stats":{"Line":2}},{"line":199,"address":[2119101],"length":1,"stats":{"Line":3}},{"line":201,"address":[3746627],"length":1,"stats":{"Line":3}},{"line":203,"address":[5294654],"length":1,"stats":{"Line":3}},{"line":204,"address":[2535591],"length":1,"stats":{"Line":3}},{"line":206,"address":[5255212],"length":1,"stats":{"Line":2}},{"line":208,"address":[3870487],"length":1,"stats":{"Line":3}},{"line":209,"address":[2535792],"length":1,"stats":{"Line":2}},{"line":211,"address":[5255346],"length":1,"stats":{"Line":2}},{"line":212,"address":[3746994],"length":1,"stats":{"Line":2}},{"line":213,"address":[3746998],"length":1,"stats":{"Line":2}},{"line":217,"address":[2120000],"length":1,"stats":{"Line":2}},{"line":222,"address":[1462640],"length":1,"stats":{"Line":2}},{"line":223,"address":[5295470,5295381],"length":1,"stats":{"Line":2}},{"line":224,"address":[3747307],"length":1,"stats":{"Line":0}},{"line":226,"address":[2536394,2536419],"length":1,"stats":{"Line":4}},{"line":227,"address":[3871122],"length":1,"stats":{"Line":2}},{"line":229,"address":[1462818],"length":1,"stats":{"Line":2}},{"line":232,"address":[5295568],"length":1,"stats":{"Line":1}},{"line":236,"address":[1462871],"length":1,"stats":{"Line":1}},{"line":237,"address":[1462894],"length":1,"stats":{"Line":1}},{"line":240,"address":[1464919,1464127,1462928],"length":1,"stats":{"Line":2}},{"line":245,"address":[3747571,3747758],"length":1,"stats":{"Line":4}},{"line":246,"address":[5295814],"length":1,"stats":{"Line":2}},{"line":250,"address":[2120701],"length":1,"stats":{"Line":0}},{"line":252,"address":[3747932,3748894],"length":1,"stats":{"Line":0}},{"line":256,"address":[1464447],"length":1,"stats":{"Line":0}},{"line":258,"address":[5297146],"length":1,"stats":{"Line":0}},{"line":259,"address":[5257412],"length":1,"stats":{"Line":0}},{"line":262,"address":[2538457,2538223],"length":1,"stats":{"Line":0}},{"line":266,"address":[5295959,5296132],"length":1,"stats":{"Line":4}},{"line":268,"address":[1463416],"length":1,"stats":{"Line":2}},{"line":269,"address":[1463449],"length":1,"stats":{"Line":2}},{"line":270,"address":[3871841,3871929,3872264],"length":1,"stats":{"Line":5}},{"line":276,"address":[5260089,5258016,5259918],"length":1,"stats":{"Line":2}},{"line":283,"address":[5297836],"length":1,"stats":{"Line":2}},{"line":284,"address":[3749743],"length":1,"stats":{"Line":2}},{"line":285,"address":[3873577],"length":1,"stats":{"Line":2}},{"line":286,"address":[5297995],"length":1,"stats":{"Line":2}},{"line":287,"address":[2538883],"length":1,"stats":{"Line":2}},{"line":291,"address":[3873682],"length":1,"stats":{"Line":2}},{"line":292,"address":[2540743,2539131,2539334],"length":1,"stats":{"Line":2}},{"line":293,"address":[3750428,3750635,3750259],"length":1,"stats":{"Line":4}},{"line":295,"address":[3750571],"length":1,"stats":{"Line":0}},{"line":298,"address":[2539704,2539580],"length":1,"stats":{"Line":4}},{"line":299,"address":[3750850,3750675],"length":1,"stats":{"Line":4}},{"line":300,"address":[2123625],"length":1,"stats":{"Line":2}},{"line":302,"address":[5259194],"length":1,"stats":{"Line":2}},{"line":309,"address":[5259411,5259377],"length":1,"stats":{"Line":4}},{"line":310,"address":[5299417,5299240],"length":1,"stats":{"Line":4}},{"line":311,"address":[5259569,5259521],"length":1,"stats":{"Line":4}},{"line":314,"address":[2124211],"length":1,"stats":{"Line":2}},{"line":315,"address":[2540353],"length":1,"stats":{"Line":2}},{"line":318,"address":[1466654],"length":1,"stats":{"Line":4}},{"line":319,"address":[3814318,3814376],"length":1,"stats":{"Line":4}},{"line":323,"address":[5299872],"length":1,"stats":{"Line":0}},{"line":327,"address":[2540810,2540800],"length":1,"stats":{"Line":0}},{"line":331,"address":[1733012,1733083,1732560],"length":1,"stats":{"Line":2}},{"line":333,"address":[1711044],"length":1,"stats":{"Line":2}},{"line":334,"address":[3532339],"length":1,"stats":{"Line":2}},{"line":335,"address":[3532600,3532359,3532440],"length":1,"stats":{"Line":6}},{"line":336,"address":[3532621],"length":1,"stats":{"Line":2}},{"line":337,"address":[1733000,1732901],"length":1,"stats":{"Line":4}}],"covered":100,"coverable":120},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","proxy.rs"],"content":"// internal crates\nuse crate::tor_provider::TargetAddr;\n\n#[derive(thiserror::Error, Debug)]\n/// Error type for the proxy module\npub enum ProxyConfigError {\n    #[error(\"{0}\")]\n    /// An error returned when constructing a proxy configuration with invalid parameters\n    Generic(String),\n}\n\n#[derive(Clone, Debug)]\n/// Configuration for a SOCKS4 proxy\npub struct Socks4ProxyConfig {\n    pub(crate) address: TargetAddr,\n}\n\nimpl Socks4ProxyConfig {\n    /// Construct a new `Socks4ProxyConfig`. The `address` argument must not be a [`crate::tor_provider::TargetAddr::OnionService`] and its port must not be 0.\n    pub fn new(address: TargetAddr) -\u003e Result\u003cSelf, ProxyConfigError\u003e {\n        let port = match \u0026address {\n            TargetAddr::Socket(addr) =\u003e addr.port(),\n            TargetAddr::Domain(addr) =\u003e addr.port(),\n            TargetAddr::OnionService(_) =\u003e {\n                return Err(ProxyConfigError::Generic(\n                    \"proxy address may not be onion service\".to_string(),\n                ))\n            }\n        };\n        if port == 0 {\n            return Err(ProxyConfigError::Generic(\"proxy port not be 0\".to_string()));\n        }\n\n        Ok(Self { address })\n    }\n}\n\n#[derive(Clone, Debug)]\n/// Configuration for a SOCKS5 proxy\npub struct Socks5ProxyConfig {\n    pub(crate) address: TargetAddr,\n    pub(crate) username: Option\u003cString\u003e,\n    pub(crate) password: Option\u003cString\u003e,\n}\n\nimpl Socks5ProxyConfig {\n    /// Construct a new `Socks5ProxyConfig`. The `address` argument must not be a  [`crate::tor_provider::TargetAddr::OnionService`] and its port must not be 0. The `username` and `password` arguments, if present, must each be less than 256 bytes long.\n    pub fn new(\n        address: TargetAddr,\n        username: Option\u003cString\u003e,\n        password: Option\u003cString\u003e,\n    ) -\u003e Result\u003cSelf, ProxyConfigError\u003e {\n        let port = match \u0026address {\n            TargetAddr::Socket(addr) =\u003e addr.port(),\n            TargetAddr::Domain(addr) =\u003e addr.port(),\n            TargetAddr::OnionService(_) =\u003e {\n                return Err(ProxyConfigError::Generic(\n                    \"proxy address may not be onion service\".to_string(),\n                ))\n            }\n        };\n        if port == 0 {\n            return Err(ProxyConfigError::Generic(\"proxy port not be 0\".to_string()));\n        }\n\n        // username must be less than 255 bytes\n        if let Some(username) = \u0026username {\n            if username.len() \u003e 255 {\n                return Err(ProxyConfigError::Generic(\n                    \"socks5 username must be \u003c= 255 bytes\".to_string(),\n                ));\n            }\n        }\n        // password must be less than 255 bytes\n        if let Some(password) = \u0026password {\n            if password.len() \u003e 255 {\n                return Err(ProxyConfigError::Generic(\n                    \"socks5 password must be \u003c= 255 bytes\".to_string(),\n                ));\n            }\n        }\n\n        Ok(Self {\n            address,\n            username,\n            password,\n        })\n    }\n}\n\n#[derive(Clone, Debug)]\n/// Configuration for an HTTP CONNECT proxy (`HTTPSProxy` in c-tor torrc configuration)\npub struct HttpsProxyConfig {\n    pub(crate) address: TargetAddr,\n    pub(crate) username: Option\u003cString\u003e,\n    pub(crate) password: Option\u003cString\u003e,\n}\n\nimpl HttpsProxyConfig {\n    /// Construct a new `HttpsProxyConfig`. The `address` argument must not be a [`crate::tor_provider::TargetAddr::OnionService`] and its port must not be 0. The `username` argument, if present, must not contain the `:` (colon) character.\n    pub fn new(\n        address: TargetAddr,\n        username: Option\u003cString\u003e,\n        password: Option\u003cString\u003e,\n    ) -\u003e Result\u003cSelf, ProxyConfigError\u003e {\n        let port = match \u0026address {\n            TargetAddr::Socket(addr) =\u003e addr.port(),\n            TargetAddr::Domain(addr) =\u003e addr.port(),\n            TargetAddr::OnionService(_) =\u003e {\n                return Err(ProxyConfigError::Generic(\n                    \"proxy address may not be onion service\".to_string(),\n                ))\n            }\n        };\n        if port == 0 {\n            return Err(ProxyConfigError::Generic(\"proxy port not be 0\".to_string()));\n        }\n\n        // username may not contain ':' character (per RFC 2617)\n        if let Some(username) = \u0026username {\n            if username.contains(':') {\n                return Err(ProxyConfigError::Generic(\n                    \"username may not contain ':' character\".to_string(),\n                ));\n            }\n        }\n\n        Ok(Self {\n            address,\n            username,\n            password,\n        })\n    }\n}\n\n#[derive(Clone, Debug)]\n/// An enum representing a possible proxy server configuration with address and possible credentials.\npub enum ProxyConfig {\n    /// A SOCKS4 proxy\n    Socks4(Socks4ProxyConfig),\n    /// A SOCKS5 proxy\n    Socks5(Socks5ProxyConfig),\n    /// An HTTP CONNECT proxy\n    Https(HttpsProxyConfig),\n}\n\nimpl From\u003cSocks4ProxyConfig\u003e for ProxyConfig {\n    fn from(config: Socks4ProxyConfig) -\u003e Self {\n        ProxyConfig::Socks4(config)\n    }\n}\n\nimpl From\u003cSocks5ProxyConfig\u003e for ProxyConfig {\n    fn from(config: Socks5ProxyConfig) -\u003e Self {\n        ProxyConfig::Socks5(config)\n    }\n}\n\nimpl From\u003cHttpsProxyConfig\u003e for ProxyConfig {\n    fn from(config: HttpsProxyConfig) -\u003e Self {\n        ProxyConfig::Https(config)\n    }\n}\n","traces":[{"line":20,"address":[3861056,3861550],"length":1,"stats":{"Line":0}},{"line":21,"address":[3737318],"length":1,"stats":{"Line":0}},{"line":22,"address":[3737485,3737355],"length":1,"stats":{"Line":0}},{"line":23,"address":[2110240,2110420],"length":1,"stats":{"Line":0}},{"line":25,"address":[2925825],"length":1,"stats":{"Line":0}},{"line":26,"address":[3861139],"length":1,"stats":{"Line":0}},{"line":30,"address":[5245874],"length":1,"stats":{"Line":0}},{"line":31,"address":[1500124,1500018],"length":1,"stats":{"Line":0}},{"line":34,"address":[5246011],"length":1,"stats":{"Line":0}},{"line":48,"address":[3737824,3739092],"length":1,"stats":{"Line":0}},{"line":53,"address":[3737856],"length":1,"stats":{"Line":0}},{"line":54,"address":[1500435,1500309],"length":1,"stats":{"Line":0}},{"line":55,"address":[3861903,3861706],"length":1,"stats":{"Line":0}},{"line":57,"address":[2110878],"length":1,"stats":{"Line":0}},{"line":58,"address":[2110749],"length":1,"stats":{"Line":0}},{"line":62,"address":[2926348],"length":1,"stats":{"Line":0}},{"line":63,"address":[2110982,2111054],"length":1,"stats":{"Line":0}},{"line":67,"address":[2926502,2926649],"length":1,"stats":{"Line":0}},{"line":68,"address":[2926657,2926718],"length":1,"stats":{"Line":0}},{"line":69,"address":[2111270],"length":1,"stats":{"Line":0}},{"line":70,"address":[2926726],"length":1,"stats":{"Line":0}},{"line":75,"address":[5246738,5246929],"length":1,"stats":{"Line":0}},{"line":76,"address":[5246937,5247214],"length":1,"stats":{"Line":0}},{"line":77,"address":[3738874],"length":1,"stats":{"Line":0}},{"line":78,"address":[1501254],"length":1,"stats":{"Line":0}},{"line":83,"address":[3738671],"length":1,"stats":{"Line":0}},{"line":84,"address":[2111405],"length":1,"stats":{"Line":0}},{"line":85,"address":[3738601],"length":1,"stats":{"Line":0}},{"line":86,"address":[3862396],"length":1,"stats":{"Line":0}},{"line":101,"address":[2927440,2928526],"length":1,"stats":{"Line":0}},{"line":106,"address":[5247536],"length":1,"stats":{"Line":0}},{"line":107,"address":[2112021,2112151],"length":1,"stats":{"Line":0}},{"line":108,"address":[3739442,3739242],"length":1,"stats":{"Line":0}},{"line":110,"address":[5247726],"length":1,"stats":{"Line":0}},{"line":111,"address":[5247597],"length":1,"stats":{"Line":0}},{"line":115,"address":[5287452],"length":1,"stats":{"Line":0}},{"line":116,"address":[2112353,2112281],"length":1,"stats":{"Line":0}},{"line":120,"address":[2112313,2112460],"length":1,"stats":{"Line":0}},{"line":121,"address":[3739923,3739636],"length":1,"stats":{"Line":0}},{"line":122,"address":[1502400],"length":1,"stats":{"Line":0}},{"line":123,"address":[2112788],"length":1,"stats":{"Line":0}},{"line":128,"address":[3863519],"length":1,"stats":{"Line":0}},{"line":129,"address":[3739661],"length":1,"stats":{"Line":0}},{"line":130,"address":[2112521],"length":1,"stats":{"Line":0}},{"line":131,"address":[1502136],"length":1,"stats":{"Line":0}},{"line":148,"address":[3740240],"length":1,"stats":{"Line":0}},{"line":149,"address":[5248641],"length":1,"stats":{"Line":0}},{"line":154,"address":[1502704],"length":1,"stats":{"Line":0}},{"line":155,"address":[3740321],"length":1,"stats":{"Line":0}},{"line":160,"address":[2113200],"length":1,"stats":{"Line":0}},{"line":161,"address":[2113217],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":51},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","tor_crypto.rs"],"content":"// standard\nuse std::convert::TryInto;\nuse std::str;\n\n// extern crates\nuse curve25519_dalek::Scalar;\nuse data_encoding::{BASE32_NOPAD, BASE64};\nuse data_encoding_macro::new_encoding;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse rand::distributions::Alphanumeric;\nuse rand::rngs::OsRng;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse rand::Rng;\nuse sha3::{Digest, Sha3_256};\nuse static_assertions::const_assert_eq;\nuse tor_llcrypto::pk::keymanip::*;\nuse tor_llcrypto::*;\n\n/// Represents various errors that can occur in the tor_crypto module.\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    /// A error encountered converting a String to a tor_crypto type\n    #[error(\"{0}\")]\n    ParseError(String),\n\n    /// An error encountered converting between tor_crypto types\n    #[error(\"{0}\")]\n    ConversionError(String),\n\n    /// An error encountered converting from a raw byte representation\n    #[error(\"invalid key\")]\n    KeyInvalid,\n}\n\n/// The number of bytes in an ed25519 secret key\n/// cbindgen:ignore\npub const ED25519_PRIVATE_KEY_SIZE: usize = 64;\n/// The number of bytes in an ed25519 public key\n/// cbindgen:ignore\npub const ED25519_PUBLIC_KEY_SIZE: usize = 32;\n/// The number of bytes in an ed25519 signature\n/// cbindgen:ignore\npub const ED25519_SIGNATURE_SIZE: usize = 64;\n/// The number of bytes needed to store onion service id as an ASCII c-string (not including null-terminator)\npub const V3_ONION_SERVICE_ID_STRING_LENGTH: usize = 56;\n/// The number of bytes needed to store onion service id as an ASCII c-string (including null-terminator)\npub const V3_ONION_SERVICE_ID_STRING_SIZE: usize = 57;\nconst_assert_eq!(\n    V3_ONION_SERVICE_ID_STRING_SIZE,\n    V3_ONION_SERVICE_ID_STRING_LENGTH + 1\n);\n/// The number of bytes needed to store base64 encoded ed25519 private key as an ASCII c-string (not including null-terminator)\npub const ED25519_PRIVATE_KEYBLOB_BASE64_LENGTH: usize = 88;\n/// key klob header string\nconst ED25519_PRIVATE_KEY_KEYBLOB_HEADER: \u0026str = \"ED25519-V3:\";\n/// The number of bytes needed to store the keyblob header\npub const ED25519_PRIVATE_KEY_KEYBLOB_HEADER_LENGTH: usize = 11;\nconst_assert_eq!(\n    ED25519_PRIVATE_KEY_KEYBLOB_HEADER_LENGTH,\n    ED25519_PRIVATE_KEY_KEYBLOB_HEADER.len()\n);\n/// The number of bytes needed to store ed25519 private keyblob as an ASCII c-string (not including a null terminator)\npub const ED25519_PRIVATE_KEY_KEYBLOB_LENGTH: usize = 99;\nconst_assert_eq!(\n    ED25519_PRIVATE_KEY_KEYBLOB_LENGTH,\n    ED25519_PRIVATE_KEY_KEYBLOB_HEADER_LENGTH + ED25519_PRIVATE_KEYBLOB_BASE64_LENGTH\n);\n/// The number of bytes needed to store ed25519 private keyblob as an ASCII c-string (including a null terminator)\npub const ED25519_PRIVATE_KEY_KEYBLOB_SIZE: usize = 100;\nconst_assert_eq!(\n    ED25519_PRIVATE_KEY_KEYBLOB_SIZE,\n    ED25519_PRIVATE_KEY_KEYBLOB_LENGTH + 1\n);\n// number of bytes in an onion service id after base32 decode\nconst V3_ONION_SERVICE_ID_RAW_SIZE: usize = 35;\n// byte index of the start of the public key checksum\nconst V3_ONION_SERVICE_ID_CHECKSUM_OFFSET: usize = 32;\n// byte index of the v3 onion service version\nconst V3_ONION_SERVICE_ID_VERSION_OFFSET: usize = 34;\n/// The number of bytes in a v3 service id's truncated checksum\nconst TRUNCATED_CHECKSUM_SIZE: usize = 2;\n/// The number of bytes in an x25519 private key\n/// cbindgen:ignore\npub const X25519_PRIVATE_KEY_SIZE: usize = 32;\n/// The number of bytes in an x25519 publickey\n/// cbindgen:ignore\npub const X25519_PUBLIC_KEY_SIZE: usize = 32;\n/// The number of bytes needed to store base64 encoded x25519 private key as an ASCII c-string (not including null-terminator)\npub const X25519_PRIVATE_KEY_BASE64_LENGTH: usize = 44;\n/// The number of bytes needed to store base64 encoded x25519 private key as an ASCII c-string (including a null terminator)\npub const X25519_PRIVATE_KEY_BASE64_SIZE: usize = 45;\nconst_assert_eq!(\n    X25519_PRIVATE_KEY_BASE64_SIZE,\n    X25519_PRIVATE_KEY_BASE64_LENGTH + 1\n);\n/// The number of bytes needed to store base32 encoded x25519 public key as an ASCII c-string (not including null-terminator)\npub const X25519_PUBLIC_KEY_BASE32_LENGTH: usize = 52;\n/// The number of bytes needed to store base32 encoded x25519 public key as an ASCII c-string (including a null terminator)\npub const X25519_PUBLIC_KEY_BASE32_SIZE: usize = 53;\nconst_assert_eq!(\n    X25519_PUBLIC_KEY_BASE32_SIZE,\n    X25519_PUBLIC_KEY_BASE32_LENGTH + 1\n);\n\nconst ONION_BASE32: data_encoding::Encoding = new_encoding! {\n    symbols: \"abcdefghijklmnopqrstuvwxyz234567\",\n    padding: '=',\n};\n\n// Free functions\n\n// securely generate password using OsRng\n#[cfg(feature = \"legacy-tor-provider\")]\npub(crate) fn generate_password(length: usize) -\u003e String {\n    let password: String = std::iter::repeat(())\n        .map(|()| OsRng.sample(Alphanumeric))\n        .map(char::from)\n        .take(length)\n        .collect();\n\n    password\n}\n\n// Struct deinitions\n\n/// An ed25519 private key.\n///\n/// This key type is used with [`crate::tor_provider::TorProvider`] trait for hosting onion-services and can be convertd to an [`Ed25519PublicKey`]. It can also be used to sign messages and create an [`Ed25519Signature`].\npub struct Ed25519PrivateKey {\n    expanded_keypair: pk::ed25519::ExpandedKeypair,\n}\n\n/// An ed25519 public key.\n///\n/// This key type is derived from [`Ed25519PrivateKey`] and can be converted to a [`V3OnionServiceId`]. It can also be used to verify a [`Ed25519Signature`].\n#[derive(Clone)]\npub struct Ed25519PublicKey {\n    public_key: pk::ed25519::PublicKey,\n}\n\n/// An ed25519 cryptographic signature\n#[derive(Clone)]\npub struct Ed25519Signature {\n    signature: pk::ed25519::Signature,\n}\n\n/// An x25519 private key\n#[derive(Clone)]\npub struct X25519PrivateKey {\n    secret_key: pk::curve25519::StaticSecret,\n}\n\n/// An x25519 public key\n#[derive(Clone, PartialEq, Eq, Hash)]\npub struct X25519PublicKey {\n    public_key: pk::curve25519::PublicKey,\n}\n\n/// A v3 onion-service id\n#[derive(Clone, PartialEq, Eq, Hash, PartialOrd, Ord)]\npub struct V3OnionServiceId {\n    data: [u8; V3_ONION_SERVICE_ID_STRING_LENGTH],\n}\n\n/// An enum representing a single bit\n#[derive(Clone, Copy)]\npub enum SignBit {\n    Zero,\n    One,\n}\n\nimpl From\u003cSignBit\u003e for u8 {\n    fn from(signbit: SignBit) -\u003e Self {\n        match signbit {\n            SignBit::Zero =\u003e 0u8,\n            SignBit::One =\u003e 1u8,\n        }\n    }\n}\n\nimpl From\u003cSignBit\u003e for bool {\n    fn from(signbit: SignBit) -\u003e Self {\n        match signbit {\n            SignBit::Zero =\u003e false,\n            SignBit::One =\u003e true,\n        }\n    }\n}\n\nimpl From\u003cbool\u003e for SignBit {\n    fn from(signbit: bool) -\u003e Self {\n        if signbit {\n            SignBit::One\n        } else {\n            SignBit::Zero\n        }\n    }\n}\n\n// which validation method to use when constructing an ed25519 expanded key from\n// a byte array\nenum FromRawValidationMethod {\n    // expanded ed25519 keys coming from legacy c-tor daemon; the scalar portion\n    // is clamped, but not reduced\n    #[cfg(feature = \"legacy-tor-provider\")]\n    LegacyCTor,\n    // expanded ed25519 keys coming from ed25519-dalek crate; the scalar portion\n    // has been clamped AND reduced\n    Ed25519Dalek,\n}\n\n/// A wrapper around `tor_llcrypto::pk::ed25519::ExpandedKeypair`.\nimpl Ed25519PrivateKey {\n    /// Securely generate a new `Ed25519PrivateKey`.\n    pub fn generate() -\u003e Ed25519PrivateKey {\n        let csprng = \u0026mut OsRng;\n        let keypair = pk::ed25519::Keypair::generate(csprng);\n\n        Ed25519PrivateKey {\n            expanded_keypair: pk::ed25519::ExpandedKeypair::from(\u0026keypair),\n        }\n    }\n\n    fn from_raw_impl(\n        raw: \u0026[u8; ED25519_PRIVATE_KEY_SIZE],\n        method: FromRawValidationMethod,\n    ) -\u003e Result\u003cEd25519PrivateKey, Error\u003e {\n        // see: https://gitlab.torproject.org/tpo/core/arti/-/issues/1343\n        match method {\n            #[cfg(feature = \"legacy-tor-provider\")]\n            FromRawValidationMethod::LegacyCTor =\u003e {\n                // Verify the scalar portion of the expanded key has been clamped\n                // see: https://gitlab.torproject.org/tpo/core/arti/-/issues/1021\n                if !(raw[0] == raw[0] \u0026 248 \u0026\u0026 raw[31] == (raw[31] \u0026 63) | 64) {\n                    return Err(Error::KeyInvalid);\n                }\n            }\n            FromRawValidationMethod::Ed25519Dalek =\u003e {\n                // Verify the scalar is non-zero and it has been reduced\n                let scalar: [u8; 32] = raw[..32].try_into().unwrap();\n                if scalar.iter().all(|\u0026x| x == 0x00u8) {\n                    return Err(Error::KeyInvalid);\n                }\n                let reduced_scalar = Scalar::from_bytes_mod_order(scalar).to_bytes();\n                if scalar != reduced_scalar {\n                    return Err(Error::KeyInvalid);\n                }\n            }\n        }\n\n        if let Some(expanded_keypair) = pk::ed25519::ExpandedKeypair::from_secret_key_bytes(*raw) {\n            Ok(Ed25519PrivateKey { expanded_keypair })\n        } else {\n            Err(Error::KeyInvalid)\n        }\n    }\n\n    /// Attempt to create an `Ed25519PrivateKey` from an array of bytes. Not all byte buffers of the required size can create a valid `Ed25519PrivateKey`. Only buffers derived from [`Ed25519PrivateKey::to_bytes()`] are required to convert correctly.\n    ///\n    /// To securely generate a valid `Ed25519PrivateKey`, use [`Ed25519PrivateKey::generate()`].\n    pub fn from_raw(raw: \u0026[u8; ED25519_PRIVATE_KEY_SIZE]) -\u003e Result\u003cEd25519PrivateKey, Error\u003e {\n        Self::from_raw_impl(raw, FromRawValidationMethod::Ed25519Dalek)\n    }\n\n    fn from_key_blob_impl(\n        key_blob: \u0026str,\n        method: FromRawValidationMethod,\n    ) -\u003e Result\u003cEd25519PrivateKey, Error\u003e {\n        if key_blob.len() != ED25519_PRIVATE_KEY_KEYBLOB_LENGTH {\n            return Err(Error::ParseError(format!(\n                \"expects string of length '{}'; received string with length '{}'\",\n                ED25519_PRIVATE_KEY_KEYBLOB_LENGTH,\n                key_blob.len()\n            )));\n        }\n\n        if !key_blob.starts_with(ED25519_PRIVATE_KEY_KEYBLOB_HEADER) {\n            return Err(Error::ParseError(format!(\n                \"expects string that begins with '{}'; received '{}'\",\n                \u0026ED25519_PRIVATE_KEY_KEYBLOB_HEADER, \u0026key_blob\n            )));\n        }\n\n        let base64_key: \u0026str = \u0026key_blob[ED25519_PRIVATE_KEY_KEYBLOB_HEADER.len()..];\n        let private_key_data = match BASE64.decode(base64_key.as_bytes()) {\n            Ok(private_key_data) =\u003e private_key_data,\n            Err(_) =\u003e {\n                return Err(Error::ParseError(format!(\n                    \"could not parse '{}' as base64\",\n                    base64_key\n                )))\n            }\n        };\n        let private_key_data_len = private_key_data.len();\n        let private_key_data_raw: [u8; ED25519_PRIVATE_KEY_SIZE] = match private_key_data.try_into()\n        {\n            Ok(private_key_data) =\u003e private_key_data,\n            Err(_) =\u003e {\n                return Err(Error::ParseError(format!(\n                    \"expects decoded private key length '{}'; actual '{}'\",\n                    ED25519_PRIVATE_KEY_SIZE, private_key_data_len\n                )))\n            }\n        };\n\n        Ed25519PrivateKey::from_raw_impl(\u0026private_key_data_raw, method)\n    }\n\n    #[cfg(feature = \"legacy-tor-provider\")]\n    pub(crate) fn from_key_blob_legacy(key_blob: \u0026str) -\u003e Result\u003cEd25519PrivateKey, Error\u003e {\n        Self::from_key_blob_impl(key_blob, FromRawValidationMethod::LegacyCTor)\n    }\n\n    /// Create an `Ed25519PrivateKey` from a [`String`] in the legacy c-tor daemon key blob format used in the `ADD_ONION` control-port command. From the c-tor control [specification](https://spec.torproject.org/control-spec/commands.html#add_onion):\n    /// \u003e For a \"ED25519-V3\" key is the Base64 encoding of the concatenation of the 32-byte ed25519 secret scalar in little-endian and the 32-byte ed25519 PRF secret.\n    ///\n    /// Only key blob strings derived from [`Ed25519PrivateKey::to_key_blob()`] are required to convert correctly.\n    pub fn from_key_blob(key_blob: \u0026str) -\u003e Result\u003cEd25519PrivateKey, Error\u003e {\n        Self::from_key_blob_impl(key_blob, FromRawValidationMethod::Ed25519Dalek)\n    }\n\n    /// Construct an `Ed25519PrivateKEy` from an [`X25519PrivateKey`].\n    pub fn from_private_x25519(\n        x25519_private: \u0026X25519PrivateKey,\n    ) -\u003e Result\u003c(Ed25519PrivateKey, SignBit), Error\u003e {\n        if let Some((result, signbit)) =\n            convert_curve25519_to_ed25519_private(\u0026x25519_private.secret_key)\n        {\n            Ok((\n                Ed25519PrivateKey {\n                    expanded_keypair: result,\n                },\n                match signbit {\n                    0u8 =\u003e SignBit::Zero,\n                    1u8 =\u003e SignBit::One,\n                    invalid_signbit =\u003e {\n                        return Err(Error::ConversionError(format!(\n                            \"convert_curve25519_to_ed25519_private() returned invalid signbit: {}\",\n                            invalid_signbit\n                        )))\n                    }\n                },\n            ))\n        } else {\n            Err(Error::ConversionError(\n                \"could not convert x25519 private key to ed25519 private key\".to_string(),\n            ))\n        }\n    }\n\n    /// Write `Ed25519PrivateKey` to a c-tor key blob formatted [`String`].\n    pub fn to_key_blob(\u0026self) -\u003e String {\n        let mut key_blob = ED25519_PRIVATE_KEY_KEYBLOB_HEADER.to_string();\n        key_blob.push_str(\u0026BASE64.encode(\u0026self.expanded_keypair.to_secret_key_bytes()));\n\n        key_blob\n    }\n\n    /// Sign the provided message and return an [`Ed25519Signature`].\n    /// ## ⚠ Warning ⚠\n    ///Only ever sign messages the private key owner controls the contents of!\n    pub fn sign_message(\u0026self, message: \u0026[u8]) -\u003e Ed25519Signature {\n        let signature = self.expanded_keypair.sign(message);\n        Ed25519Signature { signature }\n    }\n\n    /// Convert this private key to an array of bytes.\n    pub fn to_bytes(\u0026self) -\u003e [u8; ED25519_PRIVATE_KEY_SIZE] {\n        self.expanded_keypair.to_secret_key_bytes()\n    }\n\n    #[cfg(feature = \"arti-client-tor-provider\")]\n    pub(crate) fn inner(\u0026self) -\u003e \u0026pk::ed25519::ExpandedKeypair {\n        \u0026self.expanded_keypair\n    }\n}\n\nimpl PartialEq for Ed25519PrivateKey {\n    fn eq(\u0026self, other: \u0026Self) -\u003e bool {\n        self.to_bytes().eq(\u0026other.to_bytes())\n    }\n}\n\nimpl Clone for Ed25519PrivateKey {\n    fn clone(\u0026self) -\u003e Ed25519PrivateKey {\n        match Ed25519PrivateKey::from_raw(\u0026self.to_bytes()) {\n            Ok(ed25519_private_key) =\u003e ed25519_private_key,\n            Err(_) =\u003e unreachable!(),\n        }\n    }\n}\n\nimpl std::fmt::Debug for Ed25519PrivateKey {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        write!(f, \"--- ed25519 private key ---\")\n    }\n}\n\n/// A wrapper around `tor_llcrypto::pk::ed25519::PublicKey`\nimpl Ed25519PublicKey {\n    /// Construct an `Ed25519PublicKey` from an array of bytes. Not all byte buffers of the required size can create a valid `Ed25519PublicKey`. Only buffers derived from [`Ed25519PublicKey::as_bytes()`] are required to convert correctly.\n    pub fn from_raw(raw: \u0026[u8; ED25519_PUBLIC_KEY_SIZE]) -\u003e Result\u003cEd25519PublicKey, Error\u003e {\n        Ok(Ed25519PublicKey {\n            public_key: match pk::ed25519::PublicKey::from_bytes(raw) {\n                Ok(public_key) =\u003e public_key,\n                Err(_) =\u003e return Err(Error::KeyInvalid),\n            },\n        })\n    }\n\n    /// Construct an `Ed25519PublicKey` from a [`V3OnionServiceId`].\n    pub fn from_service_id(service_id: \u0026V3OnionServiceId) -\u003e Result\u003cEd25519PublicKey, Error\u003e {\n        // decode base32 encoded service id\n        let mut decoded_service_id = [0u8; V3_ONION_SERVICE_ID_RAW_SIZE];\n        let decoded_byte_count =\n            match ONION_BASE32.decode_mut(service_id.as_bytes(), \u0026mut decoded_service_id) {\n                Ok(decoded_byte_count) =\u003e decoded_byte_count,\n                Err(_) =\u003e {\n                    return Err(Error::ConversionError(format!(\n                        \"failed to decode '{}' as V3OnionServiceId\",\n                        service_id\n                    )))\n                }\n            };\n        if decoded_byte_count != V3_ONION_SERVICE_ID_RAW_SIZE {\n            return Err(Error::ConversionError(format!(\n                \"decoded byte count is '{}', expected '{}'\",\n                decoded_byte_count, V3_ONION_SERVICE_ID_RAW_SIZE\n            )));\n        }\n\n        Ed25519PublicKey::from_raw(\n            decoded_service_id[0..ED25519_PUBLIC_KEY_SIZE]\n                .try_into()\n                .unwrap(),\n        )\n    }\n\n    /// Construct an `Ed25519PublicKey` from an [`Ed25519PrivateKey`].\n    pub fn from_private_key(private_key: \u0026Ed25519PrivateKey) -\u003e Ed25519PublicKey {\n        Ed25519PublicKey {\n            public_key: *private_key.expanded_keypair.public(),\n        }\n    }\n\n    fn from_public_x25519(\n        public_x25519: \u0026X25519PublicKey,\n        signbit: SignBit,\n    ) -\u003e Result\u003cEd25519PublicKey, Error\u003e {\n        match convert_curve25519_to_ed25519_public(\u0026public_x25519.public_key, signbit.into()) {\n            Some(public_key) =\u003e Ok(Ed25519PublicKey { public_key }),\n            None =\u003e Err(Error::ConversionError(\n                \"failed to create ed25519 public key from x25519 public key and signbit\"\n                    .to_string(),\n            )),\n        }\n    }\n\n    /// View this public key as an array of bytes\n    pub fn as_bytes(\u0026self) -\u003e \u0026[u8; ED25519_PUBLIC_KEY_SIZE] {\n        self.public_key.as_bytes()\n    }\n}\n\nimpl PartialEq for Ed25519PublicKey {\n    fn eq(\u0026self, other: \u0026Self) -\u003e bool {\n        self.public_key.eq(\u0026other.public_key)\n    }\n}\n\nimpl std::fmt::Debug for Ed25519PublicKey {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        self.public_key.fmt(f)\n    }\n}\n\n\n/// A wrapper around `tor_llcrypto::pk::ed25519::Signature`\nimpl Ed25519Signature {\n    /// Construct an `Ed25519Signature` from an array of bytes.\n    pub fn from_raw(raw: \u0026[u8; ED25519_SIGNATURE_SIZE]) -\u003e Result\u003cEd25519Signature, Error\u003e {\n        // todo: message cannot fail so should not return a Result\u003c\u003e\n        Ok(Ed25519Signature {\n            signature: pk::ed25519::Signature::from_bytes(raw),\n        })\n    }\n\n    /// Verify this `Ed25519Signature` for the given message and [`Ed25519PublicKey`].\n    pub fn verify(\u0026self, message: \u0026[u8], public_key: \u0026Ed25519PublicKey) -\u003e bool {\n        if let Ok(()) = public_key\n            .public_key\n            .verify_strict(message, \u0026self.signature)\n        {\n            return true;\n        }\n        false\n    }\n\n    /// Verify this `Ed25519Signature` for the given message, [`X25519PublicKey`], and [`SignBit`]. This signature must have been created by first converting an [`X25519PrivateKey`] to a [`Ed25519PrivateKey`] and [`SignBit`], and then signing the message using this [`Ed25519PrivateKey`]. This method verifies the signature using the [`Ed25519PublicKey`] derived from the provided  [`X25519PublicKey`] and [`SignBit`].\n    pub fn verify_x25519(\n        \u0026self,\n        message: \u0026[u8],\n        public_key: \u0026X25519PublicKey,\n        signbit: SignBit,\n    ) -\u003e bool {\n        if let Ok(public_key) = Ed25519PublicKey::from_public_x25519(public_key, signbit) {\n            return self.verify(message, \u0026public_key);\n        }\n        false\n    }\n\n    /// Convert this signature to an array of bytes\n    pub fn to_bytes(\u0026self) -\u003e [u8; ED25519_SIGNATURE_SIZE] {\n        self.signature.to_bytes()\n    }\n}\n\nimpl PartialEq for Ed25519Signature {\n    fn eq(\u0026self, other: \u0026Self) -\u003e bool {\n        self.signature.eq(\u0026other.signature)\n    }\n}\n\nimpl std::fmt::Debug for Ed25519Signature {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        self.signature.fmt(f)\n    }\n}\n\n/// A wrapper around `tor_llcrypto::pk::curve25519::StaticSecret`\nimpl X25519PrivateKey {\n    /// Securely generate a new `X25519PrivateKey`\n    pub fn generate() -\u003e X25519PrivateKey {\n        let csprng = \u0026mut OsRng;\n        X25519PrivateKey {\n            secret_key: pk::curve25519::StaticSecret::random_from_rng(csprng),\n        }\n    }\n\n    /// Attempt to create an `X25519PrivateKey` from an array of bytes. Not all byte buffers of the required size can create a valid `X25519PrivateKey`. Only buffers derived from [`X25519PrivateKey::to_bytes()`] are required to convert correctly.\n    ///\n    /// To securely generate a valid `X25519PrivateKey`, use [`X25519PrivateKey::generate()`].\n    pub fn from_raw(raw: \u0026[u8; X25519_PRIVATE_KEY_SIZE]) -\u003e Result\u003cX25519PrivateKey, Error\u003e {\n        // see: https://docs.rs/x25519-dalek/2.0.0-pre.1/src/x25519_dalek/x25519.rs.html#197\n        if raw[0] == raw[0] \u0026 240 \u0026\u0026 raw[31] == (raw[31] \u0026 127) | 64 {\n            Ok(X25519PrivateKey {\n                secret_key: pk::curve25519::StaticSecret::from(*raw),\n            })\n        } else {\n            Err(Error::KeyInvalid)\n        }\n    }\n\n    /// Create an `X25519PrivateKey` from a [`String`] in the legacy c-tor daemon key blob format used in the `ONION_CLIENT_AUTH_ADD` control-port command. From the c-tor control [specification](https://spec.torproject.org/control-spec/commands.html#onion_client_auth_add):\n    /// \u003e ```text\n    /// \u003e PrivateKeyBlob = base64 encoding of x25519 key\n    /// \u003e ```\n    ///\n    /// Only key blob strings derived from [`X25519PrivateKey::to_base64()`] are required to convert correctly.\n    pub fn from_base64(base64: \u0026str) -\u003e Result\u003cX25519PrivateKey, Error\u003e {\n        // todo: see if this should be from/to key blob like with ed25519 rather than base64\n        if base64.len() != X25519_PRIVATE_KEY_BASE64_LENGTH {\n            return Err(Error::ParseError(format!(\n                \"expects string of length '{}'; received string with length '{}'\",\n                X25519_PRIVATE_KEY_BASE64_LENGTH,\n                base64.len()\n            )));\n        }\n\n        let private_key_data = match BASE64.decode(base64.as_bytes()) {\n            Ok(private_key_data) =\u003e private_key_data,\n            Err(_) =\u003e {\n                return Err(Error::ParseError(format!(\n                    \"could not parse '{}' as base64\",\n                    base64\n                )))\n            }\n        };\n        let private_key_data_len = private_key_data.len();\n        let private_key_data_raw: [u8; X25519_PRIVATE_KEY_SIZE] = match private_key_data.try_into()\n        {\n            Ok(private_key_data) =\u003e private_key_data,\n            Err(_) =\u003e {\n                return Err(Error::ParseError(format!(\n                    \"expects decoded private key length '{}'; actual '{}'\",\n                    X25519_PRIVATE_KEY_SIZE, private_key_data_len\n                )))\n            }\n        };\n\n        X25519PrivateKey::from_raw(\u0026private_key_data_raw)\n    }\n\n    /// Sign the provided message and return an [`Ed25519Signature`] and [`SignBit`].\n    ///\n    /// This method first converts this `X25519PrivateKey` to an [`Ed25519PrivateKey`] and [`SignBit`]. Then, the message is signed using the derived [`Ed25519PrivateKey`]. To verify the signature, both the [`X25519PublicKey`] and this calculated [`SignBit`] are required.\n    ///\n    /// ## ⚠ Warning ⚠\n    ///Only ever sign messages the private key owner controls the contents of!\n    pub fn sign_message(\u0026self, message: \u0026[u8]) -\u003e Result\u003c(Ed25519Signature, SignBit), Error\u003e {\n        let (ed25519_private, signbit) = Ed25519PrivateKey::from_private_x25519(self)?;\n        Ok((ed25519_private.sign_message(message), signbit))\n    }\n\n    /// Write `X25519PrivateKey` to a base64 encocded [`String`].\n    pub fn to_base64(\u0026self) -\u003e String {\n        BASE64.encode(\u0026self.secret_key.to_bytes())\n    }\n\n    /// Convert this private key to an array of bytes.\n    pub fn to_bytes(\u0026self) -\u003e [u8; X25519_PRIVATE_KEY_SIZE] {\n        self.secret_key.to_bytes()\n    }\n}\n\nimpl PartialEq for X25519PrivateKey {\n    fn eq(\u0026self, other: \u0026Self) -\u003e bool {\n        self.secret_key.to_bytes() == other.secret_key.to_bytes()\n    }\n}\n\nimpl std::fmt::Debug for X25519PrivateKey {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        write!(f, \"--- x25519 private key ---\")\n    }\n}\n\n/// A wrapper around `tor_llcrypto::pk::curve25519::PublicKey`\nimpl X25519PublicKey {\n    /// Construct an `X25519PublicKey` from an [`X25519PrivateKey`].\n    pub fn from_private_key(private_key: \u0026X25519PrivateKey) -\u003e X25519PublicKey {\n        X25519PublicKey {\n            public_key: pk::curve25519::PublicKey::from(\u0026private_key.secret_key),\n        }\n    }\n\n    /// Construct an `X25519PublicKey` from an array of bytes.\n    pub fn from_raw(raw: \u0026[u8; X25519_PUBLIC_KEY_SIZE]) -\u003e X25519PublicKey {\n        X25519PublicKey {\n            public_key: pk::curve25519::PublicKey::from(*raw),\n        }\n    }\n\n    /// Create an `X25519PublicKey` from a [`String`] in the legacy c-tor daemon key base32 format used in the `ADD_ONION` control-port command. From the c-tor control [specification](https://spec.torproject.org/control-spec/commands.html#add_onion):\n    /// \u003e ```text\n    /// \u003e V3Key = The client's base32-encoded x25519 public key, using only the key\n    /// \u003e         part of rend-spec-v3.txt section G.1.2 (v3 only).\n    /// \u003e ```\n    ///\n    /// Only key base32 strings derived from [`X25519PublicKey::to_base32()`] are required to convert correctly.\n    pub fn from_base32(base32: \u0026str) -\u003e Result\u003cX25519PublicKey, Error\u003e {\n        if base32.len() != X25519_PUBLIC_KEY_BASE32_LENGTH {\n            return Err(Error::ParseError(format!(\n                \"expects string of length '{}'; received '{}' with length '{}'\",\n                X25519_PUBLIC_KEY_BASE32_LENGTH,\n                base32,\n                base32.len()\n            )));\n        }\n\n        let public_key_data = match BASE32_NOPAD.decode(base32.as_bytes()) {\n            Ok(public_key_data) =\u003e public_key_data,\n            Err(_) =\u003e {\n                return Err(Error::ParseError(format!(\n                    \"failed to decode '{}' as X25519PublicKey\",\n                    base32\n                )))\n            }\n        };\n        let public_key_data_len = public_key_data.len();\n        let public_key_data_raw: [u8; X25519_PUBLIC_KEY_SIZE] = match public_key_data.try_into() {\n            Ok(public_key_data) =\u003e public_key_data,\n            Err(_) =\u003e {\n                return Err(Error::ParseError(format!(\n                    \"expects decoded public key length '{}'; actual '{}'\",\n                    X25519_PUBLIC_KEY_SIZE, public_key_data_len\n                )))\n            }\n        };\n\n        Ok(X25519PublicKey::from_raw(\u0026public_key_data_raw))\n    }\n\n    /// Write `X25519PublicKey` to a base32 encocded [`String`].\n    pub fn to_base32(\u0026self) -\u003e String {\n        BASE32_NOPAD.encode(self.public_key.as_bytes())\n    }\n\n    /// View this public key as an array of bytes\n    pub fn as_bytes(\u0026self) -\u003e \u0026[u8; X25519_PUBLIC_KEY_SIZE] {\n        self.public_key.as_bytes()\n    }\n}\n\nimpl std::fmt::Debug for X25519PublicKey {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        write!(f, \"{}\", self.to_base32())\n    }\n}\n\n/// Strongly-typed representation of a v3 onion-service id\nimpl V3OnionServiceId {\n    // see https://github.com/torproject/torspec/blob/main/rend-spec-v3.txt#L2143\n    fn calc_truncated_checksum(\n        public_key: \u0026[u8; ED25519_PUBLIC_KEY_SIZE],\n    ) -\u003e [u8; TRUNCATED_CHECKSUM_SIZE] {\n        let mut hasher = Sha3_256::new();\n\n        // calculate checksum\n        hasher.update(b\".onion checksum\");\n        hasher.update(public_key);\n        hasher.update([0x03u8]);\n        let hash_bytes = hasher.finalize();\n\n        [hash_bytes[0], hash_bytes[1]]\n    }\n\n    /// Create a `V3OnionServiceId` from a [`String`] in the version 3 onion service digest format. From the tor address [specification](https://spec.torproject.org/address-spec.html#onion):\n    /// \u003e ```text\n    /// \u003e onion_address = base32(PUBKEY | CHECKSUM | VERSION)\n    /// \u003e CHECKSUM = H(\".onion checksum\" | PUBKEY | VERSION)[:2]\n    /// \u003e\n    /// \u003e where:\n    /// \u003e - PUBKEY is the 32 bytes ed25519 master pubkey of the onion service.\n    /// \u003e - VERSION is a one byte version field (default value '\\x03')\n    /// \u003e - \".onion checksum\" is a constant string\n    /// \u003e - H is SHA3-256\n    /// \u003e - CHECKSUM is truncated to two bytes before inserting it in onion_address\n    /// \u003e ```\n    pub fn from_string(service_id: \u0026str) -\u003e Result\u003cV3OnionServiceId, Error\u003e {\n        if !V3OnionServiceId::is_valid(service_id) {\n            return Err(Error::ParseError(format!(\n                \"'{}' is not a valid v3 onion service id\",\n                service_id\n            )));\n        }\n        Ok(V3OnionServiceId {\n            data: service_id.as_bytes().try_into().unwrap(),\n        })\n    }\n\n    /// Create a `V3OnionServiceId` from an [`Ed25519PublicKey`].\n    pub fn from_public_key(public_key: \u0026Ed25519PublicKey) -\u003e V3OnionServiceId {\n        let mut raw_service_id = [0u8; V3_ONION_SERVICE_ID_RAW_SIZE];\n\n        raw_service_id[..ED25519_PUBLIC_KEY_SIZE].copy_from_slice(\u0026public_key.as_bytes()[..]);\n        let truncated_checksum = Self::calc_truncated_checksum(public_key.as_bytes());\n        raw_service_id[V3_ONION_SERVICE_ID_CHECKSUM_OFFSET] = truncated_checksum[0];\n        raw_service_id[V3_ONION_SERVICE_ID_CHECKSUM_OFFSET + 1] = truncated_checksum[1];\n        raw_service_id[V3_ONION_SERVICE_ID_VERSION_OFFSET] = 0x03u8;\n\n        let mut service_id = [0u8; V3_ONION_SERVICE_ID_STRING_LENGTH];\n        // panics on wrong buffer size, but given our constant buffer sizes should be fine\n        ONION_BASE32.encode_mut(\u0026raw_service_id, \u0026mut service_id);\n\n        V3OnionServiceId { data: service_id }\n    }\n\n    /// Create a `V3OnionServiceId` from an [`Ed25519PrivateKey`].\n    pub fn from_private_key(private_key: \u0026Ed25519PrivateKey) -\u003e V3OnionServiceId {\n        Self::from_public_key(\u0026Ed25519PublicKey::from_private_key(private_key))\n    }\n\n    /// Determine if the provided string is a valid representation of a `V3OnionServiceId`\n    pub fn is_valid(service_id: \u0026str) -\u003e bool {\n        if service_id.len() != V3_ONION_SERVICE_ID_STRING_LENGTH {\n            return false;\n        }\n\n        let mut decoded_service_id = [0u8; V3_ONION_SERVICE_ID_RAW_SIZE];\n        match ONION_BASE32.decode_mut(service_id.as_bytes(), \u0026mut decoded_service_id) {\n            Ok(decoded_byte_count) =\u003e {\n                // ensure right size\n                if decoded_byte_count != V3_ONION_SERVICE_ID_RAW_SIZE {\n                    return false;\n                }\n                // ensure correct version\n                if decoded_service_id[V3_ONION_SERVICE_ID_VERSION_OFFSET] != 0x03 {\n                    return false;\n                }\n                // copy public key into own buffer\n                let mut public_key = [0u8; ED25519_PUBLIC_KEY_SIZE];\n                public_key[..].copy_from_slice(\u0026decoded_service_id[..ED25519_PUBLIC_KEY_SIZE]);\n                // ensure checksum is correct\n                let truncated_checksum = Self::calc_truncated_checksum(\u0026public_key);\n                if truncated_checksum[0] != decoded_service_id[V3_ONION_SERVICE_ID_CHECKSUM_OFFSET]\n                    || truncated_checksum[1]\n                        != decoded_service_id[V3_ONION_SERVICE_ID_CHECKSUM_OFFSET + 1]\n                {\n                    return false;\n                }\n                true\n            }\n            Err(_) =\u003e false,\n        }\n    }\n\n    /// View this service id as an array of bytes\n    pub fn as_bytes(\u0026self) -\u003e \u0026[u8; V3_ONION_SERVICE_ID_STRING_LENGTH] {\n        \u0026self.data\n    }\n}\n\nimpl std::fmt::Display for V3OnionServiceId {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        unsafe { write!(f, \"{}\", str::from_utf8_unchecked(\u0026self.data)) }\n    }\n}\n\nimpl std::fmt::Debug for V3OnionServiceId {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        unsafe { write!(f, \"{}\", str::from_utf8_unchecked(\u0026self.data)) }\n    }\n}\n","traces":[{"line":114,"address":[5604848],"length":1,"stats":{"Line":3}},{"line":115,"address":[1810200],"length":1,"stats":{"Line":3}},{"line":116,"address":[3530201,3530192],"length":1,"stats":{"Line":6}},{"line":173,"address":[5604928],"length":1,"stats":{"Line":3}},{"line":174,"address":[2665305],"length":1,"stats":{"Line":3}},{"line":175,"address":[2665320],"length":1,"stats":{"Line":1}},{"line":176,"address":[1712255],"length":1,"stats":{"Line":3}},{"line":182,"address":[5604976],"length":1,"stats":{"Line":2}},{"line":183,"address":[1712281],"length":1,"stats":{"Line":2}},{"line":184,"address":[3618120],"length":1,"stats":{"Line":1}},{"line":185,"address":[1712303],"length":1,"stats":{"Line":2}},{"line":191,"address":[1810352],"length":1,"stats":{"Line":2}},{"line":192,"address":[1712332,1712341],"length":1,"stats":{"Line":3}},{"line":193,"address":[3495143],"length":1,"stats":{"Line":2}},{"line":195,"address":[1712336],"length":1,"stats":{"Line":1}},{"line":215,"address":[3618192,3618348],"length":1,"stats":{"Line":4}},{"line":216,"address":[1712389],"length":1,"stats":{"Line":4}},{"line":217,"address":[2665469],"length":1,"stats":{"Line":4}},{"line":220,"address":[5644869],"length":1,"stats":{"Line":4}},{"line":224,"address":[3495360],"length":1,"stats":{"Line":4}},{"line":229,"address":[1712581],"length":1,"stats":{"Line":4}},{"line":234,"address":[2665696,2666012],"length":1,"stats":{"Line":2}},{"line":235,"address":[3618706],"length":1,"stats":{"Line":0}},{"line":240,"address":[5645096],"length":1,"stats":{"Line":3}},{"line":241,"address":[1810850],"length":1,"stats":{"Line":9}},{"line":242,"address":[5605874],"length":1,"stats":{"Line":0}},{"line":244,"address":[3495841],"length":1,"stats":{"Line":3}},{"line":245,"address":[5645585],"length":1,"stats":{"Line":3}},{"line":246,"address":[1811279],"length":1,"stats":{"Line":1}},{"line":251,"address":[2666032,2666494,2666391],"length":1,"stats":{"Line":12}},{"line":252,"address":[5645805],"length":1,"stats":{"Line":4}},{"line":254,"address":[1811461],"length":1,"stats":{"Line":0}},{"line":261,"address":[3496352],"length":1,"stats":{"Line":3}},{"line":262,"address":[5606272],"length":1,"stats":{"Line":3}},{"line":265,"address":[5646048,5648561],"length":1,"stats":{"Line":2}},{"line":269,"address":[5606346],"length":1,"stats":{"Line":2}},{"line":270,"address":[1812136,1811984],"length":1,"stats":{"Line":0}},{"line":273,"address":[1811851],"length":1,"stats":{"Line":0}},{"line":277,"address":[5646119],"length":1,"stats":{"Line":2}},{"line":278,"address":[5647036,5646869],"length":1,"stats":{"Line":0}},{"line":280,"address":[1714282],"length":1,"stats":{"Line":0}},{"line":284,"address":[3497508],"length":1,"stats":{"Line":2}},{"line":285,"address":[3497775,3497602],"length":1,"stats":{"Line":4}},{"line":286,"address":[3497837],"length":1,"stats":{"Line":2}},{"line":288,"address":[3621978,3622104],"length":1,"stats":{"Line":0}},{"line":294,"address":[3498087],"length":1,"stats":{"Line":2}},{"line":295,"address":[2668394],"length":1,"stats":{"Line":2}},{"line":297,"address":[3621235],"length":1,"stats":{"Line":2}},{"line":299,"address":[1715836,1715978],"length":1,"stats":{"Line":0}},{"line":306,"address":[5608380],"length":1,"stats":{"Line":2}},{"line":310,"address":[1814448],"length":1,"stats":{"Line":1}},{"line":311,"address":[5609142],"length":1,"stats":{"Line":1}},{"line":318,"address":[3622304],"length":1,"stats":{"Line":1}},{"line":319,"address":[3622326],"length":1,"stats":{"Line":1}},{"line":323,"address":[1815334,1815517,1814576],"length":1,"stats":{"Line":3}},{"line":326,"address":[1815462,1814628],"length":1,"stats":{"Line":3}},{"line":329,"address":[5609601],"length":1,"stats":{"Line":3}},{"line":330,"address":[3499493],"length":1,"stats":{"Line":3}},{"line":333,"address":[1814731],"length":1,"stats":{"Line":3}},{"line":334,"address":[3622703],"length":1,"stats":{"Line":1}},{"line":335,"address":[1716857],"length":1,"stats":{"Line":3}},{"line":336,"address":[5649205],"length":1,"stats":{"Line":0}},{"line":337,"address":[3499823,3499949],"length":1,"stats":{"Line":0}},{"line":345,"address":[2670388],"length":1,"stats":{"Line":0}},{"line":346,"address":[5649171],"length":1,"stats":{"Line":0}},{"line":352,"address":[1717488,1717859],"length":1,"stats":{"Line":4}},{"line":353,"address":[1717518],"length":1,"stats":{"Line":4}},{"line":354,"address":[5610281],"length":1,"stats":{"Line":4}},{"line":356,"address":[1815889],"length":1,"stats":{"Line":4}},{"line":362,"address":[3500720],"length":1,"stats":{"Line":3}},{"line":363,"address":[3623772],"length":1,"stats":{"Line":3}},{"line":368,"address":[5650448],"length":1,"stats":{"Line":3}},{"line":369,"address":[5650465],"length":1,"stats":{"Line":3}},{"line":379,"address":[2671120],"length":1,"stats":{"Line":1}},{"line":380,"address":[5610785],"length":1,"stats":{"Line":1}},{"line":385,"address":[3500944,3501134,3501163],"length":1,"stats":{"Line":2}},{"line":386,"address":[2671241],"length":1,"stats":{"Line":2}},{"line":387,"address":[1718181],"length":1,"stats":{"Line":2}},{"line":394,"address":[3624208],"length":1,"stats":{"Line":0}},{"line":395,"address":[1718354],"length":1,"stats":{"Line":0}},{"line":402,"address":[1816480],"length":1,"stats":{"Line":3}},{"line":403,"address":[2671599],"length":1,"stats":{"Line":3}},{"line":404,"address":[1718425],"length":1,"stats":{"Line":3}},{"line":405,"address":[3624321],"length":1,"stats":{"Line":3}},{"line":406,"address":[2671679],"length":1,"stats":{"Line":0}},{"line":412,"address":[1816736,1818073],"length":1,"stats":{"Line":3}},{"line":414,"address":[5651174],"length":1,"stats":{"Line":3}},{"line":415,"address":[3501647,3501547],"length":1,"stats":{"Line":6}},{"line":417,"address":[3624733],"length":1,"stats":{"Line":3}},{"line":419,"address":[1719853,1719727],"length":1,"stats":{"Line":0}},{"line":425,"address":[5611653],"length":1,"stats":{"Line":3}},{"line":426,"address":[3502286,3502453],"length":1,"stats":{"Line":0}},{"line":433,"address":[2672157],"length":1,"stats":{"Line":3}},{"line":440,"address":[5612784],"length":1,"stats":{"Line":4}},{"line":442,"address":[1720070],"length":1,"stats":{"Line":4}},{"line":446,"address":[3626000],"length":1,"stats":{"Line":3}},{"line":450,"address":[3503019],"length":1,"stats":{"Line":3}},{"line":451,"address":[1818450],"length":1,"stats":{"Line":3}},{"line":452,"address":[2673373],"length":1,"stats":{"Line":0}},{"line":453,"address":[5652720],"length":1,"stats":{"Line":0}},{"line":460,"address":[3503328],"length":1,"stats":{"Line":4}},{"line":461,"address":[3503333],"length":1,"stats":{"Line":4}},{"line":466,"address":[2673616],"length":1,"stats":{"Line":1}},{"line":467,"address":[1720510],"length":1,"stats":{"Line":1}},{"line":472,"address":[3626400],"length":1,"stats":{"Line":0}},{"line":473,"address":[2673662],"length":1,"stats":{"Line":0}},{"line":481,"address":[5653056],"length":1,"stats":{"Line":3}},{"line":483,"address":[2673715],"length":1,"stats":{"Line":3}},{"line":484,"address":[3626456],"length":1,"stats":{"Line":3}},{"line":489,"address":[1720672],"length":1,"stats":{"Line":3}},{"line":490,"address":[5653209],"length":1,"stats":{"Line":3}},{"line":494,"address":[5613484],"length":1,"stats":{"Line":3}},{"line":496,"address":[5613513],"length":1,"stats":{"Line":1}},{"line":500,"address":[3626921,3626656],"length":1,"stats":{"Line":3}},{"line":506,"address":[1818946],"length":1,"stats":{"Line":3}},{"line":507,"address":[2674060,2674135],"length":1,"stats":{"Line":6}},{"line":509,"address":[5613718],"length":1,"stats":{"Line":0}},{"line":513,"address":[5613824],"length":1,"stats":{"Line":2}},{"line":514,"address":[5613841],"length":1,"stats":{"Line":2}},{"line":519,"address":[3626992],"length":1,"stats":{"Line":1}},{"line":520,"address":[1721134],"length":1,"stats":{"Line":1}},{"line":525,"address":[3627024],"length":1,"stats":{"Line":0}},{"line":526,"address":[3504014],"length":1,"stats":{"Line":0}},{"line":533,"address":[3627056],"length":1,"stats":{"Line":3}},{"line":534,"address":[5613950],"length":1,"stats":{"Line":3}},{"line":536,"address":[3627080],"length":1,"stats":{"Line":3}},{"line":543,"address":[5614032],"length":1,"stats":{"Line":1}},{"line":545,"address":[1819390,1819469],"length":1,"stats":{"Line":1}},{"line":546,"address":[5653972],"length":1,"stats":{"Line":1}},{"line":547,"address":[1819500],"length":1,"stats":{"Line":1}},{"line":550,"address":[2674446],"length":1,"stats":{"Line":0}},{"line":560,"address":[1821360,1819648],"length":1,"stats":{"Line":1}},{"line":562,"address":[2674715],"length":1,"stats":{"Line":1}},{"line":563,"address":[5614836,5614687],"length":1,"stats":{"Line":0}},{"line":566,"address":[2674922],"length":1,"stats":{"Line":0}},{"line":570,"address":[1721624,1722221],"length":1,"stats":{"Line":2}},{"line":571,"address":[1820363],"length":1,"stats":{"Line":1}},{"line":573,"address":[3506169,3506295],"length":1,"stats":{"Line":0}},{"line":579,"address":[3505372],"length":1,"stats":{"Line":1}},{"line":580,"address":[1820639],"length":1,"stats":{"Line":1}},{"line":582,"address":[5615396],"length":1,"stats":{"Line":1}},{"line":584,"address":[5655531,5655673],"length":1,"stats":{"Line":0}},{"line":591,"address":[5615593],"length":1,"stats":{"Line":1}},{"line":600,"address":[5656547,5656080],"length":1,"stats":{"Line":1}},{"line":601,"address":[5616387,5616577],"length":1,"stats":{"Line":1}},{"line":602,"address":[1821878,1822033],"length":1,"stats":{"Line":2}},{"line":606,"address":[2677200,2677337],"length":1,"stats":{"Line":3}},{"line":607,"address":[3630042,3629970],"length":1,"stats":{"Line":6}},{"line":611,"address":[5616992],"length":1,"stats":{"Line":0}},{"line":612,"address":[5617009],"length":1,"stats":{"Line":0}},{"line":617,"address":[1724240],"length":1,"stats":{"Line":0}},{"line":618,"address":[5656792],"length":1,"stats":{"Line":0}},{"line":623,"address":[1822432],"length":1,"stats":{"Line":0}},{"line":624,"address":[1822450],"length":1,"stats":{"Line":0}},{"line":631,"address":[1822496],"length":1,"stats":{"Line":4}},{"line":633,"address":[3630306],"length":1,"stats":{"Line":4}},{"line":638,"address":[5617248],"length":1,"stats":{"Line":3}},{"line":640,"address":[3507362],"length":1,"stats":{"Line":3}},{"line":651,"address":[1724592,1726479],"length":1,"stats":{"Line":1}},{"line":652,"address":[5657147],"length":1,"stats":{"Line":1}},{"line":653,"address":[5618025,5617844],"length":1,"stats":{"Line":0}},{"line":657,"address":[1823039],"length":1,"stats":{"Line":0}},{"line":661,"address":[5657906,5657176],"length":1,"stats":{"Line":2}},{"line":662,"address":[1725440],"length":1,"stats":{"Line":1}},{"line":664,"address":[3509420,3509546],"length":1,"stats":{"Line":0}},{"line":670,"address":[1823793],"length":1,"stats":{"Line":1}},{"line":671,"address":[1823828],"length":1,"stats":{"Line":1}},{"line":672,"address":[3508681],"length":1,"stats":{"Line":1}},{"line":674,"address":[2679548,2679406],"length":1,"stats":{"Line":0}},{"line":681,"address":[1726004],"length":1,"stats":{"Line":1}},{"line":685,"address":[1824912,1825062],"length":1,"stats":{"Line":3}},{"line":686,"address":[1825020,1824942],"length":1,"stats":{"Line":6}},{"line":690,"address":[1726960],"length":1,"stats":{"Line":2}},{"line":691,"address":[1825093],"length":1,"stats":{"Line":2}},{"line":696,"address":[5659520,5659787],"length":1,"stats":{"Line":0}},{"line":697,"address":[5659554,5659700],"length":1,"stats":{"Line":0}},{"line":704,"address":[3633200],"length":1,"stats":{"Line":5}},{"line":707,"address":[5659844],"length":1,"stats":{"Line":5}},{"line":710,"address":[5620111],"length":1,"stats":{"Line":5}},{"line":711,"address":[1825462],"length":1,"stats":{"Line":5}},{"line":712,"address":[1727326],"length":1,"stats":{"Line":5}},{"line":713,"address":[2680554],"length":1,"stats":{"Line":5}},{"line":715,"address":[1727593,1727455,1727518],"length":1,"stats":{"Line":10}},{"line":730,"address":[1727616],"length":1,"stats":{"Line":5}},{"line":731,"address":[3510571],"length":1,"stats":{"Line":5}},{"line":732,"address":[3510696,3510804],"length":1,"stats":{"Line":2}},{"line":737,"address":[5620959],"length":1,"stats":{"Line":5}},{"line":738,"address":[3510887],"length":1,"stats":{"Line":5}},{"line":743,"address":[1728719,1728208],"length":1,"stats":{"Line":4}},{"line":744,"address":[2681438],"length":1,"stats":{"Line":4}},{"line":746,"address":[5660831],"length":1,"stats":{"Line":4}},{"line":747,"address":[5621188],"length":1,"stats":{"Line":4}},{"line":748,"address":[1826551],"length":1,"stats":{"Line":4}},{"line":749,"address":[2681787,2681599],"length":1,"stats":{"Line":4}},{"line":750,"address":[5661047],"length":1,"stats":{"Line":4}},{"line":752,"address":[5661052],"length":1,"stats":{"Line":4}},{"line":754,"address":[3511536,3511440],"length":1,"stats":{"Line":4}},{"line":760,"address":[1728752],"length":1,"stats":{"Line":3}},{"line":761,"address":[5621608],"length":1,"stats":{"Line":3}},{"line":765,"address":[3634768,3635496],"length":1,"stats":{"Line":5}},{"line":766,"address":[3511777],"length":1,"stats":{"Line":5}},{"line":767,"address":[1827115],"length":1,"stats":{"Line":1}},{"line":770,"address":[3634822],"length":1,"stats":{"Line":5}},{"line":771,"address":[1827057,1827179],"length":1,"stats":{"Line":10}},{"line":772,"address":[2682282],"length":1,"stats":{"Line":5}},{"line":774,"address":[1827258],"length":1,"stats":{"Line":5}},{"line":775,"address":[2682318],"length":1,"stats":{"Line":0}},{"line":778,"address":[1827276,1827288],"length":1,"stats":{"Line":10}},{"line":779,"address":[5661769],"length":1,"stats":{"Line":1}},{"line":782,"address":[3635090],"length":1,"stats":{"Line":5}},{"line":783,"address":[1827317,1827383],"length":1,"stats":{"Line":10}},{"line":785,"address":[1827467],"length":1,"stats":{"Line":5}},{"line":786,"address":[2682548],"length":1,"stats":{"Line":5}},{"line":787,"address":[3635324,3635336,3635408],"length":1,"stats":{"Line":15}},{"line":788,"address":[3635421,3635347],"length":1,"stats":{"Line":5}},{"line":790,"address":[3512302],"length":1,"stats":{"Line":0}},{"line":792,"address":[2682692],"length":1,"stats":{"Line":5}},{"line":794,"address":[5621938],"length":1,"stats":{"Line":1}},{"line":799,"address":[1729568],"length":1,"stats":{"Line":3}},{"line":805,"address":[1827744],"length":1,"stats":{"Line":4}},{"line":806,"address":[3635673,3635558],"length":1,"stats":{"Line":8}},{"line":811,"address":[2682992],"length":1,"stats":{"Line":0}},{"line":812,"address":[1828089,1827974],"length":1,"stats":{"Line":0}}],"covered":177,"coverable":223},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","tor_provider.rs"],"content":"// standard\nuse std::any::Any;\nuse std::boxed::Box;\nuse std::convert::TryFrom;\nuse std::io::{Read, Write};\nuse std::net::{SocketAddr, TcpListener, TcpStream};\nuse std::ops::{Deref, DerefMut};\nuse std::str::FromStr;\nuse std::sync::OnceLock;\n\n// extern crates\nuse domain::base::name::Name;\nuse idna::uts46::{Hyphens, Uts46};\nuse idna::{domain_to_ascii_cow, AsciiDenyList};\nuse regex::Regex;\n\n// internal crates\nuse crate::tor_crypto::*;\n\n\n/// Various `tor_provider` errors.\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"Failed to parse '{0}' as {1}\")]\n    /// Failure parsing some string into a type\n    ParseFailure(String, String),\n\n    #[error(\"{0}\")]\n    /// Other miscellaneous error\n    Generic(String),\n}\n\n//\n// OnionAddr\n//\n\n/// A version 3 onion service address.\n///\n/// Version 3 Onion Service addresses const of a [`crate::tor_crypto::V3OnionServiceId`] and a 16-bit port number.\n#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]\npub struct OnionAddrV3 {\n    pub(crate) service_id: V3OnionServiceId,\n    pub(crate) virt_port: u16,\n}\n\nimpl OnionAddrV3 {\n    /// Create a new `OnionAddrV3` from a [`crate::tor_crypto::V3OnionServiceId`] and port number.\n    pub fn new(service_id: V3OnionServiceId, virt_port: u16) -\u003e OnionAddrV3 {\n        OnionAddrV3 {\n            service_id,\n            virt_port,\n        }\n    }\n\n    /// Return the service id associated with this onion address.\n    pub fn service_id(\u0026self) -\u003e \u0026V3OnionServiceId {\n        \u0026self.service_id\n    }\n\n    /// Return the port numebr associated with this onion address.\n    pub fn virt_port(\u0026self) -\u003e u16 {\n        self.virt_port\n    }\n}\n\nimpl std::fmt::Display for OnionAddrV3 {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        write!(f, \"{}.onion:{}\", self.service_id, self.virt_port)\n    }\n}\n\n/// An onion service address analog to [`std::net::SocketAddr`]\n#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]\npub enum OnionAddr {\n    V3(OnionAddrV3),\n}\n\nimpl FromStr for OnionAddr {\n    type Err = Error;\n    fn from_str(s: \u0026str) -\u003e Result\u003cSelf, Self::Err\u003e {\n        static ONION_SERVICE_PATTERN: OnceLock\u003cRegex\u003e = OnceLock::new();\n        let onion_service_pattern = ONION_SERVICE_PATTERN.get_or_init(|| {\n            Regex::new(r\"(?m)^(?P\u003cservice_id\u003e[a-z2-7]{56})\\.onion:(?P\u003cport\u003e[1-9][0-9]{0,4})$\")\n                .unwrap()\n        });\n\n        if let Some(caps) = onion_service_pattern.captures(s.to_lowercase().as_ref()) {\n            let service_id = caps\n                .name(\"service_id\")\n                .expect(\"missing service_id group\")\n                .as_str()\n                .to_lowercase();\n            let port = caps.name(\"port\").expect(\"missing port group\").as_str();\n            if let (Ok(service_id), Ok(port)) = (\n                V3OnionServiceId::from_string(service_id.as_ref()),\n                u16::from_str(port),\n            ) {\n                return Ok(OnionAddr::V3(OnionAddrV3::new(service_id, port)));\n            }\n        }\n        Err(Self::Err::ParseFailure(s.to_string(), \"OnionAddr\".to_string()))\n    }\n}\n\nimpl std::fmt::Display for OnionAddr {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        match self {\n            OnionAddr::V3(onion_addr) =\u003e onion_addr.fmt(f),\n        }\n    }\n}\n\n//\n// DomainAddr\n//\n\n/// A domain name analog to `std::net::SocketAddr`\n///\n/// A `DomainAddr` must not end in \".onion\"\n#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]\npub struct DomainAddr {\n    domain: String,\n    port: u16,\n}\n\n/// A `DomainAddr` has a domain name (scuh as `www.example.com`) and a port\nimpl DomainAddr {\n    /// Returns the domain name associated with this domain address.\n    pub fn domain(\u0026self) -\u003e \u0026str {\n        self.domain.as_ref()\n    }\n\n    /// Returns the port number associated with this domain address.\n    pub fn port(\u0026self) -\u003e u16 {\n        self.port\n    }\n}\n\nimpl std::fmt::Display for DomainAddr {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        let uts46: Uts46 = Default::default();\n        let (ui_str, _err) = uts46.to_user_interface(\n            self.domain.as_str().as_bytes(),\n            AsciiDenyList::URL,\n            Hyphens::Allow,\n            |_, _, _| -\u003e bool { false },\n        );\n        write!(f, \"{}:{}\", ui_str, self.port)\n    }\n}\n\nimpl TryFrom\u003c(String, u16)\u003e for DomainAddr {\n    type Error = Error;\n\n    fn try_from(value: (String, u16)) -\u003e Result\u003cSelf, Self::Error\u003e {\n        let (domain, port) = (\u0026value.0, value.1);\n        if let Ok(domain) = domain_to_ascii_cow(domain.as_bytes(), AsciiDenyList::URL) {\n            let domain = domain.to_string();\n            if let Ok(domain) = Name::\u003cVec\u003cu8\u003e\u003e::from_str(domain.as_ref()) {\n                let domain = domain.to_string();\n                if !domain.ends_with(\".onion\") {\n                    return Ok(Self {\n                        domain,\n                        port,\n                    });\n                }\n            }\n        }\n        Err(Self::Error::ParseFailure(format!(\n            \"{}:{}\",\n            domain, port\n        ), \"DomainAddr\".to_string()))\n    }\n}\n\nimpl FromStr for DomainAddr {\n    type Err = Error;\n    fn from_str(s: \u0026str) -\u003e Result\u003cSelf, Self::Err\u003e {\n        static DOMAIN_PATTERN: OnceLock\u003cRegex\u003e = OnceLock::new();\n        let domain_pattern = DOMAIN_PATTERN\n            .get_or_init(|| Regex::new(r\"(?m)^(?P\u003cdomain\u003e.*):(?P\u003cport\u003e[1-9][0-9]{0,4})$\").unwrap());\n        if let Some(caps) = domain_pattern.captures(s) {\n            let domain = caps\n                .name(\"domain\")\n                .expect(\"missing domain group\")\n                .as_str()\n                .to_string();\n            let port = caps.name(\"port\").expect(\"missing port group\").as_str();\n            if let Ok(port) = u16::from_str(port) {\n                return Self::try_from((domain, port));\n            }\n        }\n        Err(Self::Err::ParseFailure(s.to_string(), \"DomainAddr\".to_string()))\n    }\n}\n\n//\n// TargetAddr\n//\n\n/// An enum representing the various types of addresses a [`TorProvider`] implementation may connect to.\n#[derive(Clone, Debug)]\npub enum TargetAddr {\n    /// An ip address and port\n    Socket(std::net::SocketAddr),\n    /// An onion-service id and virtual port\n    OnionService(OnionAddr),\n    /// A domain name and port\n    Domain(DomainAddr),\n}\n\nimpl From\u003c(V3OnionServiceId, u16)\u003e for TargetAddr {\n    fn from(target_tuple: (V3OnionServiceId, u16)) -\u003e Self {\n        TargetAddr::OnionService(OnionAddr::V3(OnionAddrV3::new(\n            target_tuple.0,\n            target_tuple.1,\n        )))\n    }\n}\n\nimpl FromStr for TargetAddr {\n    type Err = Error;\n    fn from_str(s: \u0026str) -\u003e Result\u003cSelf, Self::Err\u003e {\n        if let Ok(socket_addr) = SocketAddr::from_str(s) {\n            return Ok(TargetAddr::Socket(socket_addr));\n        } else if let Ok(onion_addr) = OnionAddr::from_str(s) {\n            return Ok(TargetAddr::OnionService(onion_addr));\n        } else if let Ok(domain_addr) = DomainAddr::from_str(s) {\n            return Ok(TargetAddr::Domain(domain_addr));\n        }\n        Err(Self::Err::ParseFailure(s.to_string(), \"TargetAddr\".to_string()))\n    }\n}\n\nimpl std::fmt::Display for TargetAddr {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        match self {\n            TargetAddr::Socket(socket_addr) =\u003e socket_addr.fmt(f),\n            TargetAddr::OnionService(onion_addr) =\u003e onion_addr.fmt(f),\n            TargetAddr::Domain(domain_addr) =\u003e domain_addr.fmt(f),\n        }\n    }\n}\n\n/// Various events possibly returned by a [`TorProvider`] implementation's `update()` method.\n#[derive(Debug)]\npub enum TorEvent {\n    /// A status update received connecting to the Tor Network.\n    BootstrapStatus {\n        /// A number from 0 to 100 for how through the bootstrap process the `TorProvider` is.\n        progress: u32,\n        /// A short string to identify the current phase of the bootstrap process.\n        tag: String,\n        /// A longer string with a summary of the current phase of the bootstrap process.\n        summary: String,\n    },\n    /// Indicates successful connection to the Tor Network. The [`TorProvider::connect()`] and [`TorProvider::listener()`] methods may now be used.\n    BootstrapComplete,\n    /// Messages which may be useful for troubleshooting.\n    LogReceived {\n        /// A message\n        line: String,\n    },\n    /// An onion-service has been published to the Tor Network and may now be reachable by clients.\n    OnionServicePublished {\n        /// The service-id of the onion-service which has been published.\n        service_id: V3OnionServiceId,\n    },\n}\n\n/// A `CircuitToken` is used to specify circuits used to connect to clearnet services.\npub type CircuitToken = usize;\n\n//\n// Onion Stream\n//\n\n/// A wrapper around a [`std::net::TcpStream`] with some Tor-specific customisations\n///\n/// An onion-listener can be constructed using the [`TorProvider::connect()`] method.\npub struct OnionStream {\n    pub(crate) stream: TcpStream,\n    pub(crate) local_addr: Option\u003cOnionAddr\u003e,\n    pub(crate) peer_addr: Option\u003cTargetAddr\u003e,\n}\n\nimpl Deref for OnionStream {\n    type Target = TcpStream;\n    fn deref(\u0026self) -\u003e \u0026Self::Target {\n        \u0026self.stream\n    }\n}\n\nimpl DerefMut for OnionStream {\n    fn deref_mut(\u0026mut self) -\u003e \u0026mut Self::Target {\n        \u0026mut self.stream\n    }\n}\n\nimpl From\u003cOnionStream\u003e for TcpStream {\n    fn from(onion_stream: OnionStream) -\u003e Self {\n        onion_stream.stream\n    }\n}\n\nimpl Read for OnionStream {\n    fn read(\u0026mut self, buf: \u0026mut [u8]) -\u003e Result\u003cusize, std::io::Error\u003e {\n        self.stream.read(buf)\n    }\n}\n\nimpl Write for OnionStream {\n    fn write(\u0026mut self, buf: \u0026[u8]) -\u003e Result\u003cusize, std::io::Error\u003e {\n        self.stream.write(buf)\n    }\n\n    fn flush(\u0026mut self) -\u003e Result\u003c(), std::io::Error\u003e {\n        self.stream.flush()\n    }\n}\n\nimpl OnionStream {\n    /// Returns the target address of the remote peer of this onion connection.\n    pub fn peer_addr(\u0026self) -\u003e Option\u003cTargetAddr\u003e {\n        self.peer_addr.clone()\n    }\n\n    /// Returns the onion address of the local connection for an incoming onion-service connection. Returns `None` for outgoing connections.\n    pub fn local_addr(\u0026self) -\u003e Option\u003cOnionAddr\u003e {\n        self.local_addr.clone()\n    }\n\n    /// Tries to clone the underlying connection and data. A simple pass-through to [`std::net::TcpStream::try_clone()`].\n    pub fn try_clone(\u0026self) -\u003e Result\u003cSelf, std::io::Error\u003e {\n        Ok(Self {\n            stream: self.stream.try_clone()?,\n            local_addr: self.local_addr.clone(),\n            peer_addr: self.peer_addr.clone(),\n        })\n    }\n}\n\n//\n// Onion Listener\n//\n\n/// A wrapper around a [`std::net::TcpListener`] with some Tor-specific customisations.\n///\n/// An onion-listener can be constructed using the [`TorProvider::listener()`] method.\npub struct OnionListener {\n    pub(crate) listener: TcpListener,\n    pub(crate) onion_addr: OnionAddr,\n    pub(crate) data: Option\u003cBox\u003cdyn Any + Send\u003e\u003e,\n    pub(crate) drop: Option\u003cBox\u003cdyn FnMut(Box\u003cdyn Any\u003e) + Send\u003e\u003e,\n}\n\nimpl OnionListener {\n    /// Construct an `OnionListener`. The `data` and `drop` parameters are to allow custom `TorProvider` implementations their own data and cleanup procedures.\n    pub(crate) fn new\u003cT: 'static + Send\u003e(\n        listener: TcpListener,\n        onion_addr: OnionAddr,\n        data: T,\n        mut drop: impl FnMut(T) + 'static + Send) -\u003e Self {\n        // marshall our data into an Any\n        let data: Option\u003cBox\u003cdyn Any + Send\u003e\u003e = Some(Box::new(data));\n        // marhsall our drop into a function which takes an Any\n        let drop: Option\u003cBox\u003cdyn FnMut(Box\u003cdyn Any\u003e) + Send\u003e\u003e  = Some(Box::new(move |data: Box\u003cdyn std::any::Any\u003e| {\n            // encapsulate extracting our data from the Any\n            if let Ok(data) = data.downcast::\u003cT\u003e() {\n                // and call our provided drop\n                drop(*data);\n            }\n        }));\n\n        Self{\n            listener,\n            onion_addr,\n            data,\n            drop,\n        }\n    }\n\n    /// Moves the underlying `TcpListener` into or out of nonblocking mode.\n    pub fn set_nonblocking(\u0026self, nonblocking: bool) -\u003e Result\u003c(), std::io::Error\u003e {\n        self.listener.set_nonblocking(nonblocking)\n    }\n\n    /// Accept a new incoming connection from this listener.\n    pub fn accept(\u0026self) -\u003e Result\u003cOption\u003cOnionStream\u003e, std::io::Error\u003e {\n        match self.listener.accept() {\n            Ok((stream, _socket_addr)) =\u003e Ok(Some(OnionStream {\n                stream,\n                local_addr: Some(self.onion_addr.clone()),\n                peer_addr: None,\n            })),\n            Err(err) =\u003e {\n                if err.kind() == std::io::ErrorKind::WouldBlock {\n                    Ok(None)\n                } else {\n                    Err(err)\n                }\n            }\n        }\n    }\n}\n\nimpl Drop for OnionListener {\n    fn drop(\u0026mut self) {\n        if let (Some(data), Some(mut drop)) = (self.data.take(), self.drop.take()) {\n            drop(data)\n        }\n    }\n}\n\n/// The `TorProvider` trait allows for high-level Tor Network functionality. Implementations ay connect to the Tor Network, anonymously connect to both clearnet and onion-service endpoints, and host onion-services.\npub trait TorProvider: Send {\n    /// Process and return `TorEvent`s handled by this `TorProvider`.\n    fn update(\u0026mut self) -\u003e Result\u003cVec\u003cTorEvent\u003e, Error\u003e;\n    /// Begin connecting to the Tor Network.\n    fn bootstrap(\u0026mut self) -\u003e Result\u003c(), Error\u003e;\n    /// Add v3 onion-service authorisation credentials, allowing this `TorProvider` to connect to an onion-service whose service-descriptor is encrypted using the assocciated x25519 public key.\n    fn add_client_auth(\n        \u0026mut self,\n        service_id: \u0026V3OnionServiceId,\n        client_auth: \u0026X25519PrivateKey,\n    ) -\u003e Result\u003c(), Error\u003e;\n    /// Remove a previously added client authorisation credential. This `TorProvider` will be unable to connect to the onion-service associated with the removed credentail.\n    fn remove_client_auth(\u0026mut self, service_id: \u0026V3OnionServiceId) -\u003e Result\u003c(), Error\u003e;\n    /// Anonymously connect to the address specified by `target` over the Tor Network and return the associated [`OnionStream`].\n    ///\n    /// When conecting to clearnet targets, an optional [`CircuitToken`] may be used to enforce usage of different circuits through the Tor Network. If `circuit` is `None`, the default circuit is used.\n    ///\n    ///Connections made with different `CircuitToken`s are required to use different circuits through the Tor Network. However, connections made with identical `CircuitToken`s are *not* required to use identical circuits through the Tor Network.\n    ///\n    /// Specifying a circuit token when connecting to an onion-service has no effect on the resulting circuit.\n    fn connect(\n        \u0026mut self,\n        target: TargetAddr,\n        circuit: Option\u003cCircuitToken\u003e,\n    ) -\u003e Result\u003cOnionStream, Error\u003e;\n    /// Anonymously start an onion-service and return the associated [`OnionListener`].\n    ///\n    ///The resulting onion-service will not be reachable by clients until [`TorProvider::update()`] returns a [`TorEvent::OnionServicePublished`] event. The optional `authorised_clients` parameter may be used to require client authorisation keys to connect to resulting onion-service. For further information, see the Tor Project's onion-services [client-auth documentation](https://community.torproject.org/onion-services/advanced/client-auth).\n    fn listener(\n        \u0026mut self,\n        private_key: \u0026Ed25519PrivateKey,\n        virt_port: u16,\n        authorised_clients: Option\u003c\u0026[X25519PublicKey]\u003e,\n    ) -\u003e Result\u003cOnionListener, Error\u003e;\n    /// Create a new [`CircuitToken`].\n    fn generate_token(\u0026mut self) -\u003e CircuitToken;\n    /// Releaes a previously generated [`CircuitToken`].\n    fn release_token(\u0026mut self, token: CircuitToken);\n}\n","traces":[{"line":48,"address":[1911888],"length":1,"stats":{"Line":2}},{"line":56,"address":[5748688],"length":1,"stats":{"Line":0}},{"line":61,"address":[1911968],"length":1,"stats":{"Line":0}},{"line":62,"address":[5748709],"length":1,"stats":{"Line":0}},{"line":67,"address":[1738048],"length":1,"stats":{"Line":1}},{"line":68,"address":[3597084,3597000],"length":1,"stats":{"Line":2}},{"line":80,"address":[3598929,3597184,3598593],"length":1,"stats":{"Line":1}},{"line":82,"address":[1546736],"length":1,"stats":{"Line":2}},{"line":83,"address":[1752094],"length":1,"stats":{"Line":1}},{"line":87,"address":[3597277,3597400],"length":1,"stats":{"Line":2}},{"line":88,"address":[5749353,5749467],"length":1,"stats":{"Line":2}},{"line":93,"address":[1738966,1738887],"length":1,"stats":{"Line":2}},{"line":94,"address":[2769315,2769413,2769485],"length":1,"stats":{"Line":3}},{"line":95,"address":[3720967],"length":1,"stats":{"Line":1}},{"line":96,"address":[1913150,1913087],"length":1,"stats":{"Line":2}},{"line":98,"address":[1739412,1739377,1739468],"length":1,"stats":{"Line":3}},{"line":101,"address":[3598696,3598747],"length":1,"stats":{"Line":1}},{"line":106,"address":[1740064],"length":1,"stats":{"Line":1}},{"line":108,"address":[3598957],"length":1,"stats":{"Line":1}},{"line":129,"address":[5711072],"length":1,"stats":{"Line":0}},{"line":130,"address":[3722021],"length":1,"stats":{"Line":0}},{"line":134,"address":[5750832],"length":1,"stats":{"Line":0}},{"line":135,"address":[5750837],"length":1,"stats":{"Line":0}},{"line":140,"address":[5751511,5750848],"length":1,"stats":{"Line":1}},{"line":141,"address":[2770289],"length":1,"stats":{"Line":1}},{"line":142,"address":[1914266],"length":1,"stats":{"Line":1}},{"line":143,"address":[5750900],"length":1,"stats":{"Line":1}},{"line":145,"address":[1740290],"length":1,"stats":{"Line":1}},{"line":146,"address":[1752354,1752320],"length":1,"stats":{"Line":2}},{"line":148,"address":[3599460,3599550],"length":1,"stats":{"Line":2}},{"line":155,"address":[1914800,1915892,1916628],"length":1,"stats":{"Line":1}},{"line":156,"address":[1914822],"length":1,"stats":{"Line":1}},{"line":157,"address":[5751588,5751661],"length":1,"stats":{"Line":2}},{"line":158,"address":[3599963],"length":1,"stats":{"Line":1}},{"line":159,"address":[3600131,3600063],"length":1,"stats":{"Line":2}},{"line":160,"address":[1741365],"length":1,"stats":{"Line":1}},{"line":161,"address":[2771634,2771566],"length":1,"stats":{"Line":2}},{"line":162,"address":[5752304],"length":1,"stats":{"Line":1}},{"line":163,"address":[5712528],"length":1,"stats":{"Line":1}},{"line":169,"address":[2772626,2772413],"length":1,"stats":{"Line":2}},{"line":172,"address":[1916406],"length":1,"stats":{"Line":1}},{"line":178,"address":[5713648,5714535],"length":1,"stats":{"Line":1}},{"line":180,"address":[3724635],"length":1,"stats":{"Line":1}},{"line":181,"address":[5538494,5538701,5538480],"length":1,"stats":{"Line":3}},{"line":182,"address":[1742764],"length":1,"stats":{"Line":1}},{"line":183,"address":[3724913,3724802],"length":1,"stats":{"Line":2}},{"line":188,"address":[1743168,1743092],"length":1,"stats":{"Line":2}},{"line":189,"address":[1743261],"length":1,"stats":{"Line":1}},{"line":190,"address":[3725269],"length":1,"stats":{"Line":1}},{"line":193,"address":[2773790,2773745],"length":1,"stats":{"Line":1}},{"line":213,"address":[2773984],"length":1,"stats":{"Line":2}},{"line":214,"address":[1743883],"length":1,"stats":{"Line":2}},{"line":215,"address":[5714853],"length":1,"stats":{"Line":2}},{"line":223,"address":[3726825,3725920],"length":1,"stats":{"Line":1}},{"line":224,"address":[2774170],"length":1,"stats":{"Line":1}},{"line":225,"address":[1744105],"length":1,"stats":{"Line":1}},{"line":226,"address":[1918178,1918221],"length":1,"stats":{"Line":2}},{"line":227,"address":[5715243],"length":1,"stats":{"Line":1}},{"line":228,"address":[1744332,1744397],"length":1,"stats":{"Line":2}},{"line":229,"address":[3603403],"length":1,"stats":{"Line":1}},{"line":231,"address":[2774819],"length":1,"stats":{"Line":1}},{"line":236,"address":[5715904],"length":1,"stats":{"Line":0}},{"line":237,"address":[1744919],"length":1,"stats":{"Line":0}},{"line":238,"address":[2775120],"length":1,"stats":{"Line":0}},{"line":239,"address":[1919008],"length":1,"stats":{"Line":0}},{"line":240,"address":[3726976],"length":1,"stats":{"Line":0}},{"line":289,"address":[1919088],"length":1,"stats":{"Line":0}},{"line":290,"address":[5755832],"length":1,"stats":{"Line":0}},{"line":295,"address":[5755840],"length":1,"stats":{"Line":0}},{"line":296,"address":[1919112],"length":1,"stats":{"Line":0}},{"line":301,"address":[5202576],"length":1,"stats":{"Line":1}},{"line":302,"address":[2865489],"length":1,"stats":{"Line":1}},{"line":307,"address":[1745104],"length":1,"stats":{"Line":1}},{"line":308,"address":[3727074],"length":1,"stats":{"Line":1}},{"line":313,"address":[5716160],"length":1,"stats":{"Line":1}},{"line":314,"address":[1919186],"length":1,"stats":{"Line":1}},{"line":317,"address":[3604128],"length":1,"stats":{"Line":1}},{"line":318,"address":[1919221],"length":1,"stats":{"Line":1}},{"line":324,"address":[1919232],"length":1,"stats":{"Line":0}},{"line":325,"address":[5755985],"length":1,"stats":{"Line":0}},{"line":329,"address":[2775424],"length":1,"stats":{"Line":0}},{"line":330,"address":[2775441],"length":1,"stats":{"Line":0}},{"line":334,"address":[3727264,3727594],"length":1,"stats":{"Line":0}},{"line":335,"address":[5716556],"length":1,"stats":{"Line":0}},{"line":336,"address":[2775607,2775501],"length":1,"stats":{"Line":0}},{"line":337,"address":[5716427],"length":1,"stats":{"Line":0}},{"line":338,"address":[5716537],"length":1,"stats":{"Line":0}},{"line":359,"address":[3430422,3429904,3429360,3429878,3429851,3430395],"length":1,"stats":{"Line":4}},{"line":365,"address":[3553148,3552962,3552604,3552418],"length":1,"stats":{"Line":8}},{"line":367,"address":[2601949,2603094,2602630,2603451,2602800,2602086,2603083,2603168,2603462,2602493],"length":1,"stats":{"Line":12}},{"line":369,"address":[1548344,1548696],"length":1,"stats":{"Line":4}},{"line":371,"address":[3553926,3553623,3553558,3553991],"length":1,"stats":{"Line":8}},{"line":384,"address":[1745648],"length":1,"stats":{"Line":1}},{"line":385,"address":[3727637],"length":1,"stats":{"Line":1}},{"line":389,"address":[3727664,3728058],"length":1,"stats":{"Line":2}},{"line":390,"address":[3727694],"length":1,"stats":{"Line":2}},{"line":391,"address":[1745764,1745958],"length":1,"stats":{"Line":4}},{"line":392,"address":[2775971],"length":1,"stats":{"Line":2}},{"line":393,"address":[1919940,1919834],"length":1,"stats":{"Line":4}},{"line":394,"address":[2776124],"length":1,"stats":{"Line":2}},{"line":396,"address":[2775997],"length":1,"stats":{"Line":1}},{"line":397,"address":[2776406,2776026,2776333],"length":1,"stats":{"Line":2}},{"line":398,"address":[3605181],"length":1,"stats":{"Line":1}},{"line":400,"address":[2776381],"length":1,"stats":{"Line":0}},{"line":408,"address":[1733483,1733120],"length":1,"stats":{"Line":2}},{"line":409,"address":[3409840,3410070],"length":1,"stats":{"Line":4}},{"line":410,"address":[1733419],"length":1,"stats":{"Line":2}}],"covered":81,"coverable":107},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","tests","tor_crypto.rs"],"content":"// internal crates\nuse tor_interface::tor_crypto::*;\n\n#[test]\nfn test_crypto_ed25519() -\u003e Result\u003c(), anyhow::Error\u003e {\n    let private_key_blob = \"ED25519-V3:rP3u8mZaKohap0lKsB8Z8qXbXqK456JKKGONDBhV+gPBVKa2mHVQqnRTVuFXe3inU3YW6qvc7glYEwe9rK0LhQ==\";\n    let private_raw: [u8; ED25519_PRIVATE_KEY_SIZE] = [\n        0xacu8, 0xfdu8, 0xeeu8, 0xf2u8, 0x66u8, 0x5au8, 0x2au8, 0x88u8, 0x5au8, 0xa7u8, 0x49u8,\n        0x4au8, 0xb0u8, 0x1fu8, 0x19u8, 0xf2u8, 0xa5u8, 0xdbu8, 0x5eu8, 0xa2u8, 0xb8u8, 0xe7u8,\n        0xa2u8, 0x4au8, 0x28u8, 0x63u8, 0x8du8, 0x0cu8, 0x18u8, 0x55u8, 0xfau8, 0x03u8, 0xc1u8,\n        0x54u8, 0xa6u8, 0xb6u8, 0x98u8, 0x75u8, 0x50u8, 0xaau8, 0x74u8, 0x53u8, 0x56u8, 0xe1u8,\n        0x57u8, 0x7bu8, 0x78u8, 0xa7u8, 0x53u8, 0x76u8, 0x16u8, 0xeau8, 0xabu8, 0xdcu8, 0xeeu8,\n        0x09u8, 0x58u8, 0x13u8, 0x07u8, 0xbdu8, 0xacu8, 0xadu8, 0x0bu8, 0x85u8,\n    ];\n    let public_raw: [u8; ED25519_PUBLIC_KEY_SIZE] = [\n        0xf2u8, 0xfdu8, 0xa2u8, 0xdbu8, 0xf3u8, 0x80u8, 0xa6u8, 0xbau8, 0x74u8, 0xa4u8, 0x90u8,\n        0xe1u8, 0x45u8, 0x55u8, 0xeeu8, 0xb9u8, 0x32u8, 0xa0u8, 0x5cu8, 0x39u8, 0x5au8, 0xe2u8,\n        0x02u8, 0x83u8, 0x55u8, 0x27u8, 0x89u8, 0x6au8, 0x1fu8, 0x2fu8, 0x3du8, 0xc5u8,\n    ];\n    let service_id_string = \"6l62fw7tqctlu5fesdqukvpoxezkaxbzllrafa2ve6ewuhzphxczsjyd\";\n    assert!(V3OnionServiceId::is_valid(\u0026service_id_string));\n\n    let mut message = [0x00u8; 256];\n    let null_message = [0x00u8; 256];\n    for (i, ptr) in message.iter_mut().enumerate() {\n        *ptr = i as u8;\n    }\n    let signature_raw: [u8; ED25519_SIGNATURE_SIZE] = [\n        0xa6u8, 0xd6u8, 0xc6u8, 0x1au8, 0x03u8, 0xbcu8, 0x43u8, 0x6fu8, 0x38u8, 0x53u8, 0x94u8,\n        0xcdu8, 0xdcu8, 0x86u8, 0x0au8, 0x88u8, 0x64u8, 0x43u8, 0x1du8, 0x18u8, 0x84u8, 0x30u8,\n        0x2fu8, 0xcdu8, 0xa6u8, 0x79u8, 0xcau8, 0x87u8, 0xd0u8, 0x29u8, 0xe7u8, 0x2bu8, 0x32u8,\n        0x9bu8, 0xa2u8, 0xa4u8, 0x3cu8, 0x74u8, 0x6au8, 0x08u8, 0x67u8, 0x0eu8, 0x63u8, 0x60u8,\n        0xcbu8, 0x46u8, 0x22u8, 0x55u8, 0x43u8, 0x5bu8, 0x84u8, 0x68u8, 0x0fu8, 0x47u8, 0xceu8,\n        0x6cu8, 0xd2u8, 0xb8u8, 0xebu8, 0xfeu8, 0xf6u8, 0x9eu8, 0x97u8, 0x0au8,\n    ];\n\n    // test the golden path first\n    let service_id = V3OnionServiceId::from_string(\u0026service_id_string)?;\n\n    let private_key = Ed25519PrivateKey::from_raw(\u0026private_raw)?;\n    assert_eq!(\n        private_key,\n        Ed25519PrivateKey::from_key_blob(\u0026private_key_blob)?\n    );\n    assert_eq!(private_key_blob, private_key.to_key_blob());\n\n    let public_key = Ed25519PublicKey::from_raw(\u0026public_raw)?;\n    assert_eq!(public_key, Ed25519PublicKey::from_service_id(\u0026service_id)?);\n    assert_eq!(public_key, Ed25519PublicKey::from_private_key(\u0026private_key));\n    assert_eq!(service_id, V3OnionServiceId::from_public_key(\u0026public_key));\n\n    let signature = private_key.sign_message(\u0026message);\n    assert_eq!(signature, Ed25519Signature::from_raw(\u0026signature_raw)?);\n    assert!(signature.verify(\u0026message, \u0026public_key));\n    assert!(!signature.verify(\u0026null_message, \u0026public_key));\n\n    // some invalid service ids\n    assert!(!V3OnionServiceId::is_valid(\"\"));\n    assert!(!V3OnionServiceId::is_valid(\n        \"\n        aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"\n    ));\n    assert!(!V3OnionServiceId::is_valid(\n        \"6L62FW7TQCTLU5FESDQUKVPOXEZKAXBZLLRAFA2VE6EWUHZPHXCZSJYD\"\n    ));\n\n    // generate a new key, get the public key and sign/verify a message\n    let private_key = Ed25519PrivateKey::generate();\n    let public_key = Ed25519PublicKey::from_private_key(\u0026private_key);\n    let signature = private_key.sign_message(\u0026message);\n    assert!(signature.verify(\u0026message, \u0026public_key));\n\n    // test invalid private key blob returns an error\n    // https://gitlab.torproject.org/tpo/core/arti/-/issues/1021\n    let private_raw: [u8; ED25519_PRIVATE_KEY_SIZE] = [\n        0x2eu8, 0x26u8, 0x0au8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x0au8, 0x77u8, 0x77u8,\n        0x77u8, 0x77u8, 0x5du8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8,\n        0x82u8, 0xb4u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8,\n        0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0xffu8,\n        0xffu8, 0xffu8, 0xffu8, 0xffu8, 0xffu8, 0xffu8, 0xffu8, 0xffu8, 0xffu8, 0xffu8, 0xffu8,\n        0xffu8, 0xffu8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x82u8, 0x88u8,\n    ];\n    match Ed25519PrivateKey::from_raw(\u0026private_raw) {\n        Ok(_) =\u003e panic!(\"invalid key accepted\"),\n        Err(tor_interface::tor_crypto::Error::KeyInvalid) =\u003e (),\n        Err(err) =\u003e panic!(\"unexpected error: {:?}\", err),\n    }\n\n    Ok(())\n}\n\n#[test]\nfn test_crypto_x25519() -\u003e Result\u003c(), anyhow::Error\u003e {\n    // private/public key pair\n    const SECRET_BASE64: \u0026str = \"0GeSReJXdNcgvWRQdnDXhJGdu5UiwP2fefgT93/oqn0=\";\n    const SECRET_RAW: [u8; X25519_PRIVATE_KEY_SIZE] = [\n        0xd0u8, 0x67u8, 0x92u8, 0x45u8, 0xe2u8, 0x57u8, 0x74u8, 0xd7u8, 0x20u8, 0xbdu8, 0x64u8,\n        0x50u8, 0x76u8, 0x70u8, 0xd7u8, 0x84u8, 0x91u8, 0x9du8, 0xbbu8, 0x95u8, 0x22u8, 0xc0u8,\n        0xfdu8, 0x9fu8, 0x79u8, 0xf8u8, 0x13u8, 0xf7u8, 0x7fu8, 0xe8u8, 0xaau8, 0x7du8,\n    ];\n    const PUBLIC_BASE32: \u0026str = \"AEXCBCEDJ5KU34YGGMZ7PVHVDEA7D7YB7VQAPJTMTZGRJLN3JASA\";\n    const PUBLIC_RAW: [u8; X25519_PUBLIC_KEY_SIZE] = [\n        0x01u8, 0x2eu8, 0x20u8, 0x88u8, 0x83u8, 0x4fu8, 0x55u8, 0x4du8, 0xf3u8, 0x06u8, 0x33u8,\n        0x33u8, 0xf7u8, 0xd4u8, 0xf5u8, 0x19u8, 0x01u8, 0xf1u8, 0xffu8, 0x01u8, 0xfdu8, 0x60u8,\n        0x07u8, 0xa6u8, 0x6cu8, 0x9eu8, 0x4du8, 0x14u8, 0xadu8, 0xbbu8, 0x48u8, 0x24u8,\n    ];\n\n    // ensure we can convert from raw as expected\n    assert_eq!(\n        \u0026X25519PrivateKey::from_raw(\u0026SECRET_RAW)?.to_base64(),\n        SECRET_BASE64\n    );\n    assert_eq!(\n        \u0026X25519PublicKey::from_raw(\u0026PUBLIC_RAW).to_base32(),\n        PUBLIC_BASE32\n    );\n\n    // ensure we can round-trip as expected\n    assert_eq!(\n        \u0026X25519PrivateKey::from_base64(\u0026SECRET_BASE64)?.to_base64(),\n        SECRET_BASE64\n    );\n    assert_eq!(\n        \u0026X25519PublicKey::from_base32(\u0026PUBLIC_BASE32)?.to_base32(),\n        PUBLIC_BASE32\n    );\n\n    // ensure we generate the expected public key from private key\n    let private_key = X25519PrivateKey::from_base64(\u0026SECRET_BASE64)?;\n    let public_key = X25519PublicKey::from_private_key(\u0026private_key);\n    assert_eq!(public_key.to_base32(), PUBLIC_BASE32);\n\n    let message = b\"All around me are familiar faces\";\n\n    let (signature, signbit) = private_key.sign_message(message)?;\n    assert!(signature.verify_x25519(message, \u0026public_key, signbit));\n\n    Ok(())\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","tests","tor_provider.rs"],"content":"// stanndard\n#[cfg(feature = \"legacy-tor-provider\")]\nuse std::fs::File;\nuse std::io::{Read, Write};\n#[cfg(feature = \"legacy-tor-provider\")]\nuse std::process;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse std::process::{Child, Command, Stdio};\nuse std::str::FromStr;\n#[cfg(feature = \"arti-client-tor-provider\")]\nuse std::sync::Arc;\n\n// extern crates\nuse serial_test::serial;\n#[cfg(feature = \"arti-client-tor-provider\")]\nuse tokio::runtime;\n\n// internal crates\n#[cfg(feature = \"arti-client-tor-provider\")]\nuse tor_interface::arti_client_tor_client::*;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse tor_interface::censorship_circumvention::*;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse tor_interface::legacy_tor_client::*;\n#[cfg(feature = \"mock-tor-provider\")]\nuse tor_interface::mock_tor_client::*;\nuse tor_interface::tor_crypto::*;\nuse tor_interface::tor_provider::*;\n\n#[allow(dead_code)]\npub(crate) fn bootstrap_test(mut tor: Box\u003cdyn TorProvider\u003e) -\u003e anyhow::Result\u003c()\u003e {\n    tor.bootstrap()?;\n\n    let mut received_log = false;\n    let mut bootstrap_complete = false;\n    while !bootstrap_complete {\n        for event in tor.update()?.iter() {\n            match event {\n                TorEvent::BootstrapStatus {\n                    progress,\n                    tag,\n                    summary,\n                } =\u003e println!(\n                    \"BootstrapStatus: {{ progress: {}, tag: {}, summary: '{}' }}\",\n                    progress, tag, summary\n                ),\n                TorEvent::BootstrapComplete =\u003e {\n                    println!(\"Bootstrap Complete!\");\n                    bootstrap_complete = true;\n                }\n                TorEvent::LogReceived { line } =\u003e {\n                    received_log = true;\n                    println!(\"--- {}\", line);\n                }\n                _ =\u003e {}\n            }\n        }\n    }\n    assert!(\n        received_log,\n        \"should have received a log line from tor provider\"\n    );\n\n    Ok(())\n}\n\n#[allow(dead_code)]\npub(crate) fn basic_onion_service_test(\n    mut server_provider: Box\u003cdyn TorProvider\u003e,\n    mut client_provider: Box\u003cdyn TorProvider\u003e,\n) -\u003e anyhow::Result\u003c()\u003e {\n    server_provider.bootstrap()?;\n    client_provider.bootstrap()?;\n\n    let mut server_provider_bootstrap_complete = false;\n    let mut client_provider_bootstrap_complete = false;\n\n    while !server_provider_bootstrap_complete || !client_provider_bootstrap_complete {\n        for event in server_provider.update()?.iter() {\n            match event {\n                TorEvent::BootstrapStatus {\n                    progress,\n                    tag,\n                    summary,\n                } =\u003e println!(\n                    \"Server Provider BootstrapStatus: {{ progress: {}, tag: {}, summary: '{}' }}\",\n                    progress, tag, summary\n                ),\n                TorEvent::BootstrapComplete =\u003e {\n                    println!(\"Server Provider Bootstrap Complete!\");\n                    server_provider_bootstrap_complete = true;\n                }\n                TorEvent::LogReceived { line } =\u003e {\n                    println!(\"--- {}\", line);\n                }\n                _ =\u003e {}\n            }\n        }\n\n        for event in client_provider.update()?.iter() {\n            match event {\n                TorEvent::BootstrapStatus {\n                    progress,\n                    tag,\n                    summary,\n                } =\u003e println!(\n                    \"Client Provider BootstrapStatus: {{ progress: {}, tag: {}, summary: '{}' }}\",\n                    progress, tag, summary\n                ),\n                TorEvent::BootstrapComplete =\u003e {\n                    println!(\"Client Provider Bootstrap Complete!\");\n                    client_provider_bootstrap_complete = true;\n                }\n                TorEvent::LogReceived { line } =\u003e {\n                    println!(\"--- {}\", line);\n                }\n                _ =\u003e {}\n            }\n        }\n    }\n\n    // vanilla V3 onion service\n    {\n        let tor = \u0026mut server_provider;\n\n        // create an onion service for this test\n        let private_key = Ed25519PrivateKey::generate();\n\n        println!(\"Starting and listening to onion service\");\n        const VIRT_PORT: u16 = 42069u16;\n        let listener = tor.listener(\u0026private_key, VIRT_PORT, None)?;\n\n        let mut onion_published = false;\n        while !onion_published {\n            for event in tor.update()?.iter() {\n                match event {\n                    TorEvent::LogReceived { line } =\u003e {\n                        println!(\"--- {}\", line);\n                    }\n                    TorEvent::OnionServicePublished { service_id } =\u003e {\n                        let expected_service_id = V3OnionServiceId::from_private_key(\u0026private_key);\n                        if expected_service_id == *service_id {\n                            println!(\"Onion Service {} published\", service_id.to_string());\n                            onion_published = true;\n                        }\n                    }\n                    _ =\u003e {}\n                }\n            }\n        }\n\n        const MESSAGE: \u0026str = \"Hello World!\";\n\n        {\n            let tor = \u0026mut client_provider;\n            let service_id = V3OnionServiceId::from_private_key(\u0026private_key);\n\n            println!(\"Connecting to onion service\");\n            let mut attempt_count = 0;\n            let mut client = loop {\n                match tor.connect((service_id.clone(), VIRT_PORT).into(), None) {\n                    Ok(client) =\u003e break client,\n                    Err(err) =\u003e {\n                        println!(\"connect error: {:?}\", err);\n                        attempt_count += 1;\n                        if attempt_count == 3 {\n                            panic!(\"failed to connect :(\");\n                        }\n                    }\n                }\n            };\n            println!(\"Client writing message: '{}'\", MESSAGE);\n            client.write_all(MESSAGE.as_bytes())?;\n            client.flush()?;\n            println!(\"End of client scope\");\n        }\n\n        if let Some(mut server) = listener.accept()? {\n            println!(\"Server reading message\");\n            let mut buffer = Vec::new();\n            server.read_to_end(\u0026mut buffer)?;\n            let msg = String::from_utf8(buffer)?;\n\n            assert_eq!(MESSAGE, msg);\n            println!(\"Message received: '{}'\", msg);\n        } else {\n            panic!(\"no listener\");\n        }\n    }\n    Ok(())\n}\n\n#[allow(dead_code)]\npub(crate) fn authenticated_onion_service_test(\n    mut server_provider: Box\u003cdyn TorProvider\u003e,\n    mut client_provider: Box\u003cdyn TorProvider\u003e,\n) -\u003e anyhow::Result\u003c()\u003e {\n    server_provider.bootstrap()?;\n    client_provider.bootstrap()?;\n\n    let mut server_provider_bootstrap_complete = false;\n    let mut client_provider_bootstrap_complete = false;\n\n    while !server_provider_bootstrap_complete || !client_provider_bootstrap_complete {\n        for event in server_provider.update()?.iter() {\n            match event {\n                TorEvent::BootstrapStatus {\n                    progress,\n                    tag,\n                    summary,\n                } =\u003e println!(\n                    \"Server Provider BootstrapStatus: {{ progress: {}, tag: {}, summary: '{}' }}\",\n                    progress, tag, summary\n                ),\n                TorEvent::BootstrapComplete =\u003e {\n                    println!(\"Server Provider Bootstrap Complete!\");\n                    server_provider_bootstrap_complete = true;\n                }\n                TorEvent::LogReceived { line } =\u003e {\n                    println!(\"--- {}\", line);\n                }\n                _ =\u003e {}\n            }\n        }\n\n        for event in client_provider.update()?.iter() {\n            match event {\n                TorEvent::BootstrapStatus {\n                    progress,\n                    tag,\n                    summary,\n                } =\u003e println!(\n                    \"Client Provider BootstrapStatus: {{ progress: {}, tag: {}, summary: '{}' }}\",\n                    progress, tag, summary\n                ),\n                TorEvent::BootstrapComplete =\u003e {\n                    println!(\"Client Provider Bootstrap Complete!\");\n                    client_provider_bootstrap_complete = true;\n                }\n                TorEvent::LogReceived { line } =\u003e {\n                    println!(\"--- {}\", line);\n                }\n                _ =\u003e {}\n            }\n        }\n    }\n\n    // authenticated onion service\n    {\n        // create an onion service for this test\n        let private_key = Ed25519PrivateKey::generate();\n\n        let private_auth_key = X25519PrivateKey::generate();\n        let public_auth_key = X25519PublicKey::from_private_key(\u0026private_auth_key);\n\n        println!(\"Starting and listening to authenticated onion service\");\n        const VIRT_PORT: u16 = 42069u16;\n        let listener =\n            server_provider.listener(\u0026private_key, VIRT_PORT, Some(\u0026[public_auth_key]))?;\n\n        let mut onion_published = false;\n        while !onion_published {\n            for event in server_provider.update()?.iter() {\n                match event {\n                    TorEvent::LogReceived { line } =\u003e {\n                        println!(\"--- {}\", line);\n                    }\n                    TorEvent::OnionServicePublished { service_id } =\u003e {\n                        let expected_service_id = V3OnionServiceId::from_private_key(\u0026private_key);\n                        if expected_service_id == *service_id {\n                            println!(\n                                \"Authenticated Onion Service {} published\",\n                                service_id.to_string()\n                            );\n                            onion_published = true;\n                        }\n                    }\n                    _ =\u003e {}\n                }\n            }\n        }\n\n        const MESSAGE: \u0026str = \"Hello World!\";\n\n        {\n            let service_id = V3OnionServiceId::from_private_key(\u0026private_key);\n\n            println!(\"Connecting to onion service (should fail)\");\n            assert!(\n                client_provider\n                    .connect((service_id.clone(), VIRT_PORT).into(), None)\n                    .is_err(),\n                \"should not able to connect to an authenticated onion service without auth key\"\n            );\n\n            println!(\"Add auth key for onion service\");\n            client_provider.add_client_auth(\u0026service_id, \u0026private_auth_key)?;\n\n            println!(\"Connecting to onion service with authentication\");\n            let mut client =\n                client_provider.connect((service_id.clone(), VIRT_PORT).into(), None)?;\n\n            println!(\"Client writing message: '{}'\", MESSAGE);\n            client.write_all(MESSAGE.as_bytes())?;\n            client.flush()?;\n            println!(\"End of client scope\");\n\n            println!(\"Remove auth key for onion service\");\n            client_provider.remove_client_auth(\u0026service_id)?;\n        }\n\n        if let Some(mut server) = listener.accept()? {\n            println!(\"Server reading message\");\n            let mut buffer = Vec::new();\n            server.read_to_end(\u0026mut buffer)?;\n            let msg = String::from_utf8(buffer)?;\n\n            assert!(MESSAGE == msg);\n            println!(\"Message received: '{}'\", msg);\n        } else {\n            panic!(\"no listener\");\n        }\n    }\n    Ok(())\n}\n\n//\n// Mock TorProvider tests\n//\n\n#[test]\n#[cfg(feature = \"mock-tor-provider\")]\nfn test_mock_bootstrap() -\u003e anyhow::Result\u003c()\u003e {\n    bootstrap_test(Box::new(MockTorClient::new()))\n}\n\n#[test]\n#[cfg(feature = \"mock-tor-provider\")]\nfn test_mock_onion_service() -\u003e anyhow::Result\u003c()\u003e {\n    let server_provider = Box::new(MockTorClient::new());\n    let client_provider = Box::new(MockTorClient::new());\n    basic_onion_service_test(server_provider, client_provider)\n}\n\n#[test]\n#[cfg(feature = \"mock-tor-provider\")]\nfn test_mock_authenticated_onion_service() -\u003e anyhow::Result\u003c()\u003e {\n    let server_provider = Box::new(MockTorClient::new());\n    let client_provider = Box::new(MockTorClient::new());\n    authenticated_onion_service_test(server_provider, client_provider)\n}\n\n//\n// Legacy TorProvider tests\n//\n\n#[test]\n#[serial]\n#[cfg(feature = \"legacy-tor-provider\")]\nfn test_legacy_bootstrap() -\u003e anyhow::Result\u003c()\u003e {\n    let tor_path = which::which(format!(\"tor{}\", std::env::consts::EXE_SUFFIX))?;\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_legacy_bootstrap\");\n\n    let tor_config = LegacyTorClientConfig::BundledTor {\n        tor_bin_path: tor_path,\n        data_directory: data_path,\n        proxy_settings: None,\n        allowed_ports: None,\n        pluggable_transports: None,\n        bridge_lines: None,\n    };\n\n    bootstrap_test(Box::new(LegacyTorClient::new(tor_config)?))\n}\n\n#[test]\n#[serial]\n#[cfg(feature = \"legacy-tor-provider\")]\nfn test_legacy_pluggable_transport_bootstrap() -\u003e anyhow::Result\u003c()\u003e {\n    let tor_path = which::which(format!(\"tor{}\", std::env::consts::EXE_SUFFIX))?;\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_legacy_pluggable_transport_bootstrap\");\n\n    // find the lyrebird bin\n    let teb_path = std::env::var(\"TEB_PATH\")?;\n    if teb_path.is_empty() {\n        println!(\"TEB_PATH environment variable empty, so skipping test_legacy_pluggable_transport_bootstrap()\");\n        return Ok(());\n    }\n    let mut lyrebird_path = std::path::PathBuf::from(\u0026teb_path);\n    let lyrebird_bin = format!(\"lyrebird{}\", std::env::consts::EXE_SUFFIX);\n    lyrebird_path.push(lyrebird_bin.clone());\n    assert!(std::path::Path::exists(\u0026lyrebird_path));\n    assert!(std::path::Path::is_file(\u0026lyrebird_path));\n\n    // configure lyrebird pluggable transport\n    let pluggable_transport =\n        PluggableTransportConfig::new(vec![\"obfs4\".to_string()], lyrebird_path)?;\n\n    // obfs4 bridgeline\n    let bridge_line = BridgeLine::from_str(\"obfs4 207.172.185.193:22223 F34AC0CDBC06918E54292A474578C99834A58893 cert=MjqosoyVylLQuLo4LH+eQ5hS7Z44s2CaMfQbIjJtn4bGRnvLv8ldSvSED5JpvWSxm09XXg iat-mode=0\")?;\n\n    let tor_config = LegacyTorClientConfig::BundledTor {\n        tor_bin_path: tor_path,\n        data_directory: data_path,\n        proxy_settings: None,\n        allowed_ports: None,\n        pluggable_transports: Some(vec![pluggable_transport]),\n        bridge_lines: Some(vec![bridge_line]),\n    };\n\n    bootstrap_test(Box::new(LegacyTorClient::new(tor_config)?))\n}\n\n#[test]\n#[serial]\n#[cfg(feature = \"legacy-tor-provider\")]\nfn test_legacy_onion_service() -\u003e anyhow::Result\u003c()\u003e {\n    let tor_path = which::which(format!(\"tor{}\", std::env::consts::EXE_SUFFIX))?;\n\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_legacy_onion_service_server\");\n    let tor_config = LegacyTorClientConfig::BundledTor {\n        tor_bin_path: tor_path.clone(),\n        data_directory: data_path,\n        proxy_settings: None,\n        allowed_ports: None,\n        pluggable_transports: None,\n        bridge_lines: None,\n    };\n    let server_provider = Box::new(LegacyTorClient::new(tor_config)?);\n\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_legacy_onion_service_cient\");\n    let tor_config = LegacyTorClientConfig::BundledTor {\n        tor_bin_path: tor_path,\n        data_directory: data_path,\n        proxy_settings: None,\n        allowed_ports: None,\n        pluggable_transports: None,\n        bridge_lines: None,\n    };\n    let client_provider = Box::new(LegacyTorClient::new(tor_config)?);\n\n    basic_onion_service_test(server_provider, client_provider)\n}\n\n#[test]\n#[serial]\n#[cfg(feature = \"legacy-tor-provider\")]\nfn test_legacy_authenticated_onion_service() -\u003e anyhow::Result\u003c()\u003e {\n    let tor_path = which::which(format!(\"tor{}\", std::env::consts::EXE_SUFFIX))?;\n\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_legacy_authenticated_onion_service_server\");\n    let tor_config = LegacyTorClientConfig::BundledTor {\n        tor_bin_path: tor_path.clone(),\n        data_directory: data_path,\n        proxy_settings: None,\n        allowed_ports: None,\n        pluggable_transports: None,\n        bridge_lines: None,\n    };\n    let server_provider = Box::new(LegacyTorClient::new(tor_config)?);\n\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_legacy_authenticated_onion_service_cient\");\n    let tor_config = LegacyTorClientConfig::BundledTor {\n        tor_bin_path: tor_path,\n        data_directory: data_path,\n        proxy_settings: None,\n        allowed_ports: None,\n        pluggable_transports: None,\n        bridge_lines: None,\n    };\n    let client_provider = Box::new(LegacyTorClient::new(tor_config)?);\n\n    authenticated_onion_service_test(server_provider, client_provider)\n}\n\n//\n// System Legacy TorProvider tests\n//\n\n#[cfg(test)]\n#[cfg(feature = \"legacy-tor-provider\")]\nfn start_system_tor_daemon(\n    tor_path: \u0026std::ffi::OsStr,\n    name: \u0026str,\n    control_port: u16,\n    socks_port: u16,\n) -\u003e anyhow::Result\u003cChild\u003e {\n    let mut data_path = std::env::temp_dir();\n    data_path.push(name);\n    std::fs::create_dir_all(\u0026data_path)?;\n    let default_torrc = data_path.join(\"default_torrc\");\n    {\n        let _ = File::create(\u0026default_torrc)?;\n    }\n    let torrc = data_path.join(\"torrc\");\n    {\n        let _ = File::create(\u0026torrc)?;\n    }\n\n    let tor_daemon = Command::new(tor_path)\n        .stdout(Stdio::null())\n        .stdin(Stdio::null())\n        .stderr(Stdio::null())\n        // point to our above written torrc file\n        .arg(\"--defaults-torrc\")\n        .arg(default_torrc)\n        // location of torrc\n        .arg(\"--torrc-file\")\n        .arg(torrc)\n        // enable networking\n        .arg(\"DisableNetwork\")\n        .arg(\"0\")\n        // root data directory\n        .arg(\"DataDirectory\")\n        .arg(data_path)\n        // daemon will assign us a port, and we will\n        // read it from the control port file\n        .arg(\"ControlPort\")\n        .arg(control_port.to_string())\n        // password: foobar1\n        .arg(\"HashedControlPassword\")\n        .arg(\"16:E807DCE69AFE9979600760C9758B95ADB2F95E8740478AEA5356C95358\")\n        // socks port\n        .arg(\"SocksPort\")\n        .arg(socks_port.to_string())\n        // tor process will shut down after this process shuts down\n        // to avoid orphaned tor daemon\n        .arg(\"__OwningControllerProcess\")\n        .arg(process::id().to_string())\n        .spawn()?;\n\n    Ok(tor_daemon)\n}\n\n#[test]\n#[serial]\n#[cfg(feature = \"legacy-tor-provider\")]\nfn test_system_legacy_onion_service() -\u003e anyhow::Result\u003c()\u003e {\n    let tor_path = which::which(format!(\"tor{}\", std::env::consts::EXE_SUFFIX))?;\n\n    let mut server_tor_daemon = start_system_tor_daemon(\n        tor_path.as_os_str(),\n        \"test_system_legacy_onion_service_server\",\n        9251u16,\n        9250u16,\n    )?;\n    let mut client_tor_daemon = start_system_tor_daemon(\n        tor_path.as_os_str(),\n        \"test_system_legacy_onion_service_client\",\n        9351u16,\n        9350u16,\n    )?;\n\n    // give daemons time to start\n    std::thread::sleep(std::time::Duration::from_secs(5));\n\n    let tor_config = LegacyTorClientConfig::SystemTor {\n        tor_socks_addr: std::net::SocketAddr::from_str(\"127.0.0.1:9250\")?,\n        tor_control_addr: std::net::SocketAddr::from_str(\"127.0.0.1:9251\")?,\n        tor_control_passwd: \"password\".to_string(),\n    };\n    let server_provider = Box::new(LegacyTorClient::new(tor_config)?);\n\n    let tor_config = LegacyTorClientConfig::SystemTor {\n        tor_socks_addr: std::net::SocketAddr::from_str(\"127.0.0.1:9350\")?,\n        tor_control_addr: std::net::SocketAddr::from_str(\"127.0.0.1:9351\")?,\n        tor_control_passwd: \"password\".to_string(),\n    };\n    let client_provider = Box::new(LegacyTorClient::new(tor_config)?);\n\n    basic_onion_service_test(server_provider, client_provider)?;\n\n    server_tor_daemon.kill()?;\n    client_tor_daemon.kill()?;\n\n    Ok(())\n}\n\n#[test]\n#[serial]\n#[cfg(feature = \"legacy-tor-provider\")]\nfn test_system_legacy_authenticated_onion_service() -\u003e anyhow::Result\u003c()\u003e {\n    let tor_path = which::which(format!(\"tor{}\", std::env::consts::EXE_SUFFIX))?;\n\n    let mut server_tor_daemon = start_system_tor_daemon(\n        tor_path.as_os_str(),\n        \"test_system_legacy_authenticated_onion_service_server\",\n        9251u16,\n        9250u16,\n    )?;\n    let mut client_tor_daemon = start_system_tor_daemon(\n        tor_path.as_os_str(),\n        \"test_system_legacy_authenticated_onion_service_client\",\n        9351u16,\n        9350u16,\n    )?;\n\n    // give daemons time to start\n    std::thread::sleep(std::time::Duration::from_secs(5));\n\n    let tor_config = LegacyTorClientConfig::SystemTor {\n        tor_socks_addr: std::net::SocketAddr::from_str(\"127.0.0.1:9250\")?,\n        tor_control_addr: std::net::SocketAddr::from_str(\"127.0.0.1:9251\")?,\n        tor_control_passwd: \"password\".to_string(),\n    };\n    let server_provider = Box::new(LegacyTorClient::new(tor_config)?);\n\n    let tor_config = LegacyTorClientConfig::SystemTor {\n        tor_socks_addr: std::net::SocketAddr::from_str(\"127.0.0.1:9350\")?,\n        tor_control_addr: std::net::SocketAddr::from_str(\"127.0.0.1:9351\")?,\n        tor_control_passwd: \"password\".to_string(),\n    };\n    let client_provider = Box::new(LegacyTorClient::new(tor_config)?);\n\n    authenticated_onion_service_test(server_provider, client_provider)?;\n\n    server_tor_daemon.kill()?;\n    client_tor_daemon.kill()?;\n\n    Ok(())\n}\n\n//\n// Arti TorProvider tests\n//\n\n#[test]\n#[serial]\n#[cfg(feature = \"arti-client-tor-provider\")]\nfn test_arti_client_bootstrap() -\u003e anyhow::Result\u003c()\u003e {\n    let runtime: Arc\u003cruntime::Runtime\u003e = Arc::new(runtime::Runtime::new().unwrap());\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_arti_bootstrap\");\n    let tor_provider = Box::new(ArtiClientTorClient::new(runtime, \u0026data_path).unwrap());\n\n    bootstrap_test(tor_provider)\n}\n\n#[test]\n#[cfg(feature = \"arti-client-tor-provider\")]\nfn test_arti_client_onion_service() -\u003e anyhow::Result\u003c()\u003e {\n    let runtime: Arc\u003cruntime::Runtime\u003e = Arc::new(runtime::Runtime::new().unwrap());\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_arti_basic_onion_service_server\");\n    let server_provider = Box::new(ArtiClientTorClient::new(runtime.clone(), \u0026data_path).unwrap());\n\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_arti_basic_onion_service_client\");\n    let client_provider = Box::new(ArtiClientTorClient::new(runtime.clone(), \u0026data_path).unwrap());\n\n    basic_onion_service_test(server_provider, client_provider)\n}\n\n/*\nTODO: re-enable once client-auth is available in arti\n#[test]\n#[serial]\n#[cfg(feature = \"arti-client-tor-provider\")]\nfn test_arti_authenticated_onion_service() -\u003e anyhow::Result\u003c()\u003e {\n    let runtime: Arc\u003cruntime::Runtime\u003e = Arc::new(runtime::Runtime::new().unwrap());\n\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_arti_basic_onion_service_server\");\n    let server_provider = Box::new(ArtiClientTorClient::new(runtime.clone(), \u0026data_path).unwrap());\n\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_arti_basic_onion_service_client\");\n    let client_provider = Box::new(ArtiClientTorClient::new(runtime.clone(), \u0026data_path).unwrap());\n\n    authenticated_onion_service_test(server_provider, client_provider)\n}\n*/\n\n//\n// Mixed Arti/Legacy TorProvider tests\n//\n\n#[test]\n#[serial]\n#[cfg(all(feature = \"arti-client-tor-provider\", feature = \"legacy-tor-provider\"))]\nfn test_mixed_arti_client_legacy_onion_service() -\u003e anyhow::Result\u003c()\u003e {\n    let runtime: Arc\u003cruntime::Runtime\u003e = Arc::new(runtime::Runtime::new().unwrap());\n\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_arti_legacy_basic_onion_service_server\");\n    let server_provider = Box::new(ArtiClientTorClient::new(runtime, \u0026data_path)?);\n\n    let tor_path = which::which(format!(\"tor{}\", std::env::consts::EXE_SUFFIX))?;\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_arti_legacy_basic_onion_service_client\");\n    let tor_config = LegacyTorClientConfig::BundledTor {\n        tor_bin_path: tor_path,\n        data_directory: data_path,\n        proxy_settings: None,\n        allowed_ports: None,\n        pluggable_transports: None,\n        bridge_lines: None,\n    };\n    let client_provider = Box::new(LegacyTorClient::new(tor_config)?);\n\n    basic_onion_service_test(server_provider, client_provider)\n}\n\n#[test]\n#[serial]\n#[cfg(all(feature = \"arti-client-tor-provider\", feature = \"legacy-tor-provider\"))]\nfn test_mixed_legacy_arti_client_onion_service() -\u003e anyhow::Result\u003c()\u003e {\n    let tor_path = which::which(format!(\"tor{}\", std::env::consts::EXE_SUFFIX))?;\n\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_legacy_arty_basic_onion_service_client\");\n    let tor_config = LegacyTorClientConfig::BundledTor {\n        tor_bin_path: tor_path,\n        data_directory: data_path,\n        proxy_settings: None,\n        allowed_ports: None,\n        pluggable_transports: None,\n        bridge_lines: None,\n    };\n    let server_provider = Box::new(LegacyTorClient::new(tor_config)?);\n\n    let runtime: Arc\u003cruntime::Runtime\u003e = Arc::new(runtime::Runtime::new().unwrap());\n\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_legacy_arti_basic_onion_service_server\");\n    let client_provider = Box::new(ArtiClientTorClient::new(runtime, \u0026data_path)?);\n\n    basic_onion_service_test(server_provider, client_provider)\n}\n\n//\n// Misc Utils\n//\n\n#[test]\nfn test_tor_provider_target_addr() -\u003e anyhow::Result\u003c()\u003e {\n    let valid_ip_addr: \u0026[\u0026str] = \u0026[\n        \"192.168.1.1:80\",\n        \"10.0.0.1:443\",\n        \"172.16.0.1:8080\",\n        \"8.8.8.8:53\",\n        \"255.255.255.255:65535\",\n        \"0.0.0.0:22\",\n        \"192.168.0.254:21\",\n        \"127.0.0.1:3306\",\n        \"1.1.1.1:123\",\n        \"224.0.0.1:554\",\n        \"169.254.0.1:179\",\n        \"203.0.113.1:80\",\n        \"198.51.100.1:443\",\n        \"100.64.0.1:8080\",\n        \"192.0.2.1:53\",\n        \"192.88.99.1:22\",\n        \"192.0.0.1:21\",\n        \"240.0.0.1:3306\",\n        \"198.18.0.1:123\",\n        \"233.252.0.1:554\",\n        \"[2001:0db8:85a3:0000:0000:8a2e:0370:7334]:80\",\n        \"[2001:db8:85a3::8a2e:370:7334]:443\",\n        \"[::1]:8080\",\n        \"[::ffff:192.168.1.1]:53\",\n        \"[2001:0db8::1]:22\",\n        \"[fe80::1ff:fe23:4567:890a]:21\",\n        \"[2001:db8::1:0:0:1]:3306\",\n        \"[2001:0db8:0000:0042:0000:8a2e:0370:7334]:123\",\n        \"[ff02::1]:554\",\n        \"[fe80::abcd:ef01:2345:6789]:179\",\n        \"[2001:0db8:85a3:0000:0000:8a2e:0370:7334]:80\",\n        \"[2001:db8:85a3::8a2e:370:7334]:443\",\n        \"[::1]:8080\",\n        \"[::ffff:c0a8:101]:53\",\n        \"[2001:db8::1:0:0:1]:22\",\n        \"[fe80::1ff:fe23:4567:890a]:21\",\n        \"[2001:db8:0000:0042:0000:8a2e:0370:7334]:3306\",\n        \"[ff02::1]:123\",\n        \"[fe80::abcd:ef01:2345:6789]:554\",\n        \"[2001:db8::1]:179\",\n    ];\n\n    for target_addr_str in valid_ip_addr {\n        match TargetAddr::from_str(target_addr_str) {\n            Ok(TargetAddr::Socket(socket_addr)) =\u003e println!(\"{} =\u003e {}\", target_addr_str, socket_addr),\n            Ok(TargetAddr::OnionService(onion_addr)) =\u003e panic!(\n                \"unexpected conversion: {} =\u003e OnionService({})\",\n                target_addr_str, onion_addr\n            ),\n            Ok(TargetAddr::Domain(domain_addr)) =\u003e panic!(\n                \"unexpected conversion: {} =\u003e DomainAddr({})\",\n                target_addr_str, domain_addr\n            ),\n            Err(err) =\u003e Err(err)?,\n        }\n    }\n\n    let valid_onion_addr: \u0026[\u0026str] = \u0026[\n        \"6l62fw7tqctlu5fesdqukvpoxezkaxbzllrafa2ve6ewuhzphxczsjyd.onion:65535\",\n        \"6L62FW7TQCTLU5FESDQUKVPOXEZKAXBZLLRAFA2VE6EWUHZPHXCZSJYD.onion:1\",\n    ];\n\n    for target_addr_str in valid_onion_addr {\n        match TargetAddr::from_str(target_addr_str) {\n            Ok(TargetAddr::Socket(socket_addr)) =\u003e panic!(\n                \"unexpected conversion: {} =\u003e Ip({})\",\n                target_addr_str, socket_addr\n            ),\n            Ok(TargetAddr::OnionService(onion_addr)) =\u003e {\n                println!(\"{} =\u003e {}\", target_addr_str, onion_addr)\n            }\n            Ok(TargetAddr::Domain(domain_addr)) =\u003e panic!(\n                \"unexpected conversion: {} =\u003e DomainAddr({})\",\n                target_addr_str, domain_addr\n            ),\n            Err(err) =\u003e Err(err)?,\n        }\n    }\n\n    let valid_domain_addr: \u0026[\u0026str] = \u0026[\n        \"example.com:80\",\n        \"subdomain.example.com:443\",\n        \"xn--e1afmkfd.xn--p1ai:8080\",       // domain in Punycode for \"пример.рф\"\n        \"xn--fsqu00a.xn--0zwm56d:53\",       // domain in Punycode for \"例子.测试\"\n        \"münich.com:22\",                    // domain with UTF-8 characters\n        \"xn--mnich-kva.com:21\",             // Punycode for \"münich.com\"\n        \"exämple.com:3306\",                 // domain with UTF-8 characters\n        \"xn--exmple-cua.com:123\",           // Punycode for \"exämple.com\"\n        \"例子.com:554\",                      // domain with UTF-8 characters\n        \"xn--fsqu00a.com:179\",              // Punycode for \"例子.com\"\n        \"täst.de:80\",                       // domain with UTF-8 characters\n        \"xn--tst-qla.de:443\",               // Punycode for \"täst.de\"\n        \"xn--fiqs8s:80\",                    // Punycode for \"中国\"\n        \"xn--wgbh1c:8080\",                  // Punycode for \"مصر\"\n        \"münster.de:22\",                    // domain with UTF-8 characters\n        \"xn--mnster-3ya.de:21\",             // Punycode for \"münster.de\"\n        \"bücher.com:3306\",                  // domain with UTF-8 characters\n        \"xn--bcher-kva.com:123\",            // Punycode for \"bücher.com\"\n        \"xn--vermgensberatung-pwb.com:554\", // Punycode for \"vermögensberatung.com\"\n        // Max Length\n        \"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb.ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc.ddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd:65535\"\n    ];\n\n    for target_addr_str in valid_domain_addr {\n        match TargetAddr::from_str(target_addr_str) {\n            Ok(TargetAddr::Socket(socket_addr)) =\u003e panic!(\n                \"unexpected conversion: {} =\u003e SocketAddr({})\",\n                target_addr_str, socket_addr\n            ),\n            Ok(TargetAddr::OnionService(onion_addr)) =\u003e panic!(\n                \"unexpected conversion: {} =\u003e OnionService({})\",\n                target_addr_str, onion_addr\n            ),\n            Ok(TargetAddr::Domain(domain_addr)) =\u003e {\n                println!(\"{} =\u003e {}\", target_addr_str, domain_addr)\n            }\n            Err(err) =\u003e Err(err)?,\n        }\n    }\n\n    let invalid_target_addr: \u0026[\u0026str] = \u0026[\n        // ipv4-ish\n        \"192.168.1.1:99999\", // Port number out of range\n        \"192.168.1.1:abc\",   // Invalid port number\n        \"192.168.1.1:\",      // Missing port number\n        \"192.168.1.1: 80\",   // Space in port number\n        \"192.168.1.1:80a\",   // Non-numeric characters in port number\n        // ipv6-ish\n        \"[2001:db8:::1]:80\",                            // Triple colons\n        \"[2001:db8:85a3::8a2e:370:7334:1234::abcd]:80\", // Too many groups\n        \"[2001:db8:85a3::8a2e:370g:7334]:80\",           // Invalid character in group\n        \"[2001:db8:85a3::8a2e:370:7334]:99999\",         // Port number out of range\n        \"[2001:db8:85a3:8a2e:370:7334]:80\",             // Missing double colons\n        \"[::12345]:80\",                                 // Excessive leading zeroes\n        \"[2001:db8:85a3::8a2e:370:7334:]:80\",           // Trailing colon\n        \"[2001:db8:85a3::8a2e:370:7334]\",               // Missing port number\n        \"2001:db8:85a3::8a2e:370:7334:80\",              // Missing square brackets\n        \"[2001:db8:85a3::8a2e:370:7334]: 80\",           // Space in port number\n        \"[2001:db8:85a3::8a2e:370:7334]:80a\",           // Non-numeric characters in port number\n        // onion service-ish\n        \"6l62fw7tqctlu5fesdqukvpoxezkaxbzllrafa2ve6ewuhzphxczsjyd234567.onion:80\", // Too long for v3\n        \"6l62fw7tqctlu5fesdqukvpoxezkaxbzllrafa2ve6ewuhzphxcz.onion:443\", // Too short for v3\n        \"6l62fw7tqctlu5fesdqukvpoxezkaxbzllrafa2ve6ewuhzphxczsjyd.onion:99999\", // Port number out of range\n        \"abcdefghijklmnopqrstuvwxyz0123456789abcdefghijklmnopqrst.onion:21\", // Invalid characters\n        \"6l62fw7tqctlu5fesdqukvpoxezkaxbzllrafa2ve6ewuhzphxczsjyd.onion:abc\", // Invalid port number\n        \"6l62fw7tqctlu5fesdqukvpoxezkaxbzllrafa2ve6ewuhzphxczsjyd.onion: 80\", // Space in port number\n        \"6l62fw7tqctlu5fesdqukvpoxezkaxbzllrafa2ve6ewuhzphxczsjyd.onion:80a\", // Non-numeric characters in port number\n        \"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.onion:80\",  // Invalid service id\n        // domain-ish\n        \"example..com:80\",        // Double dots\n        \"exa mple.com:53\",        // Space in domain\n        \"example.com:99999\",      // Port number out of range\n        \"exaample.com:abc\",       // Invalid port number\n        \"exaample.com:\",          // Missing port number\n        \"exaample.com: 80\",       // Space in port number\n        \"ex@mple.com:80\",         // Special character in domain\n        \"example.com:80a\",        // Non-numeric characters in port number\n        \"exämple..com:80\",        // UTF-8 with double dot\n        \"xn--exmple-cua.com: 80\", // Punycode with space in port number\n        \"xn--exmple-cua.com:80a\", // Punycode with non-numeric port\n        \"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.com:65535\", // Label too long\n    ];\n\n    for target_addr_str in invalid_target_addr {\n        match TargetAddr::from_str(target_addr_str) {\n            Ok(TargetAddr::Socket(socket_addr)) =\u003e panic!(\n                \"unexpected conversion: {} =\u003e SocketAddr({})\",\n                target_addr_str, socket_addr\n            ),\n            Ok(TargetAddr::OnionService(onion_addr)) =\u003e panic!(\n                \"unexpected conversion: {} =\u003e OnionService({})\",\n                target_addr_str, onion_addr\n            ),\n            Ok(TargetAddr::Domain(domain_addr)) =\u003e panic!(\n                \"unexpected conversion: {} =\u003e DomainAddr({})\",\n                target_addr_str, domain_addr\n            ),\n            Err(_) =\u003e (),\n        }\n    }\n\n    Ok(())\n}\n","traces":[{"line":31,"address":[1476176,1477844,1477713],"length":1,"stats":{"Line":1}},{"line":32,"address":[1476332,1477837,1476272,1476183,1476948],"length":1,"stats":{"Line":2}},{"line":34,"address":[1476314],"length":1,"stats":{"Line":1}},{"line":35,"address":[1476322],"length":1,"stats":{"Line":1}},{"line":36,"address":[1476410,1476330],"length":1,"stats":{"Line":2}},{"line":37,"address":[1476420,1477727,1476744,1476481,1476898],"length":1,"stats":{"Line":4}},{"line":38,"address":[1476919],"length":1,"stats":{"Line":1}},{"line":39,"address":[1476955],"length":1,"stats":{"Line":1}},{"line":47,"address":[1477634],"length":1,"stats":{"Line":1}},{"line":48,"address":[1477112,1477607],"length":1,"stats":{"Line":2}},{"line":49,"address":[1477626],"length":1,"stats":{"Line":1}},{"line":51,"address":[1477146],"length":1,"stats":{"Line":1}},{"line":52,"address":[1477158],"length":1,"stats":{"Line":1}},{"line":53,"address":[1477639],"length":1,"stats":{"Line":1}},{"line":59,"address":[1476446],"length":1,"stats":{"Line":1}},{"line":64,"address":[1477770],"length":1,"stats":{"Line":1}},{"line":68,"address":[1480298,1477872,1486250],"length":1,"stats":{"Line":1}},{"line":72,"address":[1478030,1479535,1486219,1477926,1478104],"length":1,"stats":{"Line":2}},{"line":73,"address":[1478261,1486198,1478072,1478201],"length":1,"stats":{"Line":2}},{"line":75,"address":[1478243],"length":1,"stats":{"Line":1}},{"line":76,"address":[1478251],"length":1,"stats":{"Line":1}},{"line":78,"address":[1478384,1478342,1478259],"length":1,"stats":{"Line":3}},{"line":79,"address":[1478448,1478726,1478907,1481110,1478352],"length":1,"stats":{"Line":4}},{"line":80,"address":[1478931],"length":1,"stats":{"Line":1}},{"line":81,"address":[1480890],"length":1,"stats":{"Line":1}},{"line":89,"address":[1481023],"length":1,"stats":{"Line":1}},{"line":90,"address":[1480996,1480506],"length":1,"stats":{"Line":2}},{"line":91,"address":[1481015],"length":1,"stats":{"Line":1}},{"line":93,"address":[1480543],"length":1,"stats":{"Line":1}},{"line":94,"address":[1481028],"length":1,"stats":{"Line":1}},{"line":100,"address":[1479476,1478966,1480315,1479292],"length":1,"stats":{"Line":3}},{"line":101,"address":[1479500],"length":1,"stats":{"Line":1}},{"line":102,"address":[1479560],"length":1,"stats":{"Line":1}},{"line":110,"address":[1480219],"length":1,"stats":{"Line":1}},{"line":111,"address":[1479702,1480192],"length":1,"stats":{"Line":2}},{"line":112,"address":[1480211],"length":1,"stats":{"Line":1}},{"line":114,"address":[1479739],"length":1,"stats":{"Line":1}},{"line":115,"address":[1480224],"length":1,"stats":{"Line":1}},{"line":124,"address":[1478402],"length":1,"stats":{"Line":1}},{"line":127,"address":[1478410],"length":1,"stats":{"Line":1}},{"line":129,"address":[1481123,1481193],"length":1,"stats":{"Line":2}},{"line":131,"address":[1481395,1481212,1486177],"length":1,"stats":{"Line":1}},{"line":133,"address":[1481385],"length":1,"stats":{"Line":1}},{"line":134,"address":[1481476,1481393],"length":1,"stats":{"Line":2}},{"line":135,"address":[1481902,1481486,1482750,1482086,1481624],"length":1,"stats":{"Line":4}},{"line":136,"address":[1482110],"length":1,"stats":{"Line":1}},{"line":137,"address":[1482160],"length":1,"stats":{"Line":0}},{"line":138,"address":[1482338],"length":1,"stats":{"Line":0}},{"line":140,"address":[1482292],"length":1,"stats":{"Line":1}},{"line":141,"address":[1482311],"length":1,"stats":{"Line":1}},{"line":142,"address":[1482428,1482737],"length":1,"stats":{"Line":2}},{"line":143,"address":[1482597,1482466],"length":1,"stats":{"Line":1}},{"line":144,"address":[1482729],"length":1,"stats":{"Line":1}},{"line":155,"address":[1481526],"length":1,"stats":{"Line":1}},{"line":156,"address":[1481534],"length":1,"stats":{"Line":1}},{"line":158,"address":[1482780],"length":1,"stats":{"Line":1}},{"line":159,"address":[1482825],"length":1,"stats":{"Line":1}},{"line":161,"address":[1482836],"length":1,"stats":{"Line":1}},{"line":162,"address":[1483087],"length":1,"stats":{"Line":1}},{"line":163,"address":[1483251],"length":1,"stats":{"Line":1}},{"line":164,"address":[1485961],"length":1,"stats":{"Line":1}},{"line":165,"address":[1486030,1486071],"length":1,"stats":{"Line":1}},{"line":166,"address":[1486059],"length":1,"stats":{"Line":1}},{"line":167,"address":[1486092,1486140],"length":1,"stats":{"Line":0}},{"line":172,"address":[1483436],"length":1,"stats":{"Line":1}},{"line":173,"address":[1483655,1483532,1485885],"length":1,"stats":{"Line":1}},{"line":174,"address":[1483631,1483698,1477894,1483782,1485850],"length":1,"stats":{"Line":3}},{"line":175,"address":[1483820,1483756],"length":1,"stats":{"Line":2}},{"line":178,"address":[1483858,1485752],"length":1,"stats":{"Line":1}},{"line":179,"address":[1484298,1484199],"length":1,"stats":{"Line":2}},{"line":180,"address":[1484317],"length":1,"stats":{"Line":1}},{"line":181,"address":[1484432,1484569,1484336,1485512],"length":1,"stats":{"Line":2}},{"line":182,"address":[1485487,1484506,1484775,1484607],"length":1,"stats":{"Line":2}},{"line":184,"address":[1484733,1484901],"length":1,"stats":{"Line":2}},{"line":185,"address":[1485086],"length":1,"stats":{"Line":1}},{"line":187,"address":[1484225,1485641],"length":1,"stats":{"Line":0}},{"line":190,"address":[1485386],"length":1,"stats":{"Line":1}},{"line":194,"address":[1488682,1486272,1495500],"length":1,"stats":{"Line":1}},{"line":198,"address":[1487919,1486504,1486430,1486326,1495469],"length":1,"stats":{"Line":2}},{"line":199,"address":[1495448,1486661,1486472,1486601],"length":1,"stats":{"Line":2}},{"line":201,"address":[1486643],"length":1,"stats":{"Line":1}},{"line":202,"address":[1486651],"length":1,"stats":{"Line":1}},{"line":204,"address":[1486659,1486784,1486742],"length":1,"stats":{"Line":3}},{"line":205,"address":[1486752,1486832,1487110,1487291,1489494],"length":1,"stats":{"Line":4}},{"line":206,"address":[1487315],"length":1,"stats":{"Line":1}},{"line":207,"address":[1488748],"length":1,"stats":{"Line":1}},{"line":215,"address":[1489407],"length":1,"stats":{"Line":1}},{"line":216,"address":[1489380,1488890],"length":1,"stats":{"Line":2}},{"line":217,"address":[1489399],"length":1,"stats":{"Line":1}},{"line":219,"address":[1488927],"length":1,"stats":{"Line":1}},{"line":220,"address":[1489412],"length":1,"stats":{"Line":1}},{"line":226,"address":[1488699,1487350,1487676,1487860],"length":1,"stats":{"Line":3}},{"line":227,"address":[1487884],"length":1,"stats":{"Line":1}},{"line":228,"address":[1487944],"length":1,"stats":{"Line":1}},{"line":236,"address":[1488603],"length":1,"stats":{"Line":1}},{"line":237,"address":[1488576,1488086],"length":1,"stats":{"Line":2}},{"line":238,"address":[1488595],"length":1,"stats":{"Line":1}},{"line":240,"address":[1488123],"length":1,"stats":{"Line":1}},{"line":241,"address":[1488608],"length":1,"stats":{"Line":1}},{"line":251,"address":[1486794],"length":1,"stats":{"Line":1}},{"line":253,"address":[1489507],"length":1,"stats":{"Line":1}},{"line":254,"address":[1489570],"length":1,"stats":{"Line":1}},{"line":256,"address":[1489638],"length":1,"stats":{"Line":1}},{"line":258,"address":[1489683,1489914,1495408],"length":1,"stats":{"Line":1}},{"line":261,"address":[1489904],"length":1,"stats":{"Line":1}},{"line":262,"address":[1489912,1489995],"length":1,"stats":{"Line":2}},{"line":263,"address":[1490005,1490405,1490127,1491253,1490589],"length":1,"stats":{"Line":4}},{"line":264,"address":[1490613],"length":1,"stats":{"Line":1}},{"line":265,"address":[1490663],"length":1,"stats":{"Line":0}},{"line":266,"address":[1490841],"length":1,"stats":{"Line":0}},{"line":268,"address":[1490795],"length":1,"stats":{"Line":1}},{"line":269,"address":[1490814],"length":1,"stats":{"Line":1}},{"line":270,"address":[1491240,1490931],"length":1,"stats":{"Line":2}},{"line":271,"address":[1490969],"length":1,"stats":{"Line":1}},{"line":275,"address":[1491232],"length":1,"stats":{"Line":1}},{"line":286,"address":[1490037],"length":1,"stats":{"Line":1}},{"line":288,"address":[1491283],"length":1,"stats":{"Line":1}},{"line":289,"address":[1491376],"length":1,"stats":{"Line":1}},{"line":296,"address":[1491714],"length":1,"stats":{"Line":1}},{"line":297,"address":[1491891,1495368,1491759],"length":1,"stats":{"Line":1}},{"line":299,"address":[1491972,1491865],"length":1,"stats":{"Line":2}},{"line":300,"address":[1492432,1495347,1491991],"length":1,"stats":{"Line":1}},{"line":303,"address":[1492557],"length":1,"stats":{"Line":1}},{"line":304,"address":[1492776,1495329,1492653],"length":1,"stats":{"Line":1}},{"line":305,"address":[1492752,1492819,1492903,1495314],"length":1,"stats":{"Line":2}},{"line":306,"address":[1492877,1492941],"length":1,"stats":{"Line":2}},{"line":308,"address":[1492960],"length":1,"stats":{"Line":1}},{"line":309,"address":[1486294,1493005,1495279,1493122],"length":1,"stats":{"Line":2}},{"line":312,"address":[1493200,1495121],"length":1,"stats":{"Line":1}},{"line":313,"address":[1493640,1493541],"length":1,"stats":{"Line":2}},{"line":314,"address":[1493659],"length":1,"stats":{"Line":1}},{"line":315,"address":[1494862,1493911,1493678,1493774],"length":1,"stats":{"Line":2}},{"line":316,"address":[1493848,1494837,1493949,1494101],"length":1,"stats":{"Line":2}},{"line":318,"address":[1494227,1494075],"length":1,"stats":{"Line":2}},{"line":319,"address":[1494376],"length":1,"stats":{"Line":1}},{"line":321,"address":[1495010,1493567],"length":1,"stats":{"Line":0}},{"line":324,"address":[1494736],"length":1,"stats":{"Line":1}},{"line":488,"address":[1495520,1498034,1497833],"length":1,"stats":{"Line":1}},{"line":494,"address":[1495627],"length":1,"stats":{"Line":1}},{"line":495,"address":[1495708],"length":1,"stats":{"Line":1}},{"line":496,"address":[1498003,1495768,1495894,1495587],"length":1,"stats":{"Line":2}},{"line":497,"address":[1495863,1495943],"length":1,"stats":{"Line":2}},{"line":499,"address":[1495983,1496067,1497938],"length":1,"stats":{"Line":2}},{"line":501,"address":[1496176],"length":1,"stats":{"Line":1}},{"line":503,"address":[1497873,1496255,1496339],"length":1,"stats":{"Line":2}},{"line":506,"address":[1496554,1497068,1496686,1497304,1497419,1497610,1496900,1496624,1496792,1496456,1497153],"length":1,"stats":{"Line":10}},{"line":507,"address":[1496475],"length":1,"stats":{"Line":1}},{"line":508,"address":[1496581],"length":1,"stats":{"Line":1}},{"line":509,"address":[1496643],"length":1,"stats":{"Line":1}},{"line":512,"address":[1496752],"length":1,"stats":{"Line":1}},{"line":515,"address":[1496860],"length":1,"stats":{"Line":1}},{"line":521,"address":[1497028],"length":1,"stats":{"Line":1}},{"line":525,"address":[1497141],"length":1,"stats":{"Line":1}},{"line":531,"address":[1497292],"length":1,"stats":{"Line":1}},{"line":535,"address":[1497361],"length":1,"stats":{"Line":1}},{"line":538,"address":[1497679],"length":1,"stats":{"Line":1}}],"covered":149,"coverable":156}]};
+        var data = {"files":[{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","build.rs"],"content":"extern crate cbindgen;\nextern crate regex;\nextern crate serde;\nextern crate serde_json;\n\nuse std::fs::File;\nuse std::io::Write;\nuse std::path::PathBuf;\n\nuse regex::Regex;\nuse serde::Serialize;\n\n#[derive(Serialize)]\nstruct ConfigFlag {\n    comments: Vec\u003cString\u003e,\n    name: String,\n    enabled: bool,\n}\n\n#[derive(Serialize)]\nstruct Constant {\n    comments: Vec\u003cString\u003e,\n    name: String,\n    value: usize,\n}\n\n#[derive(Serialize)]\nstruct Alias {\n    comments: Vec\u003cString\u003e,\n    name: String,\n    typename: String,\n}\n\n#[derive(Serialize)]\nstruct Param {\n    name: String,\n    typename: String,\n}\n\n#[derive(Serialize)]\nstruct Function {\n    comments: Vec\u003cString\u003e,\n    name: String,\n    return_param: String,\n    input_params: Vec\u003cParam\u003e,\n}\n\n#[derive(Serialize)]\nstruct Data {\n    config_flags: Vec\u003cConfigFlag\u003e,\n    constants: Vec\u003cConstant\u003e,\n    aliases: Vec\u003cAlias\u003e,\n    callbacks: Vec\u003cFunction\u003e,\n    functions: Vec\u003cFunction\u003e,\n}\n\nfn preprocess_any(source: String, features: \u0026Vec\u003c\u0026str\u003e) -\u003e String {\n\n    let block_regex = Regex::new(r\"(?m)(?\u003canyblock\u003e#if \\(?(defined\\(([A-Z_]+)\\)( \\|\\| )?)+\\)?([^#]*\\n)*#endif\\n\\n)\").unwrap();\n\n    if !block_regex.is_match(\u0026source) {\n        return source;\n    }\n\n    let mut cleared_blocks: Vec\u003cString\u003e = Default::default();\n\n    let feature_regex = Regex::new(r\"defined\\((?\u003cfeature\u003e[A-Z0-9_]+)\\)\").unwrap();\n    let mut preprocessed_source = source.clone();\n    for caps in block_regex.captures_iter(source.as_str()) {\n        let anyblock = caps.name(\"anyblock\").unwrap().as_str();\n\n        let mut clear_block: bool = true;\n        for caps in feature_regex.captures_iter(anyblock) {\n            let feature = caps.name(\"feature\").unwrap().as_str();\n            if features.contains(\u0026feature) {\n                clear_block = false;\n                break;\n            }\n        }\n        if clear_block {\n            preprocessed_source = preprocessed_source.replace(\u0026anyblock, \"\");\n            cleared_blocks.push(anyblock.to_string());\n        }\n    }\n    preprocessed_source\n}\n\nfn preprocess_all(source: String, _features: \u0026Vec\u003c\u0026str\u003e) -\u003e String {\n    let block_regex = Regex::new(r\"(?m)(?\u003canyblock\u003e#if \\((defined\\(([A-Z_]+)\\)( \u0026\u0026 )?)+\\)([^#]*\\n)*#endif)\").unwrap();\n\n    if block_regex.is_match(\u0026source) {\n        panic!(\"unexpected #[cfg(all(..))]\");\n        return source;\n    }\n\n    source\n}\n\nfn preprocess_header(source: String) -\u003e String {\n    let mut features: Vec\u003c\u0026str\u003e = Default::default();\n\n    // OS features\n    #[cfg(target_os = \"windows\")]\n    features.push(\"GOSLING_PLATFORM_WINDOWS\");\n    #[cfg(target_os = \"macos\")]\n    features.push(\"GOSLING_PLATFORM_MACOS\");\n    #[cfg(target_os = \"linux\")]\n    features.push(\"GOSLING_PLATFORM_LINUX\");\n\n    // tor-provider implementations\n    #[cfg(feature = \"mock-tor-provider\")]\n    features.push(\"GOSLING_HAVE_MOCK_TOR_PROVIDER\");\n    #[cfg(feature = \"legacy-tor-provider\")]\n    features.push(\"GOSLING_HAVE_LEGACY_TOR_PROVIDER\");\n\n    let source = preprocess_any(source.to_string(), \u0026features);\n    let source = preprocess_all(source, \u0026features);\n\n    source\n}\n\nfn parse_param(params_raw: \u0026str) -\u003e Vec\u003cParam\u003e {\n    // function param\n    let param_pattern = Regex::new(r\"(?m)(?P\u003ctype\u003e(\\w+ \\**)+)(?P\u003cname\u003e\\w+)\").unwrap();\n    // pattern for our gosling structs\n    let struct_gosling_pattern = Regex::new(r\"(?m)struct (?P\u003cname\u003egosling_[\\w]+) \").unwrap();\n\n    let mut params: Vec\u003cParam\u003e = Default::default();\n    for param in param_pattern.captures_iter(params_raw) {\n        let t = \u0026param[\"type\"];\n        let t = match struct_gosling_pattern.captures(t) {\n            Some(cap) =\u003e struct_gosling_pattern.replace(t, \u0026cap[\"name\"]).to_string(),\n            None =\u003e t.to_string(),\n        };\n        let t = t.replace(\" *\", \"*\");\n        let n = \u0026param[\"name\"];\n\n        params.push(Param {\n            name: n.to_string(),\n            typename: t.trim().to_string(),\n        });\n    }\n    params\n}\n\nfn parse_header(source: \u0026str) -\u003e Data {\n    // all of the lines we cre about have this general form of muliple // style comments,\n    // followed by a single source line we care about\n    let commented_source_pattern =\n        Regex::new(r\"(?m)(?\u003ccomments\u003e(?:\\/\\/.*\\n)+)(?\u003csource\u003e.+)\").unwrap();\n    let comment_pattern = Regex::new(r\"(?m)^\\/\\/[ ]?\").unwrap();\n\n    // constant pattern\n    let constant_pattern = Regex::new(r\"^#define (?P\u003cname\u003e[A-Z0-9_]+) (?P\u003cvalue\u003e[0-9]+)$\").unwrap();\n    // primitive types\n    let typedef_pattern =\n        Regex::new(r\"^typedef (?P\u003ctype\u003e[\\w \\*]+) (?P\u003cname\u003egosling_[\\w]+);$\").unwrap();\n    // callback types\n    let callback_pattern = Regex::new(\n        r\"^typedef (?P\u003creturn\u003e[\\w \\*]+) \\(\\*(?P\u003cname\u003egosling_[\\w]+_t)\\)\\((?P\u003cparams\u003e[\\w ,\\*]*)\\);$\",\n    )\n    .unwrap();\n    // function declaration\n    let function_pattern = Regex::new(\n        r\"^(?P\u003creturn\u003e[\\w \\*]+( | \\*))(?P\u003cname\u003egosling_[\\w]+)\\((?P\u003cparams\u003e[\\w ,\\*]*)\\);$\",\n    )\n    .unwrap();\n\n    let mut config_flags: Vec\u003cConfigFlag\u003e = Default::default();\n    let mut constants: Vec\u003cConstant\u003e = Default::default();\n    let mut aliases: Vec\u003cAlias\u003e = Default::default();\n    let mut callbacks: Vec\u003cFunction\u003e = Default::default();\n    let mut functions: Vec\u003cFunction\u003e = Default::default();\n\n    config_flags.push(ConfigFlag {\n        comments: vec![\"Defined if cgosling is built with mock tor-provider support\".to_string()],\n        name: \"GOSLING_HAVE_MOCK_TOR_PROVIDER\".to_string(),\n        enabled: cfg!(feature = \"mock-tor-provider\"),\n    });\n    config_flags.push(ConfigFlag {\n        comments: vec![\"Defined if cgosling is built with legacy tor-provider support\".to_string()],\n        name: \"GOSLING_HAVE_LEGACY_TOR_PROVIDER\".to_string(),\n        enabled: cfg!(feature = \"legacy-tor-provider\"),\n    });\n\n    for commmented_source in commented_source_pattern.captures_iter(source) {\n        let comments = \u0026commmented_source[\"comments\"];\n        let comments = comment_pattern.replace_all(comments, \"\");\n        let comments = comments.trim();\n        let comments = comments.split('\\n').map(|s| s.to_string()).collect();\n\n        let source = \u0026commmented_source[\"source\"];\n\n        // try parse constant\n        if let Some(constant) = constant_pattern.captures(source) {\n            let name = constant[\"name\"].to_lowercase();\n            let value = constant[\"value\"].parse::\u003cusize\u003e().unwrap();\n            constants.push(Constant {\n                name,\n                value,\n                comments,\n            });\n        // try parse alias\n        } else if let Some(alias) = typedef_pattern.captures(source) {\n            let t = \u0026alias[\"type\"];\n            let n = \u0026alias[\"name\"];\n\n            if t == format!(\"struct {}\", n) {\n                aliases.push(Alias {\n                    name: n.to_string(),\n                    typename: \"uintptr_t\".to_string(),\n                    comments,\n                });\n            } else {\n                aliases.push(Alias {\n                    name: n.to_string(),\n                    typename: t.trim().to_string(),\n                    comments,\n                });\n            }\n        // try parse callback declaration\n        } else if let Some(callback) = callback_pattern.captures(source) {\n            let r = \u0026callback[\"return\"];\n            let n = \u0026callback[\"name\"];\n            let p = \u0026callback[\"params\"];\n\n            // move the pointer char next to the type\n            let r = r.trim().replace(\" *\", \"*\");\n\n            let params = parse_param(p);\n            callbacks.push(Function {\n                name: n.to_string(),\n                return_param: r,\n                input_params: params,\n                comments,\n            });\n        // try parse function declaration\n        } else if let Some(function) = function_pattern.captures(source) {\n            let r = \u0026function[\"return\"];\n            let n = \u0026function[\"name\"];\n            let p = \u0026function[\"params\"];\n\n            // move the pointer char next to the type\n            let r = r.trim().replace(\" *\", \"*\");\n\n            let params = parse_param(p);\n            functions.push(Function {\n                name: n.to_string(),\n                return_param: r,\n                input_params: params,\n                comments,\n            });\n        }\n    }\n\n    Data {\n        config_flags,\n        constants,\n        aliases,\n        callbacks,\n        functions,\n    }\n}\n\nfn main() {\n    if cfg!(not(feature = \"impl-lib\")) {\n        // set by cargo\n        let crate_dir = std::env::var(\"CARGO_MANIFEST_DIR\").unwrap();\n        // set by cargo\n        let profile = match std::env::var(\"PROFILE\") {\n            Ok(target) =\u003e target,\n            Err(_) =\u003e panic!(\"PROFILE not set\"),\n        };\n        // set by cmake\n        let target_dir = match std::env::var(\"CARGO_TARGET_DIR\") {\n            Ok(target) =\u003e PathBuf::from(target).join(profile),\n            Err(_) =\u003e panic!(\"CARGO_TARGET_DIR not set\"),\n        };\n\n        let header_file_path = target_dir.join(\"cgosling.h\");\n        println!(\"cargo:rerun-if-changed={}\", header_file_path.display());\n\n        // generate libgosling.h C header\n        match cbindgen::generate(\u0026crate_dir) {\n            Ok(bindings) =\u003e bindings.write_to_file(header_file_path.clone().into_os_string()),\n            Err(cbindgen::Error::ParseSyntaxError { .. }) =\u003e return, // ignore in favor of cargo's syntax check\n            Err(err) =\u003e panic!(\"{:?}\", err),\n        };\n\n        // pre-process and re-write header\n        let source = std::fs::read_to_string(header_file_path.clone()).unwrap();\n        let source = preprocess_header(source);\n        std::fs::write(header_file_path, source.clone()).unwrap();\n\n        // convert generated header to json IDL\n        let idl = parse_header(source.as_str());\n\n        // and write json IDL to disk\n        let json_file_path = target_dir.join(\"cgosling.json\");\n        println!(\"cargo:rerun-if-changed={}\", json_file_path.display());\n        let mut json_file = match File::create(json_file_path) {\n            Ok(file) =\u003e file,\n            Err(err) =\u003e panic!(\"{:?}\", err),\n        };\n        writeln!(json_file, \"{}\", serde_json::to_string_pretty(\u0026idl).unwrap()).unwrap();\n    }\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","fuzz","fuzz_targets","fuzz_cgosling.rs"],"content":"#![no_main]\n\nuse std::ffi::{c_char, c_int};\nuse std::ptr;\n\nuse libfuzzer_sys::fuzz_target;\nuse libfuzzer_sys::arbitrary;\nuse libfuzzer_sys::arbitrary::Arbitrary;\n\nuse cgosling::callbacks::*;\nuse cgosling::context::*;\nuse cgosling::crypto::*;\nuse cgosling::error::*;\nuse cgosling::ffi::*;\nuse cgosling::tor_provider::*;\nuse cgosling::utils::*;\n\n#[derive(Arbitrary, Debug)]\nenum Handle {\n    Null,\n    Valid(usize),\n    Invalid(usize),\n}\n\n#[derive(Arbitrary, Debug)]\nenum PHandle {\n    Null,\n    Valid,\n}\n\n#[derive(Arbitrary, Debug)]\nenum Callback {\n    Null,\n    Valid,\n}\n\n#[derive(Arbitrary, Debug)]\nenum Buffer\u003cT\u003e {\n    Null,\n    Valid(Vec\u003cT\u003e),\n}\n\n#[derive(Arbitrary, Debug)]\nenum Primitive\u003cT\u003e {\n    Valid(T),\n    Invalid(T),\n}\n\n#[derive(Arbitrary, Debug)]\nenum Function {\n    ErrorGetMessage{\n        error: Handle,\n    },\n    ErrorClone{\n        error_copy: PHandle,\n        orig_error: Handle,\n        out_error: PHandle,\n    },\n    ErrorFree{\n        error: Handle,\n    },\n    Ed25519PrivateKeyFree{\n        private_key: Handle,\n    },\n    X25519PrivateKeyFree{\n        private_key: Handle,\n    },\n    X25519PublicKeyFree{\n        public_key: Handle,\n    },\n    V3OnionServiceIdFree{\n        service_id: Handle,\n    },\n    IpAddressFree{\n        ip_address: Handle,\n    },\n    TargetAddressFree{\n        target_address: Handle,\n    },\n    ContextFree{\n        context: Handle,\n    },\n    TorProviderFree{\n        tor_provider: Handle,\n    },\n    LibraryInit{\n        out_library: PHandle,\n        out_error: PHandle,\n    },\n    LibraryFree{\n        library: Handle,\n    },\n    // Ed25519 Priavate Key Functions\n    Ed25519PrivateKeyGenerate{\n        out_private_key: PHandle,\n        out_error: PHandle,\n    },\n    Ed25519PrivateKeyClone{\n        out_private_key: PHandle,\n        private_key: Handle,\n        out_error: PHandle,\n    },\n    Ed25519PrivateKeyFromKeyblob{\n        out_private_key: PHandle,\n        key_blob: Buffer\u003cc_char\u003e,\n        key_blob_length: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    Ed25519PrivateKeyToKeyblob{\n        private_key: Handle,\n        out_key_blob: Buffer\u003cc_char\u003e,\n        key_blob_size: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    // X25519 Private Key Functions\n    X25519PrivateKeyClone{\n        out_private_key: PHandle,\n        private_key: Handle,\n        out_error: PHandle,\n    },\n    X25519PrivateKeyFromBase64{\n        out_private_key: PHandle,\n        base64: Buffer\u003cc_char\u003e,\n        base64_length: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    X25519PrivateKeyToBase64{\n        private_key: Handle,\n        out_base64: Buffer\u003cc_char\u003e,\n        base64_size: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    // X25519 Public Key Functions\n    X25519PublicKeyClone{\n        out_public_key: PHandle,\n        public_key: Handle,\n        out_error: PHandle,\n    },\n    X25519PublicKeyFromBase32{\n        out_public_key: PHandle,\n        base32: Buffer\u003cc_char\u003e,\n        base32_length: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    X25519PublicKeyToBase32{\n        public_key: Handle,\n        out_base32: Buffer\u003cc_char\u003e,\n        base32_size: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    // V3 Onion Service Id Functions\n    V3OnionServiceIdClone{\n        out_service_id: PHandle,\n        service_id: Handle,\n        out_error: PHandle,\n    },\n    V3OnionServiceIdFromString{\n        out_service_id: PHandle,\n        service_id_string: Buffer\u003cc_char\u003e,\n        service_id_string_length: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    V3OnionServiceIdFromEd25519PrivateKey{\n        out_service_id: PHandle,\n        ed25519_private_key: Handle,\n        out_error: PHandle,\n    },\n    V3OnionServiceIdToString{\n        service_id: Handle,\n        out_service_id_string: Buffer\u003cc_char\u003e,\n        service_id_string_size: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    StringIsValidV3OnionServiceId{\n        service_id_string: Buffer\u003cc_char\u003e,\n        service_id_string_length: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    // TorProvider Functions\n    TorProviderConfigNewMockClientConfig{\n        out_tor_provider_config: PHandle,\n        out_error: PHandle,\n    },\n    TorProviderFromTorProviderConfig{\n        out_tor_provider: PHandle,\n        tor_provider_config: Handle,\n        out_error: PHandle,\n    },\n    // Context Functions\n    ContextInit{\n        out_context: PHandle,\n        tor_provider: Handle,\n        identity_port: u16,\n        endpoint_port: u16,\n        identity_private_key: Handle,\n        out_error: PHandle,\n    },\n    ContextBootstrapTor{\n        context: Handle,\n        out_error: PHandle,\n    },\n    ContextStartIdentityServer{\n        context: Handle,\n        out_error: PHandle,\n    },\n    ContextStopIdentityServer{\n        context: Handle,\n        out_error: PHandle,\n    },\n    ContextStartEndpointServer{\n        context: Handle,\n        endpoint_private_key: Handle,\n        endpoint_name: Buffer\u003cc_char\u003e,\n        endpoint_name_length: Primitive\u003cusize\u003e,\n        client_identity: Handle,\n        client_auth_public_key: Handle,\n        out_error: PHandle,\n    },\n    ContextStopEndpointServer{\n        context: Handle,\n        endpoint_private_key: Handle,\n        out_error: PHandle,\n    },\n    ContextBeginIdentityHandshake{\n        context: Handle,\n        identity_service_id: Handle,\n        endpoint_name: Buffer\u003cc_char\u003e,\n        endpoint_name_length: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    ContextAbortIdentityClientHandshake{\n        context: Handle,\n        handshake_handle: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    ContextBeginEndpointHandshake{\n        context: Handle,\n        endpoint_service_id: Handle,\n        client_auth_private_key: Handle,\n        channel_name: Buffer\u003cc_char\u003e,\n        channel_name_length: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    ContextAbortEndpointClientHandshake{\n        context: Handle,\n        handshake_handle: Primitive\u003cusize\u003e,\n        out_error: PHandle\n    },\n    ContextPollEvents{\n        context: Handle,\n        out_error: PHandle,\n    },\n    // Callback Setters\n    ContextSetTorBootstrapStatusReceivedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetTorBootstrapCompletedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetTorLogReceivedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityClientChallengeResponseSizeCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityClientBuildChallengeResponseCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityClientHandshakeCompletedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityClientHandshakeFailedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityServerPublishedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityServerHandshakeStartedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityServerClientAllowedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityServerEndpointSupportedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityServerChallengeSizeCallack{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityServerBuildChallengeCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityServerVerifyChallengeResponseCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityServerHandshakeCompletedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityServerHandshakeRejectedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetIdentityServerHandshakeFailedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetEndpointClientHandshakeCompletedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetEndpointClientHandshakeFailedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetEndpointServerPublishedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetEndpointServerHandshakeStartedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetEndpointServerChannelSupportedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetEndpointServerHandshakeCompletedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetEndpointServerHandshakeRejectedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    ContextSetEndpointServerHandshakeFailedCallback{\n        context: Handle,\n        callback: Callback,\n        out_error: PHandle,\n    },\n    // Context Utility Functions\n    ContextGenerateCircuitToken{\n        context: Handle,\n        out_error: PHandle,\n    },\n    ContextReleaseCircuitToken{\n        context: Handle,\n        circuit_token: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n    // IpAddress Functions\n    IpAddressClone{\n        out_ip_address: PHandle,\n        ip_address: Handle,\n        out_error: PHandle,\n    },\n    IpAddressFromIpv4{\n        out_ip_address: PHandle,\n        a: u8,\n        b: u8,\n        c: u8,\n        d: u8,\n        out_error: PHandle,\n    },\n    IpAddressFromIpv6{\n        out_ip_address: PHandle,\n        a: u16,\n        b: u16,\n        c: u16,\n        d: u16,\n        e: u16,\n        f: u16,\n        g: u16,\n        h: u16,\n        out_error: PHandle,\n    },\n    // TargetAddress Functions\n    TargetAddressClone{\n        out_target_address: PHandle,\n        target_address: Handle,\n        out_error: PHandle,\n    },\n    TargetAddressFromIpAddress{\n        out_target_address: PHandle,\n        ip_address: Handle,\n        port: u16,\n        out_error: PHandle,\n    },\n    TargetAddressFromDomain{\n        out_target_address: PHandle,\n        domain: Buffer\u003cc_char\u003e,\n        domain_length: Primitive\u003cusize\u003e,\n        port: u16,\n        out_error: PHandle,\n    },\n    TargetAddressFromV3OnionServiceId{\n        out_target_address: PHandle,\n        service_id: Handle,\n        port: u16,\n        out_error: PHandle,\n    },\n    TargetAddressFromString{\n        out_target_address: PHandle,\n        target_address: Buffer\u003cc_char\u003e,\n        target_address_length: Primitive\u003cusize\u003e,\n        out_error: PHandle,\n    },\n}\n\nfn handle_as_pointer\u003cT\u003e(value: Handle, handles: \u0026Vec\u003c*mut T\u003e) -\u003e *mut T {\n    let result: *mut T = match value {\n        Handle::Null =\u003e ptr::null_mut(),\n        Handle::Valid(value) =\u003e if !handles.is_empty() {\n            let index = value % handles.len();\n            handles[index]\n        } else {\n            ptr::null_mut()\n        },\n        Handle::Invalid(value) =\u003e if !handles.contains(\u0026(value as *mut T)) {\n            value as *mut T\n        } else {\n            ptr::null_mut()\n        }\n    };\n    result\n}\n\nfn handle_to_pointer\u003cT\u003e(value: Handle, handles: \u0026mut Vec\u003c*mut T\u003e) -\u003e *mut T {\n    let result: *mut T = match value {\n        Handle::Null =\u003e ptr::null_mut(),\n        Handle::Valid(value) =\u003e if !handles.is_empty() {\n            let index = value % handles.len();\n            handles.remove(index) as *mut T\n        } else {\n            ptr::null_mut()\n        },\n        Handle::Invalid(value) =\u003e if !handles.contains(\u0026(value as *mut T)) {\n            value as *mut T\n        } else {\n            ptr::null_mut()\n        },\n    };\n    result\n}\n\nfn phandle_to_out_pointer\u003cT\u003e(value: PHandle, out_pointer: *mut *mut T) -\u003e *mut *mut T {\n    match value {\n        PHandle::Null =\u003e ptr::null_mut(),\n        PHandle::Valid =\u003e out_pointer,\n    }\n}\n\nfn primitive_to_value\u003cT: Default + std::cmp::PartialEq\u003e(value: Primitive\u003cT\u003e, values: \u0026mut Vec\u003cT\u003e) -\u003e T where usize: From\u003cT\u003e{\n    match value {\n        Primitive::Valid(value) =\u003e if !values.is_empty() {\n            let index: usize = value.into();\n            let index = index % values.len();\n            values.remove(index)\n        } else {\n            Default::default()\n        },\n        Primitive::Invalid(value) =\u003e if !values.contains(\u0026value) {\n            value\n        } else {\n            Default::default()\n        }\n    }\n}\n\nfn buffer_to_size\u003cT\u003e(buffer: \u0026Buffer\u003cT\u003e, buffer_size: \u0026Primitive\u003cusize\u003e) -\u003e usize {\n    let size: usize = match (buffer, buffer_size) {\n        (Buffer::Null, Primitive::Valid(_)) =\u003e 0usize,\n        (Buffer::Null, Primitive::Invalid(value)) =\u003e *value,\n        (Buffer::Valid(buffer), Primitive::Valid(_)) =\u003e buffer.len(),\n        (Buffer::Valid(buffer), Primitive::Invalid(value)) =\u003e std::cmp::min(*value, buffer.len()),\n    };\n    size\n}\n\nfn buffer_as_pointer\u003cT\u003e(buffer: \u0026Buffer\u003cT\u003e) -\u003e *const T {\n    let pointer: *const T = match buffer {\n        Buffer::Null =\u003e ptr::null(),\n        Buffer::Valid(value) =\u003e value.as_ptr(),\n    };\n    pointer\n}\n\nfn buffer_as_mut_pointer\u003cT\u003e(buffer: \u0026mut Buffer\u003cT\u003e) -\u003e *mut T {\n    let pointer: *mut T = match buffer {\n        Buffer::Null =\u003e ptr::null_mut(),\n        Buffer::Valid(value) =\u003e value.as_mut_ptr(),\n    };\n    pointer\n}\n\nmacro_rules! impl_set_callback {\n    ($context:ident, $callback:ident, $out_error:ident, $contexts:ident, $errors:ident,$setter:ident, $func:ident) =\u003e {\n        let context = handle_as_pointer($context, \u0026$contexts);\n        let mut error: *mut GoslingError = ptr::null_mut();\n        let out_error = phandle_to_out_pointer($out_error, \u0026mut error);\n        match $callback {\n            Callback::Null =\u003e $setter(context, None, out_error),\n            Callback::Valid =\u003e $setter(context, Some($func), out_error),\n        }\n        if !error.is_null() {\n            $errors.push(error);\n        }\n    }\n}\n\n// no-op (or minimal op) callbacks for setters\n\nextern \"C\" fn bootstrap_status_received(_context: *mut GoslingContext, _progress: u32, _tag: *const c_char, _tag_length: usize, _summary: *const c_char, _summary_length: usize) {\n\n}\n\nextern \"C\" fn bootstrap_complete(_context: *mut GoslingContext) -\u003e () {\n\n}\n\nextern \"C\" fn tor_log_received(_context: *mut GoslingContext, _line: *const c_char, _line_length: usize) {\n\n}\n\nextern \"C\" fn identity_client_handshake_challenge_response_size(_context: *mut GoslingContext, _handshake_handle: usize, _challenge_buffer: *const u8, _challenge_buffer_size: usize) -\u003e usize {\n    return 0;\n}\n\nextern \"C\" fn identity_client_handshake_build_challenge_response(_context: *mut GoslingContext, _handshake_handle: usize, _challenge_buffer: *const u8, _challenge_buffer_size: usize, _out_challenge_response_buffer: *mut u8, _challenge_response_buffer_size: usize) {\n\n}\n\nextern \"C\" fn identity_client_handshake_completed(_context: *mut GoslingContext, _handshake_handle: usize, _identity_service_id: *const GoslingV3OnionServiceId, _endpoint_service_id: *const GoslingV3OnionServiceId, _endpoint_name: *const c_char, _endpoint_name_length: usize, _client_auth_private_key: *const GoslingX25519PrivateKey) {\n\n}\n\nextern \"C\" fn identity_client_handshake_failed(_context: *mut GoslingContext, _handshake_handle: usize, _error: *const GoslingError) {\n\n}\n\nextern \"C\" fn identity_server_published(_context: *mut GoslingContext) {\n\n}\n\nextern \"C\" fn identity_server_handshake_started(_context: *mut GoslingContext, _handshake_handle: usize) {\n\n}\n\nextern \"C\" fn identity_server_handshake_client_allowed(_context: *mut GoslingContext, _handshake_handle: usize, _client_service_id: *const GoslingV3OnionServiceId) -\u003e bool {\n    true\n}\n\nextern \"C\" fn identity_server_endpoint_supported(_context: *mut GoslingContext, _handshake_handle: usize, _endpoint_name: *const c_char, _endpoint_name_length: usize) -\u003e bool {\n    true\n}\n\nextern \"C\" fn identity_server_handshake_challenge_size(_context: *mut GoslingContext, _handshake_handle: usize) -\u003e usize {\n    0usize\n}\n\nextern \"C\" fn identity_server_handshake_build_challenge(_context: *mut GoslingContext, _handshake_handle: usize, _out_challenge_buffer: *mut u8, _challenge_buffer_size: usize) {\n\n}\n\nextern \"C\" fn identity_server_handshake_verify_challenge_response(_context: *mut GoslingContext, _handshake_handle: usize, _challenge_response_buffer: *const u8, _challenge_response_buffer_size: usize) -\u003e bool {\n    true\n}\n\nextern \"C\" fn identity_server_handshake_completed(_context: *mut GoslingContext, _handshake_handle: usize, _endpoint_private_key: *const GoslingEd25519PrivateKey, _endpoint_name: *const c_char, _endpoint_name_length: usize, _client_service_id: *const GoslingV3OnionServiceId, _client_auth_public_key: *const GoslingX25519PublicKey) {\n\n}\n\nextern \"C\" fn identity_server_handshake_rejected(_context: *mut GoslingContext, _handshake_handle: usize, _client_allowed: bool, _client_requested_endpoint_valid: bool, _client_proof_signature_valid: bool, _client_auth_signature_valid: bool, _challenge_response_valid: bool) {\n\n}\n\nextern \"C\" fn identity_server_handshake_failed(_cntext: *mut GoslingContext, _handshake_handle: usize, _error: *const GoslingError) {\n\n}\n\nextern \"C\" fn endpoint_client_handhsake_completed(_context: *mut GoslingContext, _handshake_handle: usize, _endpoint_service_id: *const GoslingV3OnionServiceId, _channel_name: *const c_char, _channel_name_length: usize, _stream: c_int) {\n\n}\n\nextern \"C\" fn endpoint_client_handshake_failed(_context: *mut GoslingContext,\n    _handshake_handle: usize, _error: *const GoslingError) {\n\n}\n\nextern \"C\" fn endpoint_server_published(_context: *mut GoslingContext, _endpoint_service_id: *const GoslingV3OnionServiceId, _endpoint_name: *const c_char, _endpoint_name_length: usize) {\n\n}\n\nextern \"C\" fn endpoint_server_handshake_started(_context: *mut GoslingContext, _handshake_handle: usize) {\n\n}\n\nextern \"C\" fn endpoint_server_channel_supported(_context: *mut GoslingContext,\n_handshake_handle: usize, _client_service_id: *const GoslingV3OnionServiceId, _channel_name: *const c_char, _channel_name_length: usize) -\u003e bool {\n    true\n}\n\nextern \"C\" fn endpoint_server_handshake_completed(_context: *mut GoslingContext, _handshake_handle: usize, _endpoint_service_id: *const GoslingV3OnionServiceId, _client_service_id: *const GoslingV3OnionServiceId, _channel_name: *const c_char, _channel_name_length: usize, _stream: c_int) {\n\n}\n\nextern \"C\" fn endpoint_server_handshake_rejected(_context: *mut GoslingContext, _handshake_handle: usize, _client_allowed: bool, _client_requested_channel_valid: bool, _client_proof_signature_valid: bool) {\n\n}\n\nextern \"C\" fn endpoint_server_handshake_failed(_context: *mut GoslingContext,\n    _handshake_handle: usize, _error: *const GoslingError) {\n\n}\n\n#[derive(Arbitrary, Debug)]\nstruct Data {\n    functions: Vec\u003cFunction\u003e,\n}\n\nfuzz_target!(|data: Data| {\n    let mut libraries: Vec\u003c*mut GoslingLibrary\u003e = Default::default();\n    let mut errors: Vec\u003c*mut GoslingError\u003e = Default::default();\n    let mut contexts: Vec\u003c*mut GoslingContext\u003e = Default::default();\n    let mut ed25519_private_keys: Vec\u003c*mut GoslingEd25519PrivateKey\u003e = Default::default();\n    let mut v3_onion_service_ids: Vec\u003c*mut GoslingV3OnionServiceId\u003e = Default::default();\n    let mut x25519_private_keys: Vec\u003c*mut GoslingX25519PrivateKey\u003e = Default::default();\n    let mut x25519_public_keys : Vec\u003c*mut GoslingX25519PublicKey\u003e = Default::default();\n    let mut tor_provider_configs: Vec\u003c*mut GoslingTorProviderConfig\u003e = Default::default();\n    let mut tor_providers: Vec\u003c*mut GoslingTorProvider\u003e = Default::default();\n    let mut identity_handshakes: Vec\u003cusize\u003e = Default::default();\n    let mut endpoint_handshakes: Vec\u003cusize\u003e = Default::default();\n    let mut ip_addresses: Vec\u003c*mut GoslingIpAddress\u003e = Default::default();\n    let mut target_addresses: Vec\u003c*mut GoslingTargetAddress\u003e = Default::default();\n    let mut circuit_tokens: Vec\u003cGoslingCircuitToken\u003e = Default::default();\n\n    for function in data.functions {\n        match function {\n            Function::ErrorGetMessage{error} =\u003e {\n                let error = handle_as_pointer(error, \u0026errors);\n                gosling_error_get_message(error);\n            },\n            Function::ErrorClone{error_copy, orig_error, out_error} =\u003e {\n                let mut dest: *mut GoslingError = ptr::null_mut();\n                let error_copy = phandle_to_out_pointer(error_copy, \u0026mut dest);\n                let orig_error = handle_as_pointer(orig_error, \u0026errors);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_error_clone(error_copy, orig_error, out_error) };\n                if !dest.is_null() {\n                    errors.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ErrorFree{error} =\u003e {\n                let error = handle_to_pointer(error, \u0026mut errors);\n                gosling_error_free(error);\n            },\n            Function::Ed25519PrivateKeyFree{private_key} =\u003e {\n                let private_key = handle_to_pointer(private_key, \u0026mut ed25519_private_keys);\n                gosling_ed25519_private_key_free(private_key);\n            },\n            Function::X25519PrivateKeyFree{private_key} =\u003e {\n                let private_key = handle_to_pointer(private_key, \u0026mut x25519_private_keys);\n                gosling_x25519_private_key_free(private_key);\n            },\n            Function::X25519PublicKeyFree{public_key} =\u003e {\n                let public_key = handle_to_pointer(public_key, \u0026mut x25519_public_keys);\n                gosling_x25519_public_key_free(public_key);\n            },\n            Function::V3OnionServiceIdFree{service_id} =\u003e {\n               let service_id = handle_to_pointer(service_id, \u0026mut v3_onion_service_ids);\n               gosling_v3_onion_service_id_free(service_id);\n            },\n            Function::ContextFree{context} =\u003e {\n                let context = handle_to_pointer(context, \u0026mut contexts);\n                gosling_context_free(context);\n            },\n            Function::TorProviderFree{tor_provider} =\u003e {\n                let tor_provider = handle_to_pointer(tor_provider, \u0026mut tor_providers);\n                gosling_tor_provider_free(tor_provider);\n            },\n            Function::LibraryInit{out_library, out_error} =\u003e {\n                let mut library: *mut GoslingLibrary = ptr::null_mut();\n                let out_library = phandle_to_out_pointer(out_library, \u0026mut library);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_library_init(out_library, out_error) };\n                if !library.is_null() {\n                    libraries.push(library);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::LibraryFree{library} =\u003e {\n                let library = handle_to_pointer(library, \u0026mut libraries);\n                gosling_library_free(library);\n            },\n            Function::Ed25519PrivateKeyGenerate{out_private_key, out_error} =\u003e {\n                let mut private_key: *mut GoslingEd25519PrivateKey = ptr::null_mut();\n                let out_private_key = phandle_to_out_pointer(out_private_key, \u0026mut private_key);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_ed25519_private_key_generate(out_private_key, out_error) };\n                if !private_key.is_null() {\n                    ed25519_private_keys.push(private_key);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::Ed25519PrivateKeyClone{out_private_key, private_key, out_error} =\u003e {\n                let mut dest: *mut GoslingEd25519PrivateKey = ptr::null_mut();\n                let out_private_key = phandle_to_out_pointer(out_private_key, \u0026mut dest);\n                let private_key = handle_as_pointer(private_key, \u0026ed25519_private_keys);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_ed25519_private_key_clone(out_private_key, private_key, out_error) };\n                if !dest.is_null() {\n                    ed25519_private_keys.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::Ed25519PrivateKeyFromKeyblob{out_private_key, key_blob, key_blob_length, out_error} =\u003e {\n                let mut private_key: *mut GoslingEd25519PrivateKey = ptr::null_mut();\n                let out_private_key = phandle_to_out_pointer(out_private_key, \u0026mut private_key);\n                let key_blob_length = buffer_to_size(\u0026key_blob, \u0026key_blob_length);\n                let key_blob = buffer_as_pointer(\u0026key_blob);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_ed25519_private_key_from_keyblob(out_private_key, key_blob, key_blob_length, out_error) };\n                if !private_key.is_null() {\n                    ed25519_private_keys.push(private_key);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::Ed25519PrivateKeyToKeyblob{private_key, mut out_key_blob, key_blob_size, out_error} =\u003e {\n                let private_key = handle_as_pointer(private_key, \u0026ed25519_private_keys);\n                let key_blob_size = buffer_to_size(\u0026out_key_blob, \u0026key_blob_size);\n                let out_key_blob = buffer_as_mut_pointer(\u0026mut out_key_blob);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                gosling_ed25519_private_key_to_keyblob(private_key, out_key_blob, key_blob_size, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::X25519PrivateKeyClone{out_private_key, private_key, out_error} =\u003e {\n                let mut dest: *mut GoslingX25519PrivateKey = ptr::null_mut();\n                let out_private_key = phandle_to_out_pointer(out_private_key, \u0026mut dest);\n                let private_key = handle_as_pointer(private_key, \u0026x25519_private_keys);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_x25519_private_key_clone(out_private_key, private_key, out_error) };\n                if !dest.is_null() {\n                    x25519_private_keys.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::X25519PrivateKeyFromBase64{out_private_key, base64, base64_length, out_error} =\u003e {\n                let mut private_key: *mut GoslingX25519PrivateKey = ptr::null_mut();\n                let out_private_key = phandle_to_out_pointer(out_private_key, \u0026mut private_key);\n                let base64_length = buffer_to_size(\u0026base64, \u0026base64_length);\n                let base64 = buffer_as_pointer(\u0026base64);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_x25519_private_key_from_base64(out_private_key, base64, base64_length, out_error) };\n                if !private_key.is_null() {\n                    x25519_private_keys.push(private_key);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::X25519PrivateKeyToBase64{private_key, mut out_base64, base64_size, out_error} =\u003e {\n                let private_key = handle_as_pointer(private_key, \u0026x25519_private_keys);\n                let base64_size = buffer_to_size(\u0026out_base64, \u0026base64_size);\n                let out_base64 = buffer_as_mut_pointer(\u0026mut out_base64);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                gosling_x25519_private_key_to_base64(private_key, out_base64, base64_size, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::X25519PublicKeyClone{out_public_key, public_key, out_error} =\u003e {\n                let mut dest: *mut GoslingX25519PublicKey = ptr::null_mut();\n                let out_public_key = phandle_to_out_pointer(out_public_key, \u0026mut dest);\n                let public_key = handle_as_pointer(public_key, \u0026x25519_public_keys);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_x25519_public_key_clone(out_public_key, public_key, out_error) };\n                if !dest.is_null() {\n                    x25519_public_keys.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::X25519PublicKeyFromBase32{out_public_key, base32, base32_length, out_error} =\u003e {\n                let mut public_key: *mut GoslingX25519PublicKey = ptr::null_mut();\n                let out_public_key = phandle_to_out_pointer(out_public_key, \u0026mut public_key);\n                let base32_length = buffer_to_size(\u0026base32, \u0026base32_length);\n                let base32 = buffer_as_pointer(\u0026base32);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_x25519_public_key_from_base32(out_public_key, base32, base32_length, out_error) };\n                if !out_public_key.is_null() {\n                    x25519_public_keys.push(public_key);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::X25519PublicKeyToBase32{public_key, mut out_base32, base32_size, out_error} =\u003e {\n                let public_key = handle_as_pointer(public_key, \u0026x25519_public_keys);\n                let base32_size = buffer_to_size(\u0026out_base32, \u0026base32_size);\n                let out_base32 = buffer_as_mut_pointer(\u0026mut out_base32);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                gosling_x25519_public_key_to_base32(public_key, out_base32, base32_size, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::V3OnionServiceIdClone{out_service_id, service_id, out_error} =\u003e {\n                let mut dest: *mut GoslingV3OnionServiceId = ptr::null_mut();\n                let out_service_id = phandle_to_out_pointer(out_service_id, \u0026mut dest);\n                let service_id = handle_as_pointer(service_id, \u0026v3_onion_service_ids);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_v3_onion_service_id_clone(out_service_id, service_id, out_error) };\n                if !dest.is_null() {\n                    v3_onion_service_ids.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::V3OnionServiceIdFromString{out_service_id, service_id_string, service_id_string_length, out_error} =\u003e {\n                let mut service_id: *mut GoslingV3OnionServiceId = ptr::null_mut();\n                let out_service_id = phandle_to_out_pointer(out_service_id, \u0026mut service_id);\n                let service_id_string_length = buffer_to_size(\u0026service_id_string, \u0026service_id_string_length);\n                let service_id_string = buffer_as_pointer(\u0026service_id_string);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_v3_onion_service_id_from_string(out_service_id, service_id_string, service_id_string_length, out_error) };\n                if !out_service_id.is_null() {\n                    v3_onion_service_ids.push(service_id);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::V3OnionServiceIdFromEd25519PrivateKey{out_service_id, ed25519_private_key, out_error} =\u003e {\n                let mut service_id: *mut GoslingV3OnionServiceId = ptr::null_mut();\n                let out_service_id = phandle_to_out_pointer(out_service_id, \u0026mut service_id);\n                let ed25519_private_key = handle_as_pointer(ed25519_private_key, \u0026ed25519_private_keys);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_v3_onion_service_id_from_ed25519_private_key(out_service_id, ed25519_private_key, out_error) };\n                if !out_service_id.is_null() {\n                    v3_onion_service_ids.push(service_id);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::V3OnionServiceIdToString{service_id, mut out_service_id_string, service_id_string_size, out_error} =\u003e {\n                let service_id = handle_as_pointer(service_id, \u0026v3_onion_service_ids);\n                let service_id_string_size = buffer_to_size(\u0026out_service_id_string, \u0026service_id_string_size);\n                let out_service_id_string = buffer_as_mut_pointer(\u0026mut out_service_id_string);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                gosling_v3_onion_service_id_to_string(service_id, out_service_id_string, service_id_string_size, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::StringIsValidV3OnionServiceId{service_id_string, service_id_string_length, out_error} =\u003e {\n                let service_id_string_length = buffer_to_size(\u0026service_id_string, \u0026service_id_string_length);\n                let service_id_string = buffer_as_pointer(\u0026service_id_string);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                gosling_string_is_valid_v3_onion_service_id(service_id_string, service_id_string_length, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            }\n            Function::TorProviderConfigNewMockClientConfig{out_tor_provider_config, out_error} =\u003e {\n                let mut tor_provider_config: *mut GoslingTorProviderConfig = ptr::null_mut();\n                let out_tor_provider_config = phandle_to_out_pointer(out_tor_provider_config, \u0026mut tor_provider_config);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                unsafe { gosling_tor_provider_config_new_mock_client_config(out_tor_provider_config, out_error) };\n                if !tor_provider_config.is_null() {\n                    tor_provider_configs.push(tor_provider_config);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::TorProviderFromTorProviderConfig{out_tor_provider, tor_provider_config, out_error} =\u003e {\n                let mut tor_provider: *mut GoslingTorProvider = ptr::null_mut();\n                let out_tor_provider = phandle_to_out_pointer(out_tor_provider, \u0026mut tor_provider);\n                let tor_provider_config = handle_as_pointer(tor_provider_config, \u0026tor_provider_configs);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                unsafe { gosling_tor_provider_from_tor_provider_config(out_tor_provider, tor_provider_config, out_error) };\n                if !tor_provider.is_null() {\n                    tor_providers.push(tor_provider);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextInit{out_context, tor_provider, identity_port, endpoint_port, identity_private_key, out_error} =\u003e {\n                let mut context: *mut GoslingContext = ptr::null_mut();\n                let out_context = phandle_to_out_pointer(out_context, \u0026mut context);\n                let tor_provider = handle_as_pointer(tor_provider, \u0026tor_providers);\n                let identity_private_key = handle_as_pointer(identity_private_key, \u0026ed25519_private_keys);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                unsafe { gosling_context_init(out_context, tor_provider, identity_port, endpoint_port, identity_private_key, out_error) };\n                if !context.is_null() {\n                    contexts.push(context);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextBootstrapTor{context, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                gosling_context_bootstrap_tor(context, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextStartIdentityServer{context, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                gosling_context_start_identity_server(context, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextStopIdentityServer{context, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                gosling_context_stop_identity_server(context, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextStartEndpointServer{context, endpoint_private_key, endpoint_name, endpoint_name_length, client_identity, client_auth_public_key, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let endpoint_private_key = handle_as_pointer(endpoint_private_key, \u0026ed25519_private_keys);\n                let endpoint_name_length = buffer_to_size(\u0026endpoint_name, \u0026endpoint_name_length);\n                let endpoint_name = buffer_as_pointer(\u0026endpoint_name);\n                let client_identity = handle_as_pointer(client_identity, \u0026v3_onion_service_ids);\n                let client_auth_public_key = handle_as_pointer(client_auth_public_key, \u0026x25519_public_keys);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                gosling_context_start_endpoint_server(context, endpoint_private_key, endpoint_name, endpoint_name_length, client_identity, client_auth_public_key, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            }\n            Function::ContextStopEndpointServer{context, endpoint_private_key, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let endpoint_private_key = handle_as_pointer(endpoint_private_key, \u0026ed25519_private_keys);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                gosling_context_stop_endpoint_server(context, endpoint_private_key, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextBeginIdentityHandshake{context, identity_service_id, endpoint_name, endpoint_name_length, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let identity_service_id = handle_as_pointer(identity_service_id, \u0026v3_onion_service_ids);\n                let endpoint_name_length = buffer_to_size(\u0026endpoint_name, \u0026endpoint_name_length);\n                let endpoint_name = buffer_as_pointer(\u0026endpoint_name);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                let handshake_handle = gosling_context_begin_identity_handshake(context, identity_service_id, endpoint_name, endpoint_name_length, out_error);\n                if handshake_handle != !0usize {\n                    identity_handshakes.push(handshake_handle);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextAbortIdentityClientHandshake{context, handshake_handle, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let handshake_handle = match handshake_handle {\n                    Primitive::Valid(value) =\u003e if !identity_handshakes.is_empty() {\n                        let index = value % identity_handshakes.len();\n                        identity_handshakes[index]\n                    } else {\n                        !0usize\n                    },\n                    Primitive::Invalid(value) =\u003e if !identity_handshakes.contains(\u0026value) {\n                        value\n                    } else {\n                        !0usize\n                    }\n                };\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                gosling_context_abort_identity_client_handshake(context, handshake_handle, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextBeginEndpointHandshake{context, endpoint_service_id, client_auth_private_key, channel_name, channel_name_length, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let endpoint_service_id = handle_as_pointer(endpoint_service_id, \u0026v3_onion_service_ids);\n                let client_auth_private_key = handle_as_pointer(client_auth_private_key, \u0026x25519_private_keys);\n                let channel_name_length = buffer_to_size(\u0026channel_name, \u0026channel_name_length);\n                let channel_name = buffer_as_pointer(\u0026channel_name);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                let handshake_handle = gosling_context_begin_endpoint_handshake(context, endpoint_service_id, client_auth_private_key, channel_name, channel_name_length, out_error);\n                if handshake_handle != !0usize {\n                    endpoint_handshakes.push(handshake_handle);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextAbortEndpointClientHandshake{context, handshake_handle, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let handshake_handle = match handshake_handle {\n                    Primitive::Valid(value) =\u003e if !endpoint_handshakes.is_empty() {\n                        let index = value % endpoint_handshakes.len();\n                        endpoint_handshakes[index]\n                    } else {\n                        !0usize\n                    },\n                    Primitive::Invalid(value) =\u003e if !endpoint_handshakes.contains(\u0026value) {\n                        value\n                    } else {\n                        !0usize\n                    }\n                };\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                gosling_context_abort_endpoint_client_handshake(context, handshake_handle, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextPollEvents{context, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                gosling_context_poll_events(context, out_error);\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::ContextSetTorBootstrapStatusReceivedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_tor_bootstrap_status_received_callback, bootstrap_status_received);\n            },\n            Function::ContextSetTorBootstrapCompletedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_tor_bootstrap_completed_callback, bootstrap_complete);\n            },\n            Function::ContextSetTorLogReceivedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_tor_log_received_callback, tor_log_received);\n            },\n            Function::ContextSetIdentityClientChallengeResponseSizeCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_client_challenge_response_size_callback, identity_client_handshake_challenge_response_size);\n            },\n            Function::ContextSetIdentityClientBuildChallengeResponseCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_client_build_challenge_response_callback, identity_client_handshake_build_challenge_response);\n            },\n            Function::ContextSetIdentityClientHandshakeCompletedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_client_handshake_completed_callback, identity_client_handshake_completed);\n            },\n            Function::ContextSetIdentityClientHandshakeFailedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_client_handshake_failed_callback, identity_client_handshake_failed);\n            },\n            Function::ContextSetIdentityServerPublishedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_server_published_callback, identity_server_published);\n            },\n            Function::ContextSetIdentityServerHandshakeStartedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_server_handshake_started_callback, identity_server_handshake_started);\n            },\n            Function::ContextSetIdentityServerClientAllowedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_server_client_allowed_callback, identity_server_handshake_client_allowed);\n            },\n            Function::ContextSetIdentityServerEndpointSupportedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_server_endpoint_supported_callback, identity_server_endpoint_supported);\n            },\n            Function::ContextSetIdentityServerChallengeSizeCallack{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_server_challenge_size_callback, identity_server_handshake_challenge_size);\n            },\n            Function::ContextSetIdentityServerBuildChallengeCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_server_build_challenge_callback, identity_server_handshake_build_challenge);\n            },\n            Function::ContextSetIdentityServerVerifyChallengeResponseCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_server_verify_challenge_response_callback, identity_server_handshake_verify_challenge_response);\n            },\n            Function::ContextSetIdentityServerHandshakeCompletedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_server_handshake_completed_callback, identity_server_handshake_completed);\n            },\n            Function::ContextSetIdentityServerHandshakeRejectedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_server_handshake_rejected_callback, identity_server_handshake_rejected);\n            },\n            Function::ContextSetIdentityServerHandshakeFailedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_identity_server_handshake_failed_callback, identity_server_handshake_failed);\n            },\n            Function::ContextSetEndpointClientHandshakeCompletedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_endpoint_client_handshake_completed_callback, endpoint_client_handhsake_completed);\n            },\n            Function::ContextSetEndpointClientHandshakeFailedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_endpoint_client_handshake_failed_callback, endpoint_client_handshake_failed);\n            },\n            Function::ContextSetEndpointServerPublishedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_endpoint_server_published_callback, endpoint_server_published);\n            },\n            Function::ContextSetEndpointServerHandshakeStartedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_endpoint_server_handshake_started_callback, endpoint_server_handshake_started);\n            },\n            Function::ContextSetEndpointServerChannelSupportedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_endpoint_server_channel_supported_callback, endpoint_server_channel_supported);\n            },\n            Function::ContextSetEndpointServerHandshakeCompletedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_endpoint_server_handshake_completed_callback, endpoint_server_handshake_completed);\n            },\n            Function::ContextSetEndpointServerHandshakeRejectedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_endpoint_server_handshake_rejected_callback, endpoint_server_handshake_rejected);\n            },\n            Function::ContextSetEndpointServerHandshakeFailedCallback{context, callback, out_error} =\u003e {\n                impl_set_callback!(context, callback, out_error, contexts, errors, gosling_context_set_endpoint_server_handshake_failed_callback, endpoint_server_handshake_failed);\n            },\n            Function::ContextGenerateCircuitToken{context, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                let circuit_token = unsafe { gosling_context_generate_circuit_token(context, out_error) };\n                if !error.is_null() {\n                    errors.push(error);\n                } else {\n                    circuit_tokens.push(circuit_token);\n                }\n            },\n            Function::ContextReleaseCircuitToken{context, circuit_token, out_error} =\u003e {\n                let context = handle_as_pointer(context, \u0026contexts);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                let circuit_token = primitive_to_value(circuit_token, \u0026mut circuit_tokens);\n                unsafe { gosling_context_release_circuit_token(context, circuit_token, out_error) };\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::IpAddressFree{ip_address} =\u003e {\n                let ip_address = handle_to_pointer(ip_address, \u0026mut ip_addresses);\n                gosling_ip_address_free(ip_address);\n            },\n            Function::IpAddressClone{out_ip_address, ip_address, out_error} =\u003e {\n                let mut dest: *mut GoslingIpAddress = ptr::null_mut();\n                let out_ip_address = phandle_to_out_pointer(out_ip_address, \u0026mut dest);\n                let ip_address = handle_as_pointer(ip_address, \u0026ip_addresses);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                unsafe { gosling_ip_address_clone(out_ip_address, ip_address, out_error) };\n                if !dest.is_null() {\n                    ip_addresses.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::IpAddressFromIpv4{out_ip_address, a, b, c, d, out_error} =\u003e {\n                let mut dest: *mut GoslingIpAddress = ptr::null_mut();\n                let out_ip_address = phandle_to_out_pointer(out_ip_address, \u0026mut dest);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                unsafe { gosling_ip_address_from_ipv4(out_ip_address, a, b, c, d, out_error) };\n                if !dest.is_null() {\n                    ip_addresses.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::IpAddressFromIpv6{out_ip_address, a, b, c, d, e, f, g, h, out_error} =\u003e {\n                let mut dest: *mut GoslingIpAddress = ptr::null_mut();\n                let out_ip_address = phandle_to_out_pointer(out_ip_address, \u0026mut dest);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                unsafe { gosling_ip_address_from_ipv6(out_ip_address, a, b, c, d, e, f, g, h, out_error) };\n                if !dest.is_null() {\n                    ip_addresses.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::TargetAddressFree{target_address} =\u003e {\n                let target_address = handle_to_pointer(target_address, \u0026mut target_addresses);\n                gosling_target_address_free(target_address);\n            },\n            Function::TargetAddressClone{out_target_address, target_address, out_error} =\u003e {\n                let mut dest: *mut GoslingTargetAddress = ptr::null_mut();\n                let out_target_address = phandle_to_out_pointer(out_target_address, \u0026mut dest);\n                let target_address = handle_as_pointer(target_address, \u0026target_addresses);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n                unsafe { gosling_target_address_clone(out_target_address, target_address, out_error) };\n                if !dest.is_null() {\n                    target_addresses.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::TargetAddressFromIpAddress{out_target_address, ip_address, port, out_error} =\u003e {\n                let mut dest: *mut GoslingTargetAddress = ptr::null_mut();\n                let out_target_address = phandle_to_out_pointer(out_target_address, \u0026mut dest);\n                let ip_address = handle_as_pointer(ip_address, \u0026ip_addresses);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                unsafe { gosling_target_address_from_ip_address(out_target_address, ip_address, port, out_error) };\n                if !dest.is_null() {\n                    target_addresses.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::TargetAddressFromDomain{out_target_address, domain, domain_length, port, out_error} =\u003e {\n                let mut dest: *mut GoslingTargetAddress = ptr::null_mut();\n                let out_target_address = phandle_to_out_pointer(out_target_address, \u0026mut dest);\n                let domain_length = buffer_to_size(\u0026domain, \u0026domain_length);\n                let domain = buffer_as_pointer(\u0026domain);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                unsafe { gosling_target_address_from_domain(out_target_address, domain, domain_length, port, out_error) };\n                if !dest.is_null() {\n                    target_addresses.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::TargetAddressFromV3OnionServiceId{out_target_address, service_id, port, out_error} =\u003e {\n                let mut dest: *mut GoslingTargetAddress = ptr::null_mut();\n                let out_target_address = phandle_to_out_pointer(out_target_address, \u0026mut dest);\n                let service_id = handle_as_pointer(service_id, \u0026v3_onion_service_ids);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                unsafe { gosling_target_address_from_v3_onion_service_id(out_target_address, service_id, port, out_error) };\n                if !dest.is_null() {\n                    target_addresses.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n            Function::TargetAddressFromString{out_target_address, target_address, target_address_length, out_error} =\u003e {\n                let mut dest: *mut GoslingTargetAddress = ptr::null_mut();\n                let out_target_address = phandle_to_out_pointer(out_target_address, \u0026mut dest);\n                let target_address_length = buffer_to_size(\u0026target_address, \u0026target_address_length);\n                let target_address = buffer_as_pointer(\u0026target_address);\n                let mut error: *mut GoslingError = ptr::null_mut();\n                let out_error = phandle_to_out_pointer(out_error, \u0026mut error);\n\n                unsafe { gosling_target_address_from_string(out_target_address, target_address, target_address_length, out_error) };\n                if !dest.is_null() {\n                    target_addresses.push(dest);\n                }\n                if !error.is_null() {\n                    errors.push(error);\n                }\n            },\n        }\n    }\n});\n","traces":[{"line":448,"address":[],"length":0,"stats":{"Line":0}},{"line":449,"address":[],"length":0,"stats":{"Line":0}},{"line":450,"address":[],"length":0,"stats":{"Line":0}},{"line":451,"address":[],"length":0,"stats":{"Line":0}},{"line":452,"address":[],"length":0,"stats":{"Line":0}},{"line":453,"address":[],"length":0,"stats":{"Line":0}},{"line":455,"address":[],"length":0,"stats":{"Line":0}},{"line":457,"address":[],"length":0,"stats":{"Line":0}},{"line":458,"address":[],"length":0,"stats":{"Line":0}},{"line":460,"address":[],"length":0,"stats":{"Line":0}},{"line":463,"address":[],"length":0,"stats":{"Line":0}},{"line":466,"address":[],"length":0,"stats":{"Line":0}},{"line":467,"address":[],"length":0,"stats":{"Line":0}},{"line":468,"address":[],"length":0,"stats":{"Line":0}},{"line":469,"address":[],"length":0,"stats":{"Line":0}},{"line":470,"address":[],"length":0,"stats":{"Line":0}},{"line":471,"address":[],"length":0,"stats":{"Line":0}},{"line":473,"address":[],"length":0,"stats":{"Line":0}},{"line":475,"address":[],"length":0,"stats":{"Line":0}},{"line":476,"address":[],"length":0,"stats":{"Line":0}},{"line":478,"address":[],"length":0,"stats":{"Line":0}},{"line":481,"address":[],"length":0,"stats":{"Line":0}},{"line":484,"address":[],"length":0,"stats":{"Line":0}},{"line":485,"address":[],"length":0,"stats":{"Line":0}},{"line":486,"address":[],"length":0,"stats":{"Line":0}},{"line":487,"address":[],"length":0,"stats":{"Line":0}},{"line":492,"address":[],"length":0,"stats":{"Line":0}},{"line":493,"address":[],"length":0,"stats":{"Line":0}},{"line":494,"address":[],"length":0,"stats":{"Line":0}},{"line":495,"address":[],"length":0,"stats":{"Line":0}},{"line":496,"address":[],"length":0,"stats":{"Line":0}},{"line":498,"address":[],"length":0,"stats":{"Line":0}},{"line":500,"address":[],"length":0,"stats":{"Line":0}},{"line":501,"address":[],"length":0,"stats":{"Line":0}},{"line":503,"address":[],"length":0,"stats":{"Line":0}},{"line":508,"address":[],"length":0,"stats":{"Line":0}},{"line":509,"address":[],"length":0,"stats":{"Line":0}},{"line":510,"address":[],"length":0,"stats":{"Line":0}},{"line":511,"address":[],"length":0,"stats":{"Line":0}},{"line":512,"address":[],"length":0,"stats":{"Line":0}},{"line":513,"address":[],"length":0,"stats":{"Line":0}},{"line":515,"address":[],"length":0,"stats":{"Line":0}},{"line":518,"address":[],"length":0,"stats":{"Line":0}},{"line":519,"address":[],"length":0,"stats":{"Line":0}},{"line":520,"address":[],"length":0,"stats":{"Line":0}},{"line":521,"address":[],"length":0,"stats":{"Line":0}},{"line":523,"address":[],"length":0,"stats":{"Line":0}},{"line":526,"address":[],"length":0,"stats":{"Line":0}},{"line":527,"address":[],"length":0,"stats":{"Line":0}},{"line":528,"address":[],"length":0,"stats":{"Line":0}},{"line":529,"address":[],"length":0,"stats":{"Line":0}},{"line":531,"address":[],"length":0,"stats":{"Line":0}}],"covered":0,"coverable":52},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","src","callbacks.rs"],"content":"// standard\nuse std::os::raw::c_char;\n\n// extern crates\nuse anyhow::bail;\n#[cfg(feature = \"impl-lib\")]\nuse cgosling_proc_macros::*;\n\n// internal crates\nuse crate::context::*;\nuse crate::crypto::*;\nuse crate::error::*;\nuse crate::macros::*;\n\n#[derive(Default, Clone)]\npub(crate) struct EventCallbacks {\n    // tor events\n    pub tor_bootstrap_status_received_callback: GoslingTorBootstrapStatusReceivedCallback,\n    pub tor_bootstrap_completed_callback: GoslingTorBootstrapCompletedCallback,\n    pub tor_log_received_callback: GoslingTorLogReceivedCallback,\n\n    // identity client events\n    pub identity_client_challenge_response_size_callback:\n        GoslingIdentityClientHandshakeChallengeResponseSizeCallback,\n    pub identity_client_build_challenge_response_callback:\n        GoslingIdentityClientHandshakeBuildChallengeResponseCallback,\n    pub identity_client_handshake_completed_callback:\n        GoslingIdentityClientHandshakeCompletedCallback,\n    pub identity_client_handshake_failed_callback: GoslingIdentityClientHandshakeFailedCallback,\n\n    // identity server events\n    pub identity_server_published_callback: GoslingIdentityServerPublishedCallback,\n    pub identity_server_handshake_started_callback: GoslingIdentityServerHandshakeStartedCallback,\n    pub identity_server_client_allowed_callback:\n        GoslingIdentityServerHandshakeClientAllowedCallback,\n    pub identity_server_endpoint_supported_callback: GoslingIdentityServerEndpointSupportedCallback,\n    pub identity_server_challenge_size_callback:\n        GoslingIdentityServerHandshakeChallengeSizeCallback,\n    pub identity_server_build_challenge_callback:\n        GoslingIdentityServerHandshakeBuildChallengeCallback,\n    pub identity_server_verify_challenge_response_callback:\n        GoslingIdentityServerHandshakeVerifyChallengeResponseCallback,\n    pub identity_server_handshake_completed_callback:\n        GoslingIdentityServerHandshakeCompletedCallback,\n    pub identity_server_handshake_rejected_callback: GoslingIdentityServerHandshakeRejectedCallback,\n    pub identity_server_handshake_failed_callback: GoslingIdentityServerHandshakeFailedCallback,\n\n    // endpoint client events\n    pub endpoint_client_handshake_completed_callback:\n        GoslingEndpointClientHandshakeCompletedCallback,\n    pub endpoint_client_handshake_failed_callback: GoslingEndpointClientHandshakeFailedCallback,\n\n    // endpoint server events\n    pub endpoint_server_published_callback: GoslingEndpointServerPublishedCallback,\n    pub endpoint_server_handshake_started_callback: GoslingEndpointServerHandshakeStartedCallback,\n    pub endpoint_server_channel_supported_callback: GoslingEndpointServerChannelSupportedCallback,\n    pub endpoint_server_handshake_completed_callback:\n        GoslingEndpointServerHandshakeCompletedCallback,\n    pub endpoint_server_handshake_rejected_callback: GoslingEndpointServerHandshakeRejectedCallback,\n    pub endpoint_server_handshake_failed_callback: GoslingEndpointServerHandshakeFailedCallback,\n}\n\n/// The function pointer type for the tor bootstrap status received callback. This\n/// callback is called when context's tor daemon's bootstrap status has progressed.\n///\n/// @param context: the context associated with this event\n/// @param progress: an unsigned integer from 0 to 100 indicating the current completion\n///  perentage of the context's bootstrap process\n/// @param tag: the null-terminated short name of the current bootstrap stage\n/// @param tag_length: the number of chrs in tag not including any null-terminator\n/// @param summary: the null-terminated description of the current bootstra stage\n/// @param summary_length: the number of chars in summary not including the null-terminator\npub type GoslingTorBootstrapStatusReceivedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        progress: u32,\n        tag: *const c_char,\n        tag_length: usize,\n        summary: *const c_char,\n        summary_length: usize,\n    ) -\u003e (),\n\u003e;\n\n/// The function pointer type for the tor boootstrap completed callback. This callback\n/// is called when the context's tor daemon's bootstrap process has completed.\n///\n/// @param context: the context associated with this event\npub type GoslingTorBootstrapCompletedCallback =\n    Option\u003cextern \"C\" fn(context: *mut GoslingContext) -\u003e ()\u003e;\n\n/// The function pointer type for the tor log received callback. This callback is called\n/// whenever the context's tor daemon prints new log lines.\n///\n/// @param context: the context associated with this event\n/// @param line: the null-terminated received log line\n/// @param line_length: the number of chars in line not including the null-terminator\npub type GoslingTorLogReceivedCallback = Option\u003c\n    extern \"C\" fn(context: *mut GoslingContext, line: *const c_char, line_length: usize) -\u003e (),\n\u003e;\n\n/// The function pointer type for the client handshake challenge response size\n/// callback. This callback is called when a client needs to know how much memory\n/// to allocate for a challenge response.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: pointer to the client handshake handle this callback\n///  invocation is associated with; null if no client handshake init callback was\n///  provided\n/// @param challenge_buffer: the source buffer containing a BSON document received\n///  from the  identity server to serve as an endpoint request challenge\n/// @param challenge_buffer_size: the number of bytes in challenge_buffer\n/// @return the number of bytes required to store the challenge response object\npub type GoslingIdentityClientHandshakeChallengeResponseSizeCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        challenge_buffer: *const u8,\n        challenge_buffer_size: usize,\n    ) -\u003e usize,\n\u003e;\n\n/// The function pointer type for the identity client handshake build challlenge\n/// response callback. This callback is called when a client is ready to build a\n/// challenge response object.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param challenge_buffer: the source buffer containing a BSON document received\n///  from the  identity server to serve as an endpoint request challenge\n/// @param challenge_buffer_size: the number of bytes in challenge_buffer\n/// @param out_challenge_response_buffer: the destination buffer for the callback\n///  to write a BSON document representing the endpoint request challenge response\n///  object\n/// @param out_challenge_response_buffer_size: the number of bytes allocated in\n///  out_challenge_response_buffer\npub type GoslingIdentityClientHandshakeBuildChallengeResponseCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        challenge_buffer: *const u8,\n        challenge_buffer_size: usize,\n        out_challenge_response_buffer: *mut u8,\n        out_challenge_response_buffer_size: usize,\n    ) -\u003e (),\n\u003e;\n\n/// The function pointer type for the identity client handshake completed callback. This\n/// callback is called whenever the client successfully completes a handshake with an\n/// identity server and is granted access to an endpoint server.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param identity_service_id: the onion service id of the identity server the client\n///  has successfully completed a hadshake with\n/// @param endpoint_service_id: the onion service id of the endpoint server the client\n///  now has access to\n/// @param endpoint_name: the null-terminated name of the provided endpoint server\n/// @param endpoint_name_length: the number of chars in endpoint_name string not including\n///  the null-terminator\n/// @param client_auth_private_key: the client's x25519 private required to connect to\n///  the provided endpoint server\npub type GoslingIdentityClientHandshakeCompletedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        identity_service_id: *const GoslingV3OnionServiceId,\n        endpoint_service_id: *const GoslingV3OnionServiceId,\n        endpoint_name: *const c_char,\n        endpoint_name_length: usize,\n        client_auth_private_key: *const GoslingX25519PrivateKey,\n    ) -\u003e (),\n\u003e;\n\n/// The function pointer type for the identity client handshake handshake failed\n/// callback. This callback is called when a client's identity handshake fails.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param error: error associated with this failure\npub type GoslingIdentityClientHandshakeFailedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        error: *const GoslingError,\n    ) -\u003e (),\n\u003e;\n\n/// The function pointer type for the identity server published callback. This callback\n/// is called whenever the onion service of the identity server associated with the given\n/// context is published and should be reachable by clients.\n///\n/// @param context: the context associated with this event\npub type GoslingIdentityServerPublishedCallback =\n    Option\u003cextern \"C\" fn(context: *mut GoslingContext) -\u003e ()\u003e;\n\n/// The function pointer type of the identity server handshake started callback. This callback\n/// is called whenever the identity server is initially connected to.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\npub type GoslingIdentityServerHandshakeStartedCallback = Option\u003c\n    extern \"C\" fn(context: *mut GoslingContext, handshake_handle: GoslingHandshakeHandle) -\u003e (),\n\u003e;\n\n/// The function pointer type of the identity server handshake client allowed callback.\n/// The result of this callback partially determines if an incoming client handshake\n/// request is possible to complete. For instance an implementation of this function\n//  may reference an allow/block list to determime if identity handshakes can be\n/// completed.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param client_service_id: the v3 onion service id of the connected client\n/// @return true if the server wants to allow the requesting client to connect client may complete the handshake, false otherwise\npub type GoslingIdentityServerHandshakeClientAllowedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        client_service_id: *const GoslingV3OnionServiceId,\n    ) -\u003e bool,\n\u003e;\n\n/// The function pointer type of the identity server endpoint supported callback. This\n/// callback is called when the server needs to determine if the client's requested\n/// endpoint is supported. The result of this callback partially determines if an\n/// incoming client handshake request is possible to complete.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param endpoint_name: a null-terminated ASCII string containing the name of the\n///  endpoint being requested\n/// @param endpoint_name_length: the number of chars in endpoint_name, not\n///  including the null-terminator\n/// @return true if the server can handle requests for the requested endpoint,\n///  false otherwise\npub type GoslingIdentityServerEndpointSupportedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        endpoint_name: *const c_char,\n        endpoint_name_length: usize,\n    ) -\u003e bool,\n\u003e;\n\n/// The function pointer type for the server handshake challenge size callback.\n/// This callback is called when a server needs to know how much memory to allocate\n/// for a challenge.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @return the number of bytes required to store the challenge object\npub type GoslingIdentityServerHandshakeChallengeSizeCallback = Option\u003c\n    extern \"C\" fn(context: *mut GoslingContext, handshake_handle: GoslingHandshakeHandle) -\u003e usize,\n\u003e;\n\n/// The function pointer type for the server handshake build challenge callback.\n/// This callback is called when a server needs to build a challenge object.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param out_challenge_buffer: the destination buffer for the callback\n///  to write a BSON document representing the endpoint request challenge object\n/// @param out_challenge_buffer_size: the number of bytes allocated in\n///  out_challenge_buffer\npub type GoslingIdentityServerHandshakeBuildChallengeCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        out_challenge_buffer: *mut u8,\n        out_challenge_buffer_size: usize,\n    ) -\u003e (),\n\u003e;\n\n/// The function poointer type for the server handshake verify challenge response\n/// callback. This callback is called when a server needs to verify a challenge\n/// response object.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param challenge_response_buffer: a buffer containing the BSON document representing\n///  the endpoint request challenge response object\n/// @param challenge_response_buffer_size: the number of bytes in\n///  challenge_response_buffer\n/// @return the result of the challenge response verification\npub type GoslingIdentityServerHandshakeVerifyChallengeResponseCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        challenge_response_buffer: *const u8,\n        challenge_response_buffer_size: usize,\n    ) -\u003e bool,\n\u003e;\n\n/// The function pointer type for the identity server handshake completed callback. This\n/// callback is called whenever the identity server has successfully completed a\n/// handshake with and granted to a connecting identity client.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param endpoint_private_key: the ed25519 private key of the endpoint server to host\n///  for the client\n/// @param endpoint_name: the null-terminated name of the new endpoint server\n/// @param endpoint_name_length: the length of the endpoint_name string not including\n///  the null-terminator\n/// @param client_service_id: the onion service id of the client we have granted\n///  access to\n/// @param client_auth_public_key: the x25519 public key to use to encrypt the endpoint\n///  server's service descriptor as provided by the connecting client\npub type GoslingIdentityServerHandshakeCompletedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        endpoint_private_key: *const GoslingEd25519PrivateKey,\n        endpoint_name: *const c_char,\n        endpoint_name_length: usize,\n        client_service_id: *const GoslingV3OnionServiceId,\n        client_auth_public_key: *const GoslingX25519PublicKey,\n    ) -\u003e (),\n\u003e;\n\n/// The function pointer type of the identity server handshake rejected callback. This\n/// callback is called whenever the identity server has rejected an identity client's\n/// handshake.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param client_allowed: true if requesting client is allowed, false otherwies\n/// @param client_requested_endpoint_valid: true if requesting client requested a\n///  valid endpoint, false otherwise\n/// @param client_proof_signature_valid: true if the requesting client properly\n///  signed the identity proof, false otherwise\n/// @param client_auth_signature_valid: true if the requesting client properly signed\n///  the authorization proof, false othewise\n/// @param challenge_response_valid: true if the requesting client's challenge\n///  response was accepted by the server, false otherwise\npub type GoslingIdentityServerHandshakeRejectedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        client_allowed: bool,\n        client_requested_endpoint_valid: bool,\n        client_proof_signature_valid: bool,\n        client_auth_signature_valid: bool,\n        challenge_response_valid: bool,\n    ) -\u003e (),\n\u003e;\n\n/// The function pointer type for the identity server handshake handshake failed\n/// callback. This callback is called when a server's identity handshake fails.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param error: error associated with this failure\npub type GoslingIdentityServerHandshakeFailedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        error: *const GoslingError,\n    ) -\u003e (),\n\u003e;\n\n/// The function pointer type for the endpoint client handshake completed callback.\n/// This callback is called when the client successfully connects to an endpoint server.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param endpoint_service_id: the onion service id of the endpoint server the client\n///  has connected to\n/// @param channel_name: the null-terminated name of the channel name requested by the\n///  the client\n/// @param channel_name_length: the number of chars in channel_name not including the\n///  null-terminator\n/// @param stream: os-specific tcp socket handle associated with the connection to the\n///  endpoint server\npub type GoslingEndpointClientHandshakeCompletedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        endpoint_service_id: *const GoslingV3OnionServiceId,\n        channel_name: *const c_char,\n        channel_name_length: usize,\n        stream: GoslingTcpSocket,\n    ),\n\u003e;\n\n/// The function pointer type for the endpoint client handshake handshake failed\n/// callback. This callback is called when a client's endpoint handshake fails.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param error: error associated with this failure\npub type GoslingEndpointClientHandshakeFailedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        error: *const GoslingError,\n    ) -\u003e (),\n\u003e;\n\n/// The function pointer type for the endpoint server published callback. This callbcak\n/// is called whenever the onion service of the indicated endpoint server associted with\n/// the given context is published and should be reachable by clients.\n///\n/// @param context: the context associated with this event\n/// @param endpoint_service_id: the onion service id of the published endpoint server\n/// @param endpoint_name: the null-terminated name of the endpoint server published\n/// @param endpoint_name_length: the number of chars in endpoint_name string not including the\n///  null-terminator\npub type GoslingEndpointServerPublishedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        endpoint_service_id: *const GoslingV3OnionServiceId,\n        endpoint_name: *const c_char,\n        endpoint_name_length: usize,\n    ) -\u003e (),\n\u003e;\n\n/// The function pointer type of the endpoint server handshake started callback. This\n/// callback is called whenever the endpoint server is initially connected to.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\npub type GoslingEndpointServerHandshakeStartedCallback = Option\u003c\n    extern \"C\" fn(context: *mut GoslingContext, handshake_handle: GoslingHandshakeHandle) -\u003e (),\n\u003e;\n\n/// The function pointer type of the endpoint server channel supported callback. This\n/// callback is called when the server needs to determine if the client's requested\n/// channel is supported. The result of this callback partially determines if an\n/// incoming endpoint client handshake request is possible to complete.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param client_service_id: the onion service id of the connected endpoint client\n/// @param channel_name: a null-terminated ASCII string containing the name of the\n///  endpoint being requested\n/// @param channel_name_length: the number of chars in endpoint_name, not\n///  including the null-terminator\n/// @return true if the server can handle requests for the requested channel,\n///  false otherwise\npub type GoslingEndpointServerChannelSupportedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        client_service_id: *const GoslingV3OnionServiceId,\n        channel_name: *const c_char,\n        channel_name_length: usize,\n    ) -\u003e bool,\n\u003e;\n\n/// The function pointer type for the endpoint server handshake completed callback.\n/// This callback is called when an endpoint server completes a handshake with an\n/// endpoint client.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param endpoint_service_id: the onion service id of the endpoint server the\n///  endpoint client has connected to\n/// @param client_service_id: the onion service id of the connected endpoint client\n/// @param channel_name: the null-terminated name of the channel requested by the client\n/// @param channel_name_length: the number of chars in channel_name not including the\n///  null-terminator\n/// @param stream: os-specific tcp socket handle associated with the connection to the\n///  endpoint client\npub type GoslingEndpointServerHandshakeCompletedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        endpoint_service_id: *const GoslingV3OnionServiceId,\n        client_service_id: *const GoslingV3OnionServiceId,\n        channel_name: *const c_char,\n        channel_name_length: usize,\n        stream: GoslingTcpSocket,\n    ),\n\u003e;\n\n/// The function pointer type of the endpoint server handshake rejected callback. This\n/// callback is called whenever the endpoint server has rejected an endpoint client's\n/// handshake.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param client_allowed: true if requesting client is allowed, false otherwies\n/// @param client_requested_channel_valid: true if requesting client requested a\n///  valid endpoint, false otherwise\n/// @param client_proof_signature_valid: true if the requesting client properly\n///  signed the endpoint proof, false otherwise\npub type GoslingEndpointServerHandshakeRejectedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        client_allowed: bool,\n        client_requested_channel_valid: bool,\n        client_proof_signature_valid: bool,\n    ) -\u003e (),\n\u003e;\n\n/// The function pointer type for the endpoint server handshake handshake failed\n/// callback. This callback is called when a server's endpoint handshake fails.\n///\n/// @param context: the context associated with this event\n/// @param handshake_handle: the handshake handle this callback is associated with\n/// @param error: error associated with this failure\npub type GoslingEndpointServerHandshakeFailedCallback = Option\u003c\n    extern \"C\" fn(\n        context: *mut GoslingContext,\n        handshake_handle: GoslingHandshakeHandle,\n        error: *const GoslingError,\n    ) -\u003e (),\n\u003e;\n\nmacro_rules! impl_callback_setter {\n    ($callback_type:tt, $context:expr, $callback:expr, $error:expr) =\u003e {\n        paste::paste! {\n            translate_failures((), $error, || -\u003e anyhow::Result\u003c()\u003e {\n                let mut context_tuple_registry = get_context_tuple_registry();\n                let context = match context_tuple_registry.get_mut($context as usize) {\n                    Some(context) =\u003e context,\n                    None =\u003e {\n                        bail_invalid_handle!(context);\n                    }\n                };\n                context.1.[\u003c$callback_type\u003e] = $callback;\n                Ok(())\n            })\n        }\n    };\n}\n\n/// Set the tor bootstrap status received callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_tor_bootstrap_status_received_callback(\n    context: *mut GoslingContext,\n    callback: GoslingTorBootstrapStatusReceivedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        tor_bootstrap_status_received_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the tor bootstrap completed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_tor_bootstrap_completed_callback(\n    context: *mut GoslingContext,\n    callback: GoslingTorBootstrapCompletedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(tor_bootstrap_completed_callback, context, callback, error);\n}\n\n/// Sets the tor log received callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_tor_log_received_callback(\n    context: *mut GoslingContext,\n    callback: GoslingTorLogReceivedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(tor_log_received_callback, context, callback, error);\n}\n\n/// Sets the identity challenge challenge response size callback for the specified\n/// context\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_client_challenge_response_size_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityClientHandshakeChallengeResponseSizeCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_client_challenge_response_size_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Sets the identity client build challenge response callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_client_build_challenge_response_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityClientHandshakeBuildChallengeResponseCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_client_build_challenge_response_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the identity client handshake completed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_client_handshake_completed_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityClientHandshakeCompletedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_client_handshake_completed_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the identity client handshake failed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_client_handshake_failed_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityClientHandshakeFailedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_client_handshake_failed_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the identity server published callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_server_published_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityServerPublishedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(identity_server_published_callback, context, callback, error);\n}\n\n/// Set the identity server handshake started callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_server_handshake_started_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityServerHandshakeStartedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_server_handshake_started_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Sets the identity server client allowed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_server_client_allowed_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityServerHandshakeClientAllowedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_server_client_allowed_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Sets the identity server endpoint supported callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_server_endpoint_supported_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityServerEndpointSupportedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_server_endpoint_supported_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Sets the identity server challenge size callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on erro\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_server_challenge_size_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityServerHandshakeChallengeSizeCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_server_challenge_size_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Sets the identity server build challenge callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on erro\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_server_build_challenge_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityServerHandshakeBuildChallengeCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_server_build_challenge_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Sets the identity server verify challenge response callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on erro\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_server_verify_challenge_response_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityServerHandshakeVerifyChallengeResponseCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_server_verify_challenge_response_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the identity server request completed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_server_handshake_completed_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityServerHandshakeCompletedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_server_handshake_completed_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the identity server request rejeced callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_server_handshake_rejected_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityServerHandshakeRejectedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_server_handshake_rejected_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the identity server request failed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_identity_server_handshake_failed_callback(\n    context: *mut GoslingContext,\n    callback: GoslingIdentityServerHandshakeFailedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        identity_server_handshake_failed_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the endpoint client handshake completed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_endpoint_client_handshake_completed_callback(\n    context: *mut GoslingContext,\n    callback: GoslingEndpointClientHandshakeCompletedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        endpoint_client_handshake_completed_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the endpoint client handshake failed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_endpoint_client_handshake_failed_callback(\n    context: *mut GoslingContext,\n    callback: GoslingEndpointClientHandshakeFailedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        endpoint_client_handshake_failed_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the endpoint server published callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_endpoint_server_published_callback(\n    context: *mut GoslingContext,\n    callback: GoslingEndpointServerPublishedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(endpoint_server_published_callback, context, callback, error);\n}\n\n/// Set the endpoint server handshake started callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_endpoint_server_handshake_started_callback(\n    context: *mut GoslingContext,\n    callback: GoslingEndpointServerHandshakeStartedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        endpoint_server_handshake_started_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the endpoint server handshake started callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_endpoint_server_channel_supported_callback(\n    context: *mut GoslingContext,\n    callback: GoslingEndpointServerChannelSupportedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        endpoint_server_channel_supported_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the endpoint server channel request completed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_endpoint_server_handshake_completed_callback(\n    context: *mut GoslingContext,\n    callback: GoslingEndpointServerHandshakeCompletedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        endpoint_server_handshake_completed_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the endpoint server channel request completed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_endpoint_server_handshake_rejected_callback(\n    context: *mut GoslingContext,\n    callback: GoslingEndpointServerHandshakeRejectedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        endpoint_server_handshake_rejected_callback,\n        context,\n        callback,\n        error\n    );\n}\n\n/// Set the endpoint server channel request completed callback for the specified context.\n///\n/// @param context: the context to register the callback to\n/// @param callback: the callback to register\n/// @param  error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_set_endpoint_server_handshake_failed_callback(\n    context: *mut GoslingContext,\n    callback: GoslingEndpointServerHandshakeFailedCallback,\n    error: *mut *mut GoslingError,\n) {\n    impl_callback_setter!(\n        endpoint_server_handshake_failed_callback,\n        context,\n        callback,\n        error\n    );\n}\n","traces":[{"line":515,"address":[2811866,2811610,2811034,2811354,2811802,2810458,2810842,2811674,2811162,2811546,2811226,2811290,2810970,2810650,2811098,2811738,2810906,2810330,2810522,2810714,2810778,2811418,2811482,2810394,2810586],"length":1,"stats":{"Line":38}},{"line":516,"address":[1629166,1630078,1633118,1628862,1630990,1632814,1634942,1629470,1635246,1630382,1633726,1632206,1631294,1634334,1628558,1627950,1629774,1630686,1631598,1633422,1631902,1632510,1634030,1634638,1628254],"length":1,"stats":{"Line":19}},{"line":517,"address":[1634412,1630764,1635268,1635324,1633804,1630100,1629244,1633196,1630404,1630708,1634108,1631620,1632892,1628580,1627972,1633444,1634660,1631980,1629796,1631068,1632532,1629548,1628028,1629492,1633748,1628332,1632836,1628636,1630460,1632284,1634716,1631012,1635020,1629852,1631372,1634356,1629188,1631924,1630156,1631676,1632228,1634964,1634052,1628276,1628884,1631316,1628940,1633140,1632588,1633500],"length":1,"stats":{"Line":38}},{"line":518,"address":[1630237,1631149,1632669,1635101,1632061,1635405,1634493,1628413,1634797,1629325,1632973,1629629,1633277,1631757,1630541,1632365,1628109,1629933,1631453,1633581,1633885,1629021,1630845,1634189,1628717],"length":1,"stats":{"Line":19}},{"line":523,"address":[1635119,1629343,1634815,1630255,1632687,1629039,1633599,1632079,1631167,1633295,1629647,1630863,1634207,1628431,1629951,1631775,1635423,1630559,1631471,1628127,1628735,1632383,1632991,1633903,1634511],"length":1,"stats":{"Line":19}},{"line":524,"address":[1632390,1634518,1632998,1634214,1634822,1628742,1629350,1629654,1632086,1629958,1628438,1629046,1630566,1630262,1631478,1630870,1632694,1635430,1633302,1633606,1628134,1633910,1631782,1631174,1635126],"length":1,"stats":{"Line":19}},{"line":537,"address":[2810288,2810337],"length":1,"stats":{"Line":0}},{"line":542,"address":[3195747],"length":1,"stats":{"Line":0}},{"line":557,"address":[2810352,2810401],"length":1,"stats":{"Line":1}},{"line":562,"address":[1628324,1628423],"length":1,"stats":{"Line":2}},{"line":572,"address":[2810416,2810465],"length":1,"stats":{"Line":0}},{"line":577,"address":[1628727,1628628],"length":1,"stats":{"Line":0}},{"line":588,"address":[2810529,2810480],"length":1,"stats":{"Line":1}},{"line":593,"address":[1629031],"length":1,"stats":{"Line":1}},{"line":608,"address":[2810544,2810593],"length":1,"stats":{"Line":1}},{"line":613,"address":[1629236],"length":1,"stats":{"Line":1}},{"line":628,"address":[2810608,2810657],"length":1,"stats":{"Line":1}},{"line":633,"address":[1629540],"length":1,"stats":{"Line":1}},{"line":648,"address":[2810721,2810672],"length":1,"stats":{"Line":1}},{"line":653,"address":[1629844],"length":1,"stats":{"Line":1}},{"line":668,"address":[2810785,2810736],"length":1,"stats":{"Line":1}},{"line":673,"address":[1630148,1630247],"length":1,"stats":{"Line":2}},{"line":683,"address":[2810849,2810800],"length":1,"stats":{"Line":0}},{"line":688,"address":[1630551],"length":1,"stats":{"Line":0}},{"line":703,"address":[2810913,2810864],"length":1,"stats":{"Line":1}},{"line":708,"address":[1630756],"length":1,"stats":{"Line":1}},{"line":723,"address":[2810928,2810977],"length":1,"stats":{"Line":1}},{"line":728,"address":[1631159],"length":1,"stats":{"Line":1}},{"line":743,"address":[2811041,2810992],"length":1,"stats":{"Line":1}},{"line":748,"address":[1631463],"length":1,"stats":{"Line":1}},{"line":763,"address":[2811105,2811056],"length":1,"stats":{"Line":1}},{"line":768,"address":[1631668],"length":1,"stats":{"Line":1}},{"line":783,"address":[2811169,2811120],"length":1,"stats":{"Line":1}},{"line":788,"address":[3199804],"length":1,"stats":{"Line":1}},{"line":803,"address":[2811184,2811233],"length":1,"stats":{"Line":1}},{"line":808,"address":[3200227],"length":1,"stats":{"Line":1}},{"line":823,"address":[2811297,2811248],"length":1,"stats":{"Line":0}},{"line":828,"address":[1632580],"length":1,"stats":{"Line":0}},{"line":843,"address":[2811361,2811312],"length":1,"stats":{"Line":1}},{"line":848,"address":[3200867],"length":1,"stats":{"Line":1}},{"line":863,"address":[2811425,2811376],"length":1,"stats":{"Line":1}},{"line":868,"address":[1633188],"length":1,"stats":{"Line":1}},{"line":883,"address":[2811440,2811489],"length":1,"stats":{"Line":1}},{"line":888,"address":[1633492],"length":1,"stats":{"Line":1}},{"line":903,"address":[2811553,2811504],"length":1,"stats":{"Line":1}},{"line":908,"address":[3201827,3201724],"length":1,"stats":{"Line":2}},{"line":918,"address":[2811617,2811568],"length":1,"stats":{"Line":0}},{"line":923,"address":[1634199],"length":1,"stats":{"Line":0}},{"line":938,"address":[2811681,2811632],"length":1,"stats":{"Line":1}},{"line":943,"address":[1634503],"length":1,"stats":{"Line":1}},{"line":958,"address":[2811696,2811745],"length":1,"stats":{"Line":1}},{"line":963,"address":[1634807],"length":1,"stats":{"Line":1}},{"line":978,"address":[2811809,2811760],"length":1,"stats":{"Line":0}},{"line":983,"address":[1635012],"length":1,"stats":{"Line":0}},{"line":998,"address":[2811824,2811873],"length":1,"stats":{"Line":1}},{"line":1003,"address":[1635316],"length":1,"stats":{"Line":1}}],"covered":44,"coverable":56},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","src","context.rs"],"content":"// standard\nuse std::collections::VecDeque;\nuse std::ffi::CString;\nuse std::io::Cursor;\nuse std::os::raw::c_char;\n#[cfg(unix)]\nuse std::os::unix::io::{IntoRawFd, RawFd};\n#[cfg(windows)]\nuse std::os::windows::io::{IntoRawSocket, RawSocket};\nuse std::time::Duration;\n\n// extern crates\nuse anyhow::anyhow;\nuse anyhow::bail;\n#[cfg(feature = \"impl-lib\")]\nuse cgosling_proc_macros::*;\nuse gosling::context::*;\nuse tor_interface::tor_crypto::*;\n\n// internal\nuse crate::callbacks::*;\nuse crate::crypto::*;\nuse crate::error::Error;\nuse crate::error::*;\nuse crate::ffi::*;\nuse crate::macros::*;\nuse crate::tor_provider::*;\n\n// empty bson document layout:\n// {\n//     // document length 5 == 0x00000005\n//     0x05, 0x00, 0x00, 0x00,\n//     // document null-terminator\n//     0x00\n// };\nconst SMALLEST_BSON_DOC_SIZE: usize = 5;\n\n/// A handle for an in-progress identity handhskae\npub type GoslingHandshakeHandle = usize;\n#[cfg(any(target_os = \"linux\", target_os = \"macos\"))]\n/// A native TCP socket handle\npub type GoslingTcpSocket = RawFd;\n#[cfg(any(target_os = \"windows\"))]\n/// A native TCP socket handle\npub type GoslingTcpSocket = RawSocket;\n/// A context object associated with a single peer identity\npub struct GoslingContext;\n/// cbindgen:ignore\ntype ContextTuple = (Context, EventCallbacks, Option\u003cVecDeque\u003cContextEvent\u003e\u003e);\ndefine_registry! {ContextTuple}\n\n/// Frees a gosling_context object\n///\n/// @param in_context: the context object to free\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_free(in_context: *mut GoslingContext) {\n    impl_registry_free!(in_context, ContextTuple);\n}\n\n/// Initialize a gosling context.\n///\n/// @param out_context: returned initialied gosling context\n/// @param in_tor_provider: the tor client implementation to use; this function consumes the tor_provider\n///  and it may not be re-used in subsequent gosling_* calls, and it does not need to be freed\n/// @param identity_port: the tor virtual port the identity server listens on\n/// @param endpoint_port: the tor virtual port endpoint servers listen on\n/// @param identity_private_key: the e25519 private key used to start th identity server's onion service\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_context_init(\n    // out context\n    out_context: *mut *mut GoslingContext,\n    in_tor_provider: *mut GoslingTorProvider,\n    identity_port: u16,\n    endpoint_port: u16,\n    identity_private_key: *const GoslingEd25519PrivateKey,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_context);\n        ensure_not_null!(in_tor_provider);\n        ensure_not_equal!(identity_port, 0);\n        ensure_not_equal!(endpoint_port, 0);\n        ensure_not_null!(identity_private_key);\n\n        // get our tor provider\n        let tor_provider = match get_tor_provider_registry().remove(in_tor_provider as usize) {\n            Some(tor_provider) =\u003e tor_provider,\n            None =\u003e bail_invalid_handle!(tor_provider),\n        };\n\n        // get our identity key\n        let ed25519_private_key_registry = get_ed25519_private_key_registry();\n        let identity_private_key =\n            match ed25519_private_key_registry.get(identity_private_key as usize) {\n                Some(identity_private_key) =\u003e identity_private_key,\n                None =\u003e bail_invalid_handle!(identity_private_key),\n            };\n\n        // construct context\n        let context = Context::new(\n            tor_provider,\n            identity_port,\n            endpoint_port,\n            Duration::from_secs(60),\n            4096,\n            Some(Duration::from_secs(60)),\n            identity_private_key.clone(),\n        )?;\n\n        let handle = get_context_tuple_registry().insert((context, Default::default(), None));\n        *out_context = handle as *mut GoslingContext;\n\n        Ok(())\n    });\n}\n\n/// Connect a gosling_context to the tor network\n///\n/// @param context: the gosling context object to connect to the tor network\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_bootstrap_tor(\n    context: *mut GoslingContext,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(context);\n\n        let mut context_tuple_registry = get_context_tuple_registry();\n        let context = match context_tuple_registry.get_mut(context as usize) {\n            Some(context) =\u003e context,\n            None =\u003e bail_invalid_handle!(context),\n        };\n        Ok(context.0.bootstrap()?)\n    });\n}\n\n/// Start the identity server so that clients may request endpoints\n///\n/// @param context: the gosling context whose identity server to start\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_start_identity_server(\n    context: *mut GoslingContext,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(context);\n\n        let mut context_tuple_registry = get_context_tuple_registry();\n        let context = match context_tuple_registry.get_mut(context as usize) {\n            Some(context) =\u003e context,\n            None =\u003e bail_invalid_handle!(context),\n        };\n        Ok(context.0.identity_server_start()?)\n    });\n}\n\n/// Stop the identity server so clients can no longer request endpoints\n///\n/// @param context: the gosling context whose identity server to stop\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_stop_identity_server(\n    context: *mut GoslingContext,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(context);\n\n        let mut context_tuple_registry = get_context_tuple_registry();\n        let context = match context_tuple_registry.get_mut(context as usize) {\n            Some(context) =\u003e context,\n            None =\u003e bail_invalid_handle!(context),\n        };\n        Ok(context.0.identity_server_stop()?)\n    });\n}\n\n/// Start an endpoint server so the confirmed contact may connect\n///\n/// @param context: the gosling context with the given endpoint to start\n/// @param endpoint_private_key: the ed25519 private key needed to start the endpoint\n///  onion service\n/// @param endpoint_name: the ascii-encoded name of the endpoint server\n/// @param endpoint_name_length: the number of chars in endpoint name not including any null-terminator\n/// @param client_identity: the v3 onion service id of the gosling client associated with this endpoint\n/// @param client_auth_public_key: the x25519 public key used to encrypt the onion service descriptor\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_start_endpoint_server(\n    context: *mut GoslingContext,\n    endpoint_private_key: *const GoslingEd25519PrivateKey,\n    endpoint_name: *const c_char,\n    endpoint_name_length: usize,\n    client_identity: *const GoslingV3OnionServiceId,\n    client_auth_public_key: *const GoslingX25519PublicKey,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(context);\n        ensure_not_null!(endpoint_private_key);\n        ensure_not_null!(endpoint_name);\n        ensure_not_equal!(endpoint_name_length, 0);\n        ensure_not_null!(client_identity);\n        ensure_not_null!(client_auth_public_key);\n\n        let mut context_tuple_registry = get_context_tuple_registry();\n        let context = match context_tuple_registry.get_mut(context as usize) {\n            Some(context) =\u003e context,\n            None =\u003e bail_invalid_handle!(context),\n        };\n\n        let endpoint_name =\n            unsafe { std::slice::from_raw_parts(endpoint_name as *const u8, endpoint_name_length) };\n        let endpoint_name = std::str::from_utf8(endpoint_name)?.to_string();\n        if !endpoint_name.is_ascii() {\n            bail!(\"endpoint_name must be an ascii string\");\n        }\n\n        let ed25519_private_key_registry = get_ed25519_private_key_registry();\n        let endpoint_private_key =\n            match ed25519_private_key_registry.get(endpoint_private_key as usize) {\n                Some(ed25519_private_key) =\u003e ed25519_private_key,\n                None =\u003e bail_invalid_handle!(endpoint_private_key),\n            };\n\n        let v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n        let client_identity = match v3_onion_service_id_registry.get(client_identity as usize) {\n            Some(v3_onion_service_id) =\u003e v3_onion_service_id,\n            None =\u003e bail_invalid_handle!(client_identity),\n        };\n\n        let x25519_public_key_registry = get_x25519_public_key_registry();\n        let client_auth_public_key =\n            match x25519_public_key_registry.get(client_auth_public_key as usize) {\n                Some(x25519_public_key) =\u003e x25519_public_key,\n                None =\u003e bail_invalid_handle!(client_auth_public_key),\n            };\n\n        Ok(context.0.endpoint_server_start(\n            endpoint_private_key.clone(),\n            endpoint_name,\n            client_identity.clone(),\n            client_auth_public_key.clone(),\n        )?)\n    });\n}\n\n/// Stops an endpoint server\n///\n/// @param context: the gosling context associated with the endpoint server\n/// @param endpoint_private_key: the ed25519 private key associated with the endpoint server to stop\n/// @param error: filled on erro\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_stop_endpoint_server(\n    context: *mut GoslingContext,\n    endpoint_private_key: *const GoslingEd25519PrivateKey,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(context);\n        ensure_not_null!(endpoint_private_key);\n\n        let mut context_tuple_registry = get_context_tuple_registry();\n        let context = match context_tuple_registry.get_mut(context as usize) {\n            Some(context) =\u003e context,\n            None =\u003e bail_invalid_handle!(context),\n        };\n\n        let ed25519_private_key_registry = get_ed25519_private_key_registry();\n        let endpoint_private_key =\n            match ed25519_private_key_registry.get(endpoint_private_key as usize) {\n                Some(ed25519_private_key) =\u003e ed25519_private_key,\n                None =\u003e bail_invalid_handle!(endpoint_private_key),\n            };\n\n        let endpoint_identity = V3OnionServiceId::from_private_key(endpoint_private_key);\n        Ok(context.0.endpoint_server_stop(endpoint_identity)?)\n    });\n}\n\n/// Connect to and begin a handshake to request an endpoint from the given identity server\n///\n/// @param context: the context to request an endpoint server for\n/// @param identity_service_id: the service id of the identity server we want to request an endpoint server\n///  from\n/// @param endpoint_name: the name of the endpoint server to request\n/// @param endpoint_name_length: the number of chars in endpoin_name not including any null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_begin_identity_handshake(\n    context: *mut GoslingContext,\n    identity_service_id: *const GoslingV3OnionServiceId,\n    endpoint_name: *const c_char,\n    endpoint_name_length: usize,\n    error: *mut *mut GoslingError,\n) -\u003e GoslingHandshakeHandle {\n    translate_failures(\n        !0usize,\n        error,\n        || -\u003e anyhow::Result\u003cGoslingHandshakeHandle\u003e {\n            ensure_not_null!(context);\n            ensure_not_null!(identity_service_id);\n            ensure_not_null!(endpoint_name);\n            ensure_not_equal!(endpoint_name_length, 0);\n\n            let mut context_tuple_registry = get_context_tuple_registry();\n            let context = match context_tuple_registry.get_mut(context as usize) {\n                Some(context) =\u003e context,\n                None =\u003e bail_invalid_handle!(context),\n            };\n\n            let v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n            let identity_service_id =\n                match v3_onion_service_id_registry.get(identity_service_id as usize) {\n                    Some(v3_onion_service_id) =\u003e v3_onion_service_id,\n                    None =\u003e bail_invalid_handle!(identity_service_id),\n                };\n\n            let endpoint_name = unsafe {\n                std::slice::from_raw_parts(endpoint_name as *const u8, endpoint_name_length)\n            };\n            let endpoint_name = std::str::from_utf8(endpoint_name)?.to_string();\n            if !endpoint_name.is_ascii() {\n                bail!(\"endpoint_name must be an ascii string\")\n            }\n\n            Ok(context\n                .0\n                .identity_client_begin_handshake(identity_service_id.clone(), endpoint_name)?)\n        },\n    )\n}\n\n/// Abort an in-progress identity client handshake\n///\n/// @param context: the context associated with the identity client handshake handle\n/// @param handshake_handle: the handle associated with the identity client handshake\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_abort_identity_client_handshake(\n    context: *mut GoslingContext,\n    handshake_handle: GoslingHandshakeHandle,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(context);\n\n        let mut context_tuple_registry = get_context_tuple_registry();\n        let context = match context_tuple_registry.get_mut(context as usize) {\n            Some(context) =\u003e context,\n            None =\u003e bail_invalid_handle!(context),\n        };\n\n        Ok(context\n            .0\n            .identity_client_abort_handshake(handshake_handle)?)\n    })\n}\n\n/// Connect to and begin a handshake to request a channel from the given endpoint server\n///\n/// @param context: the context which will be opening the channel\n/// @param endpoint_service_id: the endpoint server to open a channel to\n/// @param client_auth_private_key: the x25519 clienth authorization key needed to decrypt the endpoint server's\n///  onion service descriptor\n/// @param channel_name: the ascii-encoded name of the channel to open\n/// @param channel_name_length: the number of chars in channel name not including any null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_begin_endpoint_handshake(\n    context: *mut GoslingContext,\n    endpoint_service_id: *const GoslingV3OnionServiceId,\n    client_auth_private_key: *const GoslingX25519PrivateKey,\n    channel_name: *const c_char,\n    channel_name_length: usize,\n    error: *mut *mut GoslingError,\n) -\u003e GoslingHandshakeHandle {\n    translate_failures(\n        !0usize,\n        error,\n        || -\u003e anyhow::Result\u003cGoslingHandshakeHandle\u003e {\n            ensure_not_null!(context);\n            ensure_not_null!(endpoint_service_id);\n            ensure_not_null!(client_auth_private_key);\n            ensure_not_null!(channel_name);\n            ensure_not_equal!(channel_name_length, 0);\n\n            let mut context_tuple_registry = get_context_tuple_registry();\n            let context = match context_tuple_registry.get_mut(context as usize) {\n                Some(context) =\u003e context,\n                None =\u003e bail_invalid_handle!(context),\n            };\n\n            let v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n            let endpoint_service_id =\n                match v3_onion_service_id_registry.get(endpoint_service_id as usize) {\n                    Some(v3_onion_service_id) =\u003e v3_onion_service_id,\n                    None =\u003e bail_invalid_handle!(endpoint_service_id),\n                };\n\n            let x25519_private_key_registry = get_x25519_private_key_registry();\n            let client_auth_private_key =\n                match x25519_private_key_registry.get(client_auth_private_key as usize) {\n                    Some(x25519_private_key) =\u003e x25519_private_key,\n                    None =\u003e bail_invalid_handle!(client_auth_private_key),\n                };\n\n            let channel_name = unsafe {\n                std::slice::from_raw_parts(channel_name as *const u8, channel_name_length)\n            };\n            let channel_name = std::str::from_utf8(channel_name)?.to_string();\n            if !channel_name.is_ascii() {\n                bail!(\"channel_name must be an ascii string\");\n            }\n\n            Ok(context.0.endpoint_client_begin_handshake(\n                endpoint_service_id.clone(),\n                client_auth_private_key.clone(),\n                channel_name,\n            )?)\n        },\n    )\n}\n\n/// Abort an in-progress endpoint client handshake\n///\n/// @param context: the context associated with the endpoint client handshake handle\n/// @param handshake_handle: the handle associated with the identity client handshake\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_abort_endpoint_client_handshake(\n    context: *mut GoslingContext,\n    handshake_handle: GoslingHandshakeHandle,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(context);\n\n        let mut context_tuple_registry = get_context_tuple_registry();\n        let context = match context_tuple_registry.get_mut(context as usize) {\n            Some(context) =\u003e context,\n            None =\u003e bail_invalid_handle!(context),\n        };\n\n        Ok(context\n            .0\n            .endpoint_client_abort_handshake(handshake_handle)?)\n    })\n}\n\nfn handle_context_event(\n    event: ContextEvent,\n    context: *mut GoslingContext,\n    callbacks: \u0026EventCallbacks,\n) -\u003e anyhow::Result\u003c()\u003e {\n    match event {\n        //\n        // Tor Events\n        //\n        ContextEvent::TorBootstrapStatusReceived {\n            progress,\n            tag,\n            summary,\n        } =\u003e {\n            if let Some(callback) = callbacks.tor_bootstrap_status_received_callback {\n                let tag0 = CString::new(tag.as_str()).expect(\n                    \"bootstrap status tag string should not have an intermediate null byte\",\n                );\n                let summary0 = CString::new(summary.as_str()).expect(\n                    \"bootstrap status summary string should not have an intermediate null byte\",\n                );\n                callback(\n                    context,\n                    progress,\n                    tag0.as_ptr(),\n                    tag.len(),\n                    summary0.as_ptr(),\n                    summary.len(),\n                );\n            }\n        }\n        ContextEvent::TorBootstrapCompleted =\u003e {\n            if let Some(callback) = callbacks.tor_bootstrap_completed_callback {\n                callback(context);\n            }\n        }\n        ContextEvent::TorLogReceived { line } =\u003e {\n            if let Some(callback) = callbacks.tor_log_received_callback {\n                let line0 = CString::new(line.as_str())\n                    .expect(\"tor log line string should not have an intermediate null byte\");\n                callback(context, line0.as_ptr(), line.len());\n            }\n        }\n        //\n        // Identity Client Events\n        //\n        ContextEvent::IdentityClientChallengeReceived {\n            handle,\n            endpoint_challenge,\n        } =\u003e {\n            // construct challenge response\n            let challenge_response = if let (\n                Some(challenge_response_size_callback),\n                Some(build_challenge_response_callback),\n            ) = (\n                callbacks.identity_client_challenge_response_size_callback,\n                callbacks.identity_client_build_challenge_response_callback,\n            ) {\n                let mut endpoint_challenge_buffer: Vec\u003cu8\u003e = Default::default();\n                endpoint_challenge.to_writer(\u0026mut endpoint_challenge_buffer).expect(\"endpoint_challenge should be a valid bson::document::Document and therefore serializable to Vec\u003cu8\u003e\");\n\n                // get the size of challenge response bson blob\n                let challenge_response_size = challenge_response_size_callback(\n                    context,\n                    handle,\n                    endpoint_challenge_buffer.as_ptr(),\n                    endpoint_challenge_buffer.len(),\n                );\n\n                if challenge_response_size \u003c SMALLEST_BSON_DOC_SIZE {\n                    bail!(\"identity_client_challenge_response_size_callback returned an impossibly small size '{}', smallest possible is {}\", challenge_response_size, SMALLEST_BSON_DOC_SIZE);\n                }\n\n                // get the challenge response bson blob\n                let mut challenge_response_buffer: Vec\u003cu8\u003e = vec![0u8; challenge_response_size];\n                build_challenge_response_callback(\n                    context,\n                    handle,\n                    endpoint_challenge_buffer.as_ptr(),\n                    endpoint_challenge_buffer.len(),\n                    challenge_response_buffer.as_mut_ptr(),\n                    challenge_response_buffer.len(),\n                );\n\n                // convert bson blob to bson object\n                match bson::document::Document::from_reader(Cursor::new(challenge_response_buffer))\n                {\n                    Ok(challenge_response) =\u003e challenge_response,\n                    Err(_) =\u003e bail!(\"failed to parse binary provided by identity_client_build_challenge_response_callback as BSON document\")\n                }\n            } else {\n                bail!(\"missing required identity_client_challenge_response_size() and identity_client_build_challenge_response() callbacks\");\n            };\n\n            match get_context_tuple_registry().get_mut(context as usize) {\n                Some(context) =\u003e context\n                    .0\n                    .identity_client_handle_challenge_received(handle, challenge_response)?,\n                None =\u003e bail_invalid_handle!(context),\n            };\n        }\n        ContextEvent::IdentityClientHandshakeCompleted {\n            handle,\n            identity_service_id,\n            endpoint_service_id,\n            endpoint_name,\n            client_auth_private_key,\n        } =\u003e {\n            if let Some(callback) = callbacks.identity_client_handshake_completed_callback {\n                let (identity_service_id, endpoint_service_id) = {\n                    let mut v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n                    let identity_service_id =\n                        v3_onion_service_id_registry.insert(identity_service_id);\n                    let endpoint_service_id =\n                        v3_onion_service_id_registry.insert(endpoint_service_id);\n                    (identity_service_id, endpoint_service_id)\n                };\n\n                let endpoint_name0 = CString::new(endpoint_name.as_str())\n                    .expect(\"endpoint_name should be a valid ASCII string and not have an intermediate null byte\");\n\n                let client_auth_private_key =\n                    get_x25519_private_key_registry().insert(client_auth_private_key);\n\n                callback(\n                    context,\n                    handle,\n                    identity_service_id as *const GoslingV3OnionServiceId,\n                    endpoint_service_id as *const GoslingV3OnionServiceId,\n                    endpoint_name0.as_ptr(),\n                    endpoint_name.len(),\n                    client_auth_private_key as *const GoslingX25519PrivateKey,\n                );\n\n                // cleanup\n                {\n                    let mut v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n                    v3_onion_service_id_registry.remove(identity_service_id);\n                    v3_onion_service_id_registry.remove(endpoint_service_id);\n                }\n                get_x25519_private_key_registry().remove(client_auth_private_key);\n            } else {\n                bail!(\"missing required identity_client_handshake_completed() callback\");\n            }\n        }\n        ContextEvent::IdentityClientHandshakeFailed { handle, reason } =\u003e {\n            if let Some(callback) = callbacks.identity_client_handshake_failed_callback {\n                let key = get_error_registry().insert(Error::new(format!(\"{:?}\", reason).as_str()));\n                callback(context, handle, key as *const GoslingError);\n                get_error_registry().remove(key);\n            }\n        }\n        //\n        // Identity Server Events\n        //\n        ContextEvent::IdentityServerPublished =\u003e {\n            if let Some(callback) = callbacks.identity_server_published_callback {\n                callback(context);\n            }\n        }\n        ContextEvent::IdentityServerHandshakeStarted { handle } =\u003e {\n            if let Some(callback) = callbacks.identity_server_handshake_started_callback {\n                callback(context, handle);\n            }\n        }\n        ContextEvent::IdentityServerEndpointRequestReceived {\n            handle,\n            client_service_id,\n            requested_endpoint,\n        } =\u003e {\n            let client_allowed = match callbacks.identity_server_client_allowed_callback {\n                Some(callback) =\u003e {\n                    let client_service_id =\n                        get_v3_onion_service_id_registry().insert(client_service_id);\n                    callback(\n                        context,\n                        handle,\n                        client_service_id as *const GoslingV3OnionServiceId,\n                    )\n                }\n                None =\u003e bail!(\"missing required identity_server_client_allowed() callback\"),\n            };\n\n            let endpoint_supported = match callbacks.identity_server_endpoint_supported_callback {\n                Some(callback) =\u003e {\n                    let requested_endpoint0 = CString::new(requested_endpoint.as_str()).expect(\n                        \"requested_endpoint should be a valid ASCII string and not have an intermediate null byte\",\n                    );\n                    callback(\n                        context,\n                        handle,\n                        requested_endpoint0.as_ptr(),\n                        requested_endpoint.len(),\n                    )\n                }\n                None =\u003e bail!(\"missing required identity_server_endpoint_supported() callback\"),\n            };\n            let endpoint_challenge = if let (\n                Some(challenge_size_callback),\n                Some(build_challenge_callback),\n            ) = (\n                callbacks.identity_server_challenge_size_callback,\n                callbacks.identity_server_build_challenge_callback,\n            ) {\n                // get the challenge size in bytes\n                let challenge_size = challenge_size_callback(context, handle);\n\n                if challenge_size \u003c SMALLEST_BSON_DOC_SIZE {\n                    bail!(\"identity_server_challenge_size_callback returned an impossibly small size '{}', smallest possible is {}\", challenge_size, SMALLEST_BSON_DOC_SIZE);\n                }\n\n                // construct challenge object into buffer\n                let mut challenge_buffer = vec![0u8; challenge_size];\n                build_challenge_callback(\n                    context,\n                    handle,\n                    challenge_buffer.as_mut_ptr(),\n                    challenge_size,\n                );\n\n                // convert bson blob to bson object\n                match bson::document::Document::from_reader(Cursor::new(challenge_buffer)) {\n                    Ok(challenge) =\u003e challenge,\n                    Err(_) =\u003e bail!(\"failed to parse binary provided by identity_server_build_challenge_callback as BSON document\")\n                }\n            } else {\n                bail!(\"missing required identity_server_challenge_size() and identity_server_build_challenge() callbacks\");\n            };\n\n            match get_context_tuple_registry().get_mut(context as usize) {\n                Some(context) =\u003e context.0.identity_server_handle_endpoint_request_received(\n                    handle,\n                    client_allowed,\n                    endpoint_supported,\n                    endpoint_challenge,\n                )?,\n                None =\u003e bail_invalid_handle!(context),\n            };\n        }\n        ContextEvent::IdentityServerChallengeResponseReceived {\n            handle,\n            challenge_response,\n        } =\u003e {\n            let challenge_response_valid = match callbacks\n                .identity_server_verify_challenge_response_callback\n            {\n                Some(callback) =\u003e {\n                    // get response as bytes\n                    let mut challenge_response_buffer: Vec\u003cu8\u003e = Default::default();\n                    challenge_response\n                            .to_writer(\u0026mut challenge_response_buffer).expect(\"challenge_response should be a valid bson::document::Document and therefore serializable to Vec\u003cu8\u003e\");\n\n                    callback(\n                        context,\n                        handle,\n                        challenge_response_buffer.as_ptr(),\n                        challenge_response_buffer.len(),\n                    )\n                }\n                None =\u003e {\n                    bail!(\"missing required identity_server_verify_challenge_response() callback()\")\n                }\n            };\n\n            match get_context_tuple_registry().get_mut(context as usize) {\n                Some(context) =\u003e context\n                    .0\n                    .identity_server_handle_challenge_response_received(\n                        handle,\n                        challenge_response_valid,\n                    )?,\n                None =\u003e bail_invalid_handle!(context),\n            };\n        }\n        ContextEvent::IdentityServerHandshakeCompleted {\n            handle,\n            endpoint_private_key,\n            endpoint_name,\n            client_service_id,\n            client_auth_public_key,\n        } =\u003e {\n            if let Some(callback) = callbacks.identity_server_handshake_completed_callback {\n                let endpoint_private_key = {\n                    let mut ed25519_private_key_registry = get_ed25519_private_key_registry();\n                    ed25519_private_key_registry.insert(endpoint_private_key)\n                };\n\n                let endpoint_name0 = CString::new(endpoint_name.as_str())\n                    .expect(\"endpoint_name should be a valid ASCII string and not have an intermediate null byte\");\n\n                let client_service_id = {\n                    let mut v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n                    v3_onion_service_id_registry.insert(client_service_id)\n                };\n\n                let client_auth_public_key = {\n                    let mut x25519_public_key_registry = get_x25519_public_key_registry();\n                    x25519_public_key_registry.insert(client_auth_public_key)\n                };\n\n                callback(\n                    context,\n                    handle,\n                    endpoint_private_key as *const GoslingEd25519PrivateKey,\n                    endpoint_name0.as_ptr(),\n                    endpoint_name.len(),\n                    client_service_id as *const GoslingV3OnionServiceId,\n                    client_auth_public_key as *const GoslingX25519PublicKey,\n                );\n\n                // cleanup\n                get_ed25519_private_key_registry().remove(endpoint_private_key);\n                get_v3_onion_service_id_registry().remove(client_service_id);\n                get_x25519_public_key_registry().remove(client_auth_public_key);\n            } else {\n                bail!(\"missing required identity_server_handshake_completed_callback()\");\n            }\n        }\n        ContextEvent::IdentityServerHandshakeRejected {\n            handle,\n            client_allowed,\n            client_requested_endpoint_valid,\n            client_proof_signature_valid,\n            client_auth_signature_valid,\n            challenge_response_valid,\n        } =\u003e {\n            if let Some(callback) = callbacks.identity_server_handshake_rejected_callback {\n                callback(\n                    context,\n                    handle,\n                    client_allowed,\n                    client_requested_endpoint_valid,\n                    client_proof_signature_valid,\n                    client_auth_signature_valid,\n                    challenge_response_valid,\n                );\n            }\n        }\n        ContextEvent::IdentityServerHandshakeFailed { handle, reason } =\u003e {\n            if let Some(callback) = callbacks.identity_server_handshake_failed_callback {\n                let key = get_error_registry().insert(Error::new(format!(\"{:?}\", reason).as_str()));\n                callback(context, handle, key as *const GoslingError);\n                get_error_registry().remove(key);\n            }\n        }\n        //\n        // Endpoint Client Events\n        //\n        ContextEvent::EndpointClientHandshakeCompleted {\n            endpoint_service_id,\n            handle,\n            channel_name,\n            stream,\n        } =\u003e {\n            if let Some(callback) = callbacks.endpoint_client_handshake_completed_callback {\n                let endpoint_service_id = {\n                    let mut v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n                    v3_onion_service_id_registry.insert(endpoint_service_id)\n                };\n                let channel_name0 = CString::new(channel_name.as_str())\n                    .expect(\"channel_name should be a valid ASCII string and not have an intermediate null byte\");\n\n                #[cfg(any(target_os = \"linux\", target_os = \"macos\"))]\n                let stream = stream.into_raw_fd();\n                #[cfg(target_os = \"windows\")]\n                let stream = stream.into_raw_socket();\n\n                callback(\n                    context,\n                    handle,\n                    endpoint_service_id as *const GoslingV3OnionServiceId,\n                    channel_name0.as_ptr(),\n                    channel_name.len(),\n                    stream,\n                );\n\n                // cleanup\n                get_v3_onion_service_id_registry().remove(endpoint_service_id);\n            } else {\n                bail!(\"missing required endpoint_client_handshake_completed() callback\");\n            }\n        }\n        ContextEvent::EndpointClientHandshakeFailed { handle, reason } =\u003e {\n            if let Some(callback) = callbacks.endpoint_client_handshake_failed_callback {\n                let key = get_error_registry().insert(Error::new(format!(\"{:?}\", reason).as_str()));\n                callback(context, handle, key as *const GoslingError);\n                get_error_registry().remove(key);\n            }\n        }\n        //\n        // Endpoint Server Events\n        //\n        ContextEvent::EndpointServerPublished {\n            endpoint_service_id,\n            endpoint_name,\n        } =\u003e {\n            if let Some(callback) = callbacks.endpoint_server_published_callback {\n                let endpoint_service_id = {\n                    let mut v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n                    v3_onion_service_id_registry.insert(endpoint_service_id)\n                };\n                let endpoint_name0 = CString::new(endpoint_name.as_str())\n                    .expect(\"endpoint_name should be a valid ASCII string and not have an intermediate null byte\");\n\n                callback(\n                    context,\n                    endpoint_service_id as *const GoslingV3OnionServiceId,\n                    endpoint_name0.as_ptr(),\n                    endpoint_name.len(),\n                );\n\n                // cleanup\n                get_v3_onion_service_id_registry().remove(endpoint_service_id);\n            }\n        }\n        ContextEvent::EndpointServerHandshakeStarted { handle } =\u003e {\n            if let Some(callback) = callbacks.endpoint_server_handshake_started_callback {\n                callback(context, handle);\n            }\n        }\n        ContextEvent::EndpointServerChannelRequestReceived {\n            handle,\n            client_service_id,\n            requested_channel,\n        } =\u003e {\n            let channel_supported: bool = match callbacks.endpoint_server_channel_supported_callback\n            {\n                Some(callback) =\u003e {\n                    let client_service_id = {\n                        let mut v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n                        v3_onion_service_id_registry.insert(client_service_id)\n                    };\n                    let requested_channel0 = CString::new(requested_channel.as_str()).expect(\"requested_channel should be a valid ASCII string and not have an intermediate null byte\",\n                    );\n                    let channel_supported = callback(\n                        context,\n                        handle,\n                        client_service_id as *const GoslingV3OnionServiceId,\n                        requested_channel0.as_ptr(),\n                        requested_channel.len(),\n                    );\n\n                    // cleanup\n                    get_v3_onion_service_id_registry().remove(client_service_id);\n                    channel_supported\n                }\n                None =\u003e bail!(\"missing required endpoint_server_channel_supported() callback\"),\n            };\n\n            match get_context_tuple_registry().get_mut(context as usize) {\n                Some(context) =\u003e context\n                    .0\n                    .endpoint_server_handle_channel_request_received(handle, channel_supported)?,\n                None =\u003e return Err(anyhow!(\"context is invalid\")),\n            };\n        }\n        ContextEvent::EndpointServerHandshakeCompleted {\n            handle,\n            endpoint_service_id,\n            client_service_id,\n            channel_name,\n            stream,\n        } =\u003e {\n            if let Some(callback) = callbacks.endpoint_server_handshake_completed_callback {\n                let (endpoint_service_id, client_service_id) = {\n                    let mut v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n                    let endpoint_service_id =\n                        v3_onion_service_id_registry.insert(endpoint_service_id);\n                    let client_service_id = v3_onion_service_id_registry.insert(client_service_id);\n                    (endpoint_service_id, client_service_id)\n                };\n\n                let channel_name0 = CString::new(channel_name.as_str())\n                    .expect(\"channel_name should be a valid ASCII string and not have an intermediate null byte\");\n\n                #[cfg(any(target_os = \"linux\", target_os = \"macos\"))]\n                let stream = stream.into_raw_fd();\n                #[cfg(target_os = \"windows\")]\n                let stream = stream.into_raw_socket();\n\n                callback(\n                    context,\n                    handle,\n                    endpoint_service_id as *const GoslingV3OnionServiceId,\n                    client_service_id as *const GoslingV3OnionServiceId,\n                    channel_name0.as_ptr(),\n                    channel_name.len(),\n                    stream,\n                );\n\n                // cleanup\n                {\n                    let mut v3_onion_service_id_registry = get_v3_onion_service_id_registry();\n                    v3_onion_service_id_registry.remove(endpoint_service_id);\n                    v3_onion_service_id_registry.remove(client_service_id);\n                }\n            } else {\n                bail!(\"missing required endpoint_server_handshake_completed() callback\");\n            }\n        }\n        ContextEvent::EndpointServerHandshakeRejected {\n            handle,\n            client_allowed,\n            client_requested_channel_valid,\n            client_proof_signature_valid,\n        } =\u003e {\n            if let Some(callback) = callbacks.endpoint_server_handshake_rejected_callback {\n                callback(\n                    context,\n                    handle,\n                    client_allowed,\n                    client_requested_channel_valid,\n                    client_proof_signature_valid,\n                );\n            }\n        }\n        ContextEvent::EndpointServerHandshakeFailed { handle, reason } =\u003e {\n            if let Some(callback) = callbacks.endpoint_server_handshake_failed_callback {\n                let key = get_error_registry().insert(Error::new(format!(\"{:?}\", reason).as_str()));\n                callback(context, handle, key as *const GoslingError);\n                get_error_registry().remove(key);\n            }\n        }\n    }\n    Ok(())\n}\n\n/// Update the internal gosling context state and process event callbacks\n///\n/// @param context: the context object we are updating\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_poll_events(\n    context: *mut GoslingContext,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        // we need to scope the context registry explicitly here\n        // in case our callbacks want to call any gosling functions\n        // to avoid deadlock (since a mutex is held while the context_tuple_registry\n        // is accesible)\n        let (mut context_events, callbacks) =\n            match get_context_tuple_registry().get_mut(context as usize) {\n                Some(context) =\u003e {\n                    // get our new events\n                    let mut new_events = context.0.update()?;\n                    // get a copy of our callbacks\n                    let callbacks = context.1.clone();\n\n                    // append new_events to any existing events if they exist,\n                    // otherwise just pass through new_events\n                    let context_events = match std::mem::take(\u0026mut context.2) {\n                        Some(mut context_events) =\u003e {\n                            context_events.append(\u0026mut new_events);\n                            context_events\n                        }\n                        None =\u003e {\n                            // no previous events so just pass through the new events\n                            new_events\n                        }\n                    };\n                    (context_events, callbacks)\n                }\n                None =\u003e bail_invalid_handle!(context),\n            };\n\n        // consume the events and trigger any callbacks\n        while let Some(event) = context_events.pop_front() {\n            let result = handle_context_event(event, context, \u0026callbacks);\n            if result.is_err() {\n                // if we have remaining events to consume, save them off on\n                // the context\n                if !context_events.is_empty() {\n                    if let Some(context) = get_context_tuple_registry().get_mut(context as usize) {\n                        context.2 = Some(context_events);\n                    }\n                }\n                // return the error\n                return result;\n            }\n        }\n        Ok(())\n    });\n}\n","traces":[{"line":57,"address":[1638240,1638271],"length":1,"stats":{"Line":0}},{"line":72,"address":[2229424,2229535],"length":1,"stats":{"Line":1}},{"line":81,"address":[1840438,1837760,1840326],"length":1,"stats":{"Line":2}},{"line":82,"address":[1837815],"length":1,"stats":{"Line":1}},{"line":83,"address":[2037407],"length":1,"stats":{"Line":1}},{"line":86,"address":[1838243],"length":1,"stats":{"Line":1}},{"line":89,"address":[1838259,1838443],"length":1,"stats":{"Line":2}},{"line":90,"address":[1838576],"length":1,"stats":{"Line":1}},{"line":95,"address":[1838769],"length":1,"stats":{"Line":1}},{"line":97,"address":[2038428,2038515],"length":1,"stats":{"Line":2}},{"line":98,"address":[1839022],"length":1,"stats":{"Line":1}},{"line":103,"address":[2040011,2039423,2039143,2039036],"length":1,"stats":{"Line":2}},{"line":104,"address":[1839046],"length":1,"stats":{"Line":1}},{"line":105,"address":[1839102,1839094],"length":1,"stats":{"Line":2}},{"line":106,"address":[1839113,1839098],"length":1,"stats":{"Line":2}},{"line":107,"address":[2038746],"length":1,"stats":{"Line":1}},{"line":109,"address":[2038925],"length":1,"stats":{"Line":1}},{"line":110,"address":[1839360],"length":1,"stats":{"Line":1}},{"line":113,"address":[2039507,2039276],"length":1,"stats":{"Line":2}},{"line":114,"address":[1840218,1840292],"length":1,"stats":{"Line":1}},{"line":116,"address":[1840252],"length":1,"stats":{"Line":1}},{"line":126,"address":[1638560,1638597],"length":1,"stats":{"Line":1}},{"line":130,"address":[1840480,1841106],"length":1,"stats":{"Line":2}},{"line":131,"address":[1840492],"length":1,"stats":{"Line":1}},{"line":133,"address":[1840509],"length":1,"stats":{"Line":1}},{"line":134,"address":[1840649,1840531],"length":1,"stats":{"Line":2}},{"line":135,"address":[1840738],"length":1,"stats":{"Line":1}},{"line":138,"address":[1841086,1840897,1840846,1840751,1840487],"length":1,"stats":{"Line":3}},{"line":148,"address":[1638661,1638624],"length":1,"stats":{"Line":1}},{"line":152,"address":[1638654],"length":1,"stats":{"Line":2}},{"line":153,"address":[1841148],"length":1,"stats":{"Line":1}},{"line":155,"address":[2040846],"length":1,"stats":{"Line":1}},{"line":156,"address":[1841187,1841305],"length":1,"stats":{"Line":2}},{"line":157,"address":[1841394],"length":1,"stats":{"Line":1}},{"line":160,"address":[1841407,1841502,1841143,1841553,1841742],"length":1,"stats":{"Line":3}},{"line":170,"address":[1638688,1638725],"length":1,"stats":{"Line":0}},{"line":174,"address":[1842418,1841792],"length":1,"stats":{"Line":0}},{"line":175,"address":[1841804],"length":1,"stats":{"Line":0}},{"line":177,"address":[1841821],"length":1,"stats":{"Line":0}},{"line":178,"address":[1841843,1841961],"length":1,"stats":{"Line":0}},{"line":179,"address":[1842050],"length":1,"stats":{"Line":0}},{"line":182,"address":[1842209,1842063,1841799,1842158,1842398],"length":1,"stats":{"Line":0}},{"line":198,"address":[1638866,1638752],"length":1,"stats":{"Line":1}},{"line":207,"address":[2042192,2045540],"length":1,"stats":{"Line":2}},{"line":208,"address":[1842487],"length":1,"stats":{"Line":1}},{"line":209,"address":[1842510],"length":1,"stats":{"Line":1}},{"line":210,"address":[1842618],"length":1,"stats":{"Line":1}},{"line":212,"address":[1842907],"length":1,"stats":{"Line":1}},{"line":213,"address":[1842949],"length":1,"stats":{"Line":1}},{"line":215,"address":[2042809],"length":1,"stats":{"Line":1}},{"line":216,"address":[2043006,2042832],"length":1,"stats":{"Line":2}},{"line":217,"address":[1843346],"length":1,"stats":{"Line":1}},{"line":222,"address":[1843370,1843500],"length":1,"stats":{"Line":2}},{"line":223,"address":[2045648,2043301],"length":1,"stats":{"Line":1}},{"line":224,"address":[1843701,1843781],"length":1,"stats":{"Line":2}},{"line":225,"address":[1843864,1843808],"length":1,"stats":{"Line":0}},{"line":228,"address":[1843834,1843940],"length":1,"stats":{"Line":2}},{"line":230,"address":[1844036,1843965],"length":1,"stats":{"Line":2}},{"line":231,"address":[1844145],"length":1,"stats":{"Line":1}},{"line":235,"address":[2043967,2044067],"length":1,"stats":{"Line":2}},{"line":236,"address":[1844348,1844283],"length":1,"stats":{"Line":2}},{"line":237,"address":[2044272],"length":1,"stats":{"Line":1}},{"line":241,"address":[1844564,1844472],"length":1,"stats":{"Line":2}},{"line":243,"address":[1844589,1844654],"length":1,"stats":{"Line":2}},{"line":244,"address":[1844762],"length":1,"stats":{"Line":1}},{"line":248,"address":[1845126,1845027,1845562,1845317],"length":1,"stats":{"Line":2}},{"line":249,"address":[1844887,1844783],"length":1,"stats":{"Line":2}},{"line":250,"address":[1844895],"length":1,"stats":{"Line":1}},{"line":251,"address":[1844951],"length":1,"stats":{"Line":1}},{"line":252,"address":[1845012],"length":1,"stats":{"Line":1}},{"line":264,"address":[1638929,1638880],"length":1,"stats":{"Line":0}},{"line":269,"address":[2045664,2046936],"length":1,"stats":{"Line":0}},{"line":270,"address":[1845793],"length":1,"stats":{"Line":0}},{"line":271,"address":[1845810],"length":1,"stats":{"Line":0}},{"line":273,"address":[2045791],"length":1,"stats":{"Line":0}},{"line":274,"address":[1846066,1845930],"length":1,"stats":{"Line":0}},{"line":275,"address":[2046076],"length":1,"stats":{"Line":0}},{"line":279,"address":[2046191,2046097],"length":1,"stats":{"Line":0}},{"line":281,"address":[1846305,1846362],"length":1,"stats":{"Line":0}},{"line":282,"address":[2046389],"length":1,"stats":{"Line":0}},{"line":286,"address":[1846482],"length":1,"stats":{"Line":0}},{"line":287,"address":[1846941,1846686,1845783,1846583],"length":1,"stats":{"Line":0}},{"line":301,"address":[2230040,2229936],"length":1,"stats":{"Line":1}},{"line":311,"address":[2049175,2046960],"length":1,"stats":{"Line":2}},{"line":312,"address":[2046983],"length":1,"stats":{"Line":1}},{"line":313,"address":[1847054],"length":1,"stats":{"Line":1}},{"line":314,"address":[2047130],"length":1,"stats":{"Line":1}},{"line":317,"address":[2047457],"length":1,"stats":{"Line":1}},{"line":318,"address":[2047480,2047591],"length":1,"stats":{"Line":2}},{"line":319,"address":[1847728],"length":1,"stats":{"Line":1}},{"line":323,"address":[2047845,2047724],"length":1,"stats":{"Line":2}},{"line":325,"address":[2047943,2047862],"length":1,"stats":{"Line":2}},{"line":326,"address":[1848066],"length":1,"stats":{"Line":1}},{"line":331,"address":[1848211,1848087],"length":1,"stats":{"Line":2}},{"line":333,"address":[1848227,1849199],"length":1,"stats":{"Line":1}},{"line":334,"address":[1848482,1848414],"length":1,"stats":{"Line":2}},{"line":335,"address":[1848503,1848557],"length":1,"stats":{"Line":0}},{"line":338,"address":[1848679,1848953,1849088],"length":1,"stats":{"Line":1}},{"line":340,"address":[1848639,1848825,1848542],"length":1,"stats":{"Line":2}},{"line":352,"address":[2230064,2230113],"length":1,"stats":{"Line":0}},{"line":357,"address":[1639114],"length":1,"stats":{"Line":0}},{"line":358,"address":[1849249],"length":1,"stats":{"Line":0}},{"line":360,"address":[1849266],"length":1,"stats":{"Line":0}},{"line":361,"address":[1849288,1849406],"length":1,"stats":{"Line":0}},{"line":362,"address":[2049542],"length":1,"stats":{"Line":0}},{"line":366,"address":[2049271,2049853,2049563,2049927,2049650],"length":1,"stats":{"Line":0}},{"line":368,"address":[1849668,1849508],"length":1,"stats":{"Line":0}},{"line":383,"address":[1639136,1639255],"length":1,"stats":{"Line":1}},{"line":394,"address":[1852621,1849904],"length":1,"stats":{"Line":2}},{"line":395,"address":[1849927],"length":1,"stats":{"Line":1}},{"line":396,"address":[1849950],"length":1,"stats":{"Line":1}},{"line":397,"address":[1850070],"length":1,"stats":{"Line":1}},{"line":398,"address":[1850190],"length":1,"stats":{"Line":1}},{"line":401,"address":[1850510],"length":1,"stats":{"Line":1}},{"line":402,"address":[1850636,1850541],"length":1,"stats":{"Line":2}},{"line":403,"address":[1850744],"length":1,"stats":{"Line":1}},{"line":407,"address":[1850890,1850768],"length":1,"stats":{"Line":2}},{"line":409,"address":[1850915,1850986],"length":1,"stats":{"Line":2}},{"line":410,"address":[1851095],"length":1,"stats":{"Line":1}},{"line":414,"address":[1851235,1851119],"length":1,"stats":{"Line":2}},{"line":416,"address":[1851260,1851325],"length":1,"stats":{"Line":2}},{"line":417,"address":[1851436],"length":1,"stats":{"Line":1}},{"line":422,"address":[1851457,1851581],"length":1,"stats":{"Line":2}},{"line":424,"address":[1852675,1851597],"length":1,"stats":{"Line":1}},{"line":425,"address":[1851784,1851852],"length":1,"stats":{"Line":2}},{"line":426,"address":[1851930,1851873],"length":1,"stats":{"Line":0}},{"line":429,"address":[1852549,1852357,1852075],"length":1,"stats":{"Line":1}},{"line":430,"address":[1851915],"length":1,"stats":{"Line":1}},{"line":431,"address":[1852020],"length":1,"stats":{"Line":1}},{"line":432,"address":[1852035],"length":1,"stats":{"Line":1}},{"line":445,"address":[1639329,1639280],"length":1,"stats":{"Line":0}},{"line":450,"address":[2230314],"length":1,"stats":{"Line":0}},{"line":451,"address":[1852721],"length":1,"stats":{"Line":0}},{"line":453,"address":[1852738],"length":1,"stats":{"Line":0}},{"line":454,"address":[2052948,2053081],"length":1,"stats":{"Line":0}},{"line":455,"address":[1852967],"length":1,"stats":{"Line":0}},{"line":459,"address":[2053559,2052903,2053195,2053282,2053485],"length":1,"stats":{"Line":0}},{"line":461,"address":[1852980,1853140],"length":1,"stats":{"Line":0}},{"line":465,"address":[2233943,2233862,2230336],"length":1,"stats":{"Line":1}},{"line":470,"address":[1639421],"length":1,"stats":{"Line":1}},{"line":474,"address":[1639584],"length":1,"stats":{"Line":1}},{"line":479,"address":[1642125,1639656],"length":1,"stats":{"Line":1}},{"line":480,"address":[2233249,2233144],"length":1,"stats":{"Line":0}},{"line":483,"address":[1642366,1642449],"length":1,"stats":{"Line":0}},{"line":489,"address":[2233558,2233641],"length":1,"stats":{"Line":0}},{"line":490,"address":[1642664],"length":1,"stats":{"Line":0}},{"line":491,"address":[1642687],"length":1,"stats":{"Line":0}},{"line":492,"address":[1642749],"length":1,"stats":{"Line":0}},{"line":497,"address":[2233972,2230689],"length":1,"stats":{"Line":2}},{"line":498,"address":[1642984],"length":1,"stats":{"Line":1}},{"line":501,"address":[1639747],"length":1,"stats":{"Line":1}},{"line":502,"address":[2230775,2233996],"length":1,"stats":{"Line":1}},{"line":503,"address":[1643024,1643126],"length":1,"stats":{"Line":0}},{"line":505,"address":[1643235,1643318],"length":1,"stats":{"Line":0}},{"line":511,"address":[2230837],"length":1,"stats":{"Line":1}},{"line":516,"address":[2234416,2230875],"length":1,"stats":{"Line":2}},{"line":517,"address":[1643470],"length":1,"stats":{"Line":1}},{"line":518,"address":[1643494],"length":1,"stats":{"Line":1}},{"line":520,"address":[1639875],"length":1,"stats":{"Line":1}},{"line":521,"address":[2230871],"length":1,"stats":{"Line":1}},{"line":523,"address":[1643518],"length":1,"stats":{"Line":1}},{"line":524,"address":[1643581,1643657],"length":1,"stats":{"Line":2}},{"line":530,"address":[1643699],"length":1,"stats":{"Line":1}},{"line":531,"address":[1643714],"length":1,"stats":{"Line":1}},{"line":534,"address":[1643791],"length":1,"stats":{"Line":1}},{"line":535,"address":[1645835,1645972],"length":1,"stats":{"Line":0}},{"line":539,"address":[2234814,2234958],"length":1,"stats":{"Line":2}},{"line":543,"address":[2234966],"length":1,"stats":{"Line":1}},{"line":544,"address":[1644018],"length":1,"stats":{"Line":1}},{"line":545,"address":[1644045],"length":1,"stats":{"Line":1}},{"line":546,"address":[1644072],"length":1,"stats":{"Line":1}},{"line":550,"address":[1644157],"length":1,"stats":{"Line":1}},{"line":552,"address":[1644286],"length":1,"stats":{"Line":1}},{"line":553,"address":[1644513,1645565],"length":1,"stats":{"Line":0}},{"line":556,"address":[2234445,2237109],"length":1,"stats":{"Line":0}},{"line":559,"address":[2235760,2235861,2235663],"length":1,"stats":{"Line":3}},{"line":560,"address":[2235978,2236206,2236409,2236098,2236478],"length":1,"stats":{"Line":3}},{"line":562,"address":[2235994,2236281],"length":1,"stats":{"Line":1}},{"line":566,"address":[1639995],"length":1,"stats":{"Line":1}},{"line":573,"address":[1640137,1646113],"length":1,"stats":{"Line":2}},{"line":574,"address":[2237545],"length":1,"stats":{"Line":1}},{"line":575,"address":[2237197,2237304],"length":1,"stats":{"Line":2}},{"line":576,"address":[2237405,2237321],"length":1,"stats":{"Line":2}},{"line":578,"address":[2237436],"length":1,"stats":{"Line":1}},{"line":583,"address":[1646489],"length":1,"stats":{"Line":1}},{"line":586,"address":[2237794,2237713],"length":1,"stats":{"Line":2}},{"line":594,"address":[1646929],"length":1,"stats":{"Line":1}},{"line":595,"address":[2238087],"length":1,"stats":{"Line":1}},{"line":601,"address":[2238174],"length":1,"stats":{"Line":1}},{"line":602,"address":[2238228,2238323],"length":1,"stats":{"Line":2}},{"line":603,"address":[1647234],"length":1,"stats":{"Line":1}},{"line":605,"address":[2238407],"length":1,"stats":{"Line":1}},{"line":607,"address":[1646155,1647527],"length":1,"stats":{"Line":0}},{"line":610,"address":[2231171],"length":1,"stats":{"Line":0}},{"line":611,"address":[1647683,1640232],"length":1,"stats":{"Line":0}},{"line":612,"address":[2239255,2238931,2239126,2238831],"length":1,"stats":{"Line":0}},{"line":613,"address":[1648346],"length":1,"stats":{"Line":0}},{"line":614,"address":[1648348],"length":1,"stats":{"Line":0}},{"line":621,"address":[1640274,1648585],"length":1,"stats":{"Line":2}},{"line":622,"address":[1648597],"length":1,"stats":{"Line":1}},{"line":625,"address":[1640324],"length":1,"stats":{"Line":1}},{"line":626,"address":[1640344,1648628],"length":1,"stats":{"Line":1}},{"line":627,"address":[1648640],"length":1,"stats":{"Line":0}},{"line":630,"address":[1640386],"length":1,"stats":{"Line":1}},{"line":635,"address":[2231472],"length":1,"stats":{"Line":1}},{"line":636,"address":[1648681],"length":1,"stats":{"Line":1}},{"line":637,"address":[2239861,2240008],"length":1,"stats":{"Line":2}},{"line":645,"address":[2239807,2239935],"length":1,"stats":{"Line":0}},{"line":648,"address":[2240223],"length":1,"stats":{"Line":1}},{"line":649,"address":[2240282],"length":1,"stats":{"Line":1}},{"line":650,"address":[2240401,2240310],"length":1,"stats":{"Line":2}},{"line":656,"address":[2240597,2240514],"length":1,"stats":{"Line":2}},{"line":657,"address":[1649444],"length":1,"stats":{"Line":1}},{"line":660,"address":[2240248,2240341],"length":1,"stats":{"Line":0}},{"line":662,"address":[2240773,2240728],"length":1,"stats":{"Line":2}},{"line":663,"address":[2240847],"length":1,"stats":{"Line":1}},{"line":664,"address":[2240863],"length":1,"stats":{"Line":1}},{"line":666,"address":[2240720],"length":1,"stats":{"Line":1}},{"line":667,"address":[2240724],"length":1,"stats":{"Line":1}},{"line":670,"address":[2240887],"length":1,"stats":{"Line":1}},{"line":672,"address":[2240897],"length":1,"stats":{"Line":1}},{"line":673,"address":[2242823,2242686],"length":1,"stats":{"Line":0}},{"line":677,"address":[2240908,2241052],"length":1,"stats":{"Line":2}},{"line":681,"address":[2241060],"length":1,"stats":{"Line":1}},{"line":686,"address":[1649994],"length":1,"stats":{"Line":1}},{"line":687,"address":[2241299],"length":1,"stats":{"Line":1}},{"line":688,"address":[1651211,1650224],"length":1,"stats":{"Line":0}},{"line":691,"address":[1649626,1651655],"length":1,"stats":{"Line":0}},{"line":694,"address":[2241433,2241530,2241631],"length":1,"stats":{"Line":3}},{"line":695,"address":[2242207,2242276,2241762,2241882,2242004],"length":1,"stats":{"Line":3}},{"line":699,"address":[2241778],"length":1,"stats":{"Line":1}},{"line":704,"address":[1640522],"length":1,"stats":{"Line":1}},{"line":708,"address":[2231564],"length":1,"stats":{"Line":1}},{"line":711,"address":[1651733],"length":1,"stats":{"Line":1}},{"line":713,"address":[2242977],"length":1,"stats":{"Line":1}},{"line":714,"address":[2243106,2243185],"length":1,"stats":{"Line":2}},{"line":720,"address":[1652003],"length":1,"stats":{"Line":1}},{"line":721,"address":[2243250],"length":1,"stats":{"Line":1}},{"line":725,"address":[2242923,2243048],"length":1,"stats":{"Line":0}},{"line":729,"address":[1652255,1652122],"length":1,"stats":{"Line":2}},{"line":730,"address":[1652372,1652681,1652502,1652738],"length":1,"stats":{"Line":2}},{"line":739,"address":[1640748],"length":1,"stats":{"Line":1}},{"line":746,"address":[2231800,2244023],"length":1,"stats":{"Line":2}},{"line":748,"address":[1652889,1652779],"length":1,"stats":{"Line":2}},{"line":749,"address":[2244170,2244238],"length":1,"stats":{"Line":2}},{"line":752,"address":[2244358],"length":1,"stats":{"Line":1}},{"line":756,"address":[2244502,2244583],"length":1,"stats":{"Line":2}},{"line":757,"address":[2244600,2244684],"length":1,"stats":{"Line":2}},{"line":761,"address":[1653442],"length":1,"stats":{"Line":1}},{"line":762,"address":[1653504,1653575],"length":1,"stats":{"Line":2}},{"line":769,"address":[1653645],"length":1,"stats":{"Line":1}},{"line":770,"address":[2245011],"length":1,"stats":{"Line":1}},{"line":776,"address":[1653794],"length":1,"stats":{"Line":1}},{"line":777,"address":[1653976],"length":1,"stats":{"Line":1}},{"line":778,"address":[2245467],"length":1,"stats":{"Line":1}},{"line":780,"address":[1652801,1654402],"length":1,"stats":{"Line":0}},{"line":783,"address":[1640878],"length":1,"stats":{"Line":0}},{"line":791,"address":[1640978,1654571],"length":1,"stats":{"Line":0}},{"line":803,"address":[2232012],"length":1,"stats":{"Line":0}},{"line":804,"address":[1654640,1641073],"length":1,"stats":{"Line":0}},{"line":805,"address":[1655079,1654763,1654950,1654663],"length":1,"stats":{"Line":0}},{"line":806,"address":[1655306],"length":1,"stats":{"Line":0}},{"line":807,"address":[1655308],"length":1,"stats":{"Line":0}},{"line":813,"address":[1641156],"length":1,"stats":{"Line":1}},{"line":819,"address":[1655537,1641230],"length":1,"stats":{"Line":2}},{"line":821,"address":[2247039,2246932],"length":1,"stats":{"Line":2}},{"line":822,"address":[1655692,1655760],"length":1,"stats":{"Line":2}},{"line":824,"address":[1655814],"length":1,"stats":{"Line":1}},{"line":828,"address":[2247342,2247430],"length":1,"stats":{"Line":2}},{"line":836,"address":[1656065],"length":1,"stats":{"Line":1}},{"line":837,"address":[1656127],"length":1,"stats":{"Line":1}},{"line":842,"address":[2247588],"length":1,"stats":{"Line":1}},{"line":844,"address":[2247817,2246954],"length":1,"stats":{"Line":0}},{"line":847,"address":[1641275],"length":1,"stats":{"Line":0}},{"line":848,"address":[2232320,2247973],"length":1,"stats":{"Line":0}},{"line":849,"address":[2247996,2248291,2248096,2248420],"length":1,"stats":{"Line":0}},{"line":850,"address":[2248655],"length":1,"stats":{"Line":0}},{"line":851,"address":[1657241],"length":1,"stats":{"Line":0}},{"line":857,"address":[2232365],"length":1,"stats":{"Line":1}},{"line":861,"address":[1641447,1657470],"length":1,"stats":{"Line":2}},{"line":863,"address":[2248925,2249025],"length":1,"stats":{"Line":2}},{"line":864,"address":[1657618,1657686],"length":1,"stats":{"Line":2}},{"line":866,"address":[1657740],"length":1,"stats":{"Line":1}},{"line":872,"address":[1657904,1657987],"length":1,"stats":{"Line":2}},{"line":873,"address":[1658010],"length":1,"stats":{"Line":1}},{"line":877,"address":[1658067],"length":1,"stats":{"Line":1}},{"line":880,"address":[2232492],"length":1,"stats":{"Line":1}},{"line":881,"address":[1658276,1641520],"length":1,"stats":{"Line":1}},{"line":882,"address":[2249751],"length":1,"stats":{"Line":0}},{"line":885,"address":[2232577],"length":1,"stats":{"Line":1}},{"line":890,"address":[2232651],"length":1,"stats":{"Line":1}},{"line":892,"address":[1658332],"length":1,"stats":{"Line":1}},{"line":894,"address":[2249962,2249815],"length":1,"stats":{"Line":2}},{"line":895,"address":[2250066,2249979],"length":1,"stats":{"Line":2}},{"line":897,"address":[1658652],"length":1,"stats":{"Line":1}},{"line":903,"address":[2250375,2250292],"length":1,"stats":{"Line":2}},{"line":904,"address":[2250398],"length":1,"stats":{"Line":1}},{"line":908,"address":[1659003],"length":1,"stats":{"Line":1}},{"line":911,"address":[2249758,2249889],"length":1,"stats":{"Line":0}},{"line":914,"address":[2250814,2250673],"length":1,"stats":{"Line":2}},{"line":915,"address":[2250915,2230397,2251251,2251312,2251048],"length":1,"stats":{"Line":3}},{"line":917,"address":[2251123],"length":1,"stats":{"Line":0}},{"line":918,"address":[1659378,1659468],"length":1,"stats":{"Line":0}},{"line":921,"address":[1641724],"length":1,"stats":{"Line":1}},{"line":928,"address":[1641849,1659821],"length":1,"stats":{"Line":2}},{"line":929,"address":[1660176],"length":1,"stats":{"Line":1}},{"line":930,"address":[1659844,1659951],"length":1,"stats":{"Line":2}},{"line":931,"address":[1659976,1660044],"length":1,"stats":{"Line":2}},{"line":933,"address":[2251595],"length":1,"stats":{"Line":1}},{"line":937,"address":[2251728],"length":1,"stats":{"Line":1}},{"line":941,"address":[2251968,2251872],"length":1,"stats":{"Line":2}},{"line":950,"address":[2251999],"length":1,"stats":{"Line":1}},{"line":951,"address":[2252061],"length":1,"stats":{"Line":1}},{"line":957,"address":[1660616],"length":1,"stats":{"Line":1}},{"line":958,"address":[2252202,2252297],"length":1,"stats":{"Line":2}},{"line":959,"address":[2252304],"length":1,"stats":{"Line":1}},{"line":962,"address":[1660887,1659866],"length":1,"stats":{"Line":0}},{"line":965,"address":[1641942],"length":1,"stats":{"Line":0}},{"line":971,"address":[1661081,1641982],"length":1,"stats":{"Line":0}},{"line":981,"address":[2233019],"length":1,"stats":{"Line":0}},{"line":982,"address":[2233072,2252679],"length":1,"stats":{"Line":0}},{"line":983,"address":[1661151,1661423,1661552,1661239],"length":1,"stats":{"Line":0}},{"line":984,"address":[2253304],"length":1,"stats":{"Line":0}},{"line":985,"address":[1661742],"length":1,"stats":{"Line":0}},{"line":989,"address":[1642926],"length":1,"stats":{"Line":1}},{"line":998,"address":[1661973,1661936],"length":1,"stats":{"Line":1}},{"line":1002,"address":[1661966],"length":1,"stats":{"Line":2}},{"line":1007,"address":[2054812],"length":1,"stats":{"Line":1}},{"line":1008,"address":[1853492,1853388],"length":1,"stats":{"Line":2}},{"line":1009,"address":[2053848],"length":1,"stats":{"Line":1}},{"line":1011,"address":[1853716,1853851,1855585,1853617],"length":1,"stats":{"Line":2}},{"line":1013,"address":[2054087],"length":1,"stats":{"Line":1}},{"line":1017,"address":[1854055],"length":1,"stats":{"Line":1}},{"line":1018,"address":[1854186],"length":1,"stats":{"Line":0}},{"line":1019,"address":[1854234],"length":1,"stats":{"Line":0}},{"line":1020,"address":[1854462],"length":1,"stats":{"Line":0}},{"line":1024,"address":[1854112],"length":1,"stats":{"Line":1}},{"line":1027,"address":[2054517],"length":1,"stats":{"Line":1}},{"line":1033,"address":[1854700],"length":1,"stats":{"Line":1}},{"line":1034,"address":[2055063,2055118],"length":1,"stats":{"Line":2}},{"line":1035,"address":[1854904,1854849],"length":1,"stats":{"Line":2}},{"line":1038,"address":[1854936],"length":1,"stats":{"Line":0}},{"line":1039,"address":[1854957,1855440,1855096,1855014],"length":1,"stats":{"Line":0}},{"line":1040,"address":[1855288,1855179],"length":1,"stats":{"Line":0}},{"line":1044,"address":[1854973],"length":1,"stats":{"Line":0}},{"line":1047,"address":[1855493],"length":1,"stats":{"Line":1}}],"covered":250,"coverable":346},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","src","crypto.rs"],"content":"// standard\nuse std::os::raw::c_char;\nuse std::str;\n\n// extern crates\nuse anyhow::bail;\n#[cfg(feature = \"impl-lib\")]\nuse cgosling_proc_macros::*;\nuse tor_interface::tor_crypto::*;\n\n// internal crates\nuse crate::error::*;\nuse crate::ffi::*;\nuse crate::macros::*;\n\n/// An ed25519 private key used to create a v3 onion service\npub struct GoslingEd25519PrivateKey;\ndefine_registry! {Ed25519PrivateKey}\n\n/// An x25519 private key used to decrypt v3 onion service descriptors\npub struct GoslingX25519PrivateKey;\ndefine_registry! {X25519PrivateKey}\n\n/// An x25519 public key used to encrypt v3 onoin service descriptors\npub struct GoslingX25519PublicKey;\ndefine_registry! {X25519PublicKey}\n\n/// A v3 onion service id\npub struct GoslingV3OnionServiceId;\ndefine_registry! {V3OnionServiceId}\n\n//\n// Free Functions\n//\n\n/// Frees a gosling_ed25519_private_key object\n///\n/// @param in_private_key: the private key to free\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_ed25519_private_key_free(in_private_key: *mut GoslingEd25519PrivateKey) {\n    impl_registry_free!(in_private_key, Ed25519PrivateKey);\n}\n\n/// Frees a gosling_x25519_private_key object\n///\n/// @param in_private_key: the private key to free\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_x25519_private_key_free(in_private_key: *mut GoslingX25519PrivateKey) {\n    impl_registry_free!(in_private_key, X25519PrivateKey);\n}\n\n/// Frees a gosling_x25519_public_key object\n///\n/// @param in_public_key: the public key to free\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_x25519_public_key_free(in_public_key: *mut GoslingX25519PublicKey) {\n    impl_registry_free!(in_public_key, X25519PublicKey);\n}\n\n/// Frees a gosling_v3_onion_service_id object\n///\n/// @param in_service_id: the service id object to free\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_v3_onion_service_id_free(in_service_id: *mut GoslingV3OnionServiceId) {\n    impl_registry_free!(in_service_id, V3OnionServiceId);\n}\n\n//\n// Clone Functions\n//\n\n/// Copy method for gosling_ed25519_private_key\n///\n/// @param out_private_key: returned copy\n/// @param private_key: original to copy\n/// @param error: fliled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_ed25519_private_key_clone(\n    out_private_key: *mut *mut GoslingEd25519PrivateKey,\n    private_key: *const GoslingEd25519PrivateKey,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_private_key);\n        ensure_not_null!(private_key);\n\n        let private_key = match get_ed25519_private_key_registry().get(private_key as usize) {\n            Some(private_key) =\u003e private_key.clone(),\n            None =\u003e bail_invalid_handle!(private_key),\n        };\n        let handle = get_ed25519_private_key_registry().insert(private_key);\n        *out_private_key = handle as *mut GoslingEd25519PrivateKey;\n\n        Ok(())\n    })\n}\n\n/// Copy method for gosling_x25519_public_key\n///\n/// @param out_public_key: returned copy\n/// @param public_key: original to copy\n/// @param error: fliled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_x25519_public_key_clone(\n    out_public_key: *mut *mut GoslingX25519PublicKey,\n    public_key: *const GoslingX25519PublicKey,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_public_key);\n        ensure_not_null!(public_key);\n\n        let public_key = match get_x25519_public_key_registry().get(public_key as usize) {\n            Some(public_key) =\u003e public_key.clone(),\n            None =\u003e bail_invalid_handle!(public_key),\n        };\n        let handle = get_x25519_public_key_registry().insert(public_key);\n        *out_public_key = handle as *mut GoslingX25519PublicKey;\n\n        Ok(())\n    })\n}\n\n/// Copy method for gosling_x25519_private_key\n///\n/// @param out_private_key: returned copy\n/// @param private_key: original to copy\n/// @param error: fliled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_x25519_private_key_clone(\n    out_private_key: *mut *mut GoslingX25519PrivateKey,\n    private_key: *const GoslingX25519PrivateKey,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_private_key);\n        ensure_not_null!(private_key);\n\n        let private_key = match get_x25519_private_key_registry().get(private_key as usize) {\n            Some(private_key) =\u003e private_key.clone(),\n            None =\u003e bail_invalid_handle!(private_key),\n        };\n        let handle = get_x25519_private_key_registry().insert(private_key);\n        *out_private_key = handle as *mut GoslingX25519PrivateKey;\n\n        Ok(())\n    })\n}\n\n/// Copy method for gosling_v3_onion_service_id\n///\n/// @param out_service_id: returned copy\n/// @param service_id: original to copy\n/// @param error: fliled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_v3_onion_service_id_clone(\n    out_service_id: *mut *mut GoslingV3OnionServiceId,\n    service_id: *const GoslingV3OnionServiceId,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_service_id);\n        ensure_not_null!(service_id);\n\n        let service_id = match get_v3_onion_service_id_registry().get(service_id as usize) {\n            Some(service_id) =\u003e service_id.clone(),\n            None =\u003e bail_invalid_handle!(service_id),\n        };\n        let handle = get_v3_onion_service_id_registry().insert(service_id);\n        *out_service_id = handle as *mut GoslingV3OnionServiceId;\n\n        Ok(())\n    })\n}\n\n//\n// Ed25519 Privat4e Key Functions\n//\n\n/// Creation method for securely generating a new gosling_ed25510_private_key\n///\n/// @param out_private_key: returned generated ed25519 private key\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_ed25519_private_key_generate(\n    out_private_key: *mut *mut GoslingEd25519PrivateKey,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_private_key);\n\n        let private_key = Ed25519PrivateKey::generate();\n        let handle = get_ed25519_private_key_registry().insert(private_key);\n        *out_private_key = handle as *mut GoslingEd25519PrivateKey;\n\n        Ok(())\n    })\n}\n\n/// Conversion method for converting the KeyBlob string returned by ADD_ONION\n/// command into a gosling_ed25519_private_key\n///\n/// @param out_private_key: returned ed25519 private key\n/// @param key_blob: an ed25519 KeyBlob string in the form\n///  \"ED25519-V3:abcd1234...\"\n/// @param key_blob_length: number of chars in key_blob not including any null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_ed25519_private_key_from_keyblob(\n    out_private_key: *mut *mut GoslingEd25519PrivateKey,\n    key_blob: *const c_char,\n    key_blob_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_private_key);\n        ensure_not_null!(key_blob);\n\n        if key_blob_length != ED25519_PRIVATE_KEY_KEYBLOB_LENGTH {\n            bail!(\"key_blob_length must be exactly ED25519_PRIVATE_KEY_KEYBLOB_LENGTH ({}); received '{}'\", ED25519_PRIVATE_KEY_KEYBLOB_LENGTH, key_blob_length);\n        }\n\n        let key_blob_view = std::slice::from_raw_parts(key_blob as *const u8, key_blob_length);\n        let key_blob_str = std::str::from_utf8(key_blob_view)?;\n        let private_key = Ed25519PrivateKey::from_key_blob(key_blob_str)?;\n\n        let handle = get_ed25519_private_key_registry().insert(private_key);\n        *out_private_key = handle as *mut GoslingEd25519PrivateKey;\n\n        Ok(())\n    })\n}\n\n/// Conversion method for converting an ed25519 private key to a null-\n/// terminated KeyBlob string for use with ADD_ONION command\n///\n/// @param private_key: the private key to encode\n/// @param out_key_blob: buffer to be filled with ed25519 KeyBlob in\n///  the form \"ED25519-V3:abcd1234...\\0\"\n/// @param key_blob_size: size of out_key_blob buffer in bytes, must be at\n///  least 100 characters (99 for string + 1 for null-terminator)\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_ed25519_private_key_to_keyblob(\n    private_key: *const GoslingEd25519PrivateKey,\n    out_key_blob: *mut c_char,\n    key_blob_size: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(private_key);\n        ensure_not_null!(out_key_blob);\n\n        if key_blob_size \u003c ED25519_PRIVATE_KEY_KEYBLOB_SIZE {\n            bail!(\n                \"key_blob_size must be at least ED25519_PRIVATE_KEY_KEYBLOB_SIZE ('{}'), received '{}'\",\n                ED25519_PRIVATE_KEY_KEYBLOB_SIZE,\n                key_blob_size\n            );\n        }\n\n        let registry = get_ed25519_private_key_registry();\n        match registry.get(private_key as usize) {\n            Some(private_key) =\u003e {\n                let private_key_blob = private_key.to_key_blob();\n                unsafe {\n                    // copy keyblob into output buffer\n                    let key_blob_view =\n                        std::slice::from_raw_parts_mut(out_key_blob as *mut u8, key_blob_size);\n                    std::ptr::copy(\n                        private_key_blob.as_ptr(),\n                        key_blob_view.as_mut_ptr(),\n                        ED25519_PRIVATE_KEY_KEYBLOB_LENGTH,\n                    );\n                    // add final null-terminator\n                    key_blob_view[ED25519_PRIVATE_KEY_KEYBLOB_LENGTH] = 0u8;\n                };\n            }\n            None =\u003e {\n                bail_invalid_handle!(private_key);\n            }\n        };\n\n        Ok(())\n    })\n}\n\n//\n// X25519 Private Key Functions\n//\n\n/// Conversion method for converting a base64-encoded string used by the\n/// ONION_CLIENT_AUTH_ADD command into a gosling_x25519_private_key\n///\n/// @param out_private_key: returned x25519 private key\n/// @param base64: an x25519 private key encoded as a base64 string\n/// @param base64_length: the number of chars in base64 not including any null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_x25519_private_key_from_base64(\n    out_private_key: *mut *mut GoslingX25519PrivateKey,\n    base64: *const c_char,\n    base64_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_private_key);\n        ensure_not_null!(base64);\n\n        if base64_length != X25519_PRIVATE_KEY_BASE64_LENGTH {\n            bail!(\"base64_length must be exactly X25519_PRIVATE_KEY_BASE64_LENGTH ({}); received '{}'\", X25519_PRIVATE_KEY_BASE64_LENGTH, base64_length);\n        }\n\n        let base64_view = std::slice::from_raw_parts(base64 as *const u8, base64_length);\n        let base64_str = std::str::from_utf8(base64_view)?;\n        let private_key = X25519PrivateKey::from_base64(base64_str)?;\n\n        let handle = get_x25519_private_key_registry().insert(private_key);\n        *out_private_key = handle as *mut GoslingX25519PrivateKey;\n\n        Ok(())\n    })\n}\n\n/// Conversion method for converting an x25519 private key to a null-\n/// terminated base64 string for use with ONION_CLIENT_AUTH_ADD command\n///\n/// @param private_key: the private key to encode\n/// @param out_base64: buffer to be filled with x25519 key encoded as base64\n/// @param base64_size: size of out_base64 buffer in bytes, must be at\n///  least 45 characters (44 for string + 1 for null-terminator)\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_x25519_private_key_to_base64(\n    private_key: *const GoslingX25519PrivateKey,\n    out_base64: *mut c_char,\n    base64_size: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(private_key);\n        ensure_not_null!(out_base64);\n\n        if base64_size \u003c X25519_PRIVATE_KEY_BASE64_SIZE {\n            bail!(\n                \"base64_size must be at least '{}', received '{}'\",\n                X25519_PRIVATE_KEY_BASE64_SIZE,\n                base64_size\n            );\n        }\n\n        let registry = get_x25519_private_key_registry();\n        match registry.get(private_key as usize) {\n            Some(private_key) =\u003e {\n                let private_key_blob = private_key.to_base64();\n                unsafe {\n                    // copy base64 into output buffer\n                    let base64_view =\n                        std::slice::from_raw_parts_mut(out_base64 as *mut u8, base64_size);\n                    std::ptr::copy(\n                        private_key_blob.as_ptr(),\n                        base64_view.as_mut_ptr(),\n                        X25519_PRIVATE_KEY_BASE64_LENGTH,\n                    );\n                    // add final null-terminator\n                    base64_view[X25519_PRIVATE_KEY_BASE64_LENGTH] = 0u8;\n                };\n            }\n            None =\u003e {\n                bail_invalid_handle!(private_key);\n            }\n        };\n\n        Ok(())\n    })\n}\n\n//\n// X25519 Public Key Functions\n//\n\n/// Conversion method for converting a base32-encoded string used by the\n/// ADD_ONION command into a gosling_x25519_public_key\n///\n/// @param out_public_key: returned x25519 public key\n/// @param base32: an x25519 public key encoded as a base32 string\n/// @param base32_length: the number of chars in base32 not including any null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_x25519_public_key_from_base32(\n    out_public_key: *mut *mut GoslingX25519PublicKey,\n    base32: *const c_char,\n    base32_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_public_key);\n        ensure_not_null!(base32);\n\n        if base32_length != X25519_PUBLIC_KEY_BASE32_LENGTH {\n            bail!(\n                \"base32_length must be exactly X25519_PUBLIC_KEY_BASE32_LENGTH ({}); received '{}'\",\n                X25519_PUBLIC_KEY_BASE32_LENGTH,\n                base32_length\n            );\n        }\n\n        let base32_view = std::slice::from_raw_parts(base32 as *const u8, base32_length);\n        let base32_str = std::str::from_utf8(base32_view)?;\n        let public_key = X25519PublicKey::from_base32(base32_str)?;\n\n        let handle = get_x25519_public_key_registry().insert(public_key);\n        *out_public_key = handle as *mut GoslingX25519PublicKey;\n\n        Ok(())\n    })\n}\n\n/// Conversion method for converting an x25519 public key to a null-\n/// terminated base64 string for use with ADD_ONION command\n///\n/// @param public_key: the public key to encode\n/// @param out_base32: buffer to be filled with x25519 key encoded as base32\n/// @param base32_size: size of out_base32 buffer in bytes, must be at\n///  least 53 characters (52 for string + 1 for null-terminator)\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_x25519_public_key_to_base32(\n    public_key: *const GoslingX25519PublicKey,\n    out_base32: *mut c_char,\n    base32_size: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(public_key);\n        ensure_not_null!(out_base32);\n\n        if base32_size \u003c X25519_PUBLIC_KEY_BASE32_SIZE {\n            bail!(\n                \"base32_size must be at least '{}', received '{}'\",\n                X25519_PUBLIC_KEY_BASE32_SIZE,\n                base32_size\n            );\n        }\n\n        let registry = get_x25519_public_key_registry();\n        match registry.get(public_key as usize) {\n            Some(public_key) =\u003e {\n                let public_base32 = public_key.to_base32();\n                unsafe {\n                    // copy base32 into output buffer\n                    let base32_view =\n                        std::slice::from_raw_parts_mut(out_base32 as *mut u8, base32_size);\n                    std::ptr::copy(\n                        public_base32.as_ptr(),\n                        base32_view.as_mut_ptr(),\n                        X25519_PUBLIC_KEY_BASE32_LENGTH,\n                    );\n                    // add final null-terminator\n                    base32_view[X25519_PUBLIC_KEY_BASE32_LENGTH] = 0u8;\n                };\n            }\n            None =\u003e {\n                bail_invalid_handle!(public_key);\n            }\n        };\n\n        Ok(())\n    })\n}\n\n//\n// V3 Onion Service Id Functions\n//\n\n/// Conversion method for converting a v3 onion service string into a\n/// gosling_v3_onion_service_id object\n///\n/// @param out_service_id: returned service id object\n/// @param service_id_string: a v3 onion service id string\n/// @param service_id_string_length: the number of chars in service_id_string not including any\n///  null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_v3_onion_service_id_from_string(\n    out_service_id: *mut *mut GoslingV3OnionServiceId,\n    service_id_string: *const c_char,\n    service_id_string_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_service_id);\n        ensure_not_null!(service_id_string);\n\n        if service_id_string_length != V3_ONION_SERVICE_ID_STRING_LENGTH {\n            bail!(\"service_id_string_length must be exactly V3_ONION_SERVICE_ID_STRING_LENGTH ({}); received '{}'\", V3_ONION_SERVICE_ID_STRING_LENGTH, service_id_string_length);\n        }\n\n        let service_id_view =\n            std::slice::from_raw_parts(service_id_string as *const u8, service_id_string_length);\n        let service_id_str = std::str::from_utf8(service_id_view)?;\n        let service_id = V3OnionServiceId::from_string(service_id_str)?;\n\n        let handle = get_v3_onion_service_id_registry().insert(service_id);\n        *out_service_id = handle as *mut GoslingV3OnionServiceId;\n\n        Ok(())\n    })\n}\n\n/// Conversion method for converting an ed25519 private key  into a\n/// gosling_v3_onion_service_id object\n///\n/// @param out_service_id: returned service id object\n/// @param ed25519_private_key: an e25519 private key\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_v3_onion_service_id_from_ed25519_private_key(\n    out_service_id: *mut *mut GoslingV3OnionServiceId,\n    ed25519_private_key: *const GoslingEd25519PrivateKey,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_service_id);\n        ensure_not_null!(ed25519_private_key);\n\n        let service_id = {\n            let ed25519_private_key_registry = get_ed25519_private_key_registry();\n            let ed25519_private_key =\n                match ed25519_private_key_registry.get(ed25519_private_key as usize) {\n                    Some(ed25519_private_key) =\u003e ed25519_private_key,\n                    None =\u003e bail_invalid_handle!(ed25519_private_key),\n                };\n            V3OnionServiceId::from_private_key(ed25519_private_key)\n        };\n\n        let handle = get_v3_onion_service_id_registry().insert(service_id);\n        *out_service_id = handle as *mut GoslingV3OnionServiceId;\n\n        Ok(())\n    })\n}\n\n/// Conversion method for converting v3 onion service id to a null-terminated\n/// string\n///\n/// @param service_id: the service id to encode\n/// @param out_service_id_string: buffer to be filled with x25519 key encoded as base32\n/// @param service_id_string_size: size of out_service_id_string buffer in bytes,\n///  must be at least 57 characters (56 for string + 1 for null-terminator)\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_v3_onion_service_id_to_string(\n    service_id: *const GoslingV3OnionServiceId,\n    out_service_id_string: *mut c_char,\n    service_id_string_size: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(service_id);\n        ensure_not_null!(out_service_id_string);\n\n        if service_id_string_size \u003c V3_ONION_SERVICE_ID_STRING_SIZE {\n            bail!(\n                \"service_id_string_size must be at least '{}', received '{}'\",\n                V3_ONION_SERVICE_ID_STRING_SIZE,\n                service_id_string_size\n            );\n        }\n\n        let registry = get_v3_onion_service_id_registry();\n        match registry.get(service_id as usize) {\n            Some(service_id) =\u003e {\n                let service_id_string = service_id.to_string();\n                unsafe {\n                    // copy service_id_string into output buffer\n                    let service_id_string_view = std::slice::from_raw_parts_mut(\n                        out_service_id_string as *mut u8,\n                        service_id_string_size,\n                    );\n                    std::ptr::copy(\n                        service_id_string.as_ptr(),\n                        service_id_string_view.as_mut_ptr(),\n                        V3_ONION_SERVICE_ID_STRING_LENGTH,\n                    );\n                    // add final null-terminator\n                    service_id_string_view[V3_ONION_SERVICE_ID_STRING_LENGTH] = 0u8;\n                };\n            }\n            None =\u003e {\n                bail_invalid_handle!(service_id);\n            }\n        };\n\n        Ok(())\n    })\n}\n\n/// Checks if a service id string is valid per tor rend spec:\n/// https://gitweb.torproject.org/torspec.git/tree/rend-spec-v3.txt\n///\n/// @param service_id_string: string containing the v3 service id to be validated\n/// @param service_id_string_length: the number of chars in service_id_string not including any\n///  null-terminator; must be V3_ONION_SERVICE_ID_STRING_LENGTH (56)\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_string_is_valid_v3_onion_service_id(\n    service_id_string: *const c_char,\n    service_id_string_length: usize,\n    error: *mut *mut GoslingError,\n) -\u003e bool {\n    translate_failures(false, error, || -\u003e anyhow::Result\u003cbool\u003e {\n        ensure_not_null!(service_id_string);\n\n        if service_id_string_length != V3_ONION_SERVICE_ID_STRING_LENGTH {\n            bail!(\n                \"service_id_string_length must be V3_ONION_SERVICE_ID_STRING_LENGTH (56); received '{}'\",\n                service_id_string_length\n            );\n        }\n\n        let service_id_string_slice = unsafe {\n            std::slice::from_raw_parts(service_id_string as *const u8, service_id_string_length)\n        };\n        Ok(V3OnionServiceId::is_valid(str::from_utf8(\n            service_id_string_slice,\n        )?))\n    })\n}\n","traces":[{"line":41,"address":[2867887,2867856],"length":1,"stats":{"Line":0}},{"line":50,"address":[2066048,2066077],"length":1,"stats":{"Line":0}},{"line":59,"address":[2868224,2868249],"length":1,"stats":{"Line":0}},{"line":68,"address":[2868384,2868412],"length":1,"stats":{"Line":0}},{"line":83,"address":[2868609,2868560],"length":1,"stats":{"Line":1}},{"line":88,"address":[2846192,2847025],"length":1,"stats":{"Line":2}},{"line":89,"address":[2071177],"length":1,"stats":{"Line":1}},{"line":90,"address":[2846234],"length":1,"stats":{"Line":1}},{"line":92,"address":[2846317,2846469],"length":1,"stats":{"Line":2}},{"line":93,"address":[2846573,2846688],"length":1,"stats":{"Line":2}},{"line":96,"address":[2846752],"length":1,"stats":{"Line":1}},{"line":97,"address":[2847004,2846944],"length":1,"stats":{"Line":1}},{"line":99,"address":[2846978],"length":1,"stats":{"Line":1}},{"line":110,"address":[2868624,2868673],"length":1,"stats":{"Line":1}},{"line":115,"address":[2847762,2847072],"length":1,"stats":{"Line":2}},{"line":116,"address":[2847089],"length":1,"stats":{"Line":1}},{"line":117,"address":[2847106],"length":1,"stats":{"Line":1}},{"line":119,"address":[2847341,2847189],"length":1,"stats":{"Line":2}},{"line":120,"address":[2847445],"length":1,"stats":{"Line":1}},{"line":123,"address":[2847558],"length":1,"stats":{"Line":1}},{"line":124,"address":[2847741,2847689],"length":1,"stats":{"Line":1}},{"line":126,"address":[2847723],"length":1,"stats":{"Line":1}},{"line":137,"address":[2868737,2868688],"length":1,"stats":{"Line":1}},{"line":142,"address":[2848615,2847792],"length":1,"stats":{"Line":2}},{"line":143,"address":[2847817],"length":1,"stats":{"Line":1}},{"line":144,"address":[2847834],"length":1,"stats":{"Line":1}},{"line":146,"address":[2847917,2848069],"length":1,"stats":{"Line":2}},{"line":147,"address":[2848281,2848173],"length":1,"stats":{"Line":2}},{"line":150,"address":[2848345],"length":1,"stats":{"Line":1}},{"line":151,"address":[2848594,2848534],"length":1,"stats":{"Line":1}},{"line":153,"address":[2073647],"length":1,"stats":{"Line":1}},{"line":164,"address":[2868752,2868801],"length":1,"stats":{"Line":1}},{"line":169,"address":[2074473,2073744],"length":1,"stats":{"Line":2}},{"line":170,"address":[2848673],"length":1,"stats":{"Line":1}},{"line":171,"address":[2848690],"length":1,"stats":{"Line":1}},{"line":173,"address":[2073865,2074027],"length":1,"stats":{"Line":2}},{"line":174,"address":[2849029],"length":1,"stats":{"Line":1}},{"line":177,"address":[2849142],"length":1,"stats":{"Line":1}},{"line":178,"address":[2849328,2849273],"length":1,"stats":{"Line":1}},{"line":180,"address":[2849309],"length":1,"stats":{"Line":1}},{"line":194,"address":[2066848,2066885],"length":1,"stats":{"Line":1}},{"line":198,"address":[2074496,2074955],"length":1,"stats":{"Line":2}},{"line":199,"address":[2074516],"length":1,"stats":{"Line":1}},{"line":201,"address":[2074534],"length":1,"stats":{"Line":1}},{"line":202,"address":[2074688,2074556],"length":1,"stats":{"Line":2}},{"line":203,"address":[2074864,2074921],"length":1,"stats":{"Line":1}},{"line":205,"address":[2074898],"length":1,"stats":{"Line":1}},{"line":219,"address":[2868880,2868959],"length":1,"stats":{"Line":0}},{"line":225,"address":[2849872,2851248],"length":1,"stats":{"Line":0}},{"line":226,"address":[2075028],"length":1,"stats":{"Line":0}},{"line":227,"address":[2075049],"length":1,"stats":{"Line":0}},{"line":229,"address":[2849999],"length":1,"stats":{"Line":0}},{"line":230,"address":[2850540,2850381,2850291],"length":1,"stats":{"Line":0}},{"line":233,"address":[2850084],"length":1,"stats":{"Line":0}},{"line":234,"address":[2850561,2850644,2850123],"length":1,"stats":{"Line":0}},{"line":235,"address":[2075735,2075882,2075979],"length":1,"stats":{"Line":0}},{"line":237,"address":[2850987,2850816],"length":1,"stats":{"Line":0}},{"line":238,"address":[2851214,2851159],"length":1,"stats":{"Line":0}},{"line":240,"address":[2851191],"length":1,"stats":{"Line":0}},{"line":255,"address":[2869055,2868976],"length":1,"stats":{"Line":0}},{"line":261,"address":[2067050],"length":1,"stats":{"Line":0}},{"line":262,"address":[2851308],"length":1,"stats":{"Line":0}},{"line":263,"address":[2851328],"length":1,"stats":{"Line":0}},{"line":265,"address":[2851415],"length":1,"stats":{"Line":0}},{"line":266,"address":[2851649,2851901,2851739],"length":1,"stats":{"Line":0}},{"line":273,"address":[2851491],"length":1,"stats":{"Line":0}},{"line":274,"address":[2077141,2076672],"length":1,"stats":{"Line":0}},{"line":275,"address":[2852077],"length":1,"stats":{"Line":0}},{"line":276,"address":[2852093],"length":1,"stats":{"Line":0}},{"line":280,"address":[2852189,2852278],"length":1,"stats":{"Line":0}},{"line":282,"address":[2852318],"length":1,"stats":{"Line":0}},{"line":287,"address":[2077685,2077728],"length":1,"stats":{"Line":0}},{"line":295,"address":[2852578],"length":1,"stats":{"Line":0}},{"line":312,"address":[2869151,2869072],"length":1,"stats":{"Line":0}},{"line":318,"address":[2077808,2079197],"length":1,"stats":{"Line":0}},{"line":319,"address":[2077828],"length":1,"stats":{"Line":0}},{"line":320,"address":[2077849],"length":1,"stats":{"Line":0}},{"line":322,"address":[2077939],"length":1,"stats":{"Line":0}},{"line":323,"address":[2853059,2853296,2853149],"length":1,"stats":{"Line":0}},{"line":326,"address":[2078026],"length":1,"stats":{"Line":0}},{"line":327,"address":[2078582,2078491,2078065],"length":1,"stats":{"Line":0}},{"line":328,"address":[2853592,2853349,2853501],"length":1,"stats":{"Line":0}},{"line":330,"address":[2853573,2853744],"length":1,"stats":{"Line":0}},{"line":331,"address":[2853974,2853916],"length":1,"stats":{"Line":0}},{"line":333,"address":[2853950],"length":1,"stats":{"Line":0}},{"line":347,"address":[2869168,2869247],"length":1,"stats":{"Line":0}},{"line":353,"address":[2854064,2855341],"length":1,"stats":{"Line":0}},{"line":354,"address":[2079260],"length":1,"stats":{"Line":0}},{"line":355,"address":[2079281],"length":1,"stats":{"Line":0}},{"line":357,"address":[2854183],"length":1,"stats":{"Line":0}},{"line":358,"address":[2854669,2854417,2854507],"length":1,"stats":{"Line":0}},{"line":365,"address":[2079449],"length":1,"stats":{"Line":0}},{"line":366,"address":[2854743,2854290],"length":1,"stats":{"Line":0}},{"line":367,"address":[2854845],"length":1,"stats":{"Line":0}},{"line":368,"address":[2854861],"length":1,"stats":{"Line":0}},{"line":372,"address":[2854957,2855046],"length":1,"stats":{"Line":0}},{"line":374,"address":[2855086],"length":1,"stats":{"Line":0}},{"line":379,"address":[2855246,2855289],"length":1,"stats":{"Line":0}},{"line":387,"address":[2080521],"length":1,"stats":{"Line":0}},{"line":404,"address":[2067296,2067375],"length":1,"stats":{"Line":0}},{"line":410,"address":[2080576,2081793],"length":1,"stats":{"Line":0}},{"line":411,"address":[2855388],"length":1,"stats":{"Line":0}},{"line":412,"address":[2080609],"length":1,"stats":{"Line":0}},{"line":414,"address":[2080699],"length":1,"stats":{"Line":0}},{"line":415,"address":[2855787,2855877,2856018],"length":1,"stats":{"Line":0}},{"line":422,"address":[2855580],"length":1,"stats":{"Line":0}},{"line":423,"address":[2081245,2080825,2081336],"length":1,"stats":{"Line":0}},{"line":424,"address":[2081513,2081431,2081277],"length":1,"stats":{"Line":0}},{"line":426,"address":[2856403,2856255],"length":1,"stats":{"Line":0}},{"line":427,"address":[2856491,2856541],"length":1,"stats":{"Line":0}},{"line":429,"address":[2856525],"length":1,"stats":{"Line":0}},{"line":443,"address":[2869439,2869360],"length":1,"stats":{"Line":0}},{"line":449,"address":[2067434],"length":1,"stats":{"Line":0}},{"line":450,"address":[2856620],"length":1,"stats":{"Line":0}},{"line":451,"address":[2856640],"length":1,"stats":{"Line":0}},{"line":453,"address":[2081947],"length":1,"stats":{"Line":0}},{"line":454,"address":[2082187,2082277,2082439],"length":1,"stats":{"Line":0}},{"line":461,"address":[2082025],"length":1,"stats":{"Line":0}},{"line":462,"address":[2857287,2856834],"length":1,"stats":{"Line":0}},{"line":463,"address":[2857389],"length":1,"stats":{"Line":0}},{"line":464,"address":[2082639],"length":1,"stats":{"Line":0}},{"line":468,"address":[2857501,2857590],"length":1,"stats":{"Line":0}},{"line":470,"address":[2082869],"length":1,"stats":{"Line":0}},{"line":475,"address":[2857833,2857790],"length":1,"stats":{"Line":0}},{"line":483,"address":[2083097],"length":1,"stats":{"Line":0}},{"line":501,"address":[2869456,2869535],"length":1,"stats":{"Line":0}},{"line":507,"address":[2067530],"length":1,"stats":{"Line":0}},{"line":508,"address":[2083164],"length":1,"stats":{"Line":0}},{"line":509,"address":[2083185],"length":1,"stats":{"Line":0}},{"line":511,"address":[2083275],"length":1,"stats":{"Line":0}},{"line":512,"address":[2083659,2083569,2083800],"length":1,"stats":{"Line":0}},{"line":516,"address":[2083362],"length":1,"stats":{"Line":0}},{"line":517,"address":[2858163,2858673,2858583],"length":1,"stats":{"Line":0}},{"line":518,"address":[2858767,2858615,2858877],"length":1,"stats":{"Line":0}},{"line":520,"address":[2084216,2084071],"length":1,"stats":{"Line":0}},{"line":521,"address":[2084317,2084367],"length":1,"stats":{"Line":0}},{"line":523,"address":[2859101],"length":1,"stats":{"Line":0}},{"line":535,"address":[2067633,2067584],"length":1,"stats":{"Line":1}},{"line":540,"address":[2067626],"length":1,"stats":{"Line":2}},{"line":541,"address":[2084449],"length":1,"stats":{"Line":1}},{"line":542,"address":[2859218],"length":1,"stats":{"Line":1}},{"line":545,"address":[2859301],"length":1,"stats":{"Line":1}},{"line":547,"address":[2859453,2859332],"length":1,"stats":{"Line":2}},{"line":548,"address":[2859557],"length":1,"stats":{"Line":1}},{"line":551,"address":[2084839],"length":1,"stats":{"Line":1}},{"line":554,"address":[2859674],"length":1,"stats":{"Line":1}},{"line":555,"address":[2085089,2085144],"length":1,"stats":{"Line":1}},{"line":557,"address":[2859841],"length":1,"stats":{"Line":1}},{"line":571,"address":[2067648,2067727],"length":1,"stats":{"Line":0}},{"line":577,"address":[2085200,2086503],"length":1,"stats":{"Line":0}},{"line":578,"address":[2085212],"length":1,"stats":{"Line":0}},{"line":579,"address":[2859936],"length":1,"stats":{"Line":0}},{"line":581,"address":[2860023],"length":1,"stats":{"Line":0}},{"line":582,"address":[2860347,2860509,2860257],"length":1,"stats":{"Line":0}},{"line":589,"address":[2085401],"length":1,"stats":{"Line":0}},{"line":590,"address":[2860130,2860583],"length":1,"stats":{"Line":0}},{"line":591,"address":[2085999],"length":1,"stats":{"Line":0}},{"line":592,"address":[2860701],"length":1,"stats":{"Line":0}},{"line":595,"address":[2086130,2086205],"length":1,"stats":{"Line":0}},{"line":596,"address":[2860797,2860805],"length":1,"stats":{"Line":0}},{"line":597,"address":[2860801,2860808],"length":1,"stats":{"Line":0}},{"line":600,"address":[2860926],"length":1,"stats":{"Line":0}},{"line":605,"address":[2861131,2861088],"length":1,"stats":{"Line":0}},{"line":613,"address":[2861156],"length":1,"stats":{"Line":0}},{"line":626,"address":[2869765,2869712],"length":1,"stats":{"Line":0}},{"line":631,"address":[2869754],"length":1,"stats":{"Line":0}},{"line":632,"address":[2861243],"length":1,"stats":{"Line":0}},{"line":634,"address":[2861260],"length":1,"stats":{"Line":0}},{"line":635,"address":[2861642,2861448,2861539],"length":1,"stats":{"Line":0}},{"line":642,"address":[2861351],"length":1,"stats":{"Line":0}},{"line":644,"address":[2861673,2861766,2861392],"length":1,"stats":{"Line":0}}],"covered":54,"coverable":171},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","src","error.rs"],"content":"// standard\nuse std::ffi::CString;\nuse std::os::raw::c_char;\n\n// extern crates\nuse anyhow::bail;\n#[cfg(feature = \"impl-lib\")]\nuse cgosling_proc_macros::*;\n\n// internal crates\nuse crate::ffi::*;\nuse crate::macros::*;\n\n/// Error Handling\n#[derive(Clone)]\npub struct Error {\n    message: CString,\n}\n\nimpl Error {\n    pub fn new(message: \u0026str) -\u003e Error {\n        Error {\n            message: CString::new(message).unwrap_or_default(),\n        }\n    }\n\n    pub fn message(\u0026self) -\u003e \u0026CString {\n        \u0026self.message\n    }\n}\n\ndefine_registry! {Error}\n\n/// A wrapper object containing an error message\npub struct GoslingError;\n\n/// Get error message from gosling_error\n///\n/// @param error: the error object to get the message from\n/// @return null-terminated string with error message whose\n///  lifetime is tied to the source\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_error_get_message(error: *const GoslingError) -\u003e *const c_char {\n    if !error.is_null() {\n        let key = error as usize;\n\n        let registry = get_error_registry();\n        if registry.contains_key(key) {\n            if let Some(x) = registry.get(key) {\n                return x.message().as_ptr();\n            }\n        }\n    }\n\n    std::ptr::null()\n}\n\n/// Copy method for gosling_error\n///\n/// @param out_error: returned copy\n/// @param orig_error: original to copy\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_error_clone(\n    out_error: *mut *mut GoslingError,\n    orig_error: *const GoslingError,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_error);\n        ensure_not_null!(orig_error);\n\n        let orig_error = match get_error_registry().get(orig_error as usize) {\n            Some(orig_error) =\u003e orig_error.clone(),\n            None =\u003e bail_invalid_handle!(orig_error),\n        };\n        let handle = get_error_registry().insert(orig_error);\n        *out_error = handle as *mut GoslingError;\n\n        Ok(())\n    })\n}\n\n/// Frees gosling_error and invalidates any message strings\n/// returned by gosling_error_get_message() from the given\n/// error object.\n///\n/// @param error: the error object to free\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_error_free(error: *mut GoslingError) {\n    impl_registry_free!(error, Error);\n}\n\n/// Wrapper around rust code which may panic or return a failing Result to be used at FFI boundaries.\n/// Converts panics or error Results into GoslingErrors if a memory location is provided.\n///\n/// @param default: The default value to return in the event of failure\n/// @param out_error: A pointer to pointer to GoslingError 'struct' for the C FFI\n/// @param closure: The functionality we need to encapsulate behind the error handling logic\n/// @return The result of closure() on success, or the value of default on failure.\npub(crate) fn translate_failures\u003cR, F\u003e(\n    default: R,\n    out_error: *mut *mut GoslingError,\n    closure: F,\n) -\u003e R\nwhere\n    F: FnOnce() -\u003e anyhow::Result\u003cR\u003e + std::panic::UnwindSafe,\n{\n    match std::panic::catch_unwind(closure) {\n        // handle success\n        Ok(Ok(retval)) =\u003e retval,\n        // handle runtime error\n        Ok(Err(err)) =\u003e {\n            if !out_error.is_null() {\n                // populate error with runtime error message\n                let key = get_error_registry().insert(Error::new(format!(\"{:?}\", err).as_str()));\n                unsafe {\n                    *out_error = key as *mut GoslingError;\n                };\n            }\n            default\n        }\n        // handle panic\n        Err(_) =\u003e {\n            if !out_error.is_null() {\n                // populate error with panic message\n                let key = get_error_registry().insert(Error::new(\"panic occurred\"));\n                unsafe {\n                    *out_error = key as *mut GoslingError;\n                };\n            }\n            default\n        }\n    }\n}\n","traces":[{"line":21,"address":[2861840],"length":1,"stats":{"Line":0}},{"line":23,"address":[2861860],"length":1,"stats":{"Line":0}},{"line":27,"address":[2861904],"length":1,"stats":{"Line":0}},{"line":44,"address":[2861920,2861951],"length":1,"stats":{"Line":0}},{"line":45,"address":[2861940,2861964],"length":1,"stats":{"Line":0}},{"line":46,"address":[2861975],"length":1,"stats":{"Line":0}},{"line":48,"address":[2862045,2861991],"length":1,"stats":{"Line":0}},{"line":49,"address":[2862064],"length":1,"stats":{"Line":0}},{"line":50,"address":[2862124],"length":1,"stats":{"Line":0}},{"line":51,"address":[2862216],"length":1,"stats":{"Line":0}},{"line":56,"address":[2862307],"length":1,"stats":{"Line":0}},{"line":66,"address":[2862320,2862369],"length":1,"stats":{"Line":0}},{"line":71,"address":[2862362],"length":1,"stats":{"Line":0}},{"line":72,"address":[1670681],"length":1,"stats":{"Line":0}},{"line":73,"address":[2117739],"length":1,"stats":{"Line":0}},{"line":75,"address":[1670948,1670781],"length":1,"stats":{"Line":0}},{"line":76,"address":[1671052,1671175],"length":1,"stats":{"Line":0}},{"line":79,"address":[1671255],"length":1,"stats":{"Line":0}},{"line":80,"address":[1671423,1671486],"length":1,"stats":{"Line":0}},{"line":82,"address":[1671459],"length":1,"stats":{"Line":0}},{"line":93,"address":[2259037,2259008],"length":1,"stats":{"Line":0}},{"line":104,"address":[1707728,1765376,1696992,1703259,1714460,1755984,1679568,1776080,1705015,1711788,1726540,1762668,1675548,1734155,1738171,1731483,1672896,1717164,1717184,1702332,1712715,1695227,1694284,1696972,1684928,1739916,1689851,1685835,1735884,1765356,1770704,1731904,1742588,1688908,1674240,1729248,1741264,1760923,1686236,1690272,1682240,1692960,1706384,1705963,1730576,1745264,1680892,1709072,1723868,1756907,1757308,1711808,1695628,1733212,1739936,1687580,1695648,1677819,1701024,1675568,1768048,1688928,1683155,1749280,1706364,1699680,1750588,1696571,1735904,1713136,1725196,1726139,1744843,1680491,1723888,1710461,1733232,1743936,1758672,1773392,1776060,1698316,1701004,1722516,1738592,1750608,1774716,1722544,1673811,1770684,1746187,1679548,1684908,1751951,1718107,1738572,1761324,1671552,1718508,1731884,1759595,1682220,1678240,1769376,1754636,1747936,1694304,1698336,1676876,1715815,1701931,1766291,1766692,1737220,1734556,1704608,1672475,1721180,1730155,1680912,1772971,1754235,1754656,1724795,1727483,1766720,1674212,1718528,1727904,1699660,1687600,1777003,1771619,1681819,1746588,1742187,1740843,1735483,1729228,1758652,1679147,1748859,1686256,1715840,1721200,1676475,1684507,1768028,1719451,1774315,1697915,1750187,1770283,1732811,1728827,1764032,1760016,1768955,1759996,1703680,1699259,1747515,1707307,1772020,1753284,1690252,1693883,1749260,1683556,1707708,1716763,1711387,1725216,1736819,1746608,1753312,1702352,1774736,1743515,1741244,1714480,1769356,1723467,1710480,1758251,1700603,1727884,1714059,1739515,1745244,1688507,1734576,1751968,1762267,1755563,1767627,1775659,1777404,1709052,1713116,1747916,1708651,1687179,1730556,1692539,1692940,1715408,1772048,1676896,1683584,1691596,1672876,1720779,1764955,1703660,1719852,1755964,1675147,1762688,1751544,1752883,1691195,1757328,1737248,1763611,1761344,1705040,1742608,1773372,1764012,1726560,1722115,1719872,1710050,1743916,1678220,1691616],"length":1,"stats":{"Line":36}},{"line":112,"address":[],"length":0,"stats":{"Line":72}},{"line":114,"address":[],"length":0,"stats":{"Line":36}},{"line":116,"address":[],"length":0,"stats":{"Line":0}},{"line":117,"address":[],"length":0,"stats":{"Line":0}},{"line":119,"address":[1685476,1716162,1756361,1772425,1772741,1689621,1740484,1755333,1754962,1755017,1757705,1744242,1768596,1682796,1679945,1763010,1685605,1677273,1708421,1709691,1678601,1756306,1696025,1705604,1703029,1745641,1712114,1745828,1694868,1749828,1743285,1686633,1682925,1749641,1761666,1678917,1728281,1700002,1733796,1726937,1696341,1718905,1769924,1729796,1772612,1693653,1697369,1709504,1719092,1760377,1693524,1734882,1725780,1701330,1716533,1757892,1776457,1689305,1753634,1679890,1671874,1681273,1677218,1677460,1694626,1724436,1767397,1737570,1754005,1775113,1732581,1713458,1756677,1706761,1752653,1740297,1748500,1765932,1770053,1695970,1733554,1700244,1708050,1751314,1773714,1717877,1678546,1724194,1746914,1675874,1673210,1717561,1753689,1727124,1732265,1767026,1738914,1771018,1773769,1689250,1699029,1764354,1722921,1717506,1714791,1763381,1775300,1772370,1691938,1692309,1704249,1709433,1681460,1751185,1745957,1712169,1688277,1773956,1744613,1747156,1713513,1757650,1705362,1721756,1721514,1698658,1720178,1750998,1758021,1765745,1769682,1686820,1700373,1727253,1708292,1712356,1687961,1733925,1740613,1694997,1720233,1705417,1721569,1688148,1729925,1674788,1710786,1737625,1720420,1702713,1735253,1758994,1767268,1733609,1762037,1774085,1737812,1684148,1690594,1693337,1742914,1677589,1672245,1682554,1759365,1740242,1747285,1681589,1674917,1682609,1759236,1697556,1716217,1744484,1761908,1674546,1673452,1734937,1750927,1767081,1710841,1731124,1768354,1701701,1673265,1723237,1702900,1736460,1741586,1703991,1671929,1766061,1739156,1690965,1697685,1690836,1717748,1741957,1755204,1764409,1709820,1704062,1760693,1737941,1715049,1676116,1752337,1775429,1686578,1701572,1715178,1672116,1765690,1676245,1701385,1706948,1743156,1728468,1735124,1763065,1680261,1724565,1769737,1746969,1713700,1771073,1689492,1718850,1745586,1705733,1674601,1691993,1694681,1726882,1730882,1708105,1683906,1752282,1761721,1686949,1702658,1728597,1711157,1731253,1712485,1763252,1776402,1673581,1725909,1725538,1749957,1683961,1706706,1675929,1725593,1696212,1698900,1759049,1692180,1736218,1741828,1697314,1776644,1730937,1768725,1760564,1681218,1684277,1690649,1714862,1700057,1711028,1685234,1720549,1764725,1748629,1685289,1707077,1736589,1678788,1687906,1729554,1771389,1724249,1768409,1738969,1748258,1776773,1749586,1760322,1680132,1716404,1729609,1764596,1732452,1698713,1742969,1693282,1748313,1719221,1736273,1756548,1704378,1728226,1739285,1744297,1771260,1741641,1721885,1732210,1723108,1752524,1775058,1753876,1713829,1722866],"length":1,"stats":{"Line":0}},{"line":121,"address":[],"length":0,"stats":{"Line":0}},{"line":124,"address":[],"length":0,"stats":{"Line":0}},{"line":127,"address":[],"length":0,"stats":{"Line":0}},{"line":128,"address":[],"length":0,"stats":{"Line":0}},{"line":130,"address":[],"length":0,"stats":{"Line":0}},{"line":132,"address":[],"length":0,"stats":{"Line":0}},{"line":135,"address":[],"length":0,"stats":{"Line":0}}],"covered":3,"coverable":34},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","src","ffi.rs"],"content":"// standard\nuse std::sync::atomic::{AtomicBool, Ordering};\n\n// extern crates\nuse anyhow::bail;\n#[cfg(feature = \"impl-lib\")]\nuse cgosling_proc_macros::*;\n\n// internal crates\nuse crate::context::*;\nuse crate::crypto::*;\nuse crate::error::*;\nuse crate::macros::*;\nuse crate::tor_provider::*;\nuse crate::utils::*;\n\n// tags used for types we put in ObjectRegistrys\npub(crate) const ERROR_TAG: usize = 0x1;\npub(crate) const ED25519_PRIVATE_KEY_TAG: usize = 0x2;\npub(crate) const X25519_PRIVATE_KEY_TAG: usize = 0x3;\npub(crate) const X25519_PUBLIC_KEY_TAG: usize = 0x4;\npub(crate) const V3_ONION_SERVICE_ID_TAG: usize = 0x5;\npub(crate) const IP_ADDR_TAG: usize = 0x6;\npub(crate) const TARGET_ADDR_TAG: usize = 0x7;\n#[cfg(feature = \"legacy-tor-provider\")]\npub(crate) const PROXY_CONFIG_TAG: usize = 0x8;\n#[cfg(feature = \"legacy-tor-provider\")]\npub(crate) const PLUGGABLE_TRANSPORT_CONFIG_TAG: usize = 0x9;\n#[cfg(feature = \"legacy-tor-provider\")]\npub(crate) const BRIDGE_LINE_TAG: usize = 0xA;\npub(crate) const TOR_PROVIDER_CONFIG_TAG: usize = 0xB;\npub(crate) const TOR_PROVIDER_TAG: usize = 0xC;\npub(crate) const CONTEXT_TUPLE_TAG: usize = 0xD;\n\n/// A handle for the gosling library\npub struct GoslingLibrary;\n\nstatic GOSLING_LIBRARY_INITED: AtomicBool = AtomicBool::new(false);\nconst GOSLING_LIBRARY_HANDLE: usize = {\n    // integer constant in the form 0x6000..5E (GOOOOOSE)\n    (0x60 \u003c\u003c ((std::mem::size_of::\u003cusize\u003e() - 1) * 8)) + 0x5E\n};\n\n/// Initializes the Gosling library. This function must be called before using any of the\n/// other Gosling functions.\n///\n/// @param out_library: returned gosling library handle\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_library_init(\n    out_library: *mut *mut GoslingLibrary,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_library);\n\n        if GOSLING_LIBRARY_INITED.load(Ordering::Relaxed) {\n            // error handling\n            bail!(\"gosling is already initialized\");\n        } else {\n            GOSLING_LIBRARY_INITED.store(true, Ordering::Relaxed);\n            *out_library = GOSLING_LIBRARY_HANDLE as *mut GoslingLibrary;\n        }\n        Ok(())\n    })\n}\n\n/// Frees all resources associated with the Gosling library. No-op if the library\n/// is not initialized or if it has already been freed\n/// @param in_library: gosling library handle to free\n#[no_mangle]\n#[allow(unused_variables)]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_library_free(in_library: *mut GoslingLibrary) {\n    if GOSLING_LIBRARY_INITED.load(Ordering::Relaxed) {\n        clear_error_registry();\n\n        clear_ed25519_private_key_registry();\n        clear_x25519_private_key_registry();\n        clear_x25519_public_key_registry();\n        clear_v3_onion_service_id_registry();\n        clear_ip_addr_registry();\n        clear_target_addr_registry();\n        #[cfg(feature = \"legacy-tor-provider\")]\n        clear_proxy_config_registry();\n        #[cfg(feature = \"legacy-tor-provider\")]\n        clear_pluggable_transport_config_registry();\n        #[cfg(feature = \"legacy-tor-provider\")]\n        clear_bridge_line_registry();\n        clear_tor_provider_registry();\n        clear_tor_provider_config_registry();\n        clear_context_tuple_registry();\n\n        GOSLING_LIBRARY_INITED.store(false, Ordering::Relaxed);\n    }\n}\n","traces":[{"line":51,"address":[2065216,2065253],"length":1,"stats":{"Line":1}},{"line":55,"address":[1627630],"length":1,"stats":{"Line":2}},{"line":56,"address":[2873417],"length":1,"stats":{"Line":1}},{"line":58,"address":[2873434],"length":1,"stats":{"Line":1}},{"line":60,"address":[2873574],"length":1,"stats":{"Line":0}},{"line":62,"address":[2873523],"length":1,"stats":{"Line":1}},{"line":63,"address":[2873618,2873646,2873550],"length":1,"stats":{"Line":2}},{"line":65,"address":[2873631],"length":1,"stats":{"Line":1}},{"line":75,"address":[1627664,1627701],"length":1,"stats":{"Line":1}},{"line":76,"address":[1627673,1627714],"length":1,"stats":{"Line":2}},{"line":77,"address":[1627725],"length":1,"stats":{"Line":1}},{"line":79,"address":[2065348],"length":1,"stats":{"Line":1}},{"line":80,"address":[1627739],"length":1,"stats":{"Line":1}},{"line":81,"address":[1627746],"length":1,"stats":{"Line":1}},{"line":82,"address":[1627753],"length":1,"stats":{"Line":1}},{"line":83,"address":[1627760],"length":1,"stats":{"Line":1}},{"line":84,"address":[1627767],"length":1,"stats":{"Line":1}},{"line":86,"address":[2065390],"length":1,"stats":{"Line":1}},{"line":88,"address":[1627781],"length":1,"stats":{"Line":1}},{"line":90,"address":[1627788],"length":1,"stats":{"Line":1}},{"line":91,"address":[1627795],"length":1,"stats":{"Line":1}},{"line":92,"address":[1627802],"length":1,"stats":{"Line":1}},{"line":93,"address":[1627809],"length":1,"stats":{"Line":1}},{"line":95,"address":[1627816],"length":1,"stats":{"Line":1}}],"covered":23,"coverable":24},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","src","lib.rs"],"content":"// some internal functions take a lot of args but thats ok\n#![allow(clippy::too_many_arguments)]\n// we don't generate Rust docs since this crate should never be used from\n// Rust, only from languages where the c-ffi is the only option; developers\n// should consult the Doxygen generated docs\n#![allow(clippy::missing_safety_doc)]\n\npub mod callbacks;\npub mod context;\npub mod crypto;\npub mod error;\npub mod ffi;\nmod macros;\nmod object_registry;\npub mod tor_provider;\npub mod utils;\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","src","macros.rs"],"content":"// implemeents per-type registry types\nmacro_rules! define_registry {\n    ($type:ty) =\u003e {\n        paste::paste! {\n            // ensure tag fits in 4 bits\n            static_assertions::const_assert!([\u003c$type:snake:upper _TAG\u003e] \u003c= 0b1111);\n\n            static [\u003c$type:snake:upper _REGISTRY\u003e]: std::sync::Mutex\u003ccrate::object_registry::ObjectRegistry\u003c$type, { [\u003c$type:snake:upper _TAG\u003e] }, 4\u003e\u003e = std::sync::Mutex::new(crate::object_registry::ObjectRegistry::new());\n\n            pub(crate) fn [\u003cget_ $type:snake _registry\u003e]\u003c'a\u003e() -\u003e std::sync::MutexGuard\u003c'a, crate::object_registry::ObjectRegistry\u003c$type, { [\u003c$type:snake:upper _TAG\u003e] }, 4\u003e\u003e {\n                match [\u003c$type:snake:upper _REGISTRY\u003e].lock() {\n                    Ok(registry) =\u003e registry,\n                    Err(_) =\u003e unreachable!(\"another thread panicked while holding this registry's mutex\"),\n                }\n            }\n\n            pub(crate) fn [\u003cclear_ $type:snake _registry\u003e]() {\n                match [\u003c$type:snake:upper _REGISTRY\u003e].lock() {\n                    Ok(mut registry) =\u003e *registry = crate::object_registry::ObjectRegistry::new(),\n                    Err(_) =\u003e unreachable!(\"another thread panicked while holding this registry's mutex\"),\n                }\n            }\n        }\n    }\n}\npub(crate) use define_registry;\n\n// macro for defining the implementation of freeing objects\n// owned by an ObjectRegistry\nmacro_rules! impl_registry_free {\n    ($obj:expr, $type:ty) =\u003e {\n        if $obj.is_null() {\n            return;\n        }\n\n        let key = $obj as usize;\n        paste::paste! {\n            [\u003cget_ $type:snake _registry\u003e]().remove(key);\n        }\n    };\n}\npub(crate) use impl_registry_free;\n\n//\n// Argument validation macros\n//\n\n// ensure pointer is not null\nmacro_rules! ensure_not_null {\n    ($ptr:ident) =\u003e {\n        paste::paste! {\n            if $ptr.is_null() {\n                bail!(stringify!([\u003c$ptr\u003e] must not be null));\n            }\n        }\n    };\n}\npub(crate) use ensure_not_null;\n\nmacro_rules! ensure_not_equal {\n    ($value:ident, $constant:literal) =\u003e {\n        if $value == $constant {\n            bail!(stringify!([\u003c$value\u003e must not be \u003c$constant\u003e]));\n        }\n    }\n}\npub(crate) use ensure_not_equal;\n\n// bail because handle invalid\nmacro_rules! bail_invalid_handle {\n    ($handle:ident) =\u003e {\n        paste::paste! {\n            bail!(stringify!([\u003c$handle\u003e] is invalid))\n        }\n    };\n}\npub(crate) use bail_invalid_handle;\n","traces":[{"line":10,"address":[1662206,1662000,1662184],"length":1,"stats":{"Line":7}},{"line":11,"address":[2844391,2843687],"length":1,"stats":{"Line":7}},{"line":12,"address":[2833104,2833808,2835216,2835920,2834512],"length":1,"stats":{"Line":7}},{"line":13,"address":[2253717],"length":1,"stats":{"Line":0}},{"line":17,"address":[2259925,2259456,2259860],"length":1,"stats":{"Line":13}},{"line":18,"address":[2253815],"length":1,"stats":{"Line":13}},{"line":19,"address":[2834082,2835448,2834372,2835076,2833336,2833378,2836484,2833668,2834744,2834786,2835780,2834040,2836152,2836194,2835490],"length":1,"stats":{"Line":13}},{"line":20,"address":[1662615],"length":1,"stats":{"Line":0}},{"line":32,"address":[1638260,1638284],"length":1,"stats":{"Line":0}},{"line":36,"address":[1638295],"length":1,"stats":{"Line":0}},{"line":38,"address":[2868452,2868316,2867927,2868286,2867960,2868140,2868485,2868110],"length":1,"stats":{"Line":0}},{"line":52,"address":[2873425],"length":1,"stats":{"Line":43}},{"line":53,"address":[2050296,2050415,2042728,2042385,2047268,2037891,2037533,2040884,2045719,2047149,2037426,2052969,2047026,2050050,2040196,2042274,2045838,2041572,2042492,2042862,2049337,2050173],"length":1,"stats":{"Line":0}},{"line":62,"address":[1801927,1793143,1794031,1798401,1790889,1798618,1795931,1790666,1798820],"length":1,"stats":{"Line":6}},{"line":63,"address":[1850419,1838040,1838156,1842820,1847403],"length":1,"stats":{"Line":0}},{"line":73,"address":[1631195,1629979,1630891,1630508,1632636,1631803,1634156,1634539,1633931,1635068,1635372,1631724,1628684,1630204,1628380,1630812,1631420,1629596,1632332,1633548,1629371,1633627,1633852,1635451,1628155,1633019,1632940,1628459,1628076,1632411,1632715,1632107,1628988,1630283,1632028,1629675,1633244,1635147,1628763,1630587,1629067,1631116,1633323,1629900,1634764,1634843,1631499,1629292,1634235,1634460],"length":1,"stats":{"Line":0}}],"covered":8,"coverable":16},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","src","object_registry.rs"],"content":"// standard\nuse std::collections::BTreeMap;\nuse std::option::Option;\n\n// An ObjectRegistry\u003cT\u003e maintains ownership of objects and maps them to usize keys\n// which can be safely handed out to external consumers as opaque pointer.\n// Keys are represented as a usize; the high bits are a unique identifier (calculated\n// as the number of keys handed out at the time of key creation, but this is an implementation\n// detail) while the low bits are a user-provided tag used to disambiguate keys from different\n// ObjectRegistry's.\n//\n// T: the type we are storing in the registry\n// TAG: a usize constant which occupy the low bits of returned keys\n// TAG_BITS: the number of bits needed to store the tag (the remainder of the usize bits are used\n//   for the unique id portion of the returne dkeys)\npub struct ObjectRegistry\u003cT, const TAG: usize, const TAG_BITS: u32\u003e {\n    // our internal mapping from handles to Ts\n    map: Option\u003cBTreeMap\u003cusize, T\u003e\u003e,\n    // number of Ts registered to this registry over its lifetime\n    counter: usize,\n}\n\n// Rust only supports 8-bit bytes\nconst BITS_PER_BYTE: u32 = 8;\n\nimpl\u003cT, const TAG: usize, const TAG_BITS: u32\u003e ObjectRegistry\u003cT, TAG, TAG_BITS\u003e {\n    // the number of bits available to the counter portion of an object key\n    const COUNTER_BITS: u32 = std::mem::size_of::\u003cusize\u003e() as u32 * BITS_PER_BYTE - TAG_BITS;\n    // the largest value the counter portion of the key can be without rolling over to 0\n    const COUNTER_MAX: usize = !0usize \u003e\u003e TAG_BITS;\n\n    // return the next key to return on successful insertion\n    fn next_key(\u0026mut self) -\u003e usize {\n        assert!(self.counter \u003c Self::COUNTER_MAX);\n        self.counter += 1;\n        (self.counter \u003c\u003c TAG_BITS) | TAG\n    }\n\n    // returns a new empty ObjectRegisry\n    pub const fn new() -\u003e ObjectRegistry\u003cT, TAG, TAG_BITS\u003e {\n        assert!(TAG_BITS == 0 || (TAG \u003c\u003c Self::COUNTER_BITS) \u003e\u003e Self::COUNTER_BITS == TAG);\n\n        ObjectRegistry {\n            map: None,\n            counter: 0,\n        }\n    }\n\n    // determine if the registry has an object with the specified key\n    pub fn contains_key(\u0026self, key: usize) -\u003e bool {\n        match \u0026self.map {\n            Some(map) =\u003e map.contains_key(\u0026key),\n            None =\u003e false,\n        }\n    }\n\n    // remove and return an object with the specified key\n    pub fn remove(\u0026mut self, key: usize) -\u003e Option\u003cT\u003e {\n        match \u0026mut self.map {\n            Some(map) =\u003e map.remove(\u0026key),\n            None =\u003e None,\n        }\n    }\n\n    // add object into registry and return key to reference it\n    pub fn insert(\u0026mut self, val: T) -\u003e usize {\n        let key = self.next_key();\n        match \u0026mut self.map {\n            Some(map) =\u003e {\n                if map.insert(key, val).is_some() {\n                    panic!();\n                }\n            }\n            None =\u003e {\n                let mut map = BTreeMap::new();\n                map.insert(key, val);\n                self.map = Some(map);\n            }\n        }\n        key\n    }\n\n    // gets a reference to a value by the given key\n    pub fn get(\u0026self, key: usize) -\u003e Option\u003c\u0026T\u003e {\n        match \u0026self.map {\n            Some(map) =\u003e map.get(\u0026key),\n            None =\u003e None,\n        }\n    }\n\n    // gets a mutable reference to a value by the given key\n    pub fn get_mut(\u0026mut self, key: usize) -\u003e Option\u003c\u0026mut T\u003e {\n        match \u0026mut self.map {\n            Some(map) =\u003e map.get_mut(\u0026key),\n            None =\u003e None,\n        }\n    }\n\n    #[cfg(test)]\n    // gets just the tag portion of a key assuming it came from\n    // this registry\n    fn get_tag_from_key(\u0026self, key: usize) -\u003e usize {\n        // zero out the counter bits and return tag\n        (key \u003c\u003c Self::COUNTER_BITS) \u003e\u003e Self::COUNTER_BITS\n    }\n\n    #[cfg(test)]\n    // gets the counter portion of a key assuming it came from\n    // this registry\n    fn get_counter_from_key(\u0026self, key: usize) -\u003e usize {\n        // rotate out the tag bits\n        key \u003e\u003e TAG_BITS\n    }\n\n    #[cfg(test)]\n    // calculate the key given the counter assuming it would be used\n    // by this registry\n    fn get_key_from_counter(\u0026self, counter: usize) -\u003e usize {\n        (counter \u003c\u003c TAG_BITS) | TAG\n    }\n}\n\n#[test]\nfn test_object_registry() -\u003e anyhow::Result\u003c()\u003e {\n    // create a new ObjectRegistry\n    type Int32Registry0_16 = ObjectRegistry\u003ci32, 1234usize, 16\u003e;\n    let mut registry = Int32Registry0_16::new();\n    assert_eq!(\n        Int32Registry0_16::COUNTER_BITS,\n        std::mem::size_of::\u003cusize\u003e() as u32 * BITS_PER_BYTE - 16\n    );\n\n    // add some objects to the registry and get their keys\n    let key1 = registry.insert(10);\n    let key2 = registry.insert(20);\n    let key3 = registry.insert(30);\n\n    // check that the registry contains the keys we just added\n    assert!(registry.contains_key(key1));\n    assert!(registry.contains_key(key2));\n    assert!(registry.contains_key(key3));\n\n    // check that we can get the objects back using their keys\n    assert_eq!(registry.get(key1), Some(\u002610));\n    assert_eq!(registry.get(key2), Some(\u002620));\n    assert_eq!(registry.get(key3), Some(\u002630));\n\n    // check that we can get mutable references to the objects and modify them\n    let obj = registry.get_mut(key1).unwrap();\n    *obj = 100;\n    assert_eq!(registry.get(key1), Some(\u0026100));\n\n    // check that we can remove objects from the registry and they are no longer contained\n    let obj = registry.remove(key2).unwrap();\n    assert_eq!(obj, 20);\n    assert!(!registry.contains_key(key2));\n\n    // check that the tag bits of the keys match the TAG constant we provided\n    assert_eq!(registry.get_tag_from_key(key1), 1234usize);\n    assert_eq!(registry.get_tag_from_key(key2), 1234usize);\n    assert_eq!(registry.get_tag_from_key(key3), 1234usize);\n\n    // check that the counter bits of the keys are unique and increasing\n    let counter1 = registry.get_counter_from_key(key1);\n    let counter2 = registry.get_counter_from_key(key2);\n    let counter3 = registry.get_counter_from_key(key3);\n    assert!(counter1 \u003c counter2 \u0026\u0026 counter2 \u003c counter3);\n\n    // check that we can calculate the key given the counter and it matches the key we got from insert()\n    assert_eq!(registry.get_key_from_counter(1), key1);\n    assert_eq!(registry.get_key_from_counter(2), key2);\n    assert_eq!(registry.get_key_from_counter(3), key3);\n\n    Ok(())\n}\n\n#[test]\nfn test_object_registry_key_collision() -\u003e anyhow::Result\u003c()\u003e {\n    // create two registries with different TAG values\n    let mut registry_a: ObjectRegistry\u003cString, 1usize, 8\u003e = ObjectRegistry::new();\n    let mut registry_b: ObjectRegistry\u003cString, 2usize, 8\u003e = ObjectRegistry::new();\n\n    // insert objects into the registries\n    let key_a_1 = registry_a.insert(\"a1\".to_string());\n    let key_a_2 = registry_a.insert(\"a2\".to_string());\n    let key_b_1 = registry_b.insert(\"b1\".to_string());\n    let key_b_2 = registry_b.insert(\"b2\".to_string());\n\n    // counter portions should be the same\n    assert_eq!(\n        registry_a.get_counter_from_key(key_a_1),\n        registry_b.get_counter_from_key(key_b_1)\n    );\n    assert_eq!(\n        registry_a.get_counter_from_key(key_a_2),\n        registry_b.get_counter_from_key(key_b_2)\n    );\n\n    // ensure the keys do not collide\n    assert!(key_a_1 != key_b_1);\n    assert!(key_a_2 != key_b_2);\n    assert!(key_a_1 != key_b_2);\n    assert!(key_a_2 != key_b_1);\n\n    Ok(())\n}\n#[test]\nfn test_object_registry_empty_tag() -\u003e anyhow::Result\u003c()\u003e {\n    // create a registry with tag 0 and tag bits 0\n    let mut reg = ObjectRegistry::\u003ci32, 0, 0\u003e::new();\n\n    // add some values and check their keys\n    let key1 = reg.insert(1);\n    let key2 = reg.insert(2);\n    assert_eq!(key1, 1);\n    assert_eq!(key2, 2);\n\n    Ok(())\n}\n","traces":[{"line":33,"address":[],"length":0,"stats":{"Line":11}},{"line":34,"address":[2873870,2873742,2875534,2873998,2875790,2875406,2875150,2875662,2874382,2874638,2874766,2875022,2874126,2874254,2874510,2875278,2874894],"length":1,"stats":{"Line":11}},{"line":35,"address":[],"length":0,"stats":{"Line":11}},{"line":36,"address":[],"length":0,"stats":{"Line":11}},{"line":40,"address":[2876704,2876464,2876384,2876064,2875904,2876784,2876944,2875984,2876544,2876864,2877104,2877184,2876224,2876304,2876144,2876624,2877024],"length":1,"stats":{"Line":17}},{"line":41,"address":[],"length":0,"stats":{"Line":16}},{"line":50,"address":[],"length":0,"stats":{"Line":1}},{"line":51,"address":[2877282,2877362],"length":1,"stats":{"Line":1}},{"line":52,"address":[2099011],"length":1,"stats":{"Line":1}},{"line":53,"address":[2877368,2877288],"length":1,"stats":{"Line":0}},{"line":58,"address":[],"length":0,"stats":{"Line":6}},{"line":59,"address":[2100157,2100253,2099667,2099565,2099085,2099373,2099773,2099277,2099469,2099181,2099859,2099965,2100061],"length":1,"stats":{"Line":6}},{"line":60,"address":[2100279,2099605,2099121,2099689,2099305,2099803,2099991,2099881,2100187,2099399,2099207,2100091,2099505],"length":1,"stats":{"Line":6}},{"line":61,"address":[],"length":0,"stats":{"Line":0}},{"line":66,"address":[2880384,2879435,2889686,2891142,2884160,2891762,2885664,2883264,2890314,2888818,2889558,2891660,2884011,2886416,2879600,2887052,2888960,2882542,2885562,2890480,2887200,2882640,2886267,2891060,2882624,2884123,2884912,2886379,2879559,2881024,2881152,2878768,2881184,2881782,2883132,2885648,2887164,2888099,2888128,2888930,2880236,2881952,2887975,2889728,2880348,2881910,2884746,2884881,2890449,2883234,2891168],"length":1,"stats":{"Line":11}},{"line":67,"address":[],"length":0,"stats":{"Line":22}},{"line":68,"address":[2879720,2886536,2882072,2878888,2889853,2889080,2887320,2888248,2883384,2885784,2890600,2884285,2891294,2881304,2882766,2885032,2880504],"length":1,"stats":{"Line":11}},{"line":69,"address":[2103117,2102283,2107149,2107872,2108755,2110493,2100480,2109693,2106315,2104733,2105536,2101331,2103899],"length":1,"stats":{"Line":11}},{"line":70,"address":[2101972,2108435,2110945,2109372,2102300,2103596,2110165,2105548,2101343,2102797,2105205,2103916,2101016,2107161,2109705,2106332,2107884,2100492,2104745,2106829,2108767,2110505,2103129,2106055,2104413,2107611],"length":1,"stats":{"Line":22}},{"line":71,"address":[],"length":0,"stats":{"Line":0}},{"line":74,"address":[],"length":0,"stats":{"Line":0}},{"line":75,"address":[],"length":0,"stats":{"Line":11}},{"line":76,"address":[2100714,2104111,2103990,2101670,2102374,2103300,2102495,2107220,2106527,2107982,2108133,2107332,2100575,2105770,2105631,2101483,2103188,2108895,2104792,2104895,2106406,2110562,2110669,2109752,2109070,2109855],"length":1,"stats":{"Line":20}},{"line":77,"address":[2879975,2883750,2886012,2888557,2886791,2891447,2881530,2882919,2880763,2887714,2879174,2885301,2882287,2890808,2889306,2884494,2890062],"length":1,"stats":{"Line":11}},{"line":80,"address":[],"length":0,"stats":{"Line":0}},{"line":84,"address":[2892512,2891952,2891792,2892592,2892672,2892352,2892272,2892112,2892192,2891872,2892032,2892432],"length":1,"stats":{"Line":6}},{"line":85,"address":[2891890,2891970,2892050,2892130,2891810,2892290,2892530,2892690,2892370,2892450,2892610,2892210],"length":1,"stats":{"Line":6}},{"line":86,"address":[2111559,2111239,2111479,2111639,2111159,2111799,2111399,2111319,2111719,2111879,2111079],"length":1,"stats":{"Line":6}},{"line":87,"address":[],"length":0,"stats":{"Line":0}},{"line":92,"address":[2892912,2892752,2892832,2892992],"length":1,"stats":{"Line":2}},{"line":93,"address":[2892770,2893010,2892850,2892930],"length":1,"stats":{"Line":2}},{"line":94,"address":[2892951,2892791,2893031,2892871],"length":1,"stats":{"Line":2}},{"line":95,"address":[2893016,2892776,2892856,2892936],"length":1,"stats":{"Line":0}},{"line":102,"address":[],"length":0,"stats":{"Line":1}},{"line":104,"address":[],"length":0,"stats":{"Line":1}},{"line":110,"address":[],"length":0,"stats":{"Line":3}},{"line":112,"address":[],"length":0,"stats":{"Line":3}},{"line":118,"address":[],"length":0,"stats":{"Line":1}},{"line":119,"address":[],"length":0,"stats":{"Line":1}}],"covered":32,"coverable":39},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","src","tor_provider.rs"],"content":"// standard\n#[cfg(feature = \"legacy-tor-provider\")]\nuse std::os::raw::c_char;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse std::path::Path;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse std::str::FromStr;\n\n// extern crates\nuse anyhow::bail;\n#[cfg(feature = \"impl-lib\")]\nuse cgosling_proc_macros::*;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse tor_interface::censorship_circumvention::*;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse tor_interface::legacy_tor_client::*;\n#[cfg(feature = \"mock-tor-provider\")]\nuse tor_interface::mock_tor_client::*;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse tor_interface::proxy::*;\nuse tor_interface::*;\n\n// internal crates\nuse crate::error::*;\nuse crate::ffi::*;\nuse crate::macros::*;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse crate::utils::*;\n\n/// Proxy settings object used by tor provider to connect to the tor network\n#[cfg(feature = \"legacy-tor-provider\")]\npub struct GoslingProxyConfig;\n#[cfg(feature = \"legacy-tor-provider\")]\ndefine_registry! {ProxyConfig}\n\n/// Pluggable transports settings object used by tor provider to launch pluggable-transports\n#[cfg(feature = \"legacy-tor-provider\")]\npub struct GoslingPluggableTransportConfig;\n#[cfg(feature = \"legacy-tor-provider\")]\ndefine_registry! {PluggableTransportConfig}\n\n/// Bridge line to use with particular pluggable-transport when connecting to the tor network\n#[cfg(feature = \"legacy-tor-provider\")]\npub struct GoslingBridgeLine;\n#[cfg(feature = \"legacy-tor-provider\")]\ndefine_registry! {BridgeLine}\n\n/// A tor provider config object used to construct a tor provider\npub struct GoslingTorProviderConfig;\npub(crate) enum TorProviderConfig {\n    #[cfg(feature = \"mock-tor-provider\")]\n    MockTorClientConfig,\n    #[cfg(feature = \"legacy-tor-provider\")]\n    LegacyTorClientConfig(tor_interface::legacy_tor_client::LegacyTorClientConfig),\n}\ndefine_registry! {TorProviderConfig}\n\n/// A tor provider object used by a context to connect to the tor network\npub struct GoslingTorProvider;\n/// cbindgen:ignore\ntype TorProvider = Box\u003cdyn tor_provider::TorProvider\u003e;\ndefine_registry! {TorProvider}\n\n//\n// Memory freeing functions\n//\n\n/// Frees a gosling_proxy_config\n///\n/// @param in_proxy_config: the proxy config object to free\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_proxy_config_free(in_proxy_config: *mut GoslingProxyConfig) {\n    impl_registry_free!(in_proxy_config, ProxyConfig);\n}\n\n/// Frees a gosling_pluggable_transport_config\n///\n/// @param in_pluggable_transport_config: the pluggable-transport object to free\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_pluggable_transport_config_free(\n    in_pluggable_transport_config: *mut GoslingPluggableTransportConfig,\n) {\n    impl_registry_free!(in_pluggable_transport_config, PluggableTransportConfig);\n}\n\n/// Frees a gosling_bridge_line\n///\n/// @param in_bridge_line: the bridge line object to free\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_bridge_line_free(in_bridge_line: *mut GoslingBridgeLine) {\n    impl_registry_free!(in_bridge_line, BridgeLine);\n}\n\n/// Frees a gosling_tor_provider_config\n///\n/// @param in_tor_provider_config: the tor provider config object to free\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_tor_provider_config_free(\n    in_tor_provider_config: *mut GoslingTorProviderConfig,\n) {\n    impl_registry_free!(in_tor_provider_config, TorProviderConfig);\n}\n\n/// Frees a gosling_tor_provider object\n///\n/// @param in_tor_provider: the tor provider object to free\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_tor_provider_free(in_tor_provider: *mut GoslingTorProvider) {\n    impl_registry_free!(in_tor_provider, TorProvider);\n}\n\n//\n// Proxy\n//\n\n/// Create a socks4 proxy definition\n///\n/// @param out_proxy_config: returned proxy config object\n/// @param proxy_address: the host address of the proxy, must not be an onion service\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_proxy_config_new_socks4(\n    out_proxy_config: *mut *mut GoslingProxyConfig,\n    proxy_address: *const GoslingTargetAddress,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_proxy_config);\n        ensure_not_null!(proxy_address);\n\n        let proxy_address = match get_target_addr_registry().get(proxy_address as usize) {\n            Some(target_address) =\u003e target_address.clone(),\n            None =\u003e bail_invalid_handle!(proxy_address),\n        };\n        let proxy_config = Socks4ProxyConfig::new(proxy_address)?;\n\n        let handle = get_proxy_config_registry().insert(proxy_config.into());\n        *out_proxy_config = handle as *mut GoslingProxyConfig;\n\n        Ok(())\n    });\n}\n\n/// Create a socks5 proxy definition\n///\n/// @param out_proxy_config: returned proxy config object\n/// @param proxy_address: the host address of the proxy, must not be an onion service\n/// @param username: username to authenticate with socks5 proxy\n/// @param username_length: number of characters in username, not counting any null-\n///  terminator\n/// @param password: password to authenticate with socks5 proxy\n/// @param password_length: number of characters in username, not counting any null-\n///  terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_proxy_config_new_socks5(\n    out_proxy_config: *mut *mut GoslingProxyConfig,\n    proxy_address: *const GoslingTargetAddress,\n    username: *const c_char,\n    username_length: usize,\n    password: *const c_char,\n    password_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_proxy_config);\n        ensure_not_null!(proxy_address);\n\n        let proxy_address = match get_target_addr_registry().get(proxy_address as usize) {\n            Some(target_address) =\u003e target_address.clone(),\n            None =\u003e bail_invalid_handle!(proxy_address),\n        };\n\n        let username = if username.is_null() || username_length == 0 {\n            None\n        } else {\n            let username = std::slice::from_raw_parts(username as *const u8, username_length);\n            let username = std::str::from_utf8(username)?;\n            Some(username.to_string())\n        };\n\n        let password = if password.is_null() || password_length == 0 {\n            None\n        } else {\n            let password = std::slice::from_raw_parts(password as *const u8, password_length);\n            let password = std::str::from_utf8(password)?;\n            Some(password.to_string())\n        };\n\n        let proxy_config = Socks5ProxyConfig::new(proxy_address, username, password)?;\n\n        let handle = get_proxy_config_registry().insert(proxy_config.into());\n        *out_proxy_config = handle as *mut GoslingProxyConfig;\n\n        Ok(())\n    });\n}\n\n/// Create a https proxy definition\n///\n/// @param out_proxy_config: returned proxy config object\n/// @param proxy_address: the host address of the proxy, must not be an onion service\n/// @param username: username to authenticate with https proxy\n/// @param username_length: number of characters in username, not counting any null-\n///  terminator\n/// @param password: password to authenticate with https proxy\n/// @param password_length: number of characters in username, not counting any null-\n///  terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_proxy_config_new_https(\n    out_proxy_config: *mut *mut GoslingProxyConfig,\n    proxy_address: *const GoslingTargetAddress,\n    username: *const c_char,\n    username_length: usize,\n    password: *const c_char,\n    password_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_proxy_config);\n        ensure_not_null!(proxy_address);\n\n        let proxy_address = match get_target_addr_registry().get(proxy_address as usize) {\n            Some(target_address) =\u003e target_address.clone(),\n            None =\u003e bail_invalid_handle!(proxy_address),\n        };\n\n        let username = if username.is_null() || username_length == 0 {\n            None\n        } else {\n            let username = std::slice::from_raw_parts(username as *const u8, username_length);\n            let username = std::str::from_utf8(username)?;\n            Some(username.to_string())\n        };\n\n        let password = if password.is_null() || password_length == 0 {\n            None\n        } else {\n            let password = std::slice::from_raw_parts(password as *const u8, password_length);\n            let password = std::str::from_utf8(password)?;\n            Some(password.to_string())\n        };\n\n        let proxy_config = HttpsProxyConfig::new(proxy_address, username, password)?;\n\n        let handle = get_proxy_config_registry().insert(proxy_config.into());\n        *out_proxy_config = handle as *mut GoslingProxyConfig;\n\n        Ok(())\n    });\n}\n\n//\n// Pluggable Transport\n//\n\n/// Create a new pluggable-transport config object\n///\n/// @param out_pluggable_transport_config: returned pluggable-transport object\n/// @param transports: comma-delimited list of transports this pluggable-transport\n///  supports\n/// @param transports_length: number of characters in transports, not counting any\n///  null-terminator\n/// @param path_to_binary: path to the pluggable-transport binary, either absolute or\n///  relative to the tor daemon process\n/// @param path_to_binary_length: number of characters in path_to_binary, not counting any null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_pluggable_transport_config_new(\n    out_pluggable_transport_config: *mut *mut GoslingPluggableTransportConfig,\n    transports: *const c_char,\n    transports_length: usize,\n    path_to_binary: *const c_char,\n    path_to_binary_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_pluggable_transport_config);\n        ensure_not_null!(transports);\n        ensure_not_equal!(transports_length, 0);\n        ensure_not_null!(path_to_binary);\n        ensure_not_equal!(path_to_binary_length, 0);\n\n        let transports = std::slice::from_raw_parts(transports as *const u8, transports_length);\n        let transports = std::str::from_utf8(transports)?;\n        let transports: Vec\u003cString\u003e = transports.split(',').map(|s| s.to_string()).collect();\n\n        let path_to_binary =\n            std::slice::from_raw_parts(path_to_binary as *const u8, path_to_binary_length);\n        let path_to_binary = std::str::from_utf8(path_to_binary)?;\n        let path_to_binary = Path::new(path_to_binary);\n        path_to_binary.canonicalize()?;\n\n        let pluggable_transport_config =\n            PluggableTransportConfig::new(transports, path_to_binary.into())?;\n        let handle = get_pluggable_transport_config_registry().insert(pluggable_transport_config);\n        *out_pluggable_transport_config = handle as *mut GoslingPluggableTransportConfig;\n\n        Ok(())\n    })\n}\n\n/// Add a command-line option to be used when launching the pluggable-transport\n///\n/// @param pluggable_transport_config: the pluggable-transport ocnfig object to update\n/// @param option: cmd-line option or flag to pass to the pluggable-transport on launch\n/// @param option_length: number of characters in option, not counting any null-\n///  terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_pluggable_transport_config_add_cmdline_option(\n    pluggable_transport_config: *mut GoslingPluggableTransportConfig,\n    option: *const c_char,\n    option_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(pluggable_transport_config);\n        ensure_not_null!(option);\n        ensure_not_equal!(option_length, 0);\n\n        let option = std::slice::from_raw_parts(option as *const u8, option_length);\n        let option = std::str::from_utf8(option)?;\n\n        match get_pluggable_transport_config_registry().get_mut(pluggable_transport_config as usize)\n        {\n            Some(config) =\u003e config.add_option(option.to_string()),\n            None =\u003e bail_invalid_handle!(pluggable_transport_config),\n        }\n\n        Ok(())\n    });\n}\n\n//\n// Bridge Line\n//\n\n/// Construct bridge line from string\n///\n/// @param out_bridge_line: returned bridge line object\n/// @param bridge_line: a bridge address to connect to using a pluggable-transport. For\n///  more information, see: https://tb-manual.torproject.org/bridges/\n/// @param bridge_line_length: number of characters in bridge_line, not counting any\n///  null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_bridge_line_from_string(\n    out_bridge_line: *mut *mut GoslingBridgeLine,\n    bridge_line: *const c_char,\n    bridge_line_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_bridge_line);\n        ensure_not_null!(bridge_line);\n        ensure_not_equal!(bridge_line_length, 0);\n\n        let bridge_line = std::slice::from_raw_parts(bridge_line as *const u8, bridge_line_length);\n        let bridge_line = std::str::from_utf8(bridge_line)?;\n        let bridge_line = BridgeLine::from_str(bridge_line)?;\n\n        let handle = get_bridge_line_registry().insert(bridge_line);\n        *out_bridge_line = handle as *mut GoslingBridgeLine;\n\n        Ok(())\n    });\n}\n\n//\n// Tor Provider Config Construction Functions\n//\n\n/// Create a tor provider config to build a mock no-internet tor provider for testing.\n///\n/// @param out_tor_provider_config: returned tor provider\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"mock-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_tor_provider_config_new_mock_client_config(\n    out_tor_provider_config: *mut *mut GoslingTorProviderConfig,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_tor_provider_config);\n\n        let handle =\n            get_tor_provider_config_registry().insert(TorProviderConfig::MockTorClientConfig);\n        *out_tor_provider_config = handle as *mut GoslingTorProviderConfig;\n\n        Ok(())\n    });\n}\n\n/// Create a tor provider config to build a bundled legacy tor daemon.\n///\n/// @param out_tor_provider_config: returned tor provider config\n/// @param tor_bin_path: the file system path to the tor binary; if this is null the tor executable\n///  found in the system PATH variable is used\n/// @param tor_bin_path_length: the number of chars in tor_bin_path not including any null terminator\n/// @param tor_working_directory: the file system path to store tor's data\n/// @param tor_working_directory_length: the number of chars in tor_working_directory not including any\n///  null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_tor_provider_config_new_bundled_legacy_client_config(\n    out_tor_provider_config: *mut *mut GoslingTorProviderConfig,\n    tor_bin_path: *const c_char,\n    tor_bin_path_length: usize,\n    tor_working_directory: *const c_char,\n    tor_working_directory_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_tor_provider_config);\n        if tor_bin_path.is_null() \u0026\u0026 tor_bin_path_length != 0 {\n            bail!(\"tor_bin_path is null so tor_bin_path_length must be 0\");\n        }\n        if !tor_bin_path.is_null() \u0026\u0026 tor_bin_path_length == 0 {\n            bail!(\"tor_bin_path is not null so tor_bin_path_length must be greater than 0\");\n        }\n        ensure_not_null!(tor_working_directory);\n        ensure_not_equal!(tor_working_directory_length, 0);\n\n        // tor bin\n        let tor_bin_path = if tor_bin_path.is_null() {\n            which::which(format!(\"tor{}\", std::env::consts::EXE_SUFFIX))?\n        } else {\n            let tor_bin_path =\n                std::slice::from_raw_parts(tor_bin_path as *const u8, tor_bin_path_length);\n            let tor_bin_path = std::str::from_utf8(tor_bin_path)?;\n            let tor_bin_path = Path::new(tor_bin_path);\n            tor_bin_path.canonicalize()?\n        };\n\n        // tor working dir\n        let tor_working_directory = std::slice::from_raw_parts(\n            tor_working_directory as *const u8,\n            tor_working_directory_length,\n        );\n        let tor_working_directory = std::str::from_utf8(tor_working_directory)?;\n        let tor_working_directory = Path::new(tor_working_directory).to_path_buf();\n        let tor_config = LegacyTorClientConfig::BundledTor {\n            tor_bin_path: tor_bin_path,\n            data_directory: tor_working_directory,\n            proxy_settings: None,\n            allowed_ports: None,\n            pluggable_transports: None,\n            bridge_lines: None,\n        };\n\n        let handle = get_tor_provider_config_registry()\n            .insert(TorProviderConfig::LegacyTorClientConfig(tor_config));\n        *out_tor_provider_config = handle as *mut GoslingTorProviderConfig;\n\n        Ok(())\n    });\n}\n\n/// Create a tor provider config to build a system legacy tor daemon\n///\n/// @param out_tor_provider_config: returned tor provider config\n/// @param tor_socks_host: tor daemon socks server host\n/// @param tor_socks_port: tor daemon socks server port\n/// @param tor_control_host: tor daemon control host\n/// @param tor_control_port: tor daemon control port\n/// @param tor_control_passwd: authentication password\n/// @param tor_control_passwd_length: the number of chars in tor_control_password not\n///  including any null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_tor_provider_config_new_system_legacy_client_config(\n    out_tor_provider_config: *mut *mut GoslingTorProviderConfig,\n    tor_socks_host: *const GoslingIpAddress,\n    tor_socks_port: u16,\n    tor_control_host: *const GoslingIpAddress,\n    tor_control_port: u16,\n    tor_control_passwd: *const c_char,\n    tor_control_passwd_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_tor_provider_config);\n        ensure_not_null!(tor_socks_host);\n        ensure_not_equal!(tor_socks_port, 0);\n        ensure_not_null!(tor_control_host);\n        ensure_not_equal!(tor_control_port, 0);\n        ensure_not_null!(tor_control_passwd);\n        ensure_not_equal!(tor_control_passwd_length, 0);\n\n        // constructor tor_socks_addr\n        let tor_socks_host = match get_ip_addr_registry().get(tor_socks_host as usize) {\n            Some(tor_socks_host) =\u003e tor_socks_host.clone(),\n            None =\u003e bail_invalid_handle!(tor_socks_host),\n        };\n        let tor_socks_addr = std::net::SocketAddr::new(tor_socks_host, tor_socks_port);\n\n        // construct tor_control_addr\n        let tor_control_host = match get_ip_addr_registry().get(tor_control_host as usize) {\n            Some(tor_control_host) =\u003e tor_control_host.clone(),\n            None =\u003e bail_invalid_handle!(tor_control_host),\n        };\n        let tor_control_addr = std::net::SocketAddr::new(tor_control_host, tor_control_port);\n\n        // construct tor_control_password\n        let tor_control_passwd =\n            std::slice::from_raw_parts(tor_control_passwd as *const u8, tor_control_passwd_length);\n        let tor_control_passwd = std::str::from_utf8(tor_control_passwd)?.to_string();\n\n        let tor_config = LegacyTorClientConfig::SystemTor {\n            tor_socks_addr,\n            tor_control_addr,\n            tor_control_passwd,\n        };\n\n        let handle = get_tor_provider_config_registry()\n            .insert(TorProviderConfig::LegacyTorClientConfig(tor_config));\n        *out_tor_provider_config = handle as *mut GoslingTorProviderConfig;\n\n        Ok(())\n    });\n}\n\n//\n// Tor Provider Config Modification Functions\n//\n\n/// Set a tor provider config's proxy configuration. A tor provider config\n/// does not need to support proxy configuration, so this function may fail\n/// as a result. The currently supported tor provider configs are:\n/// - Legacy Bundled Client\n///\n/// @param tor_provider_config: the tor provider config to update\n/// @param proxy_config: the proxy configuration to use; must not be null\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_tor_provider_config_set_proxy_config(\n    tor_provider_config: *mut GoslingTorProviderConfig,\n    proxy_config: *const GoslingProxyConfig,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(tor_provider_config);\n        ensure_not_null!(proxy_config);\n\n        match get_tor_provider_config_registry().get_mut(tor_provider_config as usize) {\n            Some(tor_provider_config) =\u003e match tor_provider_config {\n                TorProviderConfig::LegacyTorClientConfig(LegacyTorClientConfig::BundledTor {\n                    proxy_settings,\n                    ..\n                }) =\u003e {\n                    *proxy_settings = match get_proxy_config_registry().get(proxy_config as usize) {\n                        Some(proxy_config) =\u003e Some(proxy_config.clone()),\n                        None =\u003e bail_invalid_handle!(proxy_config),\n                    };\n                }\n                _ =\u003e bail!(\"tor_provider_config does not support this operation\"),\n            },\n            None =\u003e bail_invalid_handle!(tor_provider_config),\n        }\n\n        Ok(())\n    })\n}\n\n/// Set a tor provider config's allowed ports list. A tor provider config does\n/// not need to support a port allow-list, so this function may fail as a result.\n/// The currently supported tor provider configs are:\n/// - Legacy Bundled Client\n///\n/// @param tor_provider_config: the tor provider config to update\n/// @param allowed_ports: an array of ports the local system's firewall allows\n///  connections to; must not be null\n/// @param allowed_ports_count: the number of ports in the allowed_ports array; must\n///  not be 0\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_tor_provider_config_set_allowed_ports(\n    tor_provider_config: *mut GoslingTorProviderConfig,\n    allowed_ports: *const u16,\n    allowed_ports_count: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(tor_provider_config);\n        ensure_not_null!(allowed_ports);\n        ensure_not_equal!(allowed_ports_count, 0);\n\n        let allowed_ports_slice =\n            std::slice::from_raw_parts(allowed_ports as *const u16, allowed_ports_count);\n        match get_tor_provider_config_registry().get_mut(tor_provider_config as usize) {\n            Some(tor_provider_config) =\u003e match tor_provider_config {\n                TorProviderConfig::LegacyTorClientConfig(LegacyTorClientConfig::BundledTor {\n                    allowed_ports,\n                    ..\n                }) =\u003e {\n                    *allowed_ports = Some(allowed_ports_slice.into());\n                }\n                _ =\u003e bail!(\"tor_provider_config does not support this operation\"),\n            },\n            None =\u003e bail_invalid_handle!(tor_provider_config),\n        }\n\n        Ok(())\n    })\n}\n/// Add a pluggable-transport config to a tor provider config. A tor provider config\n/// does not need to support pluggable-transport configuration, so this function may\n/// fail as a result. The currently supported tor provider configs are:\n/// - Legacy Bundled Client\n///\n/// This function may be called multiple times allowing a tor provider config to be\n/// configured with multiple pluggable-transports.\n///\n/// @param tor_provider_config: the tor provider config to update\n/// @param pluggable_transport_config: the pluggable-transport config to add to the tor\n///  provider config; must not be null\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_tor_provider_config_add_pluggable_transport_config(\n    tor_provider_config: *mut GoslingTorProviderConfig,\n    pluggable_transport_config: *const GoslingPluggableTransportConfig,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(tor_provider_config);\n        ensure_not_null!(pluggable_transport_config);\n\n        match get_tor_provider_config_registry().get_mut(tor_provider_config as usize) {\n            Some(tor_provider_config) =\u003e match tor_provider_config {\n                TorProviderConfig::LegacyTorClientConfig(LegacyTorClientConfig::BundledTor {\n                    pluggable_transports,\n                    ..\n                }) =\u003e {\n                    let pluggable_transport_config = match get_pluggable_transport_config_registry()\n                        .get(pluggable_transport_config as usize)\n                    {\n                        Some(pluggable_transport_config) =\u003e pluggable_transport_config.clone(),\n                        None =\u003e bail_invalid_handle!(pluggable_transport_config),\n                    };\n\n                    match pluggable_transports {\n                        None =\u003e *pluggable_transports = Some(vec![pluggable_transport_config]),\n                        Some(pluggable_transports) =\u003e {\n                            pluggable_transports.push(pluggable_transport_config)\n                        }\n                    }\n                }\n                _ =\u003e bail!(\"tor_provider_config does not support this operation\"),\n            },\n            None =\u003e bail_invalid_handle!(tor_provider_config),\n        }\n\n        Ok(())\n    })\n}\n\n/// Add a bridge line to a tor provider config. A tor provider config does not need\n/// to support bridge lines, so this function may fail as a result. The currently\n/// supported tor provider configs are:\n/// - Legacy Bundled Client\n///\n/// This function may be called multiple times allowing a tor provider config to be\n/// configured with multiple bridge lines.\n///\n/// @param tor_provider_config: the tor provider config to update\n/// @param bridge_line: the bridge lin to add to the tor provider config\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(feature = \"legacy-tor-provider\")]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_tor_provider_config_add_bridge_line(\n    tor_provider_config: *mut GoslingTorProviderConfig,\n    bridge_line: *const GoslingBridgeLine,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(tor_provider_config);\n        ensure_not_null!(bridge_line);\n\n        match get_tor_provider_config_registry().get_mut(tor_provider_config as usize) {\n            Some(tor_provider_config) =\u003e match tor_provider_config {\n                TorProviderConfig::LegacyTorClientConfig(LegacyTorClientConfig::BundledTor {\n                    bridge_lines,\n                    ..\n                }) =\u003e {\n                    let bridge_line = match get_bridge_line_registry().get(bridge_line as usize) {\n                        Some(bridge_line) =\u003e bridge_line.clone(),\n                        None =\u003e bail_invalid_handle!(bridge_line),\n                    };\n\n                    match bridge_lines {\n                        None =\u003e *bridge_lines = Some(vec![bridge_line]),\n                        Some(bridge_lines) =\u003e bridge_lines.push(bridge_line),\n                    }\n                }\n                _ =\u003e bail!(\"tor_provider_config does not support this operation\"),\n            },\n            None =\u003e bail_invalid_handle!(tor_provider_config),\n        }\n\n        Ok(())\n    })\n}\n\n/// Create a tor provider from the provided tor provider config.\n///\n/// @param out_tor_provider: returned tor provider\n/// @param tor_provider_config: tor provider configuration\n/// @param error: filled on error\n#[no_mangle]\n#[cfg(any(feature = \"mock-tor-provider\", feature = \"legacy-tor-provider\"))]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_tor_provider_from_tor_provider_config(\n    out_tor_provider: *mut *mut GoslingTorProvider,\n    tor_provider_config: *const GoslingTorProviderConfig,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_tor_provider);\n        ensure_not_null!(tor_provider_config);\n\n        let tor_provider: Box\u003cdyn tor_provider::TorProvider\u003e =\n            match get_tor_provider_config_registry().get(tor_provider_config as usize) {\n                Some(tor_provider_config) =\u003e match tor_provider_config {\n                    #[cfg(feature = \"mock-tor-provider\")]\n                    TorProviderConfig::MockTorClientConfig =\u003e {\n                        let tor_provider: MockTorClient = Default::default();\n                        Box::new(tor_provider)\n                    },\n                    #[cfg(feature = \"legacy-tor-provider\")]\n                    TorProviderConfig::LegacyTorClientConfig(legacy_tor_config) =\u003e {\n                        let tor_provider: LegacyTorClient =\n                            LegacyTorClient::new(legacy_tor_config.clone())?;\n                        Box::new(tor_provider)\n                    },\n                    _ =\u003e panic!(\"unknown tor_provider_config type\"),\n                },\n                None =\u003e bail_invalid_handle!(tor_provider_config),\n            };\n\n        let handle = get_tor_provider_registry().insert(tor_provider);\n        *out_tor_provider = handle as *mut GoslingTorProvider;\n\n        Ok(())\n    });\n}\n","traces":[{"line":74,"address":[2059008,2059043],"length":1,"stats":{"Line":0}},{"line":84,"address":[2831007,2830976],"length":1,"stats":{"Line":0}},{"line":96,"address":[2059459,2059424],"length":1,"stats":{"Line":0}},{"line":105,"address":[2831391,2831360],"length":1,"stats":{"Line":0}},{"line":116,"address":[2059869,2059840],"length":1,"stats":{"Line":0}},{"line":132,"address":[2831744,2831793],"length":1,"stats":{"Line":0}},{"line":137,"address":[2831786],"length":1,"stats":{"Line":0}},{"line":138,"address":[2386177],"length":1,"stats":{"Line":0}},{"line":139,"address":[1783858],"length":1,"stats":{"Line":0}},{"line":141,"address":[1783941,1784099],"length":1,"stats":{"Line":0}},{"line":142,"address":[2386665,2386557],"length":1,"stats":{"Line":0}},{"line":145,"address":[1784370,1784674,1785153],"length":1,"stats":{"Line":0}},{"line":147,"address":[2387025,2387157],"length":1,"stats":{"Line":0}},{"line":148,"address":[1785083,1785015],"length":1,"stats":{"Line":0}},{"line":150,"address":[1785051],"length":1,"stats":{"Line":0}},{"line":168,"address":[2831922,2831808],"length":1,"stats":{"Line":0}},{"line":177,"address":[2831855],"length":1,"stats":{"Line":0}},{"line":178,"address":[1785255],"length":1,"stats":{"Line":0}},{"line":179,"address":[1785278],"length":1,"stats":{"Line":0}},{"line":181,"address":[1785382,1785566],"length":1,"stats":{"Line":0}},{"line":182,"address":[1785675,1785781],"length":1,"stats":{"Line":0}},{"line":186,"address":[2388267,2388343],"length":1,"stats":{"Line":0}},{"line":187,"address":[1785899],"length":1,"stats":{"Line":0}},{"line":189,"address":[1785938],"length":1,"stats":{"Line":0}},{"line":190,"address":[1786249,1785999,1786103],"length":1,"stats":{"Line":0}},{"line":191,"address":[1786096,1786162],"length":1,"stats":{"Line":0}},{"line":194,"address":[1786226,1786329,1786371],"length":1,"stats":{"Line":0}},{"line":195,"address":[1786353],"length":1,"stats":{"Line":0}},{"line":197,"address":[1786384],"length":1,"stats":{"Line":0}},{"line":198,"address":[1786549,1786445,1786851],"length":1,"stats":{"Line":0}},{"line":199,"address":[1786542,1786611],"length":1,"stats":{"Line":0}},{"line":202,"address":[1787735,1787188,1786894,1786659],"length":1,"stats":{"Line":0}},{"line":204,"address":[1787172,1787300],"length":1,"stats":{"Line":0}},{"line":205,"address":[1787585,1787662],"length":1,"stats":{"Line":0}},{"line":207,"address":[1787619],"length":1,"stats":{"Line":0}},{"line":225,"address":[2832050,2831936],"length":1,"stats":{"Line":0}},{"line":234,"address":[1790339,1790459,1787856],"length":1,"stats":{"Line":0}},{"line":235,"address":[1787895],"length":1,"stats":{"Line":0}},{"line":236,"address":[2390383],"length":1,"stats":{"Line":0}},{"line":238,"address":[1788206,1788022],"length":1,"stats":{"Line":0}},{"line":239,"address":[1788315,1788421],"length":1,"stats":{"Line":0}},{"line":243,"address":[1788493,1788565],"length":1,"stats":{"Line":0}},{"line":244,"address":[1788539],"length":1,"stats":{"Line":0}},{"line":246,"address":[1788578],"length":1,"stats":{"Line":0}},{"line":247,"address":[1788743,1788889,1788639],"length":1,"stats":{"Line":0}},{"line":248,"address":[1788736,1788802],"length":1,"stats":{"Line":0}},{"line":251,"address":[1788866,1788969,1789011],"length":1,"stats":{"Line":0}},{"line":252,"address":[1788993],"length":1,"stats":{"Line":0}},{"line":254,"address":[1789024],"length":1,"stats":{"Line":0}},{"line":255,"address":[2391591,2392001,2391695],"length":1,"stats":{"Line":0}},{"line":256,"address":[2391688,2391761],"length":1,"stats":{"Line":0}},{"line":259,"address":[2392909,2391809,2392342,2392028],"length":1,"stats":{"Line":0}},{"line":261,"address":[1789812,1789940],"length":1,"stats":{"Line":0}},{"line":262,"address":[2392759,2392836],"length":1,"stats":{"Line":0}},{"line":264,"address":[2392793],"length":1,"stats":{"Line":0}},{"line":286,"address":[2832064,2832173],"length":1,"stats":{"Line":0}},{"line":294,"address":[2393040,2395359,2395504],"length":1,"stats":{"Line":0}},{"line":295,"address":[1790535],"length":1,"stats":{"Line":0}},{"line":296,"address":[1790558],"length":1,"stats":{"Line":0}},{"line":298,"address":[1790847],"length":1,"stats":{"Line":0}},{"line":301,"address":[1791073],"length":1,"stats":{"Line":0}},{"line":302,"address":[1791320,1791112],"length":1,"stats":{"Line":0}},{"line":303,"address":[1792997,1791195,1792944],"length":1,"stats":{"Line":0}},{"line":306,"address":[1791279,1791471],"length":1,"stats":{"Line":0}},{"line":307,"address":[1792863,1791487,1791593],"length":1,"stats":{"Line":0}},{"line":308,"address":[1791576,1791665],"length":1,"stats":{"Line":0}},{"line":309,"address":[2395450,2394279],"length":1,"stats":{"Line":0}},{"line":312,"address":[2395423,2395395,2394483,2394899],"length":1,"stats":{"Line":0}},{"line":313,"address":[1792441,1792297],"length":1,"stats":{"Line":0}},{"line":314,"address":[1792736,1792664],"length":1,"stats":{"Line":0}},{"line":316,"address":[1792698],"length":1,"stats":{"Line":0}},{"line":330,"address":[2832192,2832271],"length":1,"stats":{"Line":0}},{"line":336,"address":[1793867,1793024],"length":1,"stats":{"Line":0}},{"line":337,"address":[1793036],"length":1,"stats":{"Line":0}},{"line":338,"address":[1793056],"length":1,"stats":{"Line":0}},{"line":341,"address":[1793285],"length":1,"stats":{"Line":0}},{"line":342,"address":[1793324,1793465,1793380],"length":1,"stats":{"Line":0}},{"line":344,"address":[1793419,1793606],"length":1,"stats":{"Line":0}},{"line":346,"address":[1793821,1793718],"length":1,"stats":{"Line":0}},{"line":350,"address":[1793853],"length":1,"stats":{"Line":0}},{"line":369,"address":[2060592,2060671],"length":1,"stats":{"Line":0}},{"line":375,"address":[2397834,2396512],"length":1,"stats":{"Line":0}},{"line":376,"address":[1793924],"length":1,"stats":{"Line":0}},{"line":377,"address":[1793944],"length":1,"stats":{"Line":0}},{"line":380,"address":[1794173],"length":1,"stats":{"Line":0}},{"line":381,"address":[1794268,1794372,1794212],"length":1,"stats":{"Line":0}},{"line":382,"address":[1794714,1794297,1794463],"length":1,"stats":{"Line":0}},{"line":384,"address":[1794866,1794695],"length":1,"stats":{"Line":0}},{"line":385,"address":[1795118,1795179],"length":1,"stats":{"Line":0}},{"line":387,"address":[1795152],"length":1,"stats":{"Line":0}},{"line":402,"address":[2832421,2832384],"length":1,"stats":{"Line":1}},{"line":406,"address":[2398201,2397888],"length":1,"stats":{"Line":2}},{"line":407,"address":[1795260],"length":1,"stats":{"Line":1}},{"line":410,"address":[1795277,1795380],"length":1,"stats":{"Line":1}},{"line":411,"address":[2398118,2398167],"length":1,"stats":{"Line":1}},{"line":413,"address":[2398152],"length":1,"stats":{"Line":1}},{"line":430,"address":[2060752,2060861],"length":1,"stats":{"Line":1}},{"line":438,"address":[2060804],"length":1,"stats":{"Line":2}},{"line":439,"address":[1795612],"length":1,"stats":{"Line":1}},{"line":440,"address":[1795760,1795632],"length":1,"stats":{"Line":2}},{"line":441,"address":[2398415],"length":1,"stats":{"Line":0}},{"line":443,"address":[1795737,1795827],"length":1,"stats":{"Line":1}},{"line":444,"address":[2398506],"length":1,"stats":{"Line":0}},{"line":446,"address":[2398487],"length":1,"stats":{"Line":1}},{"line":450,"address":[2399538,2399739,2398762],"length":1,"stats":{"Line":2}},{"line":451,"address":[2399744,2399116,2399635,2398986],"length":1,"stats":{"Line":3}},{"line":454,"address":[2398784],"length":1,"stats":{"Line":0}},{"line":455,"address":[2398823,2399204,2399336],"length":1,"stats":{"Line":0}},{"line":456,"address":[1796583],"length":1,"stats":{"Line":0}},{"line":457,"address":[1796607,1796779,1796885],"length":1,"stats":{"Line":0}},{"line":461,"address":[2399598,2399838],"length":1,"stats":{"Line":2}},{"line":462,"address":[2399592,2399584],"length":1,"stats":{"Line":2}},{"line":463,"address":[2399588,2399595],"length":1,"stats":{"Line":2}},{"line":465,"address":[1797303,1798183,1797197],"length":1,"stats":{"Line":1}},{"line":466,"address":[1797375,1797286],"length":1,"stats":{"Line":2}},{"line":467,"address":[1797480],"length":1,"stats":{"Line":1}},{"line":468,"address":[1797394],"length":1,"stats":{"Line":1}},{"line":470,"address":[2400099],"length":1,"stats":{"Line":1}},{"line":471,"address":[1797456],"length":1,"stats":{"Line":1}},{"line":472,"address":[1797464],"length":1,"stats":{"Line":1}},{"line":473,"address":[1797472],"length":1,"stats":{"Line":1}},{"line":476,"address":[2400441,2400682,2400507],"length":1,"stats":{"Line":3}},{"line":477,"address":[2400548,2400707],"length":1,"stats":{"Line":1}},{"line":478,"address":[2400803,2400731],"length":1,"stats":{"Line":1}},{"line":480,"address":[2400765],"length":1,"stats":{"Line":1}},{"line":498,"address":[2832576,2832705],"length":1,"stats":{"Line":0}},{"line":508,"address":[2832628],"length":1,"stats":{"Line":0}},{"line":509,"address":[1798276],"length":1,"stats":{"Line":0}},{"line":510,"address":[2400969],"length":1,"stats":{"Line":0}},{"line":512,"address":[1798579],"length":1,"stats":{"Line":0}},{"line":514,"address":[1798799],"length":1,"stats":{"Line":0}},{"line":518,"address":[2401790,2401689],"length":1,"stats":{"Line":0}},{"line":519,"address":[1799195],"length":1,"stats":{"Line":0}},{"line":522,"address":[2402022],"length":1,"stats":{"Line":0}},{"line":525,"address":[2402181,2402080],"length":1,"stats":{"Line":0}},{"line":526,"address":[1799565],"length":1,"stats":{"Line":0}},{"line":529,"address":[1799681],"length":1,"stats":{"Line":0}},{"line":533,"address":[1799763],"length":1,"stats":{"Line":0}},{"line":534,"address":[1800033,1799802],"length":1,"stats":{"Line":0}},{"line":536,"address":[1799898],"length":1,"stats":{"Line":0}},{"line":542,"address":[2403085,2402743,2402910],"length":1,"stats":{"Line":0}},{"line":543,"address":[2402951,2403110],"length":1,"stats":{"Line":0}},{"line":544,"address":[2403134,2403195],"length":1,"stats":{"Line":0}},{"line":546,"address":[1800424],"length":1,"stats":{"Line":0}},{"line":565,"address":[2832769,2832720],"length":1,"stats":{"Line":0}},{"line":570,"address":[1800528,1801733,1801783],"length":1,"stats":{"Line":0}},{"line":571,"address":[1800545],"length":1,"stats":{"Line":0}},{"line":572,"address":[1800562],"length":1,"stats":{"Line":0}},{"line":574,"address":[2403553,2403385],"length":1,"stats":{"Line":0}},{"line":575,"address":[1800907,1801020],"length":1,"stats":{"Line":0}},{"line":577,"address":[2403834],"length":1,"stats":{"Line":0}},{"line":580,"address":[2403842,2404301,2404367,2403957],"length":1,"stats":{"Line":0}},{"line":581,"address":[1801294,1801394],"length":1,"stats":{"Line":0}},{"line":585,"address":[1801750,1801041],"length":1,"stats":{"Line":0}},{"line":590,"address":[1801711],"length":1,"stats":{"Line":0}},{"line":608,"address":[2061167,2061088],"length":1,"stats":{"Line":0}},{"line":614,"address":[1801808,1802785],"length":1,"stats":{"Line":0}},{"line":615,"address":[2404604],"length":1,"stats":{"Line":0}},{"line":616,"address":[2404625],"length":1,"stats":{"Line":0}},{"line":620,"address":[2404870],"length":1,"stats":{"Line":0}},{"line":621,"address":[1802239,1802133],"length":1,"stats":{"Line":0}},{"line":622,"address":[2405145,2405263],"length":1,"stats":{"Line":0}},{"line":624,"address":[1802519],"length":1,"stats":{"Line":0}},{"line":627,"address":[2405347],"length":1,"stats":{"Line":0}},{"line":629,"address":[1802475,1802750],"length":1,"stats":{"Line":0}},{"line":634,"address":[1802728],"length":1,"stats":{"Line":0}},{"line":652,"address":[2832929,2832880],"length":1,"stats":{"Line":0}},{"line":657,"address":[2407216,2407266,2405632],"length":1,"stats":{"Line":0}},{"line":658,"address":[1802841],"length":1,"stats":{"Line":0}},{"line":659,"address":[2405675],"length":1,"stats":{"Line":0}},{"line":661,"address":[1803114,1802947],"length":1,"stats":{"Line":0}},{"line":662,"address":[2406052,2406170],"length":1,"stats":{"Line":0}},{"line":664,"address":[2406225],"length":1,"stats":{"Line":0}},{"line":667,"address":[1803405,1803520],"length":1,"stats":{"Line":0}},{"line":668,"address":[2406359],"length":1,"stats":{"Line":0}},{"line":670,"address":[1803721,1803616],"length":1,"stats":{"Line":0}},{"line":674,"address":[2406653],"length":1,"stats":{"Line":0}},{"line":675,"address":[1803830,1803961],"length":1,"stats":{"Line":0}},{"line":676,"address":[2406710],"length":1,"stats":{"Line":0}},{"line":677,"address":[1803855,1804307],"length":1,"stats":{"Line":0}},{"line":681,"address":[1803352,1804361],"length":1,"stats":{"Line":0}},{"line":686,"address":[1804296],"length":1,"stats":{"Line":0}},{"line":704,"address":[2832944,2832993],"length":1,"stats":{"Line":0}},{"line":709,"address":[2832986],"length":1,"stats":{"Line":0}},{"line":710,"address":[1804441],"length":1,"stats":{"Line":0}},{"line":711,"address":[1804458],"length":1,"stats":{"Line":0}},{"line":713,"address":[1804547,1804714],"length":1,"stats":{"Line":0}},{"line":714,"address":[1804818,1804931],"length":1,"stats":{"Line":0}},{"line":716,"address":[1804986],"length":1,"stats":{"Line":0}},{"line":719,"address":[1805005,1805112],"length":1,"stats":{"Line":0}},{"line":720,"address":[2408228,2408115],"length":1,"stats":{"Line":0}},{"line":724,"address":[2408301],"length":1,"stats":{"Line":0}},{"line":725,"address":[1805430,1805596],"length":1,"stats":{"Line":0}},{"line":726,"address":[1805450,1805966],"length":1,"stats":{"Line":0}},{"line":729,"address":[1804952,1806020],"length":1,"stats":{"Line":0}},{"line":734,"address":[1805955],"length":1,"stats":{"Line":0}},{"line":746,"address":[2833008,2833057],"length":1,"stats":{"Line":1}},{"line":751,"address":[2833050],"length":1,"stats":{"Line":2}},{"line":752,"address":[1806119],"length":1,"stats":{"Line":1}},{"line":753,"address":[1806139],"length":1,"stats":{"Line":1}},{"line":756,"address":[1806918,1806247,1806458],"length":1,"stats":{"Line":3}},{"line":757,"address":[1806571,1806902],"length":1,"stats":{"Line":2}},{"line":760,"address":[2409628],"length":1,"stats":{"Line":1}},{"line":761,"address":[1806879],"length":1,"stats":{"Line":1}},{"line":764,"address":[1806720],"length":1,"stats":{"Line":1}},{"line":766,"address":[1806960,1806736,1807852,1807292],"length":1,"stats":{"Line":2}},{"line":767,"address":[1807147,1807436],"length":1,"stats":{"Line":2}},{"line":774,"address":[1807513],"length":1,"stats":{"Line":1}},{"line":775,"address":[1807681,1807747],"length":1,"stats":{"Line":1}},{"line":777,"address":[1807720],"length":1,"stats":{"Line":1}}],"covered":43,"coverable":210},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","src","utils.rs"],"content":"// standard\nuse std::convert::TryFrom;\nuse std::net::{IpAddr, Ipv4Addr, Ipv6Addr, SocketAddr, TcpStream};\nuse std::os::raw::c_char;\n#[cfg(unix)]\nuse std::os::unix::io::IntoRawFd;\n#[cfg(windows)]\nuse std::os::windows::io::IntoRawSocket;\nuse std::str::FromStr;\n\n// extern\nuse anyhow::bail;\n#[cfg(feature = \"impl-lib\")]\nuse cgosling_proc_macros::*;\nuse tor_interface::tor_provider::{CircuitToken, DomainAddr, OnionAddr, OnionAddrV3, TargetAddr};\n\n// internal\nuse crate::context::*;\nuse crate::crypto::*;\nuse crate::error::*;\nuse crate::ffi::*;\nuse crate::macros::*;\n\n/// The maximum number of bytes needed to store a target address\n/// in the format domainname:port (including null-terminator)\n/// Maximum length of a human-readbale domain name is 253 bytes (per RFC 1035)\n/// see: https://stackoverflow.com/a/32294443\n/// Maximum length of the :port section is 6 bytes\n/// null-terminator is 1 byte\npub const TARGET_ADDRESS_STRING_SIZE: usize = 260;\n\n/// An internet socket address, either IPv4 or IPv6\npub struct GoslingIpAddress;\ndefine_registry! {IpAddr}\n\n/// An endpoint to connect to over tor\npub struct GoslingTargetAddress;\ndefine_registry! {TargetAddr}\n\n/// A stream isolation token\npub type GoslingCircuitToken = usize;\n\n//\n// Free Functions\n//\n\n/// Frees a gosling_ip_address object\n///\n/// @param in_ip_address: the ip address to free\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_ip_address_free(in_ip_address: *mut GoslingIpAddress) {\n    impl_registry_free!(in_ip_address, IpAddr);\n}\n\n/// Frees a gosling_target_address object\n///\n/// @param in_target_address: the target address to free\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_target_address_free(in_target_address: *mut GoslingTargetAddress) {\n    impl_registry_free!(in_target_address, TargetAddr);\n}\n\n//\n// Clone Functions\n//\n\n/// Copy method for gosling_ip_address\n///\n/// @param out_ip_address: returned copy\n/// @param ip_address: original to copy\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_ip_address_clone(\n    out_ip_address: *mut *mut GoslingIpAddress,\n    ip_address: *const GoslingIpAddress,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_ip_address);\n        ensure_not_null!(ip_address);\n\n        let ip_address = match get_ip_addr_registry().get(ip_address as usize) {\n            Some(ip_address) =\u003e ip_address.clone(),\n            None =\u003e bail_invalid_handle!(ip_address),\n        };\n        let handle = get_ip_addr_registry().insert(ip_address);\n        *out_ip_address = handle as *mut GoslingIpAddress;\n\n        Ok(())\n    })\n}\n\n/// Copy method for gosling_target_address\n///\n/// @param out_target_address: returned copy\n/// @param target_address: original to copy\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_target_address_clone(\n    out_target_address: *mut *mut GoslingTargetAddress,\n    target_address: *const GoslingTargetAddress,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_target_address);\n        ensure_not_null!(target_address);\n\n        let target_address = match get_target_addr_registry().get(target_address as usize) {\n            Some(target_address) =\u003e target_address.clone(),\n            None =\u003e bail_invalid_handle!(target_address),\n        };\n        let handle = get_target_addr_registry().insert(target_address);\n        *out_target_address = handle as *mut GoslingTargetAddress;\n\n        Ok(())\n    })\n}\n\n//\n// Connect Method\n//\n\n/// Connect to a target address using the provided gosling context's tor provider.\n///\n/// @param context: the context to use to connect with\n/// @param out_tcp_socket: returned connected tcp socket\n/// @param target_address: the destination address to connect to\n/// @param circuit_token: the circuit isolation token\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub extern \"C\" fn gosling_context_connect(\n    context: *mut GoslingContext,\n    out_tcp_socket: *mut GoslingTcpSocket,\n    target_address: *const GoslingTargetAddress,\n    circuit_token: GoslingCircuitToken,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(context);\n        ensure_not_null!(out_tcp_socket);\n        ensure_not_null!(target_address);\n\n        let mut context_tuple_registry = get_context_tuple_registry();\n        let context = match context_tuple_registry.get_mut(context as usize) {\n            Some(context) =\u003e context,\n            None =\u003e bail_invalid_handle!(context),\n        };\n\n        let target_address = match get_target_addr_registry().get(target_address as usize) {\n            Some(target_address) =\u003e target_address.clone(),\n            None =\u003e bail_invalid_handle!(target_address),\n        };\n\n        let onion_stream = context.0.connect(target_address, Some(circuit_token))?;\n        let tcp_stream: TcpStream = onion_stream.into();\n\n        #[cfg(any(target_os = \"linux\", target_os = \"macos\"))]\n        let tcp_socket = tcp_stream.into_raw_fd();\n        #[cfg(target_os = \"windows\")]\n        let tcp_socket = tcp_stream.into_raw_socket();\n\n        unsafe {\n            *out_tcp_socket = tcp_socket;\n        }\n        Ok(())\n    })\n}\n\n//\n// Ip Address Methods\n//\n\n/// Create ip address from four ipv4 octets.\n///\n/// @param out_ip_address: returned ip address\n/// @param a: first octet\n/// @param b: second octet\n/// @param c: third octet\n/// @param d: fourth octet\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_ip_address_from_ipv4(\n    out_ip_address: *mut *mut GoslingIpAddress,\n    a: u8,\n    b: u8,\n    c: u8,\n    d: u8,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_ip_address);\n\n        let ip_addr = Ipv4Addr::new(a, b, c, d);\n        let handle = get_ip_addr_registry().insert(ip_addr.into());\n        *out_ip_address = handle as *mut GoslingIpAddress;\n\n        Ok(())\n    })\n}\n\n/// Create target address from eight ipv6 16-bit sgements\n///\n/// @param out_ip_address: returned ip address\n/// @param a: first segment\n/// @param b: second segment\n/// @param c: third segment\n/// @param d: fourth segment\n/// @param e: fifth segment\n/// @param f: sixth segment\n/// @param g: seventh segment\n/// @param h: eigth segment\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_ip_address_from_ipv6(\n    out_ip_address: *mut *mut GoslingIpAddress,\n    a: u16,\n    b: u16,\n    c: u16,\n    d: u16,\n    e: u16,\n    f: u16,\n    g: u16,\n    h: u16,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_ip_address);\n        let ip_addr = Ipv6Addr::new(a, b, c, d, e, f, g, h);\n        let handle = get_ip_addr_registry().insert(ip_addr.into());\n        *out_ip_address = handle as *mut GoslingIpAddress;\n\n        Ok(())\n    })\n}\n\n//\n// Target Address Methods\n//\n\n/// Create target address from an ip address and a port.\n///\n/// @param out_target_address: returned target address\n/// @param ip_address: target ip address\n/// @param port: target port\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_target_address_from_ip_address(\n    out_target_address: *mut *mut GoslingTargetAddress,\n    ip_address: *const GoslingIpAddress,\n    port: u16,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_target_address);\n        ensure_not_null!(ip_address);\n\n        let ip_address = match get_ip_addr_registry().get(ip_address as usize) {\n            Some(ip_address) =\u003e ip_address.clone(),\n            None =\u003e bail_invalid_handle!(ip_address),\n        };\n\n        let target_address = TargetAddr::Socket(SocketAddr::new(ip_address, port));\n\n        let handle = get_target_addr_registry().insert(target_address);\n        *out_target_address = handle as *mut GoslingTargetAddress;\n\n        Ok(())\n    })\n}\n\n/// Create target address from domain and port.\n/// The resulting target address is in the format domain:port\n///\n/// @param out_target_address: returned target address\n/// @param domain: the target domain\n/// @param domain_length: the number of chars in domain not including any null-terminator\n/// @param port: the target port\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_target_address_from_domain(\n    out_target_address: *mut *mut GoslingTargetAddress,\n    domain: *const c_char,\n    domain_length: usize,\n    port: u16,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_target_address);\n        ensure_not_null!(domain);\n        if domain_length == 0 {\n            bail!(\"domain_length must be greater than 0\");\n        }\n\n        let domain_view = std::slice::from_raw_parts(domain as *const u8, domain_length);\n        let domain_str = std::str::from_utf8(domain_view)?;\n\n        let target_address =\n            TargetAddr::Domain(DomainAddr::try_from((domain_str.to_string(), port))?);\n        let handle = get_target_addr_registry().insert(target_address);\n        *out_target_address = handle as *mut GoslingTargetAddress;\n\n        Ok(())\n    })\n}\n\n/// Create target address from onion service id and port.\n///\n/// @param out_target_address: returned target address\n/// @param service_id: the target onion service id\n/// @param port: the target port\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_target_address_from_v3_onion_service_id(\n    out_target_address: *mut *mut GoslingTargetAddress,\n    service_id: *const GoslingV3OnionServiceId,\n    port: u16,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_target_address);\n        ensure_not_null!(service_id);\n\n        let service_id = match get_v3_onion_service_id_registry().get(service_id as usize) {\n            Some(service_id) =\u003e service_id.clone(),\n            None =\u003e bail_invalid_handle!(service_id),\n        };\n\n        let target_address =\n            TargetAddr::OnionService(OnionAddr::V3(OnionAddrV3::new(service_id, port)));\n        let handle = get_target_addr_registry().insert(target_address);\n        *out_target_address = handle as *mut GoslingTargetAddress;\n\n        Ok(())\n    })\n}\n\n/// Create target address from some string representation\n///\n/// @param out_target_address: returned target address\n/// @param target_address: serialised target address\n/// @param target_address_length: the number of chars in string not including any null-terminator\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_target_address_from_string(\n    out_target_address: *mut *mut GoslingTargetAddress,\n    target_address: *const c_char,\n    target_address_length: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(out_target_address);\n        ensure_not_null!(target_address);\n        if target_address_length == 0 {\n            bail!(\"target_address_length must be greater than 0\");\n        }\n\n        let target_address_view =\n            std::slice::from_raw_parts(target_address as *const u8, target_address_length);\n        let target_address_str = std::str::from_utf8(target_address_view)?;\n\n        let target_address = TargetAddr::from_str(target_address_str)?;\n        let handle = get_target_addr_registry().insert(target_address);\n        *out_target_address = handle as *mut GoslingTargetAddress;\n\n        Ok(())\n    })\n}\n\n/// Write target address to null-terminated string\n///\n/// @param target_address: the target address to write\n/// @param out_target_address_string: buffer to be filled with string\n/// @param target_address_string_size: size of the out_string buffer in bytes. The maximum\n///  required size is 262 bytes.\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_target_address_to_string(\n    target_address: *const GoslingTargetAddress,\n    out_target_address_string: *mut c_char,\n    target_address_string_size: usize,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(target_address);\n        ensure_not_null!(out_target_address_string);\n\n        let target_address_string = match get_target_addr_registry().get(target_address as usize) {\n            Some(target_address) =\u003e target_address.to_string(),\n            None =\u003e bail_invalid_handle!(target_address),\n        };\n\n        let target_address_string_len = target_address_string.len();\n        if target_address_string_len \u003e= target_address_string_size {\n            bail!(\n                \"string_size must be at least '{}', received '{}'\",\n                target_address_string_len,\n                target_address_string_size\n            );\n        }\n\n        unsafe {\n            // copy target_address_string into output buffer\n            let target_address_string_view = std::slice::from_raw_parts_mut(\n                out_target_address_string as *mut u8,\n                target_address_string_size,\n            );\n            std::ptr::copy(\n                target_address_string.as_ptr(),\n                target_address_string_view.as_mut_ptr(),\n                target_address_string_len,\n            );\n            // add final null-terminator\n            target_address_string_view[target_address_string_len] = 0u8;\n        }\n\n        Ok(())\n    })\n}\n\n//\n// Circuit Token Methods\n//\n\n/// Generate a circuit token to isolate connect calls\n///\n/// @param context: the context to use to connect with\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_context_generate_circuit_token(\n    context: *mut GoslingContext,\n    error: *mut *mut GoslingError,\n) -\u003e GoslingCircuitToken {\n    translate_failures(!0usize, error, || -\u003e anyhow::Result\u003cCircuitToken\u003e {\n        ensure_not_null!(context);\n\n        let mut context_tuple_registry = get_context_tuple_registry();\n        let token = match context_tuple_registry.get_mut(context as usize) {\n            Some(context) =\u003e context.0.generate_circuit_token(),\n            None =\u003e bail_invalid_handle!(context),\n        };\n        Ok(token)\n    })\n}\n\n/// Release a context's circuit token.\n///\n/// @param context: the context to use to connect with\n/// @param circuit_token: circuit token to destroy\n/// @param error: filled on error\n#[no_mangle]\n#[cfg_attr(feature = \"impl-lib\", rename_impl)]\npub unsafe extern \"C\" fn gosling_context_release_circuit_token(\n    context: *mut GoslingContext,\n    circuit_token: GoslingCircuitToken,\n    error: *mut *mut GoslingError,\n) {\n    translate_failures((), error, || -\u003e anyhow::Result\u003c()\u003e {\n        ensure_not_null!(context);\n\n        let mut context_tuple_registry = get_context_tuple_registry();\n        match context_tuple_registry.get_mut(context as usize) {\n            Some(context) =\u003e context.0.release_circuit_token(circuit_token),\n            None =\u003e bail_invalid_handle!(context),\n        };\n        Ok(())\n    })\n}\n","traces":[{"line":52,"address":[2055920,2055949],"length":1,"stats":{"Line":0}},{"line":61,"address":[2842287,2842256],"length":1,"stats":{"Line":0}},{"line":76,"address":[2842448,2842497],"length":1,"stats":{"Line":0}},{"line":81,"address":[2949283,2948560],"length":1,"stats":{"Line":0}},{"line":82,"address":[2317905],"length":1,"stats":{"Line":0}},{"line":83,"address":[2948594],"length":1,"stats":{"Line":0}},{"line":85,"address":[2318009,2318171],"length":1,"stats":{"Line":0}},{"line":86,"address":[2948933],"length":1,"stats":{"Line":0}},{"line":89,"address":[2949046],"length":1,"stats":{"Line":0}},{"line":90,"address":[2949262,2949207],"length":1,"stats":{"Line":0}},{"line":92,"address":[2949243],"length":1,"stats":{"Line":0}},{"line":103,"address":[2842561,2842512],"length":1,"stats":{"Line":0}},{"line":108,"address":[2318672,2319566],"length":1,"stats":{"Line":0}},{"line":109,"address":[2949337],"length":1,"stats":{"Line":0}},{"line":110,"address":[2949354],"length":1,"stats":{"Line":0}},{"line":112,"address":[2318801,2318963],"length":1,"stats":{"Line":0}},{"line":113,"address":[2319184,2319071],"length":1,"stats":{"Line":0}},{"line":116,"address":[2319252],"length":1,"stats":{"Line":0}},{"line":117,"address":[2950146,2950086],"length":1,"stats":{"Line":0}},{"line":119,"address":[2950120],"length":1,"stats":{"Line":0}},{"line":136,"address":[2056526,2056432],"length":1,"stats":{"Line":0}},{"line":143,"address":[2950208,2952192,2952246],"length":1,"stats":{"Line":0}},{"line":144,"address":[2950236],"length":1,"stats":{"Line":0}},{"line":145,"address":[2950256],"length":1,"stats":{"Line":0}},{"line":146,"address":[2950358],"length":1,"stats":{"Line":0}},{"line":148,"address":[2319874],"length":1,"stats":{"Line":0}},{"line":149,"address":[2950627,2950486],"length":1,"stats":{"Line":0}},{"line":150,"address":[2950729],"length":1,"stats":{"Line":0}},{"line":154,"address":[2950839,2950926,2950750],"length":1,"stats":{"Line":0}},{"line":155,"address":[2951029,2951134],"length":1,"stats":{"Line":0}},{"line":159,"address":[2951208,2952206,2951821],"length":1,"stats":{"Line":0}},{"line":160,"address":[2951652,2952024],"length":1,"stats":{"Line":0}},{"line":163,"address":[2952031],"length":1,"stats":{"Line":0}},{"line":168,"address":[2952058,2952136],"length":1,"stats":{"Line":0}},{"line":170,"address":[2952091],"length":1,"stats":{"Line":0}},{"line":188,"address":[2842795,2842688],"length":1,"stats":{"Line":0}},{"line":196,"address":[2842738],"length":1,"stats":{"Line":0}},{"line":197,"address":[2952284],"length":1,"stats":{"Line":0}},{"line":199,"address":[2952304],"length":1,"stats":{"Line":0}},{"line":200,"address":[2952349,2952452],"length":1,"stats":{"Line":0}},{"line":201,"address":[2952629,2952579],"length":1,"stats":{"Line":0}},{"line":203,"address":[2952613],"length":1,"stats":{"Line":0}},{"line":221,"address":[2842816,2843039],"length":1,"stats":{"Line":0}},{"line":233,"address":[2056789],"length":1,"stats":{"Line":0}},{"line":234,"address":[2952700],"length":1,"stats":{"Line":0}},{"line":235,"address":[2952720],"length":1,"stats":{"Line":0}},{"line":236,"address":[2952803,2952906],"length":1,"stats":{"Line":0}},{"line":237,"address":[2953028,2953078],"length":1,"stats":{"Line":0}},{"line":239,"address":[2953062],"length":1,"stats":{"Line":0}},{"line":255,"address":[2843056,2843138],"length":1,"stats":{"Line":0}},{"line":261,"address":[2056957],"length":1,"stats":{"Line":0}},{"line":262,"address":[2953156],"length":1,"stats":{"Line":0}},{"line":263,"address":[2953176],"length":1,"stats":{"Line":0}},{"line":265,"address":[2322766,2322933],"length":1,"stats":{"Line":0}},{"line":266,"address":[2953518],"length":1,"stats":{"Line":0}},{"line":270,"address":[2953636],"length":1,"stats":{"Line":0}},{"line":272,"address":[2323272,2323338],"length":1,"stats":{"Line":0}},{"line":273,"address":[2954069,2954011],"length":1,"stats":{"Line":0}},{"line":275,"address":[2954043],"length":1,"stats":{"Line":0}},{"line":289,"address":[2843248,2843152],"length":1,"stats":{"Line":0}},{"line":296,"address":[2324821,2323680],"length":1,"stats":{"Line":0}},{"line":297,"address":[2954164],"length":1,"stats":{"Line":0}},{"line":298,"address":[2954184],"length":1,"stats":{"Line":0}},{"line":299,"address":[2954271],"length":1,"stats":{"Line":0}},{"line":300,"address":[2954347],"length":1,"stats":{"Line":0}},{"line":303,"address":[2323937],"length":1,"stats":{"Line":0}},{"line":304,"address":[2954434,2954499,2954671],"length":1,"stats":{"Line":0}},{"line":307,"address":[2954863,2954531,2954765],"length":1,"stats":{"Line":0}},{"line":308,"address":[2954981,2954847],"length":1,"stats":{"Line":0}},{"line":309,"address":[2955243,2955185],"length":1,"stats":{"Line":0}},{"line":311,"address":[2955217],"length":1,"stats":{"Line":0}},{"line":323,"address":[2843346,2843264],"length":1,"stats":{"Line":0}},{"line":329,"address":[2955312,2956336],"length":1,"stats":{"Line":0}},{"line":330,"address":[2955332],"length":1,"stats":{"Line":0}},{"line":331,"address":[2955352],"length":1,"stats":{"Line":0}},{"line":333,"address":[2955434,2955591],"length":1,"stats":{"Line":0}},{"line":334,"address":[2325264],"length":1,"stats":{"Line":0}},{"line":339,"address":[2955812],"length":1,"stats":{"Line":0}},{"line":340,"address":[2955987,2956053],"length":1,"stats":{"Line":0}},{"line":341,"address":[2956257,2956315],"length":1,"stats":{"Line":0}},{"line":343,"address":[2325880],"length":1,"stats":{"Line":0}},{"line":355,"address":[2057216,2057295],"length":1,"stats":{"Line":0}},{"line":361,"address":[2327089,2325968],"length":1,"stats":{"Line":0}},{"line":362,"address":[2325988],"length":1,"stats":{"Line":0}},{"line":363,"address":[2326009],"length":1,"stats":{"Line":0}},{"line":364,"address":[2956511],"length":1,"stats":{"Line":0}},{"line":365,"address":[2956587],"length":1,"stats":{"Line":0}},{"line":369,"address":[2956635],"length":1,"stats":{"Line":0}},{"line":370,"address":[2956736,2956834,2956674],"length":1,"stats":{"Line":0}},{"line":372,"address":[2326672,2326358,2326520],"length":1,"stats":{"Line":0}},{"line":373,"address":[2326791,2326656],"length":1,"stats":{"Line":0}},{"line":374,"address":[2327068,2327007],"length":1,"stats":{"Line":0}},{"line":376,"address":[2327041],"length":1,"stats":{"Line":0}},{"line":389,"address":[2057391,2057312],"length":1,"stats":{"Line":0}},{"line":395,"address":[2957536,2958884],"length":1,"stats":{"Line":0}},{"line":396,"address":[2957548],"length":1,"stats":{"Line":0}},{"line":397,"address":[2327169],"length":1,"stats":{"Line":0}},{"line":399,"address":[2327260,2327442],"length":1,"stats":{"Line":0}},{"line":400,"address":[2957930],"length":1,"stats":{"Line":0}},{"line":404,"address":[2958104],"length":1,"stats":{"Line":0}},{"line":405,"address":[2958134],"length":1,"stats":{"Line":0}},{"line":406,"address":[2958694,2958604,2958831],"length":1,"stats":{"Line":0}},{"line":415,"address":[2958316,2958170],"length":1,"stats":{"Line":0}},{"line":416,"address":[2958156,2958164],"length":1,"stats":{"Line":0}},{"line":417,"address":[2958167,2958160],"length":1,"stats":{"Line":0}},{"line":419,"address":[2958435],"length":1,"stats":{"Line":0}},{"line":420,"address":[2327983],"length":1,"stats":{"Line":0}},{"line":425,"address":[2328138,2328198],"length":1,"stats":{"Line":0}},{"line":428,"address":[2958538],"length":1,"stats":{"Line":0}},{"line":442,"address":[2843552,2843589],"length":1,"stats":{"Line":0}},{"line":446,"address":[2959321,2958912],"length":1,"stats":{"Line":0}},{"line":447,"address":[2328556],"length":1,"stats":{"Line":0}},{"line":449,"address":[2328574],"length":1,"stats":{"Line":0}},{"line":450,"address":[2958963,2959087],"length":1,"stats":{"Line":0}},{"line":451,"address":[2959176,2959287],"length":1,"stats":{"Line":0}},{"line":454,"address":[2959295],"length":1,"stats":{"Line":0}},{"line":465,"address":[2057472,2057521],"length":1,"stats":{"Line":0}},{"line":470,"address":[2329008,2329402],"length":1,"stats":{"Line":0}},{"line":471,"address":[2959361],"length":1,"stats":{"Line":0}},{"line":473,"address":[2959378],"length":1,"stats":{"Line":0}},{"line":474,"address":[2959512,2959400],"length":1,"stats":{"Line":0}},{"line":475,"address":[2959601],"length":1,"stats":{"Line":0}},{"line":478,"address":[2959696],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":123},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling","tests","ffi.rs"],"content":"// standard\nuse std::ffi::{CStr, CString};\nuse std::io::{BufRead, BufReader, Write};\nuse std::net::TcpStream;\nuse std::os::raw::c_char;\n#[cfg(unix)]\nuse std::os::unix::io::{FromRawFd, RawFd};\n#[cfg(windows)]\nuse std::os::windows::io::{FromRawSocket, RawSocket};\nuse std::ptr;\nuse std::sync::atomic::{AtomicBool, Ordering};\n\n// external crates\nuse anyhow::bail;\n#[cfg(test)]\nuse serial_test::serial;\n\n// internal crates\nuse cgosling::callbacks::*;\nuse cgosling::context::*;\nuse cgosling::crypto::*;\nuse cgosling::error::*;\nuse cgosling::ffi::*;\nuse cgosling::tor_provider::*;\n\nmacro_rules! require_noerror {\n    ($func:ident($($arg:tt)*)) =\u003e {\n        // println!(\"--- {}{}\", stringify!($func), stringify!(($($arg)*)));\n        unsafe {\n            let mut error: *mut GoslingError = ptr::null_mut();\n            $func($($arg)*, \u0026mut error);\n            if !error.is_null() {\n                let msg = gosling_error_get_message(error);\n                let msg = format!(\"{:?}\", CStr::from_ptr(msg));\n                gosling_error_free(error);\n                anyhow::bail!(msg);\n            }\n        }\n    }\n}\n\n// simple bson document: { msg : \"hello world\" }\nconst CHALLENGE_BSON: [u8; 26] = [\n    0x1a, 0x00, 0x00, 0x00, // document length 26 == 0x0000001a\n    0x02, b'm', b's', b'g', 0x00, // string msg\n    0x0c, 0x00, 0x00, 0x00, // strlen(\"hello world\\x00\") 12 = 0x0000000c\n    b'h', b'e', b'l', b'l', b'o', b' ', b'w', b'o', b'r', b'l', b'd', 0x00, // \"hello world\"\n    0x00, // document null-terminator\n];\n\n// empty bson document: {}\nconst CHALLENGE_RESPONSE_BSON: [u8; 5] = [\n    0x05, 0x00, 0x00, 0x00, // document length 5 == 0x00000005\n    0x00, // document null-terminator\n];\n\nstatic ENDPOINT_NAME: \u0026CStr = unsafe { CStr::from_bytes_with_nul_unchecked(b\"endpoint_name\\0\") };\nstatic CHANNEL_NAME: \u0026CStr = unsafe { CStr::from_bytes_with_nul_unchecked(b\"channel_name\\0\") };\n\nfn create_client_identity_handshake(context: *mut GoslingContext) -\u003e anyhow::Result\u003c()\u003e {\n    extern \"C\" fn challenge_response_size_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        _challenge_buffer: *const u8,\n        challenge_buffer_size: usize,\n    ) -\u003e usize {\n        assert!(!context.is_null());\n        assert_eq!(challenge_buffer_size, CHALLENGE_BSON.len());\n\n        CHALLENGE_RESPONSE_BSON.len()\n    }\n    require_noerror!(\n        gosling_context_set_identity_client_challenge_response_size_callback(\n            context,\n            Some(challenge_response_size_callback)\n        )\n    );\n\n    extern \"C\" fn build_challenge_response_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        challenge_buffer: *const u8,\n        challenge_buffer_size: usize,\n        out_challenge_response_buffer: *mut u8,\n        challenge_response_buffer_size: usize,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!challenge_buffer.is_null());\n        assert_eq!(challenge_buffer_size, CHALLENGE_BSON.len());\n        let challenge_buffer = unsafe {\n            std::slice::from_raw_parts(challenge_buffer as *const u8, challenge_buffer_size)\n        };\n        assert_eq!(challenge_buffer, CHALLENGE_BSON);\n        assert!(!out_challenge_response_buffer.is_null());\n        let out_challenge_response_buffer = unsafe {\n            std::slice::from_raw_parts_mut(\n                out_challenge_response_buffer as *mut u8,\n                challenge_response_buffer_size,\n            )\n        };\n\n        out_challenge_response_buffer.clone_from_slice(\u0026CHALLENGE_RESPONSE_BSON);\n    }\n    require_noerror!(\n        gosling_context_set_identity_client_build_challenge_response_callback(\n            context,\n            Some(build_challenge_response_callback)\n        )\n    );\n\n    Ok(())\n}\n\nfn create_server_identity_handshake(context: *mut GoslingContext) -\u003e anyhow::Result\u003c()\u003e {\n    extern \"C\" fn client_allowed_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        client_service_id: *const GoslingV3OnionServiceId,\n    ) -\u003e bool {\n        assert!(!context.is_null());\n        assert!(!client_service_id.is_null());\n\n        true\n    }\n    require_noerror!(gosling_context_set_identity_server_client_allowed_callback(\n        context,\n        Some(client_allowed_callback)\n    ));\n\n    extern \"C\" fn endpoint_supported_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        endpoint_name: *const c_char,\n        endpoint_name_length: usize,\n    ) -\u003e bool {\n        assert!(!context.is_null());\n        let endpoint_name = unsafe { CStr::from_ptr(endpoint_name) };\n        assert_eq!(endpoint_name.to_bytes().len(), endpoint_name_length);\n        if endpoint_name == ENDPOINT_NAME {\n            return true;\n        }\n        false\n    }\n    require_noerror!(\n        gosling_context_set_identity_server_endpoint_supported_callback(\n            context,\n            Some(endpoint_supported_callback)\n        )\n    );\n\n    extern \"C\" fn challenge_size_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n    ) -\u003e usize {\n        assert!(!context.is_null());\n        CHALLENGE_BSON.len()\n    }\n    require_noerror!(gosling_context_set_identity_server_challenge_size_callback(\n        context,\n        Some(challenge_size_callback)\n    ));\n\n    extern \"C\" fn build_challenge_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        out_challenge_buffer: *mut u8,\n        challenge_buffer_size: usize,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!out_challenge_buffer.is_null());\n        assert_eq!(challenge_buffer_size, CHALLENGE_BSON.len());\n\n        let out_challenge_buffer = unsafe {\n            std::slice::from_raw_parts_mut(out_challenge_buffer as *mut u8, challenge_buffer_size)\n        };\n        out_challenge_buffer.clone_from_slice(\u0026CHALLENGE_BSON);\n    }\n    require_noerror!(\n        gosling_context_set_identity_server_build_challenge_callback(\n            context,\n            Some(build_challenge_callback)\n        )\n    );\n\n    extern \"C\" fn verify_challenge_response_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        challenge_response_buffer: *const u8,\n        challenge_response_buffer_size: usize,\n    ) -\u003e bool {\n        assert!(!context.is_null());\n        assert!(!challenge_response_buffer.is_null());\n        if challenge_response_buffer_size != CHALLENGE_RESPONSE_BSON.len() {\n            return false;\n        }\n\n        let challenge_response_buffer = unsafe {\n            std::slice::from_raw_parts(challenge_response_buffer, challenge_response_buffer_size)\n        };\n        if challenge_response_buffer != CHALLENGE_RESPONSE_BSON {\n            return false;\n        }\n        true\n    }\n    require_noerror!(\n        gosling_context_set_identity_server_verify_challenge_response_callback(\n            context,\n            Some(verify_challenge_response_callback)\n        )\n    );\n\n    Ok(())\n}\n\nfn create_server_endpoint_handshake(context: *mut GoslingContext) -\u003e anyhow::Result\u003c()\u003e {\n    extern \"C\" fn channel_supported_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        client_service_id: *const GoslingV3OnionServiceId,\n        channel_name: *const c_char,\n        channel_name_length: usize,\n    ) -\u003e bool {\n        assert!(!context.is_null());\n        assert!(!channel_name.is_null());\n        assert!(!client_service_id.is_null());\n        let channel_name = unsafe { CStr::from_ptr(channel_name) };\n        assert_eq!(channel_name.to_bytes().len(), channel_name_length);\n        if channel_name == CHANNEL_NAME {\n            return true;\n        }\n        false\n    }\n    require_noerror!(\n        gosling_context_set_endpoint_server_channel_supported_callback(\n            context,\n            Some(channel_supported_callback)\n        )\n    );\n\n    Ok(())\n}\n\n#[test]\n#[serial]\n#[cfg(feature = \"mock-tor-provider\")]\nfn test_gosling_ffi_handshake_mock_client() -\u003e anyhow::Result\u003c()\u003e {\n    let library = test_gosling_ffi_handshake_preamble()?;\n\n    // construct a shared mock config\n    let mut mock_tor_provider_config: *mut GoslingTorProviderConfig = ptr::null_mut();\n    require_noerror!(gosling_tor_provider_config_new_mock_client_config(\n        \u0026mut mock_tor_provider_config\n    ));\n\n    // construct tor providers\n    let mut alice_tor_provider: *mut GoslingTorProvider = ptr::null_mut();\n    require_noerror!(gosling_tor_provider_from_tor_provider_config(\n        \u0026mut alice_tor_provider,\n        mock_tor_provider_config\n    ));\n\n    let mut pat_tor_provider: *mut GoslingTorProvider = ptr::null_mut();\n    require_noerror!(gosling_tor_provider_from_tor_provider_config(\n        \u0026mut pat_tor_provider,\n        mock_tor_provider_config\n    ));\n\n    // do test\n    test_gosling_ffi_handshake_impl(library, alice_tor_provider, pat_tor_provider)\n}\n\n#[test]\n#[serial]\n#[cfg(feature = \"legacy-tor-provider\")]\nfn test_gosling_ffi_handshake_legacy_client() -\u003e anyhow::Result\u003c()\u003e {\n    let library = test_gosling_ffi_handshake_preamble()?;\n\n    // construct tor providers\n\n    let mut alice_working_dir = std::env::temp_dir();\n    alice_working_dir.push(\"cgosling_bundled_test_alice\");\n    let alice_working_dir: CString = CString::new(alice_working_dir.to_str().unwrap())?;\n\n    let mut alice_tor_provider_config: *mut GoslingTorProviderConfig = ptr::null_mut();\n    require_noerror!(\n        gosling_tor_provider_config_new_bundled_legacy_client_config(\n            \u0026mut alice_tor_provider_config,\n            ptr::null(),\n            0usize,\n            alice_working_dir.as_ptr(),\n            alice_working_dir.as_bytes().len()\n        )\n    );\n\n    let mut alice_tor_provider: *mut GoslingTorProvider = ptr::null_mut();\n    require_noerror!(gosling_tor_provider_from_tor_provider_config(\n        \u0026mut alice_tor_provider,\n        alice_tor_provider_config\n    ));\n\n    let mut pat_working_dir = std::env::temp_dir();\n    pat_working_dir.push(\"cgosling_bundled_test_pat\");\n    let pat_working_dir: CString = CString::new(pat_working_dir.to_str().unwrap())?;\n\n    let mut pat_tor_provider_config: *mut GoslingTorProviderConfig = ptr::null_mut();\n    require_noerror!(\n        gosling_tor_provider_config_new_bundled_legacy_client_config(\n            \u0026mut pat_tor_provider_config,\n            ptr::null(),\n            0usize,\n            pat_working_dir.as_ptr(),\n            pat_working_dir.as_bytes().len()\n        )\n    );\n\n    let mut pat_tor_provider: *mut GoslingTorProvider = ptr::null_mut();\n    require_noerror!(gosling_tor_provider_from_tor_provider_config(\n        \u0026mut pat_tor_provider,\n        pat_tor_provider_config\n    ));\n\n    // do test\n    test_gosling_ffi_handshake_impl(library, alice_tor_provider, pat_tor_provider)\n}\n\n// test bundled tor client with pluggable transport\n#[test]\n#[serial]\n#[cfg(feature = \"legacy-tor-provider\")]\nfn test_gosling_ffi_handshake_bundled_pt_client() -\u003e anyhow::Result\u003c()\u003e {\n    let library = test_gosling_ffi_handshake_preamble()?;\n\n    // construct a shared pt config using lyrebird\n    let mut pt_config: *mut GoslingPluggableTransportConfig = ptr::null_mut();\n    let transports: CString = CString::new(\"obfs4\")?;\n\n    let teb_path = std::env::var(\"TEB_PATH\")?;\n    if teb_path.is_empty() {\n        println!(\"TEB_PATH environment variable empty, so skipping test_legacy_pluggable_transport_bootstrap()\");\n        return Ok(());\n    }\n    let mut lyrebird_path = std::path::PathBuf::from(\u0026teb_path);\n    let lyrebird_bin = format!(\"lyrebird{}\", std::env::consts::EXE_SUFFIX);\n    lyrebird_path.push(lyrebird_bin);\n    assert!(std::path::Path::exists(\u0026lyrebird_path));\n    assert!(std::path::Path::is_file(\u0026lyrebird_path));\n    let lyrebird_path: CString = CString::new(lyrebird_path.to_str().unwrap())?;\n\n    require_noerror!(gosling_pluggable_transport_config_new(\n        \u0026mut pt_config,\n        transports.as_ptr(),\n        transports.as_bytes().len(),\n        lyrebird_path.as_ptr(),\n        lyrebird_path.as_bytes().len()\n    ));\n\n    // construct a obfs4 bridge line to use with lyrebird\n    let mut bridge_line: *mut GoslingBridgeLine = ptr::null_mut();\n    let bridge_line_str = \"obfs4 207.172.185.193:22223 F34AC0CDBC06918E54292A474578C99834A58893 cert=MjqosoyVylLQuLo4LH+eQ5hS7Z44s2CaMfQbIjJtn4bGRnvLv8ldSvSED5JpvWSxm09XXg iat-mode=0\";\n    let bridge_line_str = CString::new(bridge_line_str)?;\n\n    require_noerror!(gosling_bridge_line_from_string(\n        \u0026mut bridge_line,\n        bridge_line_str.as_ptr(),\n        bridge_line_str.as_bytes().len()\n    ));\n\n    // construct tor providers\n\n    let mut alice_working_dir = std::env::temp_dir();\n    alice_working_dir.push(\"cgosling_bundled_pt_test_alice\");\n    let alice_working_dir: CString = CString::new(alice_working_dir.to_str().unwrap())?;\n\n    let mut alice_tor_provider_config: *mut GoslingTorProviderConfig = ptr::null_mut();\n    require_noerror!(\n        gosling_tor_provider_config_new_bundled_legacy_client_config(\n            \u0026mut alice_tor_provider_config,\n            ptr::null(),\n            0usize,\n            alice_working_dir.as_ptr(),\n            alice_working_dir.as_bytes().len()\n        )\n    );\n\n    // add pt config\n    require_noerror!(gosling_tor_provider_config_add_pluggable_transport_config(\n        alice_tor_provider_config,\n        pt_config\n    ));\n\n    // add bridge line\n    require_noerror!(gosling_tor_provider_config_add_bridge_line(\n        alice_tor_provider_config,\n        bridge_line\n    ));\n\n    let mut alice_tor_provider: *mut GoslingTorProvider = ptr::null_mut();\n    require_noerror!(gosling_tor_provider_from_tor_provider_config(\n        \u0026mut alice_tor_provider,\n        alice_tor_provider_config\n    ));\n\n    let mut pat_working_dir = std::env::temp_dir();\n    pat_working_dir.push(\"cgosling_bundled_pt_test_pat\");\n    let pat_working_dir: CString = CString::new(pat_working_dir.to_str().unwrap())?;\n\n    let mut pat_tor_provider_config: *mut GoslingTorProviderConfig = ptr::null_mut();\n    require_noerror!(\n        gosling_tor_provider_config_new_bundled_legacy_client_config(\n            \u0026mut pat_tor_provider_config,\n            ptr::null(),\n            0usize,\n            pat_working_dir.as_ptr(),\n            pat_working_dir.as_bytes().len()\n        )\n    );\n\n    let mut pat_tor_provider: *mut GoslingTorProvider = ptr::null_mut();\n    require_noerror!(gosling_tor_provider_from_tor_provider_config(\n        \u0026mut pat_tor_provider,\n        pat_tor_provider_config\n    ));\n\n    // do test\n    test_gosling_ffi_handshake_impl(library, alice_tor_provider, pat_tor_provider)\n}\n\nfn test_gosling_ffi_handshake_preamble() -\u003e anyhow::Result\u003c*mut GoslingLibrary\u003e {\n    // init libary\n\n    println!(\"--- init gosling library\");\n    let mut library: *mut GoslingLibrary = ptr::null_mut();\n    require_noerror!(gosling_library_init(\u0026mut library));\n\n    println!(\"--- library: {:?}\", library);\n\n    Ok(library)\n}\n\nfn test_gosling_ffi_handshake_impl(\n    library: *mut GoslingLibrary,\n    alice_tor_provider: *mut GoslingTorProvider,\n    pat_tor_provider: *mut GoslingTorProvider,\n) -\u003e anyhow::Result\u003c()\u003e {\n    // init alice\n\n    println!(\"--- init alice\");\n    let mut alice_private_key: *mut GoslingEd25519PrivateKey = ptr::null_mut();\n    require_noerror!(gosling_ed25519_private_key_generate(\u0026mut alice_private_key));\n\n    let mut alice_identity: *mut GoslingV3OnionServiceId = ptr::null_mut();\n    require_noerror!(gosling_v3_onion_service_id_from_ed25519_private_key(\n        \u0026mut alice_identity,\n        alice_private_key\n    ));\n\n    let mut alice_context: *mut GoslingContext = ptr::null_mut();\n    require_noerror!(gosling_context_init(\n        \u0026mut alice_context,\n        alice_tor_provider,\n        420,\n        420,\n        alice_private_key\n    ));\n\n    create_server_identity_handshake(alice_context)?;\n    create_server_endpoint_handshake(alice_context)?;\n    // init pat\n\n    println!(\"--- init pat\");\n    let mut pat_private_key: *mut GoslingEd25519PrivateKey = ptr::null_mut();\n    require_noerror!(gosling_ed25519_private_key_generate(\u0026mut pat_private_key));\n\n    let mut pat_identity: *mut GoslingV3OnionServiceId = ptr::null_mut();\n    require_noerror!(gosling_v3_onion_service_id_from_ed25519_private_key(\n        \u0026mut pat_identity,\n        pat_private_key\n    ));\n\n    let mut pat_context: *mut GoslingContext = ptr::null_mut();\n    require_noerror!(gosling_context_init(\n        \u0026mut pat_context,\n        pat_tor_provider,\n        420,\n        420,\n        pat_private_key\n    ));\n\n    create_client_identity_handshake(pat_context)?;\n\n    // bootstrap alice\n\n    static ALICE_BOOTSTRAP_COMPLETE: AtomicBool = AtomicBool::new(false);\n    ALICE_BOOTSTRAP_COMPLETE.store(false, Ordering::Relaxed);\n\n    extern \"C\" fn alice_bootstrap_complete_callback(context: *mut GoslingContext) -\u003e () {\n        assert!(!context.is_null());\n        ALICE_BOOTSTRAP_COMPLETE.store(true, Ordering::Relaxed);\n        println!(\"--- alice bootstraped\");\n    }\n    require_noerror!(gosling_context_set_tor_bootstrap_completed_callback(\n        alice_context,\n        Some(alice_bootstrap_complete_callback)\n    ));\n\n    println!(\"--- begin alice bootstrap\");\n    require_noerror!(gosling_context_bootstrap_tor(alice_context));\n    while !ALICE_BOOTSTRAP_COMPLETE.load(Ordering::Relaxed) {\n        require_noerror!(gosling_context_poll_events(alice_context));\n    }\n\n    // init alice's identity server\n    static ALICE_IDENTITY_SERVER_READY: AtomicBool = AtomicBool::new(false);\n    ALICE_IDENTITY_SERVER_READY.store(false, Ordering::Relaxed);\n\n    extern \"C\" fn alice_identity_server_published_callback(context: *mut GoslingContext) -\u003e () {\n        assert!(!context.is_null());\n        println!(\"--- alice identity server published\");\n\n        ALICE_IDENTITY_SERVER_READY.store(true, Ordering::Relaxed);\n    }\n    require_noerror!(gosling_context_set_identity_server_published_callback(\n        alice_context,\n        Some(alice_identity_server_published_callback)\n    ));\n\n    println!(\"--- start alice identity server\");\n    require_noerror!(gosling_context_start_identity_server(alice_context));\n\n    while !ALICE_IDENTITY_SERVER_READY.load(Ordering::Relaxed) {\n        require_noerror!(gosling_context_poll_events(alice_context));\n    }\n\n    // bootstrap pat\n\n    static PAT_BOOTSTRAP_COMPLETE: AtomicBool = AtomicBool::new(false);\n    PAT_BOOTSTRAP_COMPLETE.store(false, Ordering::Relaxed);\n\n    extern \"C\" fn pat_bootstrap_complete_callback(context: *mut GoslingContext) -\u003e () {\n        assert!(!context.is_null());\n\n        println!(\"--- pat bootstrapped\");\n\n        PAT_BOOTSTRAP_COMPLETE.store(true, Ordering::Relaxed);\n    }\n    require_noerror!(gosling_context_set_tor_bootstrap_completed_callback(\n        pat_context,\n        Some(pat_bootstrap_complete_callback)\n    ));\n\n    println!(\"--- begin pat bootstrap\");\n    require_noerror!(gosling_context_bootstrap_tor(pat_context));\n    while !PAT_BOOTSTRAP_COMPLETE.load(Ordering::Relaxed) {\n        require_noerror!(gosling_context_poll_events(pat_context));\n    }\n\n    // pat requests an endpoint from alice\n\n    static mut PAT_ENDPOINT_REQUEST_COMPLETE: bool = false;\n    static mut ALICE_ENDPOINT_SERVICE_ID: *mut GoslingV3OnionServiceId = ptr::null_mut();\n    static mut PAT_ONION_AUTH_PRIVATE_KEY: *mut GoslingX25519PrivateKey = ptr::null_mut();\n    unsafe {\n        PAT_ENDPOINT_REQUEST_COMPLETE = false;\n        ALICE_ENDPOINT_SERVICE_ID = ptr::null_mut();\n        PAT_ONION_AUTH_PRIVATE_KEY = ptr::null_mut();\n    }\n\n    extern \"C\" fn pat_identity_client_handshake_completed_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        identity_service_id: *const GoslingV3OnionServiceId,\n        endpoint_service_id: *const GoslingV3OnionServiceId,\n        endpoint_name: *const c_char,\n        endpoint_name_length: usize,\n        client_auth_private_key: *const GoslingX25519PrivateKey,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!identity_service_id.is_null());\n        assert!(!endpoint_service_id.is_null());\n        assert!(!endpoint_name.is_null());\n        let endpoint_name = unsafe { CStr::from_ptr(endpoint_name) };\n        assert_eq!(endpoint_name.to_bytes().len(), endpoint_name_length);\n        assert_eq!(endpoint_name, ENDPOINT_NAME);\n        assert!(!client_auth_private_key.is_null());\n\n        let mut error: *mut GoslingError = ptr::null_mut();\n\n        let mut alice_endpoint_service_id: *mut GoslingV3OnionServiceId = ptr::null_mut();\n        unsafe {\n            gosling_v3_onion_service_id_clone(\n                \u0026mut alice_endpoint_service_id,\n                endpoint_service_id,\n                \u0026mut error,\n            );\n        }\n        assert!(error.is_null());\n        assert!(!alice_endpoint_service_id.is_null());\n        unsafe {\n            ALICE_ENDPOINT_SERVICE_ID = alice_endpoint_service_id;\n        }\n\n        let mut pat_onion_auth_private_key: *mut GoslingX25519PrivateKey = ptr::null_mut();\n        unsafe {\n            gosling_x25519_private_key_clone(\n                \u0026mut pat_onion_auth_private_key,\n                client_auth_private_key,\n                \u0026mut error,\n            );\n        }\n        assert!(error.is_null());\n        assert!(!pat_onion_auth_private_key.is_null());\n        unsafe {\n            PAT_ONION_AUTH_PRIVATE_KEY = pat_onion_auth_private_key;\n        }\n\n        println!(\"--- pat identity handshake completed\");\n\n        unsafe {\n            PAT_ENDPOINT_REQUEST_COMPLETE = true;\n        }\n    }\n    require_noerror!(\n        gosling_context_set_identity_client_handshake_completed_callback(\n            pat_context,\n            Some(pat_identity_client_handshake_completed_callback)\n        )\n    );\n\n    extern \"C\" fn pat_identity_client_handshake_failed_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        error: *const GoslingError,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!error.is_null());\n        let error_message = unsafe {\n            CStr::from_ptr(gosling_error_get_message(error))\n                .to_str()\n                .unwrap()\n        };\n\n        panic!(\"--- pat identity handshake failed: {}\", error_message);\n    }\n    require_noerror!(\n        gosling_context_set_identity_client_handshake_failed_callback(\n            pat_context,\n            Some(pat_identity_client_handshake_failed_callback)\n        )\n    );\n\n    static mut ALICE_ENDPOINT_REQUEST_COMPLETE: bool = false;\n    static mut ALICE_ENDPOINT_PRIVATE_KEY: *mut GoslingEd25519PrivateKey = ptr::null_mut();\n    static mut PAT_IDENTITY_SERVICE_ID: *mut GoslingV3OnionServiceId = ptr::null_mut();\n    static mut PAT_ONION_AUTH_PUBLIC_KEY: *mut GoslingX25519PublicKey = ptr::null_mut();\n    unsafe {\n        ALICE_ENDPOINT_REQUEST_COMPLETE = false;\n        ALICE_ENDPOINT_PRIVATE_KEY = ptr::null_mut();\n        PAT_IDENTITY_SERVICE_ID = ptr::null_mut();\n        PAT_ONION_AUTH_PUBLIC_KEY = ptr::null_mut();\n    }\n\n    extern \"C\" fn alice_identity_server_handshake_completed_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        endpoint_private_key: *const GoslingEd25519PrivateKey,\n        endpoint_name: *const c_char,\n        endpoint_name_length: usize,\n        client_service_id: *const GoslingV3OnionServiceId,\n        client_auth_public_key: *const GoslingX25519PublicKey,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!endpoint_private_key.is_null());\n        assert!(!endpoint_name.is_null());\n        let endpoint_name = unsafe { CStr::from_ptr(endpoint_name) };\n        assert_eq!(endpoint_name.to_bytes().len(), endpoint_name_length);\n        assert_eq!(endpoint_name, ENDPOINT_NAME);\n        assert!(!client_service_id.is_null());\n        assert!(!client_auth_public_key.is_null());\n\n        let mut error: *mut GoslingError = ptr::null_mut();\n\n        let mut alice_endpoint_private_key: *mut GoslingEd25519PrivateKey = ptr::null_mut();\n        unsafe {\n            gosling_ed25519_private_key_clone(\n                \u0026mut alice_endpoint_private_key,\n                endpoint_private_key,\n                \u0026mut error,\n            );\n        }\n        assert!(error.is_null());\n        assert!(!alice_endpoint_private_key.is_null());\n        unsafe {\n            ALICE_ENDPOINT_PRIVATE_KEY = alice_endpoint_private_key;\n        }\n\n        let mut pat_identity_service_id: *mut GoslingV3OnionServiceId = ptr::null_mut();\n        unsafe {\n            gosling_v3_onion_service_id_clone(\n                \u0026mut pat_identity_service_id,\n                client_service_id,\n                \u0026mut error,\n            );\n        }\n        assert!(error.is_null());\n        assert!(!pat_identity_service_id.is_null());\n        unsafe {\n            PAT_IDENTITY_SERVICE_ID = pat_identity_service_id;\n        }\n\n        let mut pat_onion_auth_public_key: *mut GoslingX25519PublicKey = ptr::null_mut();\n        unsafe {\n            gosling_x25519_public_key_clone(\n                \u0026mut pat_onion_auth_public_key,\n                client_auth_public_key,\n                \u0026mut error,\n            );\n        }\n        assert!(error.is_null());\n        assert!(!pat_onion_auth_public_key.is_null());\n        unsafe {\n            PAT_ONION_AUTH_PUBLIC_KEY = pat_onion_auth_public_key;\n        }\n\n        println!(\"--- alice identity handshake completed\");\n\n        unsafe {\n            ALICE_ENDPOINT_REQUEST_COMPLETE = true;\n        }\n    }\n    require_noerror!(\n        gosling_context_set_identity_server_handshake_completed_callback(\n            alice_context,\n            Some(alice_identity_server_handshake_completed_callback)\n        )\n    );\n\n    extern \"C\" fn alice_identity_server_handshake_failed_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        error: *const GoslingError,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!error.is_null());\n        let error_message = unsafe {\n            CStr::from_ptr(gosling_error_get_message(error))\n                .to_str()\n                .unwrap()\n        };\n\n        panic!(\"--- alice identity handshake failed: {}\", error_message);\n    }\n    require_noerror!(\n        gosling_context_set_identity_server_handshake_failed_callback(\n            alice_context,\n            Some(alice_identity_server_handshake_failed_callback)\n        )\n    );\n\n    let mut pat_begin_identity_handshake_succeeded = false;\n    for k in 1..=3 {\n        println!(\"--- pat begin identity handshake attempt {}\", k);\n\n        let mut error: *mut GoslingError = ptr::null_mut();\n        gosling_context_begin_identity_handshake(\n            pat_context,\n            alice_identity,\n            ENDPOINT_NAME.as_ptr(),\n            ENDPOINT_NAME.to_bytes().len(),\n            \u0026mut error,\n        );\n\n        if error.is_null() {\n            pat_begin_identity_handshake_succeeded = true;\n            break;\n        } else {\n            let error_message = unsafe {\n                CStr::from_ptr(gosling_error_get_message(error))\n                    .to_str()\n                    .unwrap()\n            };\n            println!(\"--- pat begin identity hanshake failed: {}\", error_message);\n            gosling_error_free(error);\n        }\n    }\n    assert!(pat_begin_identity_handshake_succeeded);\n\n    while unsafe { !ALICE_ENDPOINT_REQUEST_COMPLETE } {\n        require_noerror!(gosling_context_poll_events(alice_context));\n        require_noerror!(gosling_context_poll_events(pat_context));\n    }\n\n    // start alice's enddpoint server\n\n    static mut ALICE_ENDPOINT_PUBLISHED: bool = false;\n    unsafe {\n        ALICE_ENDPOINT_PUBLISHED = false;\n    }\n\n    extern \"C\" fn alice_endpoint_server_published_callback(\n        context: *mut GoslingContext,\n        endpoint_service_id: *const GoslingV3OnionServiceId,\n        endpoint_name: *const c_char,\n        endpoint_name_length: usize,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!endpoint_service_id.is_null());\n        let endpoint_name = unsafe { CStr::from_ptr(endpoint_name) };\n        assert_eq!(endpoint_name.to_bytes().len(), endpoint_name_length);\n        assert_eq!(endpoint_name, ENDPOINT_NAME);\n\n        println!(\"--- alice endpoint server published\");\n        unsafe {\n            ALICE_ENDPOINT_PUBLISHED = true;\n        }\n    }\n    require_noerror!(gosling_context_set_endpoint_server_published_callback(\n        alice_context,\n        Some(alice_endpoint_server_published_callback)\n    ));\n\n    println!(\"--- start init alice endpoint server\");\n    require_noerror!(gosling_context_start_endpoint_server(\n        alice_context,\n        ALICE_ENDPOINT_PRIVATE_KEY,\n        ENDPOINT_NAME.as_ptr(),\n        ENDPOINT_NAME.to_bytes().len(),\n        PAT_IDENTITY_SERVICE_ID,\n        PAT_ONION_AUTH_PUBLIC_KEY\n    ));\n\n    while unsafe { !PAT_ENDPOINT_REQUEST_COMPLETE || !ALICE_ENDPOINT_PUBLISHED } {\n        require_noerror!(gosling_context_poll_events(alice_context));\n        require_noerror!(gosling_context_poll_events(pat_context));\n    }\n\n    #[cfg(target_os = \"windows\")]\n    type TcpSocket = RawSocket;\n    #[cfg(any(target_os = \"linux\", target_os = \"macos\"))]\n    type TcpSocket = RawFd;\n\n    static mut PAT_SOCKET: Option\u003cTcpSocket\u003e = None;\n    static mut ALICE_SOCKET: Option\u003cTcpSocket\u003e = None;\n    unsafe {\n        PAT_SOCKET = None;\n        ALICE_SOCKET = None;\n    }\n\n    extern \"C\" fn pat_enpdoint_client_handshake_completed_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        endpoint_service_id: *const GoslingV3OnionServiceId,\n        channel_name: *const c_char,\n        channel_name_length: usize,\n        stream: TcpSocket,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!endpoint_service_id.is_null());\n        assert!(!channel_name.is_null());\n        let channel_name = unsafe { CStr::from_ptr(channel_name) };\n        assert_eq!(channel_name.to_bytes().len(), channel_name_length);\n        assert_eq!(channel_name, CHANNEL_NAME);\n\n        unsafe {\n            PAT_SOCKET = Some(stream);\n        }\n        println!(\"--- pat endpoint handshake complete\");\n    }\n    require_noerror!(\n        gosling_context_set_endpoint_client_handshake_completed_callback(\n            pat_context,\n            Some(pat_enpdoint_client_handshake_completed_callback)\n        )\n    );\n\n    extern \"C\" fn pat_endpoint_client_handshake_failed_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        error: *const GoslingError,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!error.is_null());\n\n        let error_message = unsafe {\n            CStr::from_ptr(gosling_error_get_message(error))\n                .to_str()\n                .unwrap()\n        };\n        panic!(\"--- pat endpoint handshake failed: {}\", error_message);\n    }\n    require_noerror!(\n        gosling_context_set_endpoint_client_handshake_failed_callback(\n            pat_context,\n            Some(pat_endpoint_client_handshake_failed_callback)\n        )\n    );\n\n    extern \"C\" fn alice_endpoint_server_handshake_completed_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        endpoint_service_id: *const GoslingV3OnionServiceId,\n        client_service_id: *const GoslingV3OnionServiceId,\n        channel_name: *const c_char,\n        channel_name_length: usize,\n        stream: TcpSocket,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!endpoint_service_id.is_null());\n        assert!(!client_service_id.is_null());\n        assert!(!channel_name.is_null());\n        let channel_name = unsafe { CStr::from_ptr(channel_name) };\n        assert_eq!(channel_name.to_bytes().len(), channel_name_length);\n        assert_eq!(channel_name, CHANNEL_NAME);\n\n        unsafe { ALICE_SOCKET = Some(stream) };\n        println!(\"--- alice endpoint hanshake complete\");\n    }\n    require_noerror!(\n        gosling_context_set_endpoint_server_handshake_completed_callback(\n            alice_context,\n            Some(alice_endpoint_server_handshake_completed_callback)\n        )\n    );\n\n    extern \"C\" fn alice_endpoint_server_handshake_failed_callback(\n        context: *mut GoslingContext,\n        _handshake_handle: usize,\n        error: *const GoslingError,\n    ) -\u003e () {\n        assert!(!context.is_null());\n        assert!(!error.is_null());\n\n        let error_message = unsafe {\n            CStr::from_ptr(gosling_error_get_message(error))\n                .to_str()\n                .unwrap()\n        };\n        panic!(\"--- alice endpoint handshake failed: {}\", error_message);\n    }\n    require_noerror!(\n        gosling_context_set_endpoint_server_handshake_failed_callback(\n            alice_context,\n            Some(alice_endpoint_server_handshake_failed_callback)\n        )\n    );\n\n    let mut pat_begin_endpoint_handshake_succeeded = false;\n    for k in 1..=3 {\n        println!(\"--- pat begin endpoint handshake attempt {}\", k);\n\n        let mut error: *mut GoslingError = ptr::null_mut();\n        unsafe {\n            gosling_context_begin_endpoint_handshake(\n                pat_context,\n                ALICE_ENDPOINT_SERVICE_ID,\n                PAT_ONION_AUTH_PRIVATE_KEY,\n                CHANNEL_NAME.as_ptr(),\n                CHANNEL_NAME.to_bytes().len(),\n                \u0026mut error,\n            );\n        }\n\n        if error.is_null() {\n            pat_begin_endpoint_handshake_succeeded = true;\n            break;\n        } else {\n            let error_message = unsafe {\n                CStr::from_ptr(gosling_error_get_message(error))\n                    .to_str()\n                    .unwrap()\n            };\n            println!(\"--- pat begin endpoint hanshake failed: {}\", error_message);\n            gosling_error_free(error);\n        }\n    }\n    assert!(pat_begin_endpoint_handshake_succeeded);\n\n    while unsafe { PAT_SOCKET.is_none() || ALICE_SOCKET.is_none() } {\n        require_noerror!(gosling_context_poll_events(alice_context));\n        require_noerror!(gosling_context_poll_events(pat_context));\n    }\n\n    #[cfg(unix)]\n    let (mut pat_stream, alice_stream) = unsafe {\n        (\n            TcpStream::from_raw_fd(PAT_SOCKET.unwrap()),\n            TcpStream::from_raw_fd(ALICE_SOCKET.unwrap()),\n        )\n    };\n    #[cfg(windows)]\n    let (mut pat_stream, alice_stream) = unsafe {\n        (\n            TcpStream::from_raw_socket(PAT_SOCKET.unwrap()),\n            TcpStream::from_raw_socket(ALICE_SOCKET.unwrap()),\n        )\n    };\n\n    println!(\"--- pat writes message\");\n\n    static MESSAGE: \u0026str = \"Hello Alice!\\n\";\n\n    pat_stream.write(MESSAGE.as_bytes())?;\n    pat_stream.flush()?;\n\n    println!(\"--- alice waits for message\");\n\n    alice_stream.set_nonblocking(false)?;\n    let mut alice_reader = BufReader::new(alice_stream);\n    let mut alice_read_string: String = Default::default();\n    let mut alice_message_read: bool = false;\n    while !alice_message_read {\n        match alice_reader.read_line(\u0026mut alice_read_string) {\n            Ok(0) =\u003e {\n                println!(\"--- alice reads 0\");\n            }\n            Ok(val) =\u003e {\n                assert_eq!(val, MESSAGE.len());\n                assert_eq!(alice_read_string, MESSAGE);\n                // remove trailing new-line\n                alice_read_string.truncate(alice_read_string.len() - 1);\n\n                println!(\"--- alice received '{}'\", alice_read_string);\n                alice_message_read = true;\n            }\n            Err(err) =\u003e bail!(\"{}\", err),\n        }\n    }\n\n    // we have to free gosling library at the end or else the backing TorProvider will go away\n    // and then pat_stream and alice_stream will no longer be valid\n    println!(\"--- free gosling library\");\n    gosling_library_free(library);\n\n    Ok(())\n}\n","traces":[{"line":29,"address":[1712084,1716575,1709956],"length":1,"stats":{"Line":3}},{"line":30,"address":[1698640,1704601,1693648,1689099,1700057,1702440,1700932,1689772,1697384,1688652,1694511,1701668,1703738,1692350,1691430],"length":1,"stats":{"Line":47}},{"line":31,"address":[1692370,1694531,1693761,1697614,1700960,1703851,1704621,1698753,1702460,1689789,1689116,1688661,1691567,1701696,1700194],"length":1,"stats":{"Line":47}},{"line":32,"address":[1704646,1688677,1691597,1703881,1694556,1700977,1698778,1692395,1700224,1689811,1689138,1697639,1693791,1702485,1701713],"length":1,"stats":{"Line":47}},{"line":33,"address":[1688733,1703914,1702524,1693824,1700263,1690031,1689382,1704679,1697678,1701752,1701016,1691636,1692434,1694589,1698817],"length":1,"stats":{"Line":0}},{"line":34,"address":[1700291,1693908,1694155,1694617,1688850,1697706,1698906,1694683,1692770,1701974,1704773,1702613,1689502,1700606,1701238,1701848,1703998,1702095,1702552,1704124,1699032,1692523,1690151,1689605,1698021,1693852,1705020,1690059,1690254,1699153,1691664,1691858,1702860,1704245,1694034,1697900,1704899,1691732,1688758,1688941,1694809,1701044,1702739,1689410,1703942,1700359,1701359,1692649,1704707,1697774,1700485,1691979,1701112,1694930,1692462,1701780,1698845],"length":1,"stats":{"Line":0}},{"line":35,"address":[1688949,1694938,1692778,1701367,1694163,1698029,1690262,1691987,1702103,1702868,1704253,1705028,1700614,1699161,1689613],"length":1,"stats":{"Line":0}},{"line":36,"address":[1694180,1698046,1702120,1704524,1694955,1692004,1695214,1701384,1702363,1700891,1692264,1702885,1704270,1690394,1689838,1690544,1703128,1693038,1688963,1689990,1694434,1698306,1699438,1690279,1701627,1700631,1705304,1692795,1689325,1689630,1699178,1689165,1705045],"length":1,"stats":{"Line":0}},{"line":60,"address":[1710652,1709936],"length":1,"stats":{"Line":1}},{"line":61,"address":[1711271,1711232],"length":1,"stats":{"Line":1}},{"line":67,"address":[1711333,1711284,1711256],"length":1,"stats":{"Line":2}},{"line":68,"address":[1711290,1711363],"length":1,"stats":{"Line":1}},{"line":72,"address":[1710021],"length":1,"stats":{"Line":1}},{"line":79,"address":[1711522,1711440],"length":1,"stats":{"Line":1}},{"line":87,"address":[1711557,1711535,1711507],"length":1,"stats":{"Line":2}},{"line":88,"address":[1711546,1711594,1711649],"length":1,"stats":{"Line":2}},{"line":89,"address":[1711679,1711600],"length":1,"stats":{"Line":1}},{"line":91,"address":[1711736],"length":1,"stats":{"Line":1}},{"line":93,"address":[1711798],"length":1,"stats":{"Line":1}},{"line":94,"address":[1711915,1711966],"length":1,"stats":{"Line":1}},{"line":102,"address":[1712024],"length":1,"stats":{"Line":1}},{"line":104,"address":[1710409],"length":1,"stats":{"Line":1}},{"line":111,"address":[1711017],"length":1,"stats":{"Line":1}},{"line":114,"address":[1712064,1712846],"length":1,"stats":{"Line":1}},{"line":115,"address":[1715351,1715312],"length":1,"stats":{"Line":1}},{"line":120,"address":[1715364,1715336,1715390],"length":1,"stats":{"Line":2}},{"line":121,"address":[1715375,1715424,1715442],"length":1,"stats":{"Line":2}},{"line":125,"address":[1712197],"length":1,"stats":{"Line":1}},{"line":130,"address":[1715544,1715488],"length":1,"stats":{"Line":1}},{"line":136,"address":[1715557,1715585,1715529],"length":1,"stats":{"Line":2}},{"line":137,"address":[1715568,1715628],"length":1,"stats":{"Line":2}},{"line":138,"address":[1715638],"length":1,"stats":{"Line":1}},{"line":139,"address":[1715760],"length":1,"stats":{"Line":1}},{"line":144,"address":[1712603],"length":1,"stats":{"Line":1}},{"line":151,"address":[1715837,1715808],"length":1,"stats":{"Line":1}},{"line":155,"address":[1715850,1715866,1715822],"length":1,"stats":{"Line":2}},{"line":158,"address":[1713255],"length":1,"stats":{"Line":1}},{"line":163,"address":[1715904,1715954],"length":1,"stats":{"Line":1}},{"line":169,"address":[1715939,1715989,1715967],"length":1,"stats":{"Line":2}},{"line":170,"address":[1716026,1715978,1716081],"length":1,"stats":{"Line":2}},{"line":171,"address":[1716032,1716111],"length":1,"stats":{"Line":1}},{"line":174,"address":[1716168],"length":1,"stats":{"Line":1}},{"line":176,"address":[1716220],"length":1,"stats":{"Line":1}},{"line":178,"address":[1713883],"length":1,"stats":{"Line":1}},{"line":185,"address":[1716272,1716321],"length":1,"stats":{"Line":1}},{"line":191,"address":[1716356,1716334,1716306],"length":1,"stats":{"Line":2}},{"line":192,"address":[1716345,1716393,1716412],"length":1,"stats":{"Line":2}},{"line":193,"address":[1716404],"length":1,"stats":{"Line":1}},{"line":194,"address":[1716473],"length":1,"stats":{"Line":0}},{"line":198,"address":[1716452,1716490],"length":1,"stats":{"Line":2}},{"line":200,"address":[1716500],"length":1,"stats":{"Line":1}},{"line":205,"address":[1714511],"length":1,"stats":{"Line":1}},{"line":212,"address":[1715095],"length":1,"stats":{"Line":1}},{"line":215,"address":[1717161,1716560],"length":1,"stats":{"Line":1}},{"line":216,"address":[1717200,1717269],"length":1,"stats":{"Line":1}},{"line":223,"address":[1717254,1717308,1717282],"length":1,"stats":{"Line":2}},{"line":224,"address":[1717293,1717371,1717345],"length":1,"stats":{"Line":2}},{"line":225,"address":[1717408,1717436,1717356],"length":1,"stats":{"Line":2}},{"line":226,"address":[1717419,1717479],"length":1,"stats":{"Line":2}},{"line":227,"address":[1717489],"length":1,"stats":{"Line":1}},{"line":228,"address":[1717611],"length":1,"stats":{"Line":1}},{"line":233,"address":[1716624],"length":1,"stats":{"Line":1}},{"line":240,"address":[1716968],"length":1,"stats":{"Line":1}},{"line":428,"address":[1717664,1718514],"length":1,"stats":{"Line":1}},{"line":431,"address":[1717671],"length":1,"stats":{"Line":1}},{"line":432,"address":[1717740],"length":1,"stats":{"Line":1}},{"line":435,"address":[1718224],"length":1,"stats":{"Line":1}},{"line":437,"address":[1718299],"length":1,"stats":{"Line":1}},{"line":440,"address":[1718560,1719956],"length":1,"stats":{"Line":1}},{"line":447,"address":[1718645],"length":1,"stats":{"Line":1}},{"line":448,"address":[1719208],"length":1,"stats":{"Line":1}},{"line":451,"address":[1719660],"length":1,"stats":{"Line":1}},{"line":452,"address":[1719708],"length":1,"stats":{"Line":1}},{"line":457,"address":[1720373],"length":1,"stats":{"Line":1}},{"line":458,"address":[1720421],"length":1,"stats":{"Line":1}},{"line":466,"address":[1721023,1721358],"length":1,"stats":{"Line":1}},{"line":467,"address":[1721552,1721295],"length":1,"stats":{"Line":1}},{"line":470,"address":[1721399],"length":1,"stats":{"Line":1}},{"line":471,"address":[1721458],"length":1,"stats":{"Line":1}},{"line":474,"address":[1721953],"length":1,"stats":{"Line":1}},{"line":475,"address":[1722001],"length":1,"stats":{"Line":1}},{"line":480,"address":[1722631],"length":1,"stats":{"Line":1}},{"line":481,"address":[1722679],"length":1,"stats":{"Line":1}},{"line":489,"address":[1723281,1723688],"length":1,"stats":{"Line":1}},{"line":494,"address":[1723553],"length":1,"stats":{"Line":1}},{"line":496,"address":[1744752,1744776],"length":1,"stats":{"Line":1}},{"line":497,"address":[1744761,1744824,1744789],"length":1,"stats":{"Line":2}},{"line":498,"address":[1744795],"length":1,"stats":{"Line":1}},{"line":499,"address":[1744854],"length":1,"stats":{"Line":1}},{"line":501,"address":[1723627],"length":1,"stats":{"Line":1}},{"line":506,"address":[1724065],"length":1,"stats":{"Line":1}},{"line":507,"address":[1724136],"length":1,"stats":{"Line":1}},{"line":508,"address":[1724723],"length":1,"stats":{"Line":1}},{"line":509,"address":[1725005],"length":1,"stats":{"Line":1}},{"line":514,"address":[1725054],"length":1,"stats":{"Line":1}},{"line":516,"address":[1744936,1744912],"length":1,"stats":{"Line":1}},{"line":517,"address":[1744978,1744949,1744921],"length":1,"stats":{"Line":2}},{"line":518,"address":[1745008,1744955],"length":1,"stats":{"Line":2}},{"line":520,"address":[1745024],"length":1,"stats":{"Line":1}},{"line":522,"address":[1725120],"length":1,"stats":{"Line":1}},{"line":527,"address":[1726066],"length":1,"stats":{"Line":1}},{"line":528,"address":[1726137],"length":1,"stats":{"Line":1}},{"line":530,"address":[1726724],"length":1,"stats":{"Line":1}},{"line":531,"address":[1727006],"length":1,"stats":{"Line":1}},{"line":537,"address":[1727055],"length":1,"stats":{"Line":1}},{"line":539,"address":[1745072,1745096],"length":1,"stats":{"Line":1}},{"line":540,"address":[1745138,1745081,1745109],"length":1,"stats":{"Line":2}},{"line":542,"address":[1745168,1745115],"length":1,"stats":{"Line":2}},{"line":544,"address":[1745184],"length":1,"stats":{"Line":1}},{"line":546,"address":[1727129],"length":1,"stats":{"Line":1}},{"line":551,"address":[1728067],"length":1,"stats":{"Line":1}},{"line":552,"address":[1728138],"length":1,"stats":{"Line":1}},{"line":553,"address":[1728725],"length":1,"stats":{"Line":1}},{"line":554,"address":[1729007],"length":1,"stats":{"Line":1}},{"line":563,"address":[1729056],"length":1,"stats":{"Line":1}},{"line":564,"address":[1729087],"length":1,"stats":{"Line":1}},{"line":565,"address":[1729122],"length":1,"stats":{"Line":1}},{"line":568,"address":[1745327,1745232],"length":1,"stats":{"Line":1}},{"line":577,"address":[1745312,1745366,1745340],"length":1,"stats":{"Line":2}},{"line":578,"address":[1745403,1745351,1745429],"length":1,"stats":{"Line":2}},{"line":579,"address":[1745492,1745414,1745466],"length":1,"stats":{"Line":2}},{"line":580,"address":[1745477,1745557,1745529],"length":1,"stats":{"Line":2}},{"line":581,"address":[1745540,1745600],"length":1,"stats":{"Line":2}},{"line":582,"address":[1745610],"length":1,"stats":{"Line":1}},{"line":583,"address":[1745743],"length":1,"stats":{"Line":1}},{"line":584,"address":[1745856,1745907],"length":1,"stats":{"Line":1}},{"line":586,"address":[1745940],"length":1,"stats":{"Line":1}},{"line":588,"address":[1745981],"length":1,"stats":{"Line":1}},{"line":596,"address":[1746018],"length":1,"stats":{"Line":1}},{"line":597,"address":[1746084,1746158],"length":1,"stats":{"Line":1}},{"line":599,"address":[1746117],"length":1,"stats":{"Line":1}},{"line":602,"address":[1746196],"length":1,"stats":{"Line":1}},{"line":610,"address":[1746233],"length":1,"stats":{"Line":1}},{"line":611,"address":[1746373,1746299],"length":1,"stats":{"Line":1}},{"line":613,"address":[1746332],"length":1,"stats":{"Line":1}},{"line":616,"address":[1746406,1746347],"length":1,"stats":{"Line":2}},{"line":619,"address":[1746425],"length":1,"stats":{"Line":1}},{"line":622,"address":[1729169],"length":1,"stats":{"Line":1}},{"line":629,"address":[1746524,1746448],"length":1,"stats":{"Line":0}},{"line":634,"address":[1746484,1746537,1746563],"length":1,"stats":{"Line":0}},{"line":635,"address":[1746548,1746640,1746600],"length":1,"stats":{"Line":0}},{"line":637,"address":[1746683,1746860,1746611],"length":1,"stats":{"Line":0}},{"line":642,"address":[1746971],"length":1,"stats":{"Line":0}},{"line":644,"address":[1730151],"length":1,"stats":{"Line":1}},{"line":656,"address":[1730764],"length":1,"stats":{"Line":1}},{"line":657,"address":[1730795],"length":1,"stats":{"Line":1}},{"line":658,"address":[1730830],"length":1,"stats":{"Line":1}},{"line":659,"address":[1730865],"length":1,"stats":{"Line":1}},{"line":662,"address":[1747056,1747151],"length":1,"stats":{"Line":1}},{"line":671,"address":[1747164,1747136,1747190],"length":1,"stats":{"Line":2}},{"line":672,"address":[1747175,1747227,1747253],"length":1,"stats":{"Line":2}},{"line":673,"address":[1747318,1747238,1747290],"length":1,"stats":{"Line":2}},{"line":674,"address":[1747301,1747361],"length":1,"stats":{"Line":2}},{"line":675,"address":[1747371],"length":1,"stats":{"Line":1}},{"line":676,"address":[1747510],"length":1,"stats":{"Line":1}},{"line":677,"address":[1747623,1747668],"length":1,"stats":{"Line":1}},{"line":678,"address":[1747705,1747737,1747653],"length":1,"stats":{"Line":2}},{"line":680,"address":[1747770],"length":1,"stats":{"Line":1}},{"line":682,"address":[1747811],"length":1,"stats":{"Line":1}},{"line":690,"address":[1747848],"length":1,"stats":{"Line":1}},{"line":691,"address":[1747914,1747988],"length":1,"stats":{"Line":1}},{"line":693,"address":[1747947],"length":1,"stats":{"Line":1}},{"line":696,"address":[1748026],"length":1,"stats":{"Line":1}},{"line":704,"address":[1748063],"length":1,"stats":{"Line":1}},{"line":705,"address":[1748129,1748203],"length":1,"stats":{"Line":1}},{"line":707,"address":[1748162],"length":1,"stats":{"Line":1}},{"line":710,"address":[1748241],"length":1,"stats":{"Line":1}},{"line":718,"address":[1748278],"length":1,"stats":{"Line":1}},{"line":719,"address":[1748344,1748418],"length":1,"stats":{"Line":1}},{"line":721,"address":[1748377],"length":1,"stats":{"Line":1}},{"line":724,"address":[1748451,1748392],"length":1,"stats":{"Line":2}},{"line":727,"address":[1748470],"length":1,"stats":{"Line":1}},{"line":730,"address":[1730912],"length":1,"stats":{"Line":1}},{"line":737,"address":[1748572,1748496],"length":1,"stats":{"Line":0}},{"line":742,"address":[1748585,1748532,1748611],"length":1,"stats":{"Line":0}},{"line":743,"address":[1748688,1748648,1748596],"length":1,"stats":{"Line":0}},{"line":745,"address":[1748908,1748659,1748731],"length":1,"stats":{"Line":0}},{"line":750,"address":[1749019],"length":1,"stats":{"Line":0}},{"line":752,"address":[1731561],"length":1,"stats":{"Line":1}},{"line":759,"address":[1732174],"length":1,"stats":{"Line":1}},{"line":760,"address":[1732466,1732182,1732525],"length":1,"stats":{"Line":3}},{"line":761,"address":[1732649],"length":1,"stats":{"Line":1}},{"line":763,"address":[1732748],"length":1,"stats":{"Line":1}},{"line":765,"address":[1732760],"length":1,"stats":{"Line":1}},{"line":766,"address":[1732776],"length":1,"stats":{"Line":1}},{"line":767,"address":[1732792],"length":1,"stats":{"Line":1}},{"line":768,"address":[1732819],"length":1,"stats":{"Line":1}},{"line":772,"address":[1732879],"length":1,"stats":{"Line":1}},{"line":773,"address":[1733307],"length":1,"stats":{"Line":1}},{"line":777,"address":[1733087,1732901],"length":1,"stats":{"Line":0}},{"line":781,"address":[1733213],"length":1,"stats":{"Line":0}},{"line":782,"address":[1733288],"length":1,"stats":{"Line":0}},{"line":785,"address":[1732506,1733320],"length":1,"stats":{"Line":1}},{"line":787,"address":[1733348],"length":1,"stats":{"Line":1}},{"line":788,"address":[1733508],"length":1,"stats":{"Line":1}},{"line":789,"address":[1743967],"length":1,"stats":{"Line":1}},{"line":796,"address":[1733360],"length":1,"stats":{"Line":1}},{"line":799,"address":[1749104,1749165],"length":1,"stats":{"Line":1}},{"line":805,"address":[1749178,1749204,1749150],"length":1,"stats":{"Line":2}},{"line":806,"address":[1749241,1749269,1749189],"length":1,"stats":{"Line":2}},{"line":807,"address":[1749312,1749252],"length":1,"stats":{"Line":2}},{"line":808,"address":[1749322],"length":1,"stats":{"Line":1}},{"line":809,"address":[1749449],"length":1,"stats":{"Line":1}},{"line":811,"address":[1749557],"length":1,"stats":{"Line":1}},{"line":813,"address":[1749602],"length":1,"stats":{"Line":1}},{"line":816,"address":[1733403],"length":1,"stats":{"Line":1}},{"line":821,"address":[1733893],"length":1,"stats":{"Line":1}},{"line":822,"address":[1733995],"length":1,"stats":{"Line":1}},{"line":831,"address":[1734665,1734888],"length":1,"stats":{"Line":2}},{"line":832,"address":[1735144],"length":1,"stats":{"Line":1}},{"line":833,"address":[1742836],"length":1,"stats":{"Line":1}},{"line":844,"address":[1734929],"length":1,"stats":{"Line":1}},{"line":845,"address":[1734966],"length":1,"stats":{"Line":1}},{"line":848,"address":[1749632,1749714],"length":1,"stats":{"Line":1}},{"line":856,"address":[1749753,1749699,1749727],"length":1,"stats":{"Line":2}},{"line":857,"address":[1749738,1749790,1749816],"length":1,"stats":{"Line":2}},{"line":858,"address":[1749801,1749853,1749881],"length":1,"stats":{"Line":2}},{"line":859,"address":[1749864,1749924],"length":1,"stats":{"Line":2}},{"line":860,"address":[1749934],"length":1,"stats":{"Line":1}},{"line":861,"address":[1750061],"length":1,"stats":{"Line":1}},{"line":864,"address":[1750173],"length":1,"stats":{"Line":1}},{"line":866,"address":[1750217],"length":1,"stats":{"Line":1}},{"line":868,"address":[1735039],"length":1,"stats":{"Line":1}},{"line":875,"address":[1750272,1750348],"length":1,"stats":{"Line":0}},{"line":880,"address":[1750387,1750361,1750308],"length":1,"stats":{"Line":0}},{"line":881,"address":[1750372,1750424,1750464],"length":1,"stats":{"Line":0}},{"line":884,"address":[1750507,1750435,1750684],"length":1,"stats":{"Line":0}},{"line":888,"address":[1750795],"length":1,"stats":{"Line":0}},{"line":890,"address":[1735565],"length":1,"stats":{"Line":1}},{"line":897,"address":[1750880,1750973],"length":1,"stats":{"Line":1}},{"line":906,"address":[1750986,1750958,1751012],"length":1,"stats":{"Line":2}},{"line":907,"address":[1751075,1751049,1750997],"length":1,"stats":{"Line":2}},{"line":908,"address":[1751112,1751138,1751060],"length":1,"stats":{"Line":2}},{"line":909,"address":[1751123,1751175,1751203],"length":1,"stats":{"Line":2}},{"line":910,"address":[1751186,1751246],"length":1,"stats":{"Line":2}},{"line":911,"address":[1751256],"length":1,"stats":{"Line":1}},{"line":912,"address":[1751383],"length":1,"stats":{"Line":1}},{"line":914,"address":[1751495],"length":1,"stats":{"Line":1}},{"line":915,"address":[1751539],"length":1,"stats":{"Line":1}},{"line":917,"address":[1736214],"length":1,"stats":{"Line":1}},{"line":924,"address":[1751676,1751600],"length":1,"stats":{"Line":0}},{"line":929,"address":[1751636,1751715,1751689],"length":1,"stats":{"Line":0}},{"line":930,"address":[1751752,1751792,1751700],"length":1,"stats":{"Line":0}},{"line":933,"address":[1752012,1751763,1751835],"length":1,"stats":{"Line":0}},{"line":937,"address":[1752123],"length":1,"stats":{"Line":0}},{"line":939,"address":[1736863],"length":1,"stats":{"Line":1}},{"line":946,"address":[1737476],"length":1,"stats":{"Line":1}},{"line":947,"address":[1737484,1737768,1737827],"length":1,"stats":{"Line":3}},{"line":948,"address":[1737951],"length":1,"stats":{"Line":1}},{"line":950,"address":[1738050],"length":1,"stats":{"Line":1}},{"line":953,"address":[1738062],"length":1,"stats":{"Line":1}},{"line":954,"address":[1738078],"length":1,"stats":{"Line":1}},{"line":955,"address":[1738093],"length":1,"stats":{"Line":1}},{"line":956,"address":[1738108],"length":1,"stats":{"Line":1}},{"line":957,"address":[1738135],"length":1,"stats":{"Line":1}},{"line":962,"address":[1738203],"length":1,"stats":{"Line":1}},{"line":963,"address":[1738631],"length":1,"stats":{"Line":1}},{"line":967,"address":[1738225,1738411],"length":1,"stats":{"Line":0}},{"line":971,"address":[1738537],"length":1,"stats":{"Line":0}},{"line":972,"address":[1738612],"length":1,"stats":{"Line":0}},{"line":975,"address":[1738644,1737808],"length":1,"stats":{"Line":1}},{"line":977,"address":[1738672],"length":1,"stats":{"Line":1}},{"line":978,"address":[1738935],"length":1,"stats":{"Line":1}},{"line":979,"address":[1741705],"length":1,"stats":{"Line":1}},{"line":985,"address":[1738802,1738733],"length":1,"stats":{"Line":2}},{"line":986,"address":[1738814,1739035],"length":1,"stats":{"Line":2}},{"line":997,"address":[1739085,1739152],"length":1,"stats":{"Line":2}},{"line":1001,"address":[1739171,1739393,1741220],"length":1,"stats":{"Line":1}},{"line":1002,"address":[1741199,1739536,1739378,1739446],"length":1,"stats":{"Line":2}},{"line":1004,"address":[1739581,1739510],"length":1,"stats":{"Line":2}},{"line":1006,"address":[1739731,1718621,1741178,1739600],"length":1,"stats":{"Line":2}},{"line":1007,"address":[1739701],"length":1,"stats":{"Line":1}},{"line":1008,"address":[1739784],"length":1,"stats":{"Line":1}},{"line":1009,"address":[1739831],"length":1,"stats":{"Line":1}},{"line":1010,"address":[1739839],"length":1,"stats":{"Line":1}},{"line":1011,"address":[1739865,1739977],"length":1,"stats":{"Line":2}},{"line":1013,"address":[1740155,1740226],"length":1,"stats":{"Line":0}},{"line":1015,"address":[1740181],"length":1,"stats":{"Line":1}},{"line":1016,"address":[1740258,1740197],"length":1,"stats":{"Line":2}},{"line":1017,"address":[1740394],"length":1,"stats":{"Line":1}},{"line":1019,"address":[1740519],"length":1,"stats":{"Line":1}},{"line":1021,"address":[1740705],"length":1,"stats":{"Line":1}},{"line":1022,"address":[1740774],"length":1,"stats":{"Line":1}},{"line":1024,"address":[1740787,1740024,1740952],"length":1,"stats":{"Line":0}},{"line":1030,"address":[1739888,1741061],"length":1,"stats":{"Line":2}},{"line":1031,"address":[1741088],"length":1,"stats":{"Line":1}},{"line":1033,"address":[1741097],"length":1,"stats":{"Line":1}}],"covered":254,"coverable":287},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","cgosling-proc-macros","src","lib.rs"],"content":"use proc_macro::TokenStream;\nuse quote::quote;\nuse syn::{parse_macro_input, ItemFn};\n\n// This macro renames a function call to a _impl variant.\n//\n// Why is this necessary? Basically, cargo  cannot currently be relied\n// on to build cdylibs correctly due to various issues limited to but\n// probably not including:\n// - not setting soname for linux shared libraries\n// - naming import libs incorrectly for mingw windows\n// - not generating correct symlinks based on version and major version for linux and macos\n//\n// The recommended solution is to use the cdylib_link_lines crate to work around\n// some of these problems, but I've run into other fun issues with that crate:\n// - import libs output to wrong directory for mingw windows\n// - import_name being set incorrectly for macos\n// - hasn't been updated in some years and seems abandoned\n//\n// So now dear reader, we come to this monstrosity. This is just one part of\n// the rest of the build system hack to solve all the above problems; namely\n// we will only use rustc to generate a static library, and from there build\n// a shared library using native C tools via CMake which handles all of the\n// above problems.\n//\n// So we need to build our cgosling crate as a static lib twice: first with the\n// ordinary functions names and second with the functions renamed in the form\n// foo() to foo_impl(). The foo_impl() variant will then be linked into a shared\n// library and called through exported functions of the foo() variety using\n// the ordinary toolchain.\n//\n// The cgosling shared library target will call the underlying functions via simple\n// passthrough with the final (logical) call chain being like a so:\n// - shared_library::foo() -\u003e static_library::foo_impl()\n//\n// Static library callers will have the following call chain:\n// - static_library::foo()\n//\n// I'm sorry it had to be this way\n#[proc_macro_attribute]\npub fn rename_impl(_attr: TokenStream, item: TokenStream) -\u003e TokenStream {\n    // parse the input as a function\n    let mut impl_fn: ItemFn = parse_macro_input!(item);\n\n    // append \"_impl\" to the original function name for the _impl function\n    impl_fn.sig.ident = syn::Ident::new(\n        \u0026format!(\"{}_impl\", impl_fn.sig.ident),\n        impl_fn.sig.ident.span(),\n    );\n\n    let expanded = quote! {\n        #impl_fn\n    };\n\n    // Return the combined TokenStream\n    TokenStream::from(expanded)\n}\n","traces":[{"line":41,"address":[259264,260226,260342],"length":1,"stats":{"Line":0}},{"line":43,"address":[259290,260235,259516,259338],"length":1,"stats":{"Line":0}},{"line":46,"address":[259866,259986],"length":1,"stats":{"Line":0}},{"line":47,"address":[259748,259619,259417],"length":1,"stats":{"Line":0}},{"line":48,"address":[259829],"length":1,"stats":{"Line":0}},{"line":51,"address":[260037],"length":1,"stats":{"Line":0}},{"line":56,"address":[260156],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":7},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","fuzz","fuzz_targets","arbitrary_types.rs"],"content":"// extern\nuse bson::Document;\nuse bson::spec::BinarySubtype::Generic;\nuse curve25519_dalek::Scalar;\nuse tor_interface::tor_crypto::*;\n\n// fuzzing\nuse libfuzzer_sys::arbitrary;\nuse libfuzzer_sys::arbitrary::{Arbitrary, Error, Unstructured};\n\n// Generate Arbitray Types\n\n// Ed25519 Private Key\n#[derive(Debug)]\npub(crate) struct ArbitraryEd25519PrivateKey {\n    pub value: Ed25519PrivateKey,\n}\n\nimpl\u003c'a\u003e Arbitrary\u003c'a\u003e for ArbitraryEd25519PrivateKey {\n    fn arbitrary(u: \u0026mut Unstructured\u003c'a\u003e) -\u003e Result\u003cSelf, Error\u003e {\n        // expanded secret key raw bytes\n        let mut raw: [u8; 64] = [0u8; 64];\n\n        // construct a valid Scalar\n        let mut scalar: [u8; 32] = [0u8; 32];\n        u.fill_buffer(\u0026mut scalar)?;\n\n        scalar = curve25519_dalek::scalar::clamp_integer(scalar.clone());\n        scalar = Scalar::from_bytes_mod_order(scalar).to_bytes();\n        raw[00..32].copy_from_slice(\u0026scalar);\n\n        let mut hash: [u8; 32] = [0u8; 32];\n        u.fill_buffer(\u0026mut hash)?;\n\n        raw[32..64].copy_from_slice(\u0026hash);\n\n        let value = Ed25519PrivateKey::from_raw(\u0026raw).unwrap();\n\n        Ok(ArbitraryEd25519PrivateKey{value})\n    }\n}\n\n// Ed25519 Public Key\n#[derive(Debug)]\npub(crate) struct ArbitraryEd25519PublicKey {\n    pub value: Ed25519PublicKey,\n}\n\nimpl\u003c'a\u003e Arbitrary\u003c'a\u003e for ArbitraryEd25519PublicKey {\n    fn arbitrary(u: \u0026mut Unstructured\u003c'a\u003e) -\u003e Result\u003cSelf, Error\u003e {\n        let private = ArbitraryEd25519PrivateKey::arbitrary(u)?;\n        let value = Ed25519PublicKey::from_private_key(\u0026private.value);\n\n        Ok(ArbitraryEd25519PublicKey{value})\n    }\n}\n\n// Ed25519 Signature\n#[derive(Debug)]\npub(crate) struct ArbitraryEd25519Signature {\n    pub value: Ed25519Signature,\n}\n\nimpl\u003c'a\u003e Arbitrary\u003c'a\u003e for ArbitraryEd25519Signature {\n    fn arbitrary(u: \u0026mut Unstructured\u003c'a\u003e) -\u003e Result\u003cSelf, Error\u003e {\n        let mut message: [u8; 32] = [0u8; 32];\n        u.fill_buffer(\u0026mut message)?;\n\n        let private = ArbitraryEd25519PrivateKey::arbitrary(u)?;\n        let value = private.value.sign_message(\u0026message);\n\n        Ok(ArbitraryEd25519Signature{value})\n    }\n}\n\n// V3OnionServicId\n// x25519 Private Key\n#[derive(Debug)]\npub(crate) struct ArbitraryV3OnionServiceId {\n    pub value: V3OnionServiceId,\n}\n\nimpl\u003c'a\u003e Arbitrary\u003c'a\u003e for ArbitraryV3OnionServiceId {\n    fn arbitrary(u: \u0026mut Unstructured\u003c'a\u003e) -\u003e Result\u003cSelf, Error\u003e {\n        let private = ArbitraryEd25519PrivateKey::arbitrary(u)?;\n        let value = V3OnionServiceId::from_private_key(\u0026private.value);\n\n        Ok(ArbitraryV3OnionServiceId{value})\n    }\n}\n\n// x25519 Private Key\n#[derive(Debug)]\npub(crate) struct ArbitraryX25519PrivateKey {\n    pub value: X25519PrivateKey,\n}\n\nimpl\u003c'a\u003e Arbitrary\u003c'a\u003e for ArbitraryX25519PrivateKey {\n    fn arbitrary(u: \u0026mut Unstructured\u003c'a\u003e) -\u003e Result\u003cSelf, Error\u003e {\n        let mut raw: [u8; 32] = [0u8; 32];\n        u.fill_buffer(\u0026mut raw)?;\n\n        raw[0] \u0026= 240;\n        raw[31] \u0026= 127;\n        raw[31] |= 64;\n\n        let value = X25519PrivateKey::from_raw(\u0026raw).unwrap();\n\n        Ok(ArbitraryX25519PrivateKey{value})\n    }\n}\n\n// x25519 Public Key\n#[derive(Debug)]\npub(crate) struct ArbitraryX25519PublicKey {\n    pub value: X25519PublicKey,\n}\n\nimpl\u003c'a\u003e Arbitrary\u003c'a\u003e for ArbitraryX25519PublicKey {\n    fn arbitrary(u: \u0026mut Unstructured\u003c'a\u003e) -\u003e Result\u003cSelf, Error\u003e {\n        let mut raw: [u8; 32] = [0u8; 32];\n        u.fill_buffer(\u0026mut raw)?;\n\n        let value = X25519PublicKey::from_raw(\u0026raw);\n\n        Ok(ArbitraryX25519PublicKey{value})\n    }\n}\n\n// Bson\n#[derive(Debug)]\npub(crate) struct ArbitraryBSON {\n    pub value: bson::Bson,\n}\n\nimpl\u003c'a\u003e Arbitrary\u003c'a\u003e for ArbitraryBSON {\n    fn arbitrary(u: \u0026mut Unstructured\u003c'a\u003e) -\u003e Result\u003cSelf, Error\u003e {\n        #[derive(Arbitrary)]\n        enum BSONType {\n            Null, // 0\n            Boolean, // 1\n            Int32, // 2\n            Int64, // 3\n            Double, // 4\n            String, // 5\n            Binary, // 6\n            Array, // 7\n            Document, // 8\n        }\n\n        let value = match BSONType::arbitrary(u)? {\n            BSONType::Null =\u003e bson::Bson::Null,\n            BSONType::Boolean =\u003e bson::Bson::Boolean(bool::arbitrary(u)?),\n            BSONType::Int32 =\u003e bson::Bson::Int32(i32::arbitrary(u)?),\n            BSONType::Int64 =\u003e bson::Bson::Int64(i64::arbitrary(u)?),\n            BSONType::Double =\u003e bson::Bson::Double(f64::arbitrary(u)?),\n            BSONType::String =\u003e {\n                match std::ffi::CString::arbitrary(u)?.into_string() {\n                    Ok(value) =\u003e bson::Bson::String(value),\n                    Err(_) =\u003e bson::Bson::Null,\n                }\n            },\n            BSONType::Binary =\u003e bson::Bson::Binary(bson::Binary {subtype: Generic, bytes: Vec::\u003cu8\u003e::arbitrary(u)?}),\n            BSONType::Array =\u003e bson::Bson::Array(Vec::\u003cArbitraryBSON\u003e::arbitrary(u)?.drain(..).map(|val| val.value).collect()),\n            BSONType::Document =\u003e bson::Bson::Document(ArbitraryBSONDocument::arbitrary(u)?.value),\n        };\n\n        Ok(ArbitraryBSON{value})\n    }\n}\n\n#[derive(Debug)]\npub(crate) struct ArbitraryBSONDocument {\n    pub value: Document,\n}\n\nimpl\u003c'a\u003e Arbitrary\u003c'a\u003e for ArbitraryBSONDocument {\n    fn arbitrary(u: \u0026mut Unstructured\u003c'a\u003e) -\u003e Result\u003cSelf, Error\u003e {\n        let mut value = Document::new();\n        for key in Vec::\u003cstd::ffi::CString\u003e::arbitrary(u)?.drain(..) {\n            match key.into_string() {\n                Ok(key) =\u003e value.insert(key, ArbitraryBSON::arbitrary(u)?.value),\n                Err(_) =\u003e None,\n            };\n        }\n        Ok(ArbitraryBSONDocument{value})\n    }\n}\n\n// argument for a bson doc\n#[derive(Arbitrary, Debug)]\npub(crate) enum Argument\u003cT\u003e {\n    // no value\n    Missing,\n    // a valid value\n    Valid,\n    // an invalid value of the same type\n    Invalid(T),\n    // an invalid value of an arbitrary type\n    Random(ArbitraryBSON),\n}","traces":[{"line":20,"address":[],"length":0,"stats":{"Line":0}},{"line":22,"address":[],"length":0,"stats":{"Line":0}},{"line":25,"address":[],"length":0,"stats":{"Line":0}},{"line":26,"address":[],"length":0,"stats":{"Line":0}},{"line":28,"address":[],"length":0,"stats":{"Line":0}},{"line":29,"address":[],"length":0,"stats":{"Line":0}},{"line":30,"address":[],"length":0,"stats":{"Line":0}},{"line":32,"address":[],"length":0,"stats":{"Line":0}},{"line":33,"address":[],"length":0,"stats":{"Line":0}},{"line":35,"address":[],"length":0,"stats":{"Line":0}},{"line":37,"address":[],"length":0,"stats":{"Line":0}},{"line":39,"address":[],"length":0,"stats":{"Line":0}},{"line":50,"address":[],"length":0,"stats":{"Line":0}},{"line":51,"address":[],"length":0,"stats":{"Line":0}},{"line":52,"address":[],"length":0,"stats":{"Line":0}},{"line":54,"address":[],"length":0,"stats":{"Line":0}},{"line":65,"address":[],"length":0,"stats":{"Line":0}},{"line":66,"address":[],"length":0,"stats":{"Line":0}},{"line":67,"address":[],"length":0,"stats":{"Line":0}},{"line":69,"address":[],"length":0,"stats":{"Line":0}},{"line":70,"address":[],"length":0,"stats":{"Line":0}},{"line":72,"address":[],"length":0,"stats":{"Line":0}},{"line":84,"address":[],"length":0,"stats":{"Line":0}},{"line":85,"address":[],"length":0,"stats":{"Line":0}},{"line":86,"address":[],"length":0,"stats":{"Line":0}},{"line":88,"address":[],"length":0,"stats":{"Line":0}},{"line":99,"address":[],"length":0,"stats":{"Line":0}},{"line":100,"address":[],"length":0,"stats":{"Line":0}},{"line":101,"address":[],"length":0,"stats":{"Line":0}},{"line":103,"address":[],"length":0,"stats":{"Line":0}},{"line":104,"address":[],"length":0,"stats":{"Line":0}},{"line":105,"address":[],"length":0,"stats":{"Line":0}},{"line":107,"address":[],"length":0,"stats":{"Line":0}},{"line":109,"address":[],"length":0,"stats":{"Line":0}},{"line":120,"address":[],"length":0,"stats":{"Line":0}},{"line":121,"address":[],"length":0,"stats":{"Line":0}},{"line":122,"address":[],"length":0,"stats":{"Line":0}},{"line":124,"address":[],"length":0,"stats":{"Line":0}},{"line":126,"address":[],"length":0,"stats":{"Line":0}},{"line":137,"address":[],"length":0,"stats":{"Line":0}},{"line":151,"address":[],"length":0,"stats":{"Line":0}},{"line":152,"address":[],"length":0,"stats":{"Line":0}},{"line":153,"address":[],"length":0,"stats":{"Line":0}},{"line":154,"address":[],"length":0,"stats":{"Line":0}},{"line":155,"address":[],"length":0,"stats":{"Line":0}},{"line":156,"address":[],"length":0,"stats":{"Line":0}},{"line":157,"address":[],"length":0,"stats":{"Line":0}},{"line":158,"address":[],"length":0,"stats":{"Line":0}},{"line":159,"address":[],"length":0,"stats":{"Line":0}},{"line":160,"address":[],"length":0,"stats":{"Line":0}},{"line":163,"address":[],"length":0,"stats":{"Line":0}},{"line":164,"address":[],"length":0,"stats":{"Line":0}},{"line":165,"address":[],"length":0,"stats":{"Line":0}},{"line":168,"address":[],"length":0,"stats":{"Line":0}},{"line":178,"address":[],"length":0,"stats":{"Line":0}},{"line":179,"address":[],"length":0,"stats":{"Line":0}},{"line":180,"address":[],"length":0,"stats":{"Line":0}},{"line":181,"address":[],"length":0,"stats":{"Line":0}},{"line":182,"address":[],"length":0,"stats":{"Line":0}},{"line":183,"address":[],"length":0,"stats":{"Line":0}},{"line":186,"address":[],"length":0,"stats":{"Line":0}}],"covered":0,"coverable":61},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","fuzz","fuzz_targets","fuzz_endpoint_client.rs"],"content":"#![no_main]\n\n// std\nuse std::io::{Cursor, Write};\nuse std::net::TcpStream;\nuse std::time::Duration;\n\n// gosling\nuse ::gosling::*;\nuse context::*;\n\n// extern\nuse bson::Bson;\nuse bson::Document;\nuse bson::doc;\nuse bson::spec::BinarySubtype;\n\nuse tor_interface::mock_tor_client::*;\nuse tor_interface::tor_crypto::*;\nuse tor_interface::tor_provider::*;\n\n// fuzzing\nuse libfuzzer_sys::fuzz_target;\nuse libfuzzer_sys::arbitrary;\nuse libfuzzer_sys::arbitrary::Arbitrary;\n\nmod arbitrary_types;\nuse crate::arbitrary_types::*;\n\nmod utils;\nuse crate::utils::*;\n\n#[derive(Arbitrary, Debug)]\nstruct ErrorSection {\n    cookie: Argument\u003ci64\u003e,\n    code: Argument\u003ci32\u003e,\n}\n\n#[derive(Arbitrary, Debug)]\nstruct ResponseSection {\n    cookie: Argument\u003ci64\u003e,\n    state: Argument\u003ci32\u003e,\n    result: Argument\u003cArbitraryBSON\u003e,\n}\n\n#[derive(Arbitrary, Debug)]\nenum Response {\n    Noise(Vec\u003cu8\u003e),\n    Document(ArbitraryBSONDocument),\n    HonkRPC {\n        single_message: bool,\n        pending: Option\u003cResponseSection\u003e,\n        complete: Option\u003cResponseSection\u003e,\n        error: Option\u003cErrorSection\u003e,\n    },\n}\n\n\n#[derive(Arbitrary, Debug)]\nstruct HandshakeData {\n    // server data\n    alice_private_ed25519: ArbitraryEd25519PrivateKey,\n    alice_endpoint_ed25519: ArbitraryEd25519PrivateKey,\n    server_cookie: Cookie,\n\n    // client data\n    bob_private_ed25519: ArbitraryEd25519PrivateKey,\n    bob_private_x25519: ArbitraryX25519PrivateKey,\n\n    begin_handshake_response: Response,\n    send_response_response: Response,\n}\n\n// two gosling instance, Alice and Bob\n// Alice is a malicious/broken server, Bob is a valid client\nfuzz_target!(|data: HandshakeData| {\n\n    // Bob client data\n    let bob_private_key = data.bob_private_ed25519.value;\n    let bob_service_id = V3OnionServiceId::from_private_key(\u0026bob_private_key);\n    let bob_service_id_string = bob_service_id.to_string();\n    let bob_private_x25519 = data.bob_private_x25519.value;\n    let bob_public_x25519 = X25519PublicKey::from_private_key(\u0026bob_private_x25519);\n\n    // Alice server data\n    let alice_private_key = data.alice_private_ed25519.value;\n    let alice_onion_service_id = V3OnionServiceId::from_private_key(\u0026alice_private_key);\n    let alice_onion_service_id_string = alice_onion_service_id.to_string();\n    let alice_endpoint_ed25519 = data.alice_endpoint_ed25519.value;\n    let alice_endpoint_onion_service_id = V3OnionServiceId::from_private_key(\u0026alice_endpoint_ed25519);\n    let alice_endpoint_onion_service_id_string = alice_endpoint_onion_service_id.to_string();\n\n    //\n    // Init malicious Alice server and Bob client\n    //\n\n    // init alice\n    let mut alice_tor = MockTorClient::new();\n\n    // bootstrap alice\n    alice_tor.bootstrap().unwrap();\n    let mut bootstrap_complete = false;\n    while !bootstrap_complete {\n        for event in alice_tor.update().unwrap().drain(..) {\n            match event {\n                TorEvent::BootstrapComplete =\u003e {\n                    bootstrap_complete = true;\n                }\n                _ =\u003e ()\n            }\n        }\n    }\n\n\n    let alice_listener = alice_tor.listener(\u0026alice_endpoint_ed25519, 420, Some(\u0026[bob_public_x25519])).unwrap();\n    let mut identity_server_published: bool = false;\n    while !identity_server_published {\n        for event in alice_tor.update().unwrap().drain(..) {\n            match event {\n                TorEvent::OnionServicePublished{service_id} =\u003e {\n                    assert_eq!(service_id, alice_endpoint_onion_service_id);\n                    identity_server_published = true;\n                },\n                _ =\u003e ()\n            }\n        }\n    }\n\n    // init bob\n    let bob_tor = MockTorClient::new();\n\n    // create bob gosling context\n    let mut bob = Context::new(Box::new(bob_tor), 420, 420, std::time::Duration::from_millis(32), IDENTITY_MAX_MESSAGE_SIZE, Some(std::time::Duration::from_millis(32)), bob_private_key).unwrap();\n    bob.bootstrap().unwrap();\n    let mut bootstrap_complete: bool = false;\n    while !bootstrap_complete {\n        for event in bob.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::TorBootstrapStatusReceived{progress: _, tag: _, summary: _} =\u003e (),\n                ContextEvent::TorBootstrapCompleted =\u003e {\n                    bootstrap_complete = true;\n                }\n                ContextEvent::TorLogReceived{line: _} =\u003e (),\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n    //\n    // Bob initiates handshake\n    //\n    let handshake_handle = bob.endpoint_client_begin_handshake(alice_endpoint_onion_service_id.clone(), bob_private_x25519, VALID_CHANNEL.to_string()).unwrap();\n    // first update to queue the HonkRPC call\n    assert_eq!(0, bob.update().unwrap().len());\n    // second upate sends the HonkRPC message\n    assert_eq!(0, bob.update().unwrap().len());\n\n    // alice waits for connect, return OnionStream\n    let mut alice_stream : TcpStream = match alice_listener.accept().unwrap() {\n        Some(stream) =\u003e stream.into(),\n        None =\u003e panic!(\"listener accept failed\"),\n    };\n    alice_stream.set_nonblocking(false).unwrap();\n    alice_stream.set_read_timeout(Some(Duration::from_millis(100u64))).unwrap();\n\n\n    //\n    // Alice receives begin_handshake() and build responses\n    //\n\n    let begin_handshake_cookie = {\n        let honkrpc_msg = bson::document::Document::from_reader(\u0026mut alice_stream).unwrap();\n        assert_eq!(honkrpc_msg.get_i32(\"honk_rpc\").unwrap(), HONK_RPC);\n        let sections = honkrpc_msg.get_array(\"sections\").unwrap();\n        assert_eq!(sections.len(), 1);\n        let honkrpc_request = match \u0026sections[0] {\n            Bson::Document(document) =\u003e document,\n            bson =\u003e panic!(\"unexpected bson in sections array: {}\", bson),\n        };\n        assert_eq!(honkrpc_request.get_i32(\"id\").unwrap(), REQUEST_SECTION);\n        let begin_handshake_cookie = honkrpc_request.get_i64(\"cookie\").unwrap();\n        assert_eq!(honkrpc_request.get_str(\"namespace\").unwrap(), GOSLING_ENDPOINT_NAMESPACE);\n        assert_eq!(honkrpc_request.get_str(\"function\").unwrap(), GOSLING_ENDPOINT_BEGIN_HANDSHAKE_FUNCTION);\n        let arguments = honkrpc_request.get_document(\"arguments\").unwrap();\n        assert_eq!(arguments.get_str(\"client_identity\").unwrap(), bob_service_id_string);\n        assert_eq!(arguments.get_str(\"channel\").unwrap(), VALID_CHANNEL);\n        begin_handshake_cookie\n    };\n\n\n\n    // messages can be built such that multiple errors exist so lets track\n    // all the layers of possible errors\n    let mut expect_timeout: bool = false;\n    let mut expect_bson_parse_failure: bool = false;\n    let mut expect_bson_too_small: bool = false;\n    let mut expect_bson_too_large: bool = false;\n    let mut expect_honkrpc_message_parse_failure: bool = false;\n    let mut expect_gosling_unexpected_response: bool = false;\n    let mut expect_unknown_error_section: bool = false;\n\n    let message: Vec\u003cu8\u003e = match data.begin_handshake_response {\n        Response::Noise(bytes) =\u003e {\n            match bytes.len() {\n                0..=3 =\u003e expect_timeout = true,\n                len =\u003e {\n                    let size: i32 = (bytes[0] as i32)\n                                  | (bytes[1] as i32) \u003c\u003c 8\n                                  | (bytes[2] as i32) \u003c\u003c 16\n                                  | (bytes[3] as i32) \u003c\u003c 24;\n                    if size \u003c= 4 {\n                        expect_bson_too_small = true;\n                    } else if size \u003e ENDPOINT_MAX_MESSAGE_SIZE {\n                        expect_bson_too_large = true;\n                    } else if size as usize \u003e len {\n                        expect_timeout = true;\n                    } else {\n                        match bson::document::Document::from_reader(Cursor::new(bytes.clone())) {\n                            Ok(_) =\u003e expect_honkrpc_message_parse_failure = true,\n                            Err(_) =\u003e expect_bson_parse_failure = true,\n                        }\n                    }\n                }\n            };\n            bytes.clone()\n        },\n        Response::Document(document) =\u003e {\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            document.value.to_writer(\u0026mut bytes).unwrap();\n            if bytes.len() \u003e ENDPOINT_MAX_MESSAGE_SIZE as usize {\n                expect_bson_too_large = true;\n            } else {\n                expect_honkrpc_message_parse_failure = true;\n            }\n            bytes\n        },\n        Response::HonkRPC{single_message, pending, complete, error} =\u003e {\n            let mut sections: Vec\u003cDocument\u003e = Default::default();\n\n            // build our pending section\n            if let Some(pending) = pending {\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(RESPONSE_SECTION));\n\n                let cookie = match pending.cookie {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(begin_handshake_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == begin_handshake_cookie {\n                            Some(Bson::Int64(!cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int64(cookie) = bson.value {\n                            if cookie != begin_handshake_cookie {\n                                expect_gosling_unexpected_response = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n\n                        Some(bson.value)\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let state = match pending.state {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int32(PENDING_REQUEST_STATE)),\n                    Argument::Invalid(state) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if state == PENDING_REQUEST_STATE || state == COMPLETE_REQUEST_STATE {\n                            Some(Bson::Int32(!state))\n                        } else {\n                            Some(Bson::Int32(state))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int32(state) = bson.value {\n                            if state != PENDING_REQUEST_STATE \u0026\u0026 state != COMPLETE_REQUEST_STATE {\n                                expect_honkrpc_message_parse_failure = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n                        Some(bson.value)\n                    }\n                };\n                if let Some(state) = state {\n                    section.insert(\"state\", state);\n                }\n\n                let result = match pending.result {\n                    Argument::Missing =\u003e None,\n                    Argument::Valid =\u003e None,\n                    Argument::Invalid(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        Some(bson.value)\n                    }\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        Some(bson.value)\n                    }\n                };\n                if let Some(result) = result {\n                    section.insert(\"result\", result);\n                }\n\n                sections.push(section);\n            }\n            // build our complete section\n            if let Some(complete) = complete {\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(RESPONSE_SECTION));\n\n                let cookie = match complete.cookie {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(begin_handshake_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == begin_handshake_cookie {\n                            Some(Bson::Int64(!cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int64(cookie) = bson.value {\n                            if cookie != begin_handshake_cookie {\n                                expect_gosling_unexpected_response = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n\n                        Some(bson.value)\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let state = match complete.state {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int32(COMPLETE_REQUEST_STATE)),\n                    Argument::Invalid(state) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if state == PENDING_REQUEST_STATE || state == COMPLETE_REQUEST_STATE {\n                            Some(Bson::Int32(!state))\n                        } else {\n                            Some(Bson::Int32(state))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int32(state) = bson.value {\n                            if state == PENDING_REQUEST_STATE {\n                                expect_timeout = true;\n                            } else if state != COMPLETE_REQUEST_STATE {\n                                expect_honkrpc_message_parse_failure = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n                        Some(bson.value)\n                    }\n                };\n                if let Some(state) = state {\n                    section.insert(\"state\", state);\n                }\n\n                let result = match complete.result {\n                    Argument::Missing =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        None\n                    },\n                    Argument::Valid =\u003e {\n                        let mut result = Document::new();\n                        result.insert(\"server_cookie\", Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: data.server_cookie.to_vec()}));\n                        Some(Bson::Document(result))\n                    },\n                    Argument::Invalid(bson) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        Some(bson.value)\n                    }\n                    Argument::Random(bson) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        Some(bson.value)\n                    }\n                };\n                if let Some(result) = result {\n                    section.insert(\"result\", result);\n                }\n\n                sections.push(section);\n            } else if let Some(error) = error {\n                // build an error section if there's no complete section\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(ERROR_SECTION));\n\n                let cookie = match error.cookie {\n                    Argument::Missing =\u003e {\n                        expect_unknown_error_section = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(begin_handshake_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == begin_handshake_cookie {\n                            Some(Bson::Int64(!begin_handshake_cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if let Bson::Int64(value) = bson.value {\n                            Some(Bson::Null)\n                        } else {\n                            Some(bson.value)\n                        }\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let code = match error.code {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    }\n                    Argument::Valid =\u003e {\n                        // error success\n                        expect_gosling_unexpected_response = true;\n                        Some(Bson::Int32(0i32))\n                    },\n                    Argument::Invalid(code) =\u003e {\n                        // all i32 are somehow valid error codes\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if let Bson::Int32(value) = bson.value {\n                            Some(Bson::Null)\n                        } else {\n                            Some(bson.value)\n                        }\n                    }\n                };\n                if let Some(code) = code {\n                    section.insert(\"code\", code);\n                }\n\n                sections.push(section);\n            } else {\n                expect_timeout = true;\n            }\n\n            // convert sections into honk-rpc messages and serialize to byte vecs\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            if single_message {\n                let mut message = Document::new();\n                message.insert(\"honk_rpc\", HONK_RPC);\n\n                if sections.len() == 0 {\n                    expect_honkrpc_message_parse_failure = true;\n                }\n\n                message.insert(\"sections\", sections);\n\n                message.to_writer(\u0026mut bytes).unwrap();\n                if bytes.len() \u003e ENDPOINT_MAX_MESSAGE_SIZE as usize {\n                    expect_bson_too_large = true;\n                }\n            } else {\n                let mut bytes_written = 0usize;\n                for section in sections.drain(..) {\n                    let mut message = Document::new();\n                    message.insert(\"honk_rpc\", HONK_RPC);\n                    message.insert(\"sections\", vec![section]);\n\n                    message.to_writer(\u0026mut bytes).unwrap();\n\n                    if bytes.len() - bytes_written \u003e ENDPOINT_MAX_MESSAGE_SIZE as usize {\n                        expect_bson_too_large = true;\n                    }\n                    bytes_written = bytes.len();\n                }\n            }\n\n            bytes\n        },\n    };\n    alice_stream.write(message.as_slice()).unwrap();\n\n    //\n    // Bob receives begin_handshake() response and builds reply\n    //\n    for event in bob.update().unwrap().drain(..) {\n        match event {\n            ContextEvent::EndpointClientHandshakeFailed{handle, reason} =\u003e {\n                assert_eq!(handshake_handle, handle);\n                match reason {\n                    context::Error::EndpointClientError(\n                        endpoint_client::Error::HonkRPCFailure(\n                            honk_rpc::honk_rpc::Error::MessageReadTimedOut(_))) =\u003e {\n                        assert!(expect_timeout, \"{:?}\", reason);\n                    }\n                    context::Error::EndpointClientError(\n                        endpoint_client::Error::HonkRPCFailure(\n                            honk_rpc::honk_rpc::Error::BsonDocumentSizeTooSmall(_))) =\u003e {\n                        assert!(expect_bson_too_small, \"{:?}\", reason);\n                    },\n                    context::Error::EndpointClientError(\n                        endpoint_client::Error::HonkRPCFailure(\n                            honk_rpc::honk_rpc::Error::BsonDocumentSizeTooLarge(_, _))) =\u003e {\n                        assert!(expect_bson_too_large, \"{:?}\", reason);\n                    },\n                    context::Error::EndpointClientError(\n                        endpoint_client::Error::HonkRPCFailure(\n                            honk_rpc::honk_rpc::Error::MessageConversionFailed(_))) =\u003e {\n                        assert!(expect_honkrpc_message_parse_failure, \"{:?}\", reason);\n                    },\n                    context::Error::EndpointClientError(\n                        endpoint_client::Error::HonkRPCFailure(\n                            honk_rpc::honk_rpc::Error::UnknownErrorSectionReceived(_))) =\u003e {\n                        assert!(expect_unknown_error_section, \"{:?}\", reason);\n                    },\n                    context::Error::EndpointClientError(\n                        endpoint_client::Error::UnexpectedResponseReceived(_)) =\u003e {\n                        assert!(expect_gosling_unexpected_response, \"{:?}\", reason);\n                    },\n                    error =\u003e panic!(\"unexpected error: {:?}\", error),\n                }\n                // bob should have closed the connection on alice after handshake failure\n                return;\n            }\n            event =\u003e panic!(\"unexpected event: {:?}\", event),\n        }\n    }\n\n    // handle dangling unexpected response\n    for event in bob.update().unwrap().drain(..) {\n        match event {\n            ContextEvent::EndpointClientHandshakeFailed{handle, reason} =\u003e {\n                assert_eq!(handshake_handle, handle);\n                match reason {\n                    context::Error::EndpointClientError(\n                        endpoint_client::Error::UnexpectedResponseReceived(_)) =\u003e {\n                        assert!(expect_gosling_unexpected_response, \"{:?}\", reason);\n                    },\n                    error =\u003e panic!(\"unexpected error: {:?}\", error),\n                }\n                // bob should have closed the connection on alice after handshake failure\n                return;\n            }\n            event =\u003e panic!(\"unexpected event: {:?}\", event),\n        }\n    }\n    assert_eq!(0, bob.update().unwrap().len());\n\n    // give it a chance to timeout if it is mean to\n    while expect_timeout {\n        for event in bob.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::EndpointClientHandshakeFailed{handle, reason} =\u003e {\n                    assert_eq!(handshake_handle, handle);\n                    match reason {\n                        context::Error::EndpointClientError(\n                            endpoint_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageReadTimedOut(_))) =\u003e (),\n                        error =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n                    // bob should have closed the connection on alice after handshake failure\n                    return;\n                }\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n\n    // println!(\"expect_timeout: {}\", expect_timeout);\n\n    // Alice receives send_reponse() and builds response\n    let send_response_cookie = {\n        let honkrpc_msg = bson::document::Document::from_reader(\u0026mut alice_stream).unwrap();\n        assert_eq!(honkrpc_msg.get_i32(\"honk_rpc\").unwrap(), HONK_RPC);\n        let sections = honkrpc_msg.get_array(\"sections\").unwrap();\n        assert_eq!(sections.len(), 1);\n        let honkrpc_request = match \u0026sections[0] {\n            Bson::Document(document) =\u003e document,\n            bson =\u003e panic!(\"unexpected bson in sections array: {}\", bson),\n        };\n        assert_eq!(honkrpc_request.get_i32(\"id\").unwrap(), REQUEST_SECTION);\n        let send_response_cookie = honkrpc_request.get_i64(\"cookie\").unwrap();\n        assert_eq!(honkrpc_request.get_str(\"namespace\").unwrap(), GOSLING_ENDPOINT_NAMESPACE);\n        assert_eq!(honkrpc_request.get_str(\"function\").unwrap(), GOSLING_ENDPOINT_SEND_RESPONSE_FUNCTION);\n        let arguments = honkrpc_request.get_document(\"arguments\").unwrap();\n        let client_cookie = arguments.get_binary_generic(\"client_cookie\").unwrap();\n        let client_identity_proof_signature = arguments.get_binary_generic(\"client_identity_proof_signature\").unwrap();\n\n        send_response_cookie\n    };\n\n    let mut expect_timeout: bool = false;\n    let mut expect_bson_parse_failure: bool = false;\n    let mut expect_bson_too_small: bool = false;\n    let mut expect_bson_too_large: bool = false;\n    let mut expect_honkrpc_message_parse_failure: bool = false;\n    let mut expect_gosling_unexpected_response: bool = false;\n    let mut expect_unknown_error_section: bool = false;\n\n    let message: Vec\u003cu8\u003e = match data.send_response_response {\n        Response::Noise(bytes) =\u003e {\n            match bytes.len() {\n                0..=3 =\u003e expect_timeout = true,\n                len =\u003e {\n                    let size: i32 = (bytes[0] as i32)\n                                  | (bytes[1] as i32) \u003c\u003c 8\n                                  | (bytes[2] as i32) \u003c\u003c 16\n                                  | (bytes[3] as i32) \u003c\u003c 24;\n                    if size \u003c= 4 {\n                        expect_bson_too_small = true;\n                    } else if size \u003e ENDPOINT_MAX_MESSAGE_SIZE {\n                        expect_bson_too_large = true;\n                    } else if size as usize \u003e len {\n                        expect_timeout = true;\n                    } else {\n                        match bson::document::Document::from_reader(Cursor::new(bytes.clone())) {\n                            Ok(_) =\u003e expect_honkrpc_message_parse_failure = true,\n                            Err(_) =\u003e expect_bson_parse_failure = true,\n                        }\n                    }\n                }\n            };\n            bytes.clone()\n        },\n        Response::Document(document) =\u003e {\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            document.value.to_writer(\u0026mut bytes).unwrap();\n            if bytes.len() \u003e ENDPOINT_MAX_MESSAGE_SIZE as usize {\n                expect_bson_too_large = true;\n            } else {\n                expect_honkrpc_message_parse_failure = true;\n            }\n            bytes\n        },\n        Response::HonkRPC{single_message, pending, complete, error} =\u003e {\n            let mut sections: Vec\u003cDocument\u003e = Default::default();\n\n            // build our pending section\n            if let Some(pending) = pending {\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(RESPONSE_SECTION));\n\n                let cookie = match pending.cookie {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(send_response_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == send_response_cookie {\n                            Some(Bson::Int64(!cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int64(cookie) = bson.value {\n                            if cookie != send_response_cookie {\n                                expect_gosling_unexpected_response = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n\n                        Some(bson.value)\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let state = match pending.state {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int32(PENDING_REQUEST_STATE)),\n                    Argument::Invalid(state) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if state == PENDING_REQUEST_STATE || state == COMPLETE_REQUEST_STATE {\n                            Some(Bson::Int32(!state))\n                        } else {\n                            Some(Bson::Int32(state))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int32(state) = bson.value {\n                            if state != PENDING_REQUEST_STATE \u0026\u0026 state != COMPLETE_REQUEST_STATE {\n                                expect_honkrpc_message_parse_failure = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n                        Some(bson.value)\n                    }\n                };\n                if let Some(state) = state {\n                    section.insert(\"state\", state);\n                }\n\n                let result = match pending.result {\n                    Argument::Missing =\u003e None,\n                    Argument::Valid =\u003e None,\n                    Argument::Invalid(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        Some(bson.value)\n                    }\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        Some(bson.value)\n                    }\n                };\n                if let Some(result) = result {\n                    section.insert(\"result\", result);\n                }\n\n                sections.push(section);\n            }\n            // build our complete section\n            if let Some(complete) = complete {\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(RESPONSE_SECTION));\n\n                let cookie = match complete.cookie {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(send_response_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == send_response_cookie {\n                            Some(Bson::Int64(!cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int64(cookie) = bson.value {\n                            if cookie != send_response_cookie {\n                                expect_gosling_unexpected_response = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n\n                        Some(bson.value)\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let state = match complete.state {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int32(COMPLETE_REQUEST_STATE)),\n                    Argument::Invalid(state) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if state == COMPLETE_REQUEST_STATE {\n                            Some(Bson::Int32(!state))\n                        } else {\n                            Some(Bson::Int32(state))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int32(state) = bson.value {\n                            if state == PENDING_REQUEST_STATE {\n                                expect_timeout = true;\n                            } else if state != COMPLETE_REQUEST_STATE {\n                                expect_honkrpc_message_parse_failure = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n                        Some(bson.value)\n                    }\n                };\n                if let Some(state) = state {\n                    section.insert(\"state\", state);\n                }\n\n                let result = match complete.result {\n                    Argument::Missing =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        None\n                    },\n                    Argument::Valid =\u003e {\n                        Some(Bson::Document(doc!{}))\n                    },\n                    Argument::Invalid(bson) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        Some(bson.value)\n                    },\n                    Argument::Random(bson) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        Some(bson.value)\n                    },\n                };\n                if let Some(result) = result {\n                    section.insert(\"result\", result);\n                }\n\n                sections.push(section);\n            } else if let Some(error) = error {\n                // build an error section if there's no complete section\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(ERROR_SECTION));\n\n                let cookie = match error.cookie {\n                    Argument::Missing =\u003e {\n                        expect_unknown_error_section = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(send_response_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == send_response_cookie {\n                            Some(Bson::Int64(!send_response_cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if let Bson::Int64(value) = bson.value {\n                            Some(Bson::Null)\n                        } else {\n                            Some(bson.value)\n                        }\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let code = match error.code {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    }\n                    Argument::Valid =\u003e {\n                        // error success\n                        expect_gosling_unexpected_response = true;\n                        Some(Bson::Int32(0i32))\n                    },\n                    Argument::Invalid(code) =\u003e {\n                        // all i32 are somehow valid error codes\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if let Bson::Int32(value) = bson.value {\n                            Some(Bson::Null)\n                        } else {\n                            Some(bson.value)\n                        }\n                    }\n                };\n                if let Some(code) = code {\n                    section.insert(\"code\", code);\n                }\n\n                sections.push(section);\n            } else {\n                expect_timeout = true;\n            }\n\n            // convert sections into honk-rpc messages and serialize to byte vecs\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            if single_message {\n                let mut message = Document::new();\n                message.insert(\"honk_rpc\", HONK_RPC);\n\n                if sections.len() == 0 {\n                    expect_honkrpc_message_parse_failure = true;\n                }\n\n                message.insert(\"sections\", sections);\n\n                message.to_writer(\u0026mut bytes).unwrap();\n                if bytes.len() \u003e ENDPOINT_MAX_MESSAGE_SIZE as usize {\n                    expect_bson_too_large = true;\n                }\n            } else {\n                let mut bytes_written = 0usize;\n                for section in sections.drain(..) {\n                    let mut message = Document::new();\n                    message.insert(\"honk_rpc\", HONK_RPC);\n                    message.insert(\"sections\", vec![section]);\n\n                    message.to_writer(\u0026mut bytes).unwrap();\n\n                    if bytes.len() - bytes_written \u003e ENDPOINT_MAX_MESSAGE_SIZE as usize {\n                        expect_bson_too_large = true;\n                    }\n                    bytes_written = bytes.len();\n                }\n            }\n\n            bytes\n        },\n    };\n    alice_stream.write(message.as_slice()).unwrap();\n\n    //\n    // Bob receives send_response() response and finishes handshake\n    //\n    let mut send_response_complete: bool = false;\n    while !send_response_complete {\n        for event in bob.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::EndpointClientHandshakeFailed{handle, reason} =\u003e {\n                    assert_eq!(handshake_handle, handle);\n                    match reason {\n                        context::Error::EndpointClientError(\n                            endpoint_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageReadTimedOut(_))) =\u003e {\n                            assert!(expect_timeout, \"{:?}\", reason);\n                        }\n                        context::Error::EndpointClientError(\n                            endpoint_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooSmall(_))) =\u003e {\n                            assert!(expect_bson_too_small, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointClientError(\n                            endpoint_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooLarge(_, _))) =\u003e {\n                            assert!(expect_bson_too_large, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointClientError(\n                            endpoint_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageConversionFailed(_))) =\u003e {\n                            assert!(expect_honkrpc_message_parse_failure, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointClientError(\n                            endpoint_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::UnknownErrorSectionReceived(_))) =\u003e {\n                            assert!(expect_unknown_error_section, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointClientError(\n                            endpoint_client::Error::UnexpectedResponseReceived(_)) =\u003e {\n                            assert!(expect_gosling_unexpected_response, \"{:?}\", reason);\n                        },\n                        error =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n                    // bob should have closed the connection on alice after handshake failure\n                    return;\n                },\n                ContextEvent::EndpointClientHandshakeCompleted{handle, endpoint_service_id, channel_name, stream: _} =\u003e {\n                    assert_eq!(handshake_handle, handle);\n                    assert_eq!(endpoint_service_id, alice_endpoint_onion_service_id);\n                    assert_eq!(channel_name, VALID_CHANNEL);\n                    send_response_complete = true;\n                },\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n});\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","fuzz","fuzz_targets","fuzz_endpoint_server.rs"],"content":"#![no_main]\n\n// std\nuse std::io::{Cursor, Write};\nuse std::time::Duration;\n\n// gosling\nuse ::gosling::*;\nuse context::*;\n\n// extern\nuse bson::Bson;\nuse bson::Document;\nuse bson::doc;\nuse bson::spec::BinarySubtype;\nuse data_encoding::HEXLOWER;\nuse tor_interface::mock_tor_client::*;\nuse tor_interface::tor_crypto::*;\nuse tor_interface::tor_provider::*;\nuse honk_rpc::honk_rpc::{get_message_overhead, get_response_section_size};\n\n// fuzzing\nuse libfuzzer_sys::fuzz_target;\nuse libfuzzer_sys::arbitrary;\nuse libfuzzer_sys::arbitrary::Arbitrary;\n\nmod arbitrary_types;\nuse crate::arbitrary_types::*;\n\nmod utils;\nuse crate::utils::*;\n\n#[derive(Arbitrary, Debug)]\nenum BeginHandshakeMessage {\n    // random bytes\n    Noise(Vec\u003cu8\u003e),\n    /* HonkRpcMessage */\n    /* BSON */\n    // a valid honkrpc request\n    Request{\n        version: Argument\u003cString\u003e,\n        client_identity: Argument\u003cArbitraryV3OnionServiceId\u003e,\n        channel: Argument\u003cString\u003e,\n    },\n}\n\n#[derive(Arbitrary, Debug)]\nenum SendResponseMessage {\n    Noise(Vec\u003cu8\u003e),\n    /* HonkRpcMessage */\n    /* BSON */\n    // a valid honkrpc requst\n    Request{\n        client_cookie: Argument\u003cCookie\u003e,\n        client_identity_proof_signature: Argument\u003cArbitraryEd25519Signature\u003e,\n    },\n}\n\n#[derive(Arbitrary, Debug)]\nstruct HandshakeData {\n    // server data\n    alice_private_ed25519: ArbitraryEd25519PrivateKey,\n    alice_endpoint_ed25519: ArbitraryEd25519PrivateKey,\n    channel_supported: bool,\n    // client data\n    bob_private_ed25519: ArbitraryEd25519PrivateKey,\n    bob_private_x25519: ArbitraryX25519PrivateKey,\n    client_cookie: Cookie,\n    // client messages\n    begin_handshake_cookie: i64,\n    begin_handshake: BeginHandshakeMessage,\n    send_response_cookie: i64,\n    send_response: SendResponseMessage,\n}\n\n// two gosling instance, Alice and Bob\n// Alice is a valid server, Bob connects and sends garbage at certain point in the form of bad data in correctly structured+ordered gosling bison messages or noise\nfuzz_target!(|data: HandshakeData| {\n\n    // alice server data\n    let alice_identity_ed25519 = data.alice_private_ed25519.value;\n    let alice_onion_service_id = V3OnionServiceId::from_private_key(\u0026alice_identity_ed25519);\n    let alice_onion_service_id_string = alice_onion_service_id.to_string();\n    let alice_endpoint_ed25519 = data.alice_endpoint_ed25519.value;\n    let alice_endpoint_onion_service_id = V3OnionServiceId::from_private_key(\u0026alice_endpoint_ed25519);\n    let alice_endpoint_onion_service_id_string = alice_endpoint_onion_service_id.to_string();\n\n\n    // bob client data\n    let bob_private_key = data.bob_private_ed25519.value;\n    let bob_onion_service_id = V3OnionServiceId::from_private_key(\u0026bob_private_key);\n    let bob_onion_service_id_string = bob_onion_service_id.to_string();\n    let bob_private_x25519 = data.bob_private_x25519.value;\n    let bob_public_x25519 = X25519PublicKey::from_private_key(\u0026bob_private_x25519);\n\n    //\n    // Init Alice server and malicious Bob client\n    //\n\n    // init alice\n    let alice_tor = MockTorClient::new();\n\n    // create alice gosling context\n    let mut alice = Context::new(Box::new(alice_tor), 420, 420, std::time::Duration::from_millis(32), ENDPOINT_MAX_MESSAGE_SIZE, Some(std::time::Duration::from_millis(32)), alice_identity_ed25519.clone()).unwrap();\n\n    // bootstrap alice\n    alice.bootstrap().unwrap();\n    let mut endpoint_server_published: bool = false;\n    while !endpoint_server_published {\n        for event in alice.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::TorBootstrapStatusReceived{progress: _, tag: _, summary: _} =\u003e (),\n                ContextEvent::TorBootstrapCompleted =\u003e {\n                    // start alice endpoint server\n                    match alice.endpoint_server_start(alice_endpoint_ed25519.clone(), VALID_ENDPOINT.to_string(), bob_onion_service_id.clone(), bob_public_x25519.clone()) {\n                        Ok(()) =\u003e (),\n                        Err(context::Error::InvalidArgument(_)) =\u003e {\n                            assert_eq!(alice_onion_service_id_string, alice_endpoint_onion_service_id_string);\n                            return;\n                        },\n                        Err(error) =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n                }\n                ContextEvent::TorLogReceived{line: _} =\u003e (),\n                ContextEvent::EndpointServerPublished{endpoint_service_id, endpoint_name} =\u003e {\n                    assert_eq!(endpoint_service_id, alice_endpoint_onion_service_id);\n                    assert_eq!(endpoint_name, VALID_ENDPOINT);\n                    endpoint_server_published = true;\n                }\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n\n\n    // init bob\n    let mut bob_tor = MockTorClient::new();\n\n    // bootstrap bob\n    bob_tor.bootstrap().unwrap();\n    let mut bootstrap_complete = false;\n    while !bootstrap_complete {\n        for event in bob_tor.update().unwrap().drain(..) {\n            match event {\n                TorEvent::BootstrapComplete =\u003e {\n                    bootstrap_complete = true;\n                }\n                _ =\u003e ()\n            }\n        }\n    }\n    bob_tor.add_client_auth(\u0026alice_endpoint_onion_service_id, \u0026bob_private_x25519).unwrap();\n\n    // bob connects to alice\n    let mut bob_stream = bob_tor.connect((alice_endpoint_onion_service_id.clone(), 420).into(), None).unwrap();\n    bob_stream.set_nonblocking(false).unwrap();\n    bob_stream.set_read_timeout(Some(Duration::from_millis(100u64))).unwrap();\n\n\n    //\n    // Alice waits for handshake started\n    //\n    let mut alice_handshake_started: bool = false;\n    let mut alice_handshake_handle: HandshakeHandle = INVALID_HANDSHAKE_HANDLE;\n    while !alice_handshake_started {\n        for event in alice.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::EndpointServerHandshakeStarted{handle} =\u003e {\n                    alice_handshake_started = true;\n                    alice_handshake_handle = handle;\n                }\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n\n    //\n    // Bob sends begin_handshake()\n    //\n    #[derive(PartialEq, Debug)]\n    enum ExpectedBeginHandshakeResponse {\n        // Success Case\n        EndpointRequestReceived,\n        // Error Cases\n        ErrorTimedOut,\n        ErrorBsonParseFailure,\n        ErrorBsonTooSmall,\n        ErrorBsonTooLarge,\n        ErrorMessageParseFailure,\n        ErrorBadGoslingVersion,\n        ErrorInvalidArg,\n        ErrorBadClient,\n    }\n    let mut expected_response = ExpectedBeginHandshakeResponse::EndpointRequestReceived;\n\n    let message = match \u0026data.begin_handshake {\n        BeginHandshakeMessage::Noise(bytes) =\u003e {\n            expected_response = match bytes.len() {\n                0..=3 =\u003e ExpectedBeginHandshakeResponse::ErrorTimedOut,\n                len =\u003e {\n                    let size: i32 = (bytes[0] as i32)\n                                  | (bytes[1] as i32) \u003c\u003c 8\n                                  | (bytes[2] as i32) \u003c\u003c 16\n                                  | (bytes[3] as i32) \u003c\u003c 24;\n                    if size \u003c= 4 {\n                        ExpectedBeginHandshakeResponse::ErrorBsonTooSmall\n                    } else if size \u003e ENDPOINT_MAX_MESSAGE_SIZE {\n                        ExpectedBeginHandshakeResponse::ErrorBsonTooLarge\n                    } else if size as usize \u003e len {\n                        ExpectedBeginHandshakeResponse::ErrorTimedOut\n                    } else {\n                        match bson::document::Document::from_reader(Cursor::new(bytes.clone())) {\n                            Ok(_) =\u003e ExpectedBeginHandshakeResponse::ErrorMessageParseFailure,\n                            Err(_) =\u003e ExpectedBeginHandshakeResponse::ErrorBsonParseFailure,\n                        }\n                    }\n                }\n            };\n            bytes.clone()\n        },\n        BeginHandshakeMessage::Request{\n            version,\n            client_identity,\n            channel} =\u003e {\n            match (\u0026version, \u0026client_identity, \u0026channel) {\n                (Argument::Valid, Argument::Valid | Argument::Invalid(_), Argument::Valid | Argument::Invalid(_)) =\u003e (),\n                (Argument::Missing | Argument::Invalid(_) | Argument::Random(_), _, _) =\u003e  expected_response = ExpectedBeginHandshakeResponse::ErrorBadGoslingVersion,\n                _ =\u003e expected_response = ExpectedBeginHandshakeResponse::ErrorInvalidArg,\n            }\n\n            let mut message = Document::new();\n            message.insert(\"honk_rpc\", Bson::Int32(HONK_RPC));\n\n            let mut section = Document::new();\n            section.insert(\"id\", Bson::Int32(REQUEST_SECTION));\n            section.insert(\"namespace\", Bson::String(\"gosling_endpoint\".to_string()));\n            section.insert(\"function\", Bson::String(\"begin_handshake\".to_string()));\n            section.insert(\"cookie\", Bson::Int64(data.begin_handshake_cookie));\n\n            let mut arguments = Document::new();\n            let version = match version {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e Some(Bson::String(GOSLING_PROTOCOL_VERSION.to_string())),\n                Argument::Invalid(invalid) =\u003e {\n                    if invalid == GOSLING_PROTOCOL_VERSION {\n                        Some(Bson::String(\"invalid_version\".to_string()))\n                    } else {\n                        Some(Bson::String(invalid.clone()))\n                    }\n                },\n                Argument::Random(ArbitraryBSON{value: Bson::String(_)}) =\u003e Some(Bson::Null),\n                Argument::Random(bson) =\u003e Some(bson.value.clone()),\n            };\n            if let Some(version) = version {\n                arguments.insert(\"version\", version);\n            }\n\n            let client_identity = match client_identity {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e Some(Bson::String(bob_onion_service_id_string.clone())),\n                Argument::Invalid(invalid) =\u003e {\n                    let invalid = invalid.value.to_string();\n                    Some(Bson::String(invalid))\n                },\n                Argument::Random(ArbitraryBSON{value: Bson::String(_)}) =\u003e Some(Bson::Null),\n                Argument::Random(bson) =\u003e Some(bson.value.clone()),\n            };\n            if let Some(client_identity) = client_identity {\n                arguments.insert(\"client_identity\", client_identity);\n            }\n\n            let channel = match channel {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e Some(Bson::String(VALID_CHANNEL.to_string())),\n                Argument::Invalid(value) =\u003e {\n                    if value == VALID_CHANNEL {\n                        Some(Bson::String(\"invalid_channel\".to_string()))\n                    } else if value.is_ascii() {\n                        Some(Bson::String(value.clone()))\n                    } else {\n                        Some(Bson::String(Default::default()))\n                    }\n                },\n                Argument::Random(ArbitraryBSON{value: Bson::String(value)}) =\u003e {\n                    if !value.is_ascii() {\n                        Some(Bson::String(value.clone()))\n                    } else {\n                        Some(Bson::Null)\n                    }\n                },\n                Argument::Random(bson) =\u003e Some(bson.value.clone()),\n            };\n            if let Some(channel) = channel {\n                arguments.insert(\"channel\", channel);\n            }\n\n            section.insert(\"arguments\", arguments);\n            message.insert(\"sections\", vec![section]);\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            message.to_writer(\u0026mut bytes).unwrap();\n            if bytes.len() \u003e ENDPOINT_MAX_MESSAGE_SIZE as usize {\n                expected_response = ExpectedBeginHandshakeResponse::ErrorBsonTooLarge;\n            }\n            bytes\n        },\n    };\n    bob_stream.write(message.as_slice()).unwrap();\n\n\n    //\n    // Alice handles begin_handshake()\n    //\n    let mut alice_begin_handshake_handled: bool = false;\n    while !alice_begin_handshake_handled {\n        for event in alice.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::EndpointServerChannelRequestReceived{handle, client_service_id: _, requested_channel} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    assert_eq!(expected_response, ExpectedBeginHandshakeResponse::EndpointRequestReceived);\n                    #[derive(PartialEq, Debug)]\n                    enum ExpectedHandleEndpointRequestReceiveResult {\n                        Success,\n                        // Error Cases\n                        ErrorSectionTooLarge,\n                    }\n\n                    let mut expected_result = ExpectedHandleEndpointRequestReceiveResult::Success;\n\n                    // calculate the expected size of our reponse message\n                    let begin_handshake_complete_message_size = {\n                        let result = doc!{\n                            \"server_cookie\" : bson::Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: [0u8; COOKIE_SIZE].to_vec()}),\n                        };\n                        let response_section_size = get_response_section_size(Some(Bson::Document(result))).unwrap();\n                        get_message_overhead().unwrap() + response_section_size\n                    };\n                    if begin_handshake_complete_message_size \u003e ENDPOINT_MAX_MESSAGE_SIZE as usize {\n                        expected_result = ExpectedHandleEndpointRequestReceiveResult::ErrorSectionTooLarge;\n                    }\n\n                    match alice.endpoint_server_handle_channel_request_received(\n                        alice_handshake_handle,\n                        data.channel_supported \u0026\u0026 requested_channel == VALID_CHANNEL) {\n                        Ok(()) =\u003e assert_eq!(expected_result, ExpectedHandleEndpointRequestReceiveResult::Success),\n                        Err(error) =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n\n                    alice_begin_handshake_handled = true;\n                }\n                ContextEvent::EndpointServerHandshakeFailed{handle, reason} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    match reason {\n                        context::Error::EndpointServerError(\n                            endpoint_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageReadTimedOut(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedBeginHandshakeResponse::ErrorTimedOut, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointServerError(\n                            endpoint_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentParseFailed(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedBeginHandshakeResponse::ErrorBsonParseFailure, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointServerError(\n                            endpoint_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooSmall(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedBeginHandshakeResponse::ErrorBsonTooSmall, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointServerError(\n                            endpoint_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooLarge(_, _))) =\u003e {\n                            assert_eq!(expected_response, ExpectedBeginHandshakeResponse::ErrorBsonTooLarge, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointServerError(\n                            endpoint_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageConversionFailed(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedBeginHandshakeResponse::ErrorMessageParseFailure, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointServerError(endpoint_server::Error::BadClient) =\u003e {\n                            assert!(expected_response == ExpectedBeginHandshakeResponse::ErrorBadClient ||\n                                    expected_response == ExpectedBeginHandshakeResponse::ErrorBadGoslingVersion ||\n                                    expected_response == ExpectedBeginHandshakeResponse::ErrorInvalidArg, \"{:?}\", reason);\n                        },\n                        error =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n                    alice_begin_handshake_handled = true;\n                }\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n        // Alice sends Bob begin_handshake() response (or does nothing)\n    for event in alice.update().unwrap().drain(..) {\n        match event {\n            event =\u003e panic!(\"unexpected event: {:?}\", event),\n        }\n    }\n\n    //\n    // Bob reads begin_handshake() response or error sections\n    //\n\n    // bob receives begin_handshake() pending response\n    let begin_handshake_pending = bson::document::Document::from_reader(\u0026mut bob_stream);\n    match expected_response {\n        ExpectedBeginHandshakeResponse::ErrorTimedOut |\n        ExpectedBeginHandshakeResponse::ErrorBsonTooSmall |\n        ExpectedBeginHandshakeResponse::ErrorBsonTooLarge |\n        ExpectedBeginHandshakeResponse::ErrorBsonParseFailure |\n        ExpectedBeginHandshakeResponse::ErrorMessageParseFailure =\u003e {\n            match begin_handshake_pending {\n                Err(bson::de::Error::Io(_)) =\u003e return,\n                Ok(message) =\u003e panic!(\"unexpected message: {:?}\", message),\n                Err(error) =\u003e panic!(\"unexpected error: {:?}\", error),\n            }\n        },\n        ExpectedBeginHandshakeResponse::ErrorBadGoslingVersion =\u003e {\n            match begin_handshake_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": ERROR_SECTION,\n                                \"cookie\": data.begin_handshake_cookie,\n                                \"code\": ERROR_CODE_BAD_VERSION,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n        ExpectedBeginHandshakeResponse::ErrorInvalidArg =\u003e {\n            match begin_handshake_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": ERROR_SECTION,\n                                \"cookie\": data.begin_handshake_cookie,\n                                \"code\": ERROR_CODE_INVALID_ARG,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n        ExpectedBeginHandshakeResponse::EndpointRequestReceived |\n        ExpectedBeginHandshakeResponse::ErrorBadClient =\u003e {\n            match begin_handshake_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": RESPONSE_SECTION,\n                                \"cookie\": data.begin_handshake_cookie,\n                                \"state\": PENDING_REQUEST_STATE,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        }\n    }\n\n\n    // bob receives begin_handshake() result\n    let begin_handshake_result = bson::document::Document::from_reader(\u0026mut bob_stream);\n    let mut server_cookie: Cookie = Default::default();\n    match expected_response {\n        ExpectedBeginHandshakeResponse::ErrorTimedOut |\n        ExpectedBeginHandshakeResponse::ErrorBsonTooSmall |\n        ExpectedBeginHandshakeResponse::ErrorBsonTooLarge |\n        ExpectedBeginHandshakeResponse::ErrorBsonParseFailure |\n        ExpectedBeginHandshakeResponse::ErrorMessageParseFailure |\n        ExpectedBeginHandshakeResponse::ErrorBadGoslingVersion |\n        ExpectedBeginHandshakeResponse::ErrorInvalidArg =\u003e {\n            match begin_handshake_result {\n                Err(bson::de::Error::Io(_)) =\u003e return,\n                Ok(message) =\u003e panic!(\"unexpected message: {:?}\", message),\n                Err(error) =\u003e panic!(\"unexpected error: {:?}\", error),\n            }\n        },\n        ExpectedBeginHandshakeResponse::ErrorBadClient =\u003e {\n            match begin_handshake_result {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": ERROR_SECTION,\n                                \"cookie\": data.begin_handshake_cookie,\n                                \"code\": ERROR_CODE_FAILURE,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n        ExpectedBeginHandshakeResponse::EndpointRequestReceived =\u003e {\n            match begin_handshake_result {\n                Ok(message) =\u003e {\n                    assert_eq!(message.get_i32(\"honk_rpc\").unwrap(), HONK_RPC);\n                    let sections = message.get_array(\"sections\").unwrap();\n                    assert_eq!(sections.len(), 1);\n                    let section = \u0026sections[0];\n                    match section {\n                        Bson::Document(section) =\u003e {\n                            assert_eq!(section.get_i32(\"id\"), Ok(RESPONSE_SECTION));\n                            let response = section;\n                            assert_eq!(response.get_i64(\"cookie\"), Ok(data.begin_handshake_cookie));\n                            assert_eq!(response.get_i32(\"state\"), Ok(COMPLETE_REQUEST_STATE));\n                            let result = response.get_document(\"result\").unwrap();\n                            server_cookie = result.get_binary_generic(\"server_cookie\").unwrap().clone().try_into().unwrap();\n                        },\n                        bson =\u003e panic!(\"unexpected section: {:?}\", bson),\n                    }\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        }\n    }\n\n    //\n    // Bsob sends send_response()\n    //\n\n    #[derive(PartialEq, Debug)]\n    enum ExpectedSendResponseResponse {\n        // Success Case\n        EmptyDocumentReceived,\n        // Error Cases\n        ErrorTimedOut,\n        ErrorBsonParseFailure,\n        ErrorBsonTooSmall,\n        ErrorBsonTooLarge,\n        ErrorMessageParseFailure,\n        ErrorInvalidArg,\n        ErrorBadClient,\n    }\n    let mut expected_response = match (data.channel_supported, data.begin_handshake) {\n        (true, BeginHandshakeMessage::Request{version: Argument::Valid, client_identity: Argument::Valid, channel: Argument::Valid}) =\u003e ExpectedSendResponseResponse::EmptyDocumentReceived,\n        _ =\u003e ExpectedSendResponseResponse::ErrorBadClient,\n    };\n\n    let message = match data.send_response {\n        SendResponseMessage::Noise(bytes) =\u003e {\n            expected_response = match bytes.len() {\n                0..=3 =\u003e ExpectedSendResponseResponse::ErrorTimedOut,\n                len =\u003e {\n                    let size: i32 = (bytes[0] as i32)\n                                  | (bytes[1] as i32) \u003c\u003c 8\n                                  | (bytes[2] as i32) \u003c\u003c 16\n                                  | (bytes[3] as i32) \u003c\u003c 24;\n                    if size \u003c= 4 {\n                        ExpectedSendResponseResponse::ErrorBsonTooSmall\n                    } else if size \u003e ENDPOINT_MAX_MESSAGE_SIZE {\n                        ExpectedSendResponseResponse::ErrorBsonTooLarge\n                    } else if size as usize \u003e len {\n                        ExpectedSendResponseResponse::ErrorTimedOut\n                    } else {\n                        match bson::document::Document::from_reader(Cursor::new(bytes.clone())) {\n                            Ok(_) =\u003e ExpectedSendResponseResponse::ErrorMessageParseFailure,\n                            Err(_) =\u003e ExpectedSendResponseResponse::ErrorBsonParseFailure,\n                        }\n                    }\n                }\n            };\n            bytes\n        },\n        SendResponseMessage::Request{\n            client_cookie,\n            client_identity_proof_signature} =\u003e {\n            match (\u0026client_cookie, \u0026client_identity_proof_signature) {\n                (Argument::Valid, Argument::Valid) =\u003e (),\n                (Argument::Valid | Argument::Invalid(_),\n                 Argument::Valid | Argument::Invalid(_)) =\u003e expected_response = ExpectedSendResponseResponse::ErrorBadClient,\n                _ =\u003e expected_response = ExpectedSendResponseResponse::ErrorInvalidArg,\n            }\n\n            let mut message = Document::new();\n            message.insert(\"honk_rpc\", Bson::Int32(HONK_RPC));\n\n            let mut section = Document::new();\n            section.insert(\"id\", Bson::Int32(REQUEST_SECTION));\n            section.insert(\"namespace\", Bson::String(\"gosling_endpoint\".to_string()));\n            section.insert(\"function\", Bson::String(\"send_response\".to_string()));\n            section.insert(\"cookie\", Bson::Int64(data.send_response_cookie));\n\n            let mut arguments = Document::new();\n            let client_cookie = match client_cookie {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: data.client_cookie.to_vec()})),\n                Argument::Invalid(value) =\u003e {\n                    // ensure the cookie is actually invalid\n                    if value == data.client_cookie {\n                        Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: value.map(|x| !x).to_vec()}))\n                    } else {\n                        Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: value.to_vec()}))\n                    }\n                }\n                Argument::Random(ArbitraryBSON{value: Bson::Binary(_)}) =\u003e Some(Bson::Null),\n                Argument::Random(bson) =\u003e Some(bson.value),\n            };\n            if let Some(client_cookie) = client_cookie {\n                arguments.insert(\"client_cookie\", client_cookie);\n            }\n\n            let client_identity_proof_signature = match client_identity_proof_signature {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e {\n                    let client_identity_proof = build_client_proof(\"gosling-endpoint\", VALID_CHANNEL, \u0026bob_onion_service_id, \u0026alice_endpoint_onion_service_id, \u0026data.client_cookie, \u0026server_cookie);\n                    let client_identity_proof_signature = bob_private_key.sign_message(\u0026client_identity_proof);\n                    Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_identity_proof_signature.to_bytes().to_vec()}))\n                },\n                Argument::Invalid(invalid) =\u003e {\n                    Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: invalid.value.to_bytes().to_vec()}))\n                }\n                Argument::Random(ArbitraryBSON{value: Bson::Binary(_)}) =\u003e Some(Bson::Null),\n                Argument::Random(bson) =\u003e Some(bson.value),\n            };\n            if let Some(client_identity_proof_signature) = client_identity_proof_signature {\n                arguments.insert(\"client_identity_proof_signature\", client_identity_proof_signature);\n            }\n\n            section.insert(\"arguments\", arguments);\n            message.insert(\"sections\", vec![section]);\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            message.to_writer(\u0026mut bytes).unwrap();\n            if bytes.len() \u003e ENDPOINT_MAX_MESSAGE_SIZE as usize {\n                expected_response = ExpectedSendResponseResponse::ErrorBsonTooLarge;\n            }\n            bytes\n        },\n    };\n    bob_stream.write(message.as_slice()).unwrap();\n\n    //\n    // Alice handles send_response()\n    //\n\n    let mut alice_send_response_handled: bool = false;\n    while !alice_send_response_handled {\n        for event in alice.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::EndpointServerHandshakeFailed{handle, reason} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    match reason {\n                        context::Error::EndpointServerError(\n                            endpoint_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageReadTimedOut(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedSendResponseResponse::ErrorTimedOut, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointServerError(\n                            endpoint_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentParseFailed(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedSendResponseResponse::ErrorBsonParseFailure, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointServerError(\n                            endpoint_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooSmall(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedSendResponseResponse::ErrorBsonTooSmall, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointServerError(\n                            endpoint_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooLarge(_, _))) =\u003e {\n                            assert_eq!(expected_response, ExpectedSendResponseResponse::ErrorBsonTooLarge, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointServerError(\n                            endpoint_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageConversionFailed(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedSendResponseResponse::ErrorMessageParseFailure, \"{:?}\", reason);\n                        },\n                        context::Error::EndpointServerError(endpoint_server::Error::BadClient) =\u003e {\n                            assert!(expected_response == ExpectedSendResponseResponse::ErrorBadClient ||\n                                    expected_response == ExpectedSendResponseResponse::ErrorInvalidArg, \"{:?}\", reason);\n                        },\n                        error =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n                    alice_send_response_handled = true;\n                },\n                ContextEvent::EndpointServerHandshakeCompleted{handle, endpoint_service_id, client_service_id, channel_name, stream: _} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    assert_eq!(endpoint_service_id, alice_endpoint_onion_service_id);\n                    assert_eq!(client_service_id, bob_onion_service_id);\n                    assert_eq!(channel_name, VALID_CHANNEL);\n                    alice_send_response_handled = true;\n                    assert_eq!(expected_response, ExpectedSendResponseResponse::EmptyDocumentReceived);\n                },\n                ContextEvent::EndpointServerHandshakeRejected { handle, client_allowed: _, client_requested_channel_valid: _, client_proof_signature_valid: _} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    alice_send_response_handled = true;\n                },\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n\n    //\n    // Bob reads send_response() response or error sections\n    //\n\n    // first read response (pending) or error section\n    let send_response_pending = bson::document::Document::from_reader(\u0026mut bob_stream);\n    match expected_response {\n        ExpectedSendResponseResponse::ErrorTimedOut |\n        ExpectedSendResponseResponse::ErrorBsonTooSmall |\n        ExpectedSendResponseResponse::ErrorBsonTooLarge |\n        ExpectedSendResponseResponse::ErrorBsonParseFailure |\n        ExpectedSendResponseResponse::ErrorMessageParseFailure =\u003e {\n            match send_response_pending {\n                Err(bson::de::Error::Io(_)) =\u003e return,\n                Ok(message) =\u003e panic!(\"unexpected message: {:?}\", message),\n                Err(error) =\u003e panic!(\"unexpected error: {:?}\", error),\n            }\n        },\n        ExpectedSendResponseResponse::ErrorInvalidArg =\u003e {\n            match send_response_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": ERROR_SECTION,\n                                \"cookie\": data.send_response_cookie,\n                                \"code\": ERROR_CODE_INVALID_ARG,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n        ExpectedSendResponseResponse::ErrorBadClient =\u003e {\n            match send_response_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": ERROR_SECTION,\n                                \"cookie\": data.send_response_cookie,\n                                \"code\": ERROR_CODE_FAILURE,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n        ExpectedSendResponseResponse::EmptyDocumentReceived =\u003e {\n            match send_response_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": RESPONSE_SECTION,\n                                \"cookie\": data.send_response_cookie,\n                                \"state\": COMPLETE_REQUEST_STATE,\n                                \"result\": doc!{},\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        }\n    }\n\n    // success!\n    ()\n});\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","fuzz","fuzz_targets","fuzz_identity_client.rs"],"content":"#![no_main]\n\n// std\nuse std::io::{Cursor, Write};\nuse std::net::TcpStream;\nuse std::time::Duration;\n\n// gosling\nuse ::gosling::*;\nuse context::*;\n\n// extern\nuse bson::Bson;\nuse bson::Document;\nuse bson::doc;\nuse bson::spec::BinarySubtype;\n\nuse tor_interface::mock_tor_client::*;\nuse tor_interface::tor_crypto::*;\nuse tor_interface::tor_provider::*;\n\n// fuzzing\nuse libfuzzer_sys::fuzz_target;\nuse libfuzzer_sys::arbitrary;\nuse libfuzzer_sys::arbitrary::Arbitrary;\n\nmod arbitrary_types;\nuse crate::arbitrary_types::*;\n\nmod utils;\nuse crate::utils::*;\n\n#[derive(Arbitrary, Debug)]\nstruct ErrorSection {\n    cookie: Argument\u003ci64\u003e,\n    code: Argument\u003ci32\u003e,\n}\n\n#[derive(Arbitrary, Debug)]\nstruct ResponseSection {\n    cookie: Argument\u003ci64\u003e,\n    state: Argument\u003ci32\u003e,\n    result: Argument\u003cArbitraryBSON\u003e,\n}\n\n#[derive(Arbitrary, Debug)]\nenum Response {\n    Noise(Vec\u003cu8\u003e),\n    Document(ArbitraryBSONDocument),\n    HonkRPC {\n        single_message: bool,\n        pending: Option\u003cResponseSection\u003e,\n        complete: Option\u003cResponseSection\u003e,\n        error: Option\u003cErrorSection\u003e,\n    },\n}\n\n\n#[derive(Arbitrary, Debug)]\nstruct HandshakeData {\n    // server data\n    alice_private_ed25519: ArbitraryEd25519PrivateKey,\n    server_cookie: Cookie,\n    endpoint_challenge: ArbitraryBSONDocument,\n    endpoint_service_id: ArbitraryV3OnionServiceId,\n\n    // client data\n    bob_private_ed25519: ArbitraryEd25519PrivateKey,\n    endpoint_challenge_response: ArbitraryBSONDocument,\n\n    begin_handshake_response: Response,\n    send_response_response: Response,\n\n}\n\n// two gosling instance, Alice and Bob\n// Alice is a malicious/broken server, Bob is a valid client\nfuzz_target!(|data: HandshakeData| {\n\n    //\n    // Init malicious Alice server and Bon client\n    //\n\n    // init alice\n    let mut alice_tor = MockTorClient::new();\n\n    // bootstrap alice\n    alice_tor.bootstrap().unwrap();\n    let mut bootstrap_complete = false;\n    while !bootstrap_complete {\n        for event in alice_tor.update().unwrap().drain(..) {\n            match event {\n                TorEvent::BootstrapComplete =\u003e {\n                    bootstrap_complete = true;\n                }\n                _ =\u003e ()\n            }\n        }\n    }\n\n    let alice_private_key = data.alice_private_ed25519.value;\n    let alice_onion_service_id = V3OnionServiceId::from_private_key(\u0026alice_private_key);\n    let alice_onion_service_id_string = alice_onion_service_id.to_string();\n    let alice_listener = alice_tor.listener(\u0026alice_private_key, 420, None).unwrap();\n    let mut identity_server_published: bool = false;\n    while !identity_server_published {\n        for event in alice_tor.update().unwrap().drain(..) {\n            match event {\n                TorEvent::OnionServicePublished{service_id} =\u003e {\n                    assert_eq!(service_id, alice_onion_service_id);\n                    identity_server_published = true;\n                },\n                _ =\u003e ()\n            }\n        }\n    }\n\n    // init bob\n    let bob_tor = MockTorClient::new();\n\n    // create bob gosling context\n    let bob_private_key = data.bob_private_ed25519.value;\n    let bob_service_id = V3OnionServiceId::from_private_key(\u0026bob_private_key);\n    let bob_service_id_string = bob_service_id.to_string();\n    let mut bob = Context::new(Box::new(bob_tor), 420, 420, std::time::Duration::from_millis(32), IDENTITY_MAX_MESSAGE_SIZE, None, bob_private_key).unwrap();\n    bob.bootstrap().unwrap();\n    let mut bootstrap_complete: bool = false;\n    while !bootstrap_complete {\n        for event in bob.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::TorBootstrapStatusReceived{progress: _, tag: _, summary: _} =\u003e (),\n                ContextEvent::TorBootstrapCompleted =\u003e {\n                    bootstrap_complete = true;\n                }\n                ContextEvent::TorLogReceived{line: _} =\u003e (),\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n\n    //\n    // Bob initiates handshake\n    //\n    let handshake_handle = bob.identity_client_begin_handshake(alice_onion_service_id.clone(), VALID_ENDPOINT.to_string()).unwrap();\n    // first update to queue the HonkRPC call\n    assert_eq!(0, bob.update().unwrap().len());\n    // second upate sends the HonkRPC message\n    assert_eq!(0, bob.update().unwrap().len());\n\n    // alice waits for connect, return OnionStream\n    let mut alice_stream : TcpStream = match alice_listener.accept().unwrap() {\n        Some(stream) =\u003e stream.into(),\n        None =\u003e panic!(\"listener accept failed\"),\n    };\n    alice_stream.set_nonblocking(false).unwrap();\n    alice_stream.set_read_timeout(Some(Duration::from_millis(100u64))).unwrap();\n\n    //\n    // Alice receives begin_handshake() and build responses\n    //\n\n    let begin_handshake_cookie = {\n        let honkrpc_msg = bson::document::Document::from_reader(\u0026mut alice_stream).unwrap();\n        assert_eq!(honkrpc_msg.get_i32(\"honk_rpc\").unwrap(), HONK_RPC);\n        let sections = honkrpc_msg.get_array(\"sections\").unwrap();\n        assert_eq!(sections.len(), 1);\n        let honkrpc_request = match \u0026sections[0] {\n            Bson::Document(document) =\u003e document,\n            bson =\u003e panic!(\"unexpected bson in sections array: {}\", bson),\n        };\n        assert_eq!(honkrpc_request.get_i32(\"id\").unwrap(), REQUEST_SECTION);\n        let begin_handshake_cookie = honkrpc_request.get_i64(\"cookie\").unwrap();\n        assert_eq!(honkrpc_request.get_str(\"namespace\").unwrap(), GOSLING_IDENTITY_NAMESPACE);\n        assert_eq!(honkrpc_request.get_str(\"function\").unwrap(), GOSLING_IDENTITY_BEGIN_HANDSHAKE_FUNCTION);\n        let arguments = honkrpc_request.get_document(\"arguments\").unwrap();\n        assert_eq!(arguments.get_str(\"client_identity\").unwrap(), bob_service_id_string);\n        assert_eq!(arguments.get_str(\"endpoint\").unwrap(), VALID_ENDPOINT);\n        begin_handshake_cookie\n    };\n\n    // messages can be built such that multiple errors exist so lets track\n    // all the layers of possible errors\n    let mut expect_timeout: bool = false;\n    let mut expect_bson_parse_failure: bool = false;\n    let mut expect_bson_too_small: bool = false;\n    let mut expect_bson_too_large: bool = false;\n    let mut expect_honkrpc_message_parse_failure: bool = false;\n    let mut expect_gosling_unexpected_response: bool = false;\n    let mut expect_unknown_error_section: bool = false;\n\n    let message: Vec\u003cu8\u003e = match data.begin_handshake_response {\n        Response::Noise(bytes) =\u003e {\n            match bytes.len() {\n                0..=3 =\u003e expect_timeout = true,\n                len =\u003e {\n                    let size: i32 = (bytes[0] as i32)\n                                  | (bytes[1] as i32) \u003c\u003c 8\n                                  | (bytes[2] as i32) \u003c\u003c 16\n                                  | (bytes[3] as i32) \u003c\u003c 24;\n                    if size \u003c= 4 {\n                        expect_bson_too_small = true;\n                    } else if size \u003e IDENTITY_MAX_MESSAGE_SIZE {\n                        expect_bson_too_large = true;\n                    } else if size as usize \u003e len {\n                        expect_timeout = true;\n                    } else {\n                        match bson::document::Document::from_reader(Cursor::new(bytes.clone())) {\n                            Ok(_) =\u003e expect_honkrpc_message_parse_failure = true,\n                            Err(_) =\u003e expect_bson_parse_failure = true,\n                        }\n                    }\n                }\n            };\n            bytes.clone()\n        },\n        Response::Document(document) =\u003e {\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            document.value.to_writer(\u0026mut bytes).unwrap();\n            if bytes.len() \u003e IDENTITY_MAX_MESSAGE_SIZE as usize {\n                expect_bson_too_large = true;\n            } else {\n                expect_honkrpc_message_parse_failure = true;\n            }\n            bytes\n        },\n        Response::HonkRPC{single_message, pending, complete, error} =\u003e {\n            let mut sections: Vec\u003cDocument\u003e = Default::default();\n\n            // build our pending section\n            if let Some(pending) = pending {\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(RESPONSE_SECTION));\n\n                let cookie = match pending.cookie {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(begin_handshake_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == begin_handshake_cookie {\n                            Some(Bson::Int64(!cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int64(cookie) = bson.value {\n                            if cookie != begin_handshake_cookie {\n                                expect_gosling_unexpected_response = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n\n                        Some(bson.value)\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let state = match pending.state {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int32(PENDING_REQUEST_STATE)),\n                    Argument::Invalid(state) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if state == PENDING_REQUEST_STATE {\n                            Some(Bson::Int32(!state))\n                        } else {\n                            Some(Bson::Int32(state))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int32(state) = bson.value {\n                            if state != PENDING_REQUEST_STATE {\n                                expect_honkrpc_message_parse_failure = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n                        Some(bson.value)\n                    }\n                };\n                if let Some(state) = state {\n                    section.insert(\"state\", state);\n                }\n\n                let result = match pending.result {\n                    Argument::Missing =\u003e None,\n                    Argument::Valid =\u003e None,\n                    Argument::Invalid(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        Some(bson.value)\n                    }\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        Some(bson.value)\n                    }\n                };\n                if let Some(result) = result {\n                    section.insert(\"result\", result);\n                }\n\n                sections.push(section);\n            }\n            // build our complete section\n            if let Some(complete) = complete {\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(RESPONSE_SECTION));\n\n                let cookie = match complete.cookie {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(begin_handshake_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == begin_handshake_cookie {\n                            Some(Bson::Int64(!cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int64(cookie) = bson.value {\n                            if cookie != begin_handshake_cookie {\n                                expect_gosling_unexpected_response = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n\n                        Some(bson.value)\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let state = match complete.state {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int32(COMPLETE_REQUEST_STATE)),\n                    Argument::Invalid(state) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if state == COMPLETE_REQUEST_STATE {\n                            Some(Bson::Int32(!state))\n                        } else {\n                            Some(Bson::Int32(state))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int32(state) = bson.value {\n                            if state == PENDING_REQUEST_STATE {\n                                expect_timeout = true;\n                            } else if state != COMPLETE_REQUEST_STATE {\n                                expect_honkrpc_message_parse_failure = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n                        Some(bson.value)\n                    }\n                };\n                if let Some(state) = state {\n                    section.insert(\"state\", state);\n                }\n\n                let result = match complete.result {\n                    Argument::Missing =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        None\n                    },\n                    Argument::Valid =\u003e {\n                        let mut result = Document::new();\n                        result.insert(\"server_cookie\", Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: data.server_cookie.to_vec()}));\n                        result.insert(\"endpoint_challenge\", data.endpoint_challenge.value.clone());\n                        Some(Bson::Document(result))\n                    },\n                    Argument::Invalid(bson) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        Some(bson.value)\n                    }\n                    Argument::Random(bson) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        Some(bson.value)\n                    }\n                };\n                if let Some(result) = result {\n                    section.insert(\"result\", result);\n                }\n\n                sections.push(section);\n            } else if let Some(error) = error {\n                // build an error section if there's no complete section\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(ERROR_SECTION));\n\n                let cookie = match error.cookie {\n                    Argument::Missing =\u003e {\n                        expect_unknown_error_section = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(begin_handshake_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == begin_handshake_cookie {\n                            Some(Bson::Int64(!begin_handshake_cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if let Bson::Int64(value) = bson.value {\n                            Some(Bson::Null)\n                        } else {\n                            Some(bson.value)\n                        }\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let code = match error.code {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    }\n                    Argument::Valid =\u003e {\n                        // error success\n                        expect_gosling_unexpected_response = true;\n                        Some(Bson::Int32(0i32))\n                    },\n                    Argument::Invalid(code) =\u003e {\n                        // all i32 are somehow valid error codes\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if let Bson::Int32(value) = bson.value {\n                            Some(Bson::Null)\n                        } else {\n                            Some(bson.value)\n                        }\n                    }\n                };\n                if let Some(code) = code {\n                    section.insert(\"code\", code);\n                }\n\n                sections.push(section);\n            } else {\n                expect_timeout = true;\n            }\n\n            // convert sections into honk-rpc messages and serialize to byte vecs\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            if single_message {\n                let mut message = Document::new();\n                message.insert(\"honk_rpc\", HONK_RPC);\n\n                if sections.len() == 0 {\n                    expect_honkrpc_message_parse_failure = true;\n                }\n\n                message.insert(\"sections\", sections);\n\n                message.to_writer(\u0026mut bytes).unwrap();\n                if bytes.len() \u003e IDENTITY_MAX_MESSAGE_SIZE as usize {\n                    expect_bson_too_large = true;\n                }\n            } else {\n                let mut bytes_written = 0usize;\n                for section in sections.drain(..) {\n                    let mut message = Document::new();\n                    message.insert(\"honk_rpc\", HONK_RPC);\n                    message.insert(\"sections\", vec![section]);\n\n                    message.to_writer(\u0026mut bytes).unwrap();\n\n                    if bytes.len() - bytes_written \u003e IDENTITY_MAX_MESSAGE_SIZE as usize {\n                        expect_bson_too_large = true;\n                    }\n                    bytes_written = bytes.len();\n                }\n            }\n\n            bytes\n        },\n    };\n    alice_stream.write(message.as_slice()).unwrap();\n\n    //\n    // Bob receives begin_handshake() response and builds reply\n    //\n    let mut begin_handshake_complete: bool = false;\n    while !begin_handshake_complete {\n        for event in bob.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::IdentityClientHandshakeFailed{handle, reason} =\u003e {\n                    assert_eq!(handshake_handle, handle);\n                    match reason {\n                        context::Error::IdentityClientError(\n                            identity_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageReadTimedOut(_))) =\u003e {\n                            assert!(expect_timeout, \"{:?}\", reason);\n                        }\n                        context::Error::IdentityClientError(\n                            identity_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooSmall(_))) =\u003e {\n                            assert!(expect_bson_too_small, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityClientError(\n                            identity_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooLarge(_, _))) =\u003e {\n                            assert!(expect_bson_too_large, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityClientError(\n                            identity_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageConversionFailed(_))) =\u003e {\n                            assert!(expect_honkrpc_message_parse_failure, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityClientError(\n                            identity_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::UnknownErrorSectionReceived(_))) =\u003e {\n                            assert!(expect_unknown_error_section, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityClientError(\n                            identity_client::Error::UnexpectedResponseReceived(_)) =\u003e {\n                            assert!(expect_gosling_unexpected_response, \"{:?}\", reason);\n                        },\n                        error =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n                    // bob should have closed the connection on alice after handshake failure\n                    return;\n                }\n                ContextEvent::IdentityClientChallengeReceived{handle, endpoint_challenge} =\u003e {\n                    assert!(!begin_handshake_complete);\n                    assert!(!expect_timeout);\n                    assert!(!expect_bson_too_small);\n                    assert!(!expect_bson_too_large);\n                    assert!(!expect_honkrpc_message_parse_failure);\n                    assert!(!expect_gosling_unexpected_response);\n                    assert_eq!(handshake_handle, handle);\n                    // compare the raw bytes ince an arbitrary bson doc may have Double(NaN) which fails equality test\n                    assert_eq!({\n                        let mut bytes: Vec\u003cu8\u003e = Default::default();\n                        endpoint_challenge.to_writer(\u0026mut bytes).unwrap();\n                        bytes\n                    },{\n                        let mut bytes: Vec\u003cu8\u003e = Default::default();\n                        data.endpoint_challenge.value.to_writer(\u0026mut bytes).unwrap();\n                        bytes\n                    });\n\n                    // just reply with an empty challenge response\n                    match bob.identity_client_handle_challenge_received(handle, data.endpoint_challenge_response.value.clone()) {\n                        Ok(()) =\u003e begin_handshake_complete = true,\n                        // there is a limit to how large a response can be based on the honk-rpc max message size\n                        Err(context::Error::IdentityClientError(identity_client::Error::EndpointChallengeResponseTooLarge(_,_))) =\u003e return,\n                        Err(error) =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n                }\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n    // first update to queue the HonkRPC call\n    assert_eq!(0, bob.update().unwrap().len());\n    // second upate sends the HonkRPC message\n    assert_eq!(0, bob.update().unwrap().len());\n\n\n    // Alice receives send_reponse() and builds response\n    let send_response_cookie = {\n        let honkrpc_msg = bson::document::Document::from_reader(\u0026mut alice_stream).unwrap();\n        assert_eq!(honkrpc_msg.get_i32(\"honk_rpc\").unwrap(), HONK_RPC);\n        let sections = honkrpc_msg.get_array(\"sections\").unwrap();\n        assert_eq!(sections.len(), 1);\n        let honkrpc_request = match \u0026sections[0] {\n            Bson::Document(document) =\u003e document,\n            bson =\u003e panic!(\"unexpected bson in sections array: {}\", bson),\n        };\n        assert_eq!(honkrpc_request.get_i32(\"id\").unwrap(), REQUEST_SECTION);\n        let send_response_cookie = honkrpc_request.get_i64(\"cookie\").unwrap();\n        assert_eq!(honkrpc_request.get_str(\"namespace\").unwrap(), GOSLING_IDENTITY_NAMESPACE);\n        assert_eq!(honkrpc_request.get_str(\"function\").unwrap(), GOSLING_IDENTITY_SEND_RESPONSE_FUNCTION);\n        let arguments = honkrpc_request.get_document(\"arguments\").unwrap();\n        let client_cookie = arguments.get_binary_generic(\"client_cookie\").unwrap();\n        let client_identity_proof_signature = arguments.get_binary_generic(\"client_identity_proof_signature\").unwrap();\n        let client_authorization_key = arguments.get_binary_generic(\"client_authorization_key\").unwrap();\n        let client_authorization_key_signbit = arguments.get_bool(\"client_authorization_key_signbit\").unwrap();\n        let client_authorization_signature = arguments.get_binary_generic(\"client_authorization_signature\").unwrap();\n        let challenge_response = arguments.get_document(\"challenge_response\").unwrap();\n\n        send_response_cookie\n    };\n\n    let mut expect_timeout: bool = false;\n    let mut expect_bson_parse_failure: bool = false;\n    let mut expect_bson_too_small: bool = false;\n    let mut expect_bson_too_large: bool = false;\n    let mut expect_honkrpc_message_parse_failure: bool = false;\n    let mut expect_gosling_unexpected_response: bool = false;\n    let mut expect_unknown_error_section: bool = false;\n\n    let message: Vec\u003cu8\u003e = match data.send_response_response {\n        Response::Noise(bytes) =\u003e {\n            match bytes.len() {\n                0..=3 =\u003e expect_timeout = true,\n                len =\u003e {\n                    let size: i32 = (bytes[0] as i32)\n                                  | (bytes[1] as i32) \u003c\u003c 8\n                                  | (bytes[2] as i32) \u003c\u003c 16\n                                  | (bytes[3] as i32) \u003c\u003c 24;\n                    if size \u003c= 4 {\n                        expect_bson_too_small = true;\n                    } else if size \u003e IDENTITY_MAX_MESSAGE_SIZE {\n                        expect_bson_too_large = true;\n                    } else if size as usize \u003e len {\n                        expect_timeout = true;\n                    } else {\n                        match bson::document::Document::from_reader(Cursor::new(bytes.clone())) {\n                            Ok(_) =\u003e expect_honkrpc_message_parse_failure = true,\n                            Err(_) =\u003e expect_bson_parse_failure = true,\n                        }\n                    }\n                }\n            };\n            bytes.clone()\n        },\n        Response::Document(document) =\u003e {\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            document.value.to_writer(\u0026mut bytes).unwrap();\n            if bytes.len() \u003e IDENTITY_MAX_MESSAGE_SIZE as usize {\n                expect_bson_too_large = true;\n            } else {\n                expect_honkrpc_message_parse_failure = true;\n            }\n            bytes\n        },\n        Response::HonkRPC{single_message, pending, complete, error} =\u003e {\n            let mut sections: Vec\u003cDocument\u003e = Default::default();\n\n            // build our pending section\n            if let Some(pending) = pending {\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(RESPONSE_SECTION));\n\n                let cookie = match pending.cookie {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(send_response_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == send_response_cookie {\n                            Some(Bson::Int64(!cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int64(cookie) = bson.value {\n                            if cookie != send_response_cookie {\n                                expect_gosling_unexpected_response = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n\n                        Some(bson.value)\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let state = match pending.state {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int32(PENDING_REQUEST_STATE)),\n                    Argument::Invalid(state) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if state == PENDING_REQUEST_STATE {\n                            Some(Bson::Int32(!state))\n                        } else {\n                            Some(Bson::Int32(state))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int32(state) = bson.value {\n                            if state != PENDING_REQUEST_STATE {\n                                expect_honkrpc_message_parse_failure = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n                        Some(bson.value)\n                    }\n                };\n                if let Some(state) = state {\n                    section.insert(\"state\", state);\n                }\n\n                let result = match pending.result {\n                    Argument::Missing =\u003e None,\n                    Argument::Valid =\u003e None,\n                    Argument::Invalid(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        Some(bson.value)\n                    }\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        Some(bson.value)\n                    }\n                };\n                if let Some(result) = result {\n                    section.insert(\"result\", result);\n                }\n\n                sections.push(section);\n            }\n            // build our complete section\n            if let Some(complete) = complete {\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(RESPONSE_SECTION));\n\n                let cookie = match complete.cookie {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(send_response_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == send_response_cookie {\n                            Some(Bson::Int64(!cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int64(cookie) = bson.value {\n                            if cookie != send_response_cookie {\n                                expect_gosling_unexpected_response = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n\n                        Some(bson.value)\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let state = match complete.state {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int32(COMPLETE_REQUEST_STATE)),\n                    Argument::Invalid(state) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if state == COMPLETE_REQUEST_STATE {\n                            Some(Bson::Int32(!state))\n                        } else {\n                            Some(Bson::Int32(state))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        if let Bson::Int32(state) = bson.value {\n                            if state == PENDING_REQUEST_STATE {\n                                expect_timeout = true;\n                            } else if state != COMPLETE_REQUEST_STATE {\n                                expect_honkrpc_message_parse_failure = true;\n                            }\n                        } else {\n                            expect_honkrpc_message_parse_failure = true;\n                        }\n                        Some(bson.value)\n                    }\n                };\n                if let Some(state) = state {\n                    section.insert(\"state\", state);\n                }\n\n                let result = match complete.result {\n                    Argument::Missing =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        None\n                    },\n                    Argument::Valid =\u003e {\n                        Some(Bson::String(data.endpoint_service_id.value.to_string()))\n                    },\n                    Argument::Invalid(bson) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        Some(bson.value)\n                    },\n                    Argument::Random(bson) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        Some(bson.value)\n                    },\n                };\n                if let Some(result) = result {\n                    section.insert(\"result\", result);\n                }\n\n                sections.push(section);\n            } else if let Some(error) = error {\n                // build an error section if there's no complete section\n                let mut section = Document::new();\n                section.insert(\"id\", Bson::Int32(ERROR_SECTION));\n\n                let cookie = match error.cookie {\n                    Argument::Missing =\u003e {\n                        expect_unknown_error_section = true;\n                        None\n                    },\n                    Argument::Valid =\u003e Some(Bson::Int64(send_response_cookie)),\n                    Argument::Invalid(cookie) =\u003e {\n                        expect_gosling_unexpected_response = true;\n                        if cookie == send_response_cookie {\n                            Some(Bson::Int64(!send_response_cookie))\n                        } else {\n                            Some(Bson::Int64(cookie))\n                        }\n                    },\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if let Bson::Int64(value) = bson.value {\n                            Some(Bson::Null)\n                        } else {\n                            Some(bson.value)\n                        }\n                    }\n                };\n                if let Some(cookie) = cookie {\n                    section.insert(\"cookie\", cookie);\n                }\n\n                let code = match error.code {\n                    Argument::Missing =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    }\n                    Argument::Valid =\u003e {\n                        // error success\n                        expect_gosling_unexpected_response = true;\n                        Some(Bson::Int32(0i32))\n                    },\n                    Argument::Invalid(code) =\u003e {\n                        // all i32 are somehow valid error codes\n                        expect_honkrpc_message_parse_failure = true;\n                        None\n                    },\n                    Argument::Random(bson) =\u003e {\n                        expect_honkrpc_message_parse_failure = true;\n                        if let Bson::Int32(value) = bson.value {\n                            Some(Bson::Null)\n                        } else {\n                            Some(bson.value)\n                        }\n                    }\n                };\n                if let Some(code) = code {\n                    section.insert(\"code\", code);\n                }\n\n                sections.push(section);\n            } else {\n                expect_timeout = true;\n            }\n\n            // convert sections into honk-rpc messages and serialize to byte vecs\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            if single_message {\n                let mut message = Document::new();\n                message.insert(\"honk_rpc\", HONK_RPC);\n\n                if sections.len() == 0 {\n                    expect_honkrpc_message_parse_failure = true;\n                }\n\n                message.insert(\"sections\", sections);\n\n                message.to_writer(\u0026mut bytes).unwrap();\n                if bytes.len() \u003e IDENTITY_MAX_MESSAGE_SIZE as usize {\n                    expect_bson_too_large = true;\n                }\n            } else {\n                let mut bytes_written = 0usize;\n                for section in sections.drain(..) {\n                    let mut message = Document::new();\n                    message.insert(\"honk_rpc\", HONK_RPC);\n                    message.insert(\"sections\", vec![section]);\n\n                    message.to_writer(\u0026mut bytes).unwrap();\n\n                    if bytes.len() - bytes_written \u003e IDENTITY_MAX_MESSAGE_SIZE as usize {\n                        expect_bson_too_large = true;\n                    }\n                    bytes_written = bytes.len();\n                }\n            }\n\n            bytes\n        },\n    };\n    alice_stream.write(message.as_slice()).unwrap();\n\n    //\n    // Bob receives send_response() response and finishes handshake\n    //\n    let mut send_response_complete: bool = false;\n    while !send_response_complete {\n        for event in bob.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::IdentityClientHandshakeFailed{handle, reason} =\u003e {\n                    assert_eq!(handshake_handle, handle);\n                    match reason {\n                        context::Error::IdentityClientError(\n                            identity_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageReadTimedOut(_))) =\u003e {\n                            assert!(expect_timeout, \"{:?}\", reason);\n                        }\n                        context::Error::IdentityClientError(\n                            identity_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooSmall(_))) =\u003e {\n                            assert!(expect_bson_too_small, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityClientError(\n                            identity_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooLarge(_, _))) =\u003e {\n                            assert!(expect_bson_too_large, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityClientError(\n                            identity_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageConversionFailed(_))) =\u003e {\n                            assert!(expect_honkrpc_message_parse_failure, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityClientError(\n                            identity_client::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::UnknownErrorSectionReceived(_))) =\u003e {\n                            assert!(expect_unknown_error_section, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityClientError(\n                            identity_client::Error::UnexpectedResponseReceived(_)) =\u003e {\n                            assert!(expect_gosling_unexpected_response, \"{:?}\", reason);\n                        },\n                        error =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n                    // bob should have closed the connection on alice after handshake failure\n                    return;\n                },\n                ContextEvent::IdentityClientHandshakeCompleted{handle, identity_service_id, endpoint_service_id, endpoint_name, client_auth_private_key} =\u003e {\n                    assert_eq!(handshake_handle, handle);\n                    assert_eq!(identity_service_id, alice_onion_service_id);\n                    assert_eq!(endpoint_service_id, data.endpoint_service_id.value);\n                    assert_eq!(endpoint_name, VALID_ENDPOINT);\n                    send_response_complete = true;\n                },\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n});\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","fuzz","fuzz_targets","fuzz_identity_server.rs"],"content":"#![no_main]\n\n// std\nuse std::io::{Cursor, Write};\nuse std::time::Duration;\n\n// gosling\nuse ::gosling::*;\nuse context::*;\n\n// extern\nuse bson::Bson;\nuse bson::Document;\nuse bson::doc;\nuse bson::spec::BinarySubtype;\nuse data_encoding::HEXLOWER;\nuse tor_interface::mock_tor_client::*;\nuse tor_interface::tor_crypto::*;\nuse tor_interface::tor_provider::*;\nuse honk_rpc::honk_rpc::{get_message_overhead, get_response_section_size};\n\n// fuzzing\nuse libfuzzer_sys::fuzz_target;\nuse libfuzzer_sys::arbitrary;\nuse libfuzzer_sys::arbitrary::Arbitrary;\n\nmod arbitrary_types;\nuse crate::arbitrary_types::*;\n\nmod utils;\nuse crate::utils::*;\n\n#[derive(Arbitrary, Debug)]\nenum BeginHandshakeMessage {\n    // random bytes\n    Noise(Vec\u003cu8\u003e),\n    /* HonkRpcMessage */\n    /* BSON */\n    // a valid honkrpc request\n    Request{\n        version: Argument\u003cString\u003e,\n        client_identity: Argument\u003cArbitraryV3OnionServiceId\u003e,\n        endpoint: Argument\u003cString\u003e,\n    },\n}\n\n#[derive(Arbitrary, Debug)]\nenum SendResponseMessage {\n    Noise(Vec\u003cu8\u003e),\n    /* HonkRpcMessage */\n    /* BSON */\n    // a valid honkrpc requst\n    Request{\n        client_cookie: Argument\u003cCookie\u003e,\n        client_identity_proof_signature: Argument\u003cArbitraryEd25519Signature\u003e,\n        client_authorization_key: Argument\u003cArbitraryX25519PrivateKey\u003e,\n        client_authorization_key_signbit: Argument\u003cbool\u003e,\n        client_authorization_signature: Argument\u003cArbitraryEd25519Signature\u003e,\n        challenge_response: Argument\u003cArbitraryBSONDocument\u003e,\n    },\n}\n\n#[derive(Arbitrary, Debug)]\nstruct HandshakeData {\n    // server data\n    alice_private_ed25519: ArbitraryEd25519PrivateKey,\n    client_allowed: bool,\n    endpoint_supported: bool,\n    endpoint_challenge: ArbitraryBSONDocument,\n    // client data\n    bob_private_ed25519: ArbitraryEd25519PrivateKey,\n    bob_private_x25519: ArbitraryX25519PrivateKey,\n    client_cookie: Cookie,\n    // client messages\n    begin_handshake_cookie: i64,\n    begin_handshake: BeginHandshakeMessage,\n    send_response_cookie: i64,\n    send_response: SendResponseMessage,\n}\n\n// two gosling instance, Alice and Bob\n// Alice is a valid server, Bob connects and sends garbage at certain point in the form of bad data in correctly structured+ordered gosling bison messages or noise\nfuzz_target!(|data: HandshakeData| {\n\n    //\n    // Init Alice server and malicious Bob client\n    //\n\n    // init alice\n    let alice_tor = MockTorClient::new();\n\n    // create alice gosling context\n    let alice_private_key = data.alice_private_ed25519.value;\n    let alice_onion_service_id = V3OnionServiceId::from_private_key(\u0026alice_private_key);\n    let mut alice = Context::new(Box::new(alice_tor), 420, 420, std::time::Duration::from_millis(32), IDENTITY_MAX_MESSAGE_SIZE, None, alice_private_key).unwrap();\n\n    // bootstrap alice\n    alice.bootstrap().unwrap();\n    let mut identity_server_published: bool = false;\n    while !identity_server_published {\n        for event in alice.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::TorBootstrapStatusReceived{progress: _, tag: _, summary: _} =\u003e (),\n                ContextEvent::TorBootstrapCompleted =\u003e {\n                    // start alice identity server\n                    alice.identity_server_start().unwrap();\n                }\n                ContextEvent::TorLogReceived{line: _} =\u003e (),\n                ContextEvent::IdentityServerPublished =\u003e {\n                    identity_server_published = true;\n                }\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n\n    // init bob\n    let mut bob_tor = MockTorClient::new();\n\n    // bootstrap bob\n    bob_tor.bootstrap().unwrap();\n    let mut bootstrap_complete = false;\n    while !bootstrap_complete {\n        for event in bob_tor.update().unwrap().drain(..) {\n            match event {\n                TorEvent::BootstrapComplete =\u003e {\n                    bootstrap_complete = true;\n                }\n                _ =\u003e ()\n            }\n        }\n    }\n\n    let bob_private_key = data.bob_private_ed25519.value;\n    let bob_onion_service_id = V3OnionServiceId::from_private_key(\u0026bob_private_key);\n    let bob_onion_service_id_string = bob_onion_service_id.to_string();\n\n    // bob connects to alice\n    let mut bob_stream = bob_tor.connect((alice_onion_service_id.clone(), 420).into(), None).unwrap();\n    bob_stream.set_nonblocking(false).unwrap();\n    bob_stream.set_read_timeout(Some(Duration::from_millis(100u64))).unwrap();\n\n    //\n    // Alice waits for handshake started\n    //\n    let mut alice_handshake_started: bool = false;\n    let mut alice_handshake_handle: HandshakeHandle = INVALID_HANDSHAKE_HANDLE;\n    while !alice_handshake_started {\n        for event in alice.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::IdentityServerHandshakeStarted{handle} =\u003e {\n                    alice_handshake_started = true;\n                    alice_handshake_handle = handle;\n                }\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n\n    //\n    // Bob sends begin_handshake()\n    //\n    #[derive(PartialEq, Debug)]\n    enum ExpectedBeginHandshakeResponse {\n        // Success Case\n        EndpointRequestReceived,\n        // Error Cases\n        ErrorTimedOut,\n        ErrorBsonParseFailure,\n        ErrorBsonTooSmall,\n        ErrorBsonTooLarge,\n        ErrorMessageParseFailure,\n        ErrorBadGoslingVersion,\n        ErrorInvalidArg,\n        ErrorBadClient,\n    }\n    let mut expected_response = ExpectedBeginHandshakeResponse::EndpointRequestReceived;\n\n    let message = match \u0026data.begin_handshake {\n        BeginHandshakeMessage::Noise(bytes) =\u003e {\n            expected_response = match bytes.len() {\n                0..=3 =\u003e ExpectedBeginHandshakeResponse::ErrorTimedOut,\n                len =\u003e {\n                    let size: i32 = (bytes[0] as i32)\n                                  | (bytes[1] as i32) \u003c\u003c 8\n                                  | (bytes[2] as i32) \u003c\u003c 16\n                                  | (bytes[3] as i32) \u003c\u003c 24;\n                    if size \u003c= 4 {\n                        ExpectedBeginHandshakeResponse::ErrorBsonTooSmall\n                    } else if size \u003e IDENTITY_MAX_MESSAGE_SIZE {\n                        ExpectedBeginHandshakeResponse::ErrorBsonTooLarge\n                    } else if size as usize \u003e len {\n                        ExpectedBeginHandshakeResponse::ErrorTimedOut\n                    } else {\n                        match bson::document::Document::from_reader(Cursor::new(bytes.clone())) {\n                            Ok(_) =\u003e ExpectedBeginHandshakeResponse::ErrorMessageParseFailure,\n                            Err(_) =\u003e ExpectedBeginHandshakeResponse::ErrorBsonParseFailure,\n                        }\n                    }\n                }\n            };\n            bytes.clone()\n        },\n        BeginHandshakeMessage::Request{\n            version,\n            client_identity,\n            endpoint} =\u003e {\n            match (\u0026version, \u0026client_identity, \u0026endpoint) {\n                (Argument::Valid, Argument::Valid | Argument::Invalid(_), Argument::Valid | Argument::Invalid(_)) =\u003e (),\n                (Argument::Missing | Argument::Invalid(_) | Argument::Random(_), _, _) =\u003e  expected_response = ExpectedBeginHandshakeResponse::ErrorBadGoslingVersion,\n                _ =\u003e expected_response = ExpectedBeginHandshakeResponse::ErrorInvalidArg,\n            }\n\n            let mut message = Document::new();\n            message.insert(\"honk_rpc\", Bson::Int32(HONK_RPC));\n\n            let mut section = Document::new();\n            section.insert(\"id\", Bson::Int32(REQUEST_SECTION));\n            section.insert(\"namespace\", Bson::String(\"gosling_identity\".to_string()));\n            section.insert(\"function\", Bson::String(\"begin_handshake\".to_string()));\n            section.insert(\"cookie\", Bson::Int64(data.begin_handshake_cookie));\n\n            let mut arguments = Document::new();\n            let version = match version {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e Some(Bson::String(GOSLING_PROTOCOL_VERSION.to_string())),\n                Argument::Invalid(invalid) =\u003e {\n                    if invalid == GOSLING_PROTOCOL_VERSION {\n                        Some(Bson::String(\"invalid_version\".to_string()))\n                    } else {\n                        Some(Bson::String(invalid.clone()))\n                    }\n                },\n                Argument::Random(ArbitraryBSON{value: Bson::String(_)}) =\u003e Some(Bson::Null),\n                Argument::Random(bson) =\u003e Some(bson.value.clone()),\n            };\n            if let Some(version) = version {\n                arguments.insert(\"version\", version);\n            }\n\n            let client_identity = match client_identity {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e Some(Bson::String(bob_onion_service_id_string.clone())),\n                Argument::Invalid(invalid) =\u003e {\n                    let invalid = invalid.value.to_string();\n                    Some(Bson::String(invalid))\n                },\n                Argument::Random(ArbitraryBSON{value: Bson::String(_)}) =\u003e Some(Bson::Null),\n                Argument::Random(bson) =\u003e Some(bson.value.clone()),\n            };\n            if let Some(client_identity) = client_identity {\n                arguments.insert(\"client_identity\", client_identity);\n            }\n\n            let endpoint = match endpoint {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e Some(Bson::String(VALID_ENDPOINT.to_string())),\n                Argument::Invalid(value) =\u003e {\n                    if value == VALID_ENDPOINT {\n                        Some(Bson::String(\"invalid_endpoint\".to_string()))\n                    } else if value.is_ascii() {\n                        Some(Bson::String(value.clone()))\n                    } else {\n                        Some(Bson::String(Default::default()))\n                    }\n                },\n                Argument::Random(ArbitraryBSON{value: Bson::String(value)}) =\u003e {\n                    if !value.is_ascii() {\n                        Some(Bson::String(value.clone()))\n                    } else {\n                        Some(Bson::Null)\n                    }\n                },\n                Argument::Random(bson) =\u003e Some(bson.value.clone()),\n            };\n            if let Some(endpoint) = endpoint {\n                arguments.insert(\"endpoint\", endpoint);\n            }\n\n            section.insert(\"arguments\", arguments);\n            message.insert(\"sections\", vec![section]);\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            message.to_writer(\u0026mut bytes).unwrap();\n            if bytes.len() \u003e IDENTITY_MAX_MESSAGE_SIZE as usize {\n                expected_response = ExpectedBeginHandshakeResponse::ErrorBsonTooLarge;\n            }\n            bytes\n        },\n    };\n    bob_stream.write(message.as_slice()).unwrap();\n\n    //\n    // Alice handles begin_handshake()\n    //\n    let mut alice_begin_handshake_handled: bool = false;\n    while !alice_begin_handshake_handled {\n        for event in alice.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::IdentityServerEndpointRequestReceived{handle, client_service_id: _, requested_endpoint} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    assert_eq!(expected_response, ExpectedBeginHandshakeResponse::EndpointRequestReceived);\n                    #[derive(PartialEq, Debug)]\n                    enum ExpectedHandleEndpointRequestReceiveResult {\n                        Success,\n                        // Error Cases\n                        ErrorSectionTooLarge,\n                    }\n\n                    let mut expected_result = ExpectedHandleEndpointRequestReceiveResult::Success;\n\n                    // calculate the expected size of our reponse message\n                    let begin_handshake_complete_message_size = {\n                        let result = doc!{\n                            \"server_cookie\" : bson::Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: [0u8; COOKIE_SIZE].to_vec()}),\n                            \"endpoint_challenge\" : data.endpoint_challenge.value.clone(),\n                        };\n                        let response_section_size = get_response_section_size(Some(Bson::Document(result))).unwrap();\n                        get_message_overhead().unwrap() + response_section_size\n                    };\n                    if begin_handshake_complete_message_size \u003e IDENTITY_MAX_MESSAGE_SIZE as usize {\n                        expected_result = ExpectedHandleEndpointRequestReceiveResult::ErrorSectionTooLarge;\n                    }\n\n                    match alice.identity_server_handle_endpoint_request_received(\n                        alice_handshake_handle,\n                        data.client_allowed,\n                        data.endpoint_supported \u0026\u0026 requested_endpoint == VALID_ENDPOINT,\n                        data.endpoint_challenge.value.clone()) {\n                        Err(context::Error::IdentityServerError(identity_server::Error::EndpointChallengeTooLarge(_,_))) =\u003e {\n                            assert_eq!(expected_result, ExpectedHandleEndpointRequestReceiveResult::ErrorSectionTooLarge);\n                            return;\n                        },\n                        Ok(()) =\u003e {\n                            assert_eq!(expected_result, ExpectedHandleEndpointRequestReceiveResult::Success);\n                        }\n                        result =\u003e panic!(\"unexpected result: {:?}\", result)\n                    }\n\n                    alice_begin_handshake_handled = true;\n                }\n                ContextEvent::IdentityServerHandshakeFailed{handle, reason} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    match reason {\n                        context::Error::IdentityServerError(\n                            identity_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageReadTimedOut(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedBeginHandshakeResponse::ErrorTimedOut, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityServerError(\n                            identity_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentParseFailed(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedBeginHandshakeResponse::ErrorBsonParseFailure, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityServerError(\n                            identity_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooSmall(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedBeginHandshakeResponse::ErrorBsonTooSmall, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityServerError(\n                            identity_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooLarge(_, _))) =\u003e {\n                            assert_eq!(expected_response, ExpectedBeginHandshakeResponse::ErrorBsonTooLarge, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityServerError(\n                            identity_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageConversionFailed(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedBeginHandshakeResponse::ErrorMessageParseFailure, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityServerError(identity_server::Error::BadClient) =\u003e {\n                            assert!(expected_response == ExpectedBeginHandshakeResponse::ErrorBadClient ||\n                                    expected_response == ExpectedBeginHandshakeResponse::ErrorBadGoslingVersion ||\n                                    expected_response == ExpectedBeginHandshakeResponse::ErrorInvalidArg, \"{:?}\", reason);\n                        },\n                        error =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n                    alice_begin_handshake_handled = true;\n                }\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n        // Alice sends Bob begin_handshake() response (or does nothing)\n    for event in alice.update().unwrap().drain(..) {\n        match event {\n            event =\u003e panic!(\"unexpected event: {:?}\", event),\n        }\n    }\n\n    //\n    // Bob reads begin_handshake() response or error sections\n    //\n\n    // bob receives begin_handshake() pending response\n    let begin_handshake_pending = bson::document::Document::from_reader(\u0026mut bob_stream);\n    match expected_response {\n        ExpectedBeginHandshakeResponse::ErrorTimedOut |\n        ExpectedBeginHandshakeResponse::ErrorBsonTooSmall |\n        ExpectedBeginHandshakeResponse::ErrorBsonTooLarge |\n        ExpectedBeginHandshakeResponse::ErrorBsonParseFailure |\n        ExpectedBeginHandshakeResponse::ErrorMessageParseFailure =\u003e {\n            match begin_handshake_pending {\n                Err(bson::de::Error::Io(_)) =\u003e return,\n                Ok(message) =\u003e panic!(\"unexpected message: {:?}\", message),\n                Err(error) =\u003e panic!(\"unexpected error: {:?}\", error),\n            }\n        },\n        ExpectedBeginHandshakeResponse::ErrorBadGoslingVersion =\u003e {\n            match begin_handshake_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": ERROR_SECTION,\n                                \"cookie\": data.begin_handshake_cookie,\n                                \"code\": ERROR_CODE_BAD_VERSION,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n        ExpectedBeginHandshakeResponse::ErrorInvalidArg =\u003e {\n            match begin_handshake_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": ERROR_SECTION,\n                                \"cookie\": data.begin_handshake_cookie,\n                                \"code\": ERROR_CODE_INVALID_ARG,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n        ExpectedBeginHandshakeResponse::EndpointRequestReceived |\n        ExpectedBeginHandshakeResponse::ErrorBadClient =\u003e {\n            match begin_handshake_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": RESPONSE_SECTION,\n                                \"cookie\": data.begin_handshake_cookie,\n                                \"state\": PENDING_REQUEST_STATE,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        }\n    }\n\n    // bob receives begin_handshake() result\n    let begin_handshake_result = bson::document::Document::from_reader(\u0026mut bob_stream);\n    let mut server_cookie: Cookie = Default::default();\n    match expected_response {\n        ExpectedBeginHandshakeResponse::ErrorTimedOut |\n        ExpectedBeginHandshakeResponse::ErrorBsonTooSmall |\n        ExpectedBeginHandshakeResponse::ErrorBsonTooLarge |\n        ExpectedBeginHandshakeResponse::ErrorBsonParseFailure |\n        ExpectedBeginHandshakeResponse::ErrorMessageParseFailure |\n        ExpectedBeginHandshakeResponse::ErrorBadGoslingVersion |\n        ExpectedBeginHandshakeResponse::ErrorInvalidArg =\u003e {\n            match begin_handshake_result {\n                Err(bson::de::Error::Io(_)) =\u003e return,\n                Ok(message) =\u003e panic!(\"unexpected message: {:?}\", message),\n                Err(error) =\u003e panic!(\"unexpected error: {:?}\", error),\n            }\n        },\n        ExpectedBeginHandshakeResponse::ErrorBadClient =\u003e {\n            match begin_handshake_result {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": ERROR_SECTION,\n                                \"cookie\": data.begin_handshake_cookie,\n                                \"code\": ERROR_CODE_FAILURE,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n        ExpectedBeginHandshakeResponse::EndpointRequestReceived =\u003e {\n            match begin_handshake_result {\n                Ok(message) =\u003e {\n                    assert_eq!(message.get_i32(\"honk_rpc\").unwrap(), HONK_RPC);\n                    let sections = message.get_array(\"sections\").unwrap();\n                    assert_eq!(sections.len(), 1);\n                    let section = \u0026sections[0];\n                    match section {\n                        Bson::Document(section) =\u003e {\n                            assert_eq!(section.get_i32(\"id\"), Ok(RESPONSE_SECTION));\n                            let response = section;\n                            assert_eq!(response.get_i64(\"cookie\"), Ok(data.begin_handshake_cookie));\n                            assert_eq!(response.get_i32(\"state\"), Ok(COMPLETE_REQUEST_STATE));\n                            let result = response.get_document(\"result\").unwrap();\n                            server_cookie = result.get_binary_generic(\"server_cookie\").unwrap().clone().try_into().unwrap();\n                            let endpoint_challenge = result.get_document(\"endpoint_challenge\").unwrap();\n                            // compare the raw bytes ince an arbitrary bson doc may have Double(NaN) which fails equality test\n                            assert_eq!({\n                                let mut bytes: Vec\u003cu8\u003e = Default::default();\n                                endpoint_challenge.to_writer(\u0026mut bytes).unwrap();\n                                bytes\n                            },{\n                                let mut bytes: Vec\u003cu8\u003e = Default::default();\n                                data.endpoint_challenge.value.to_writer(\u0026mut bytes).unwrap();\n                                bytes\n                            });\n                        },\n                        bson =\u003e panic!(\"unexpected section: {:?}\", bson),\n                    }\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        }\n\n    }\n\n    //\n    // Bsob sends send_response()\n    //\n\n    #[derive(PartialEq, Debug)]\n    enum ExpectedSendResponseResponse {\n        // Success Case\n        EndpointOnionServiceIdReceived,\n        // Error Cases\n        ErrorTimedOut,\n        ErrorBsonParseFailure,\n        ErrorBsonTooSmall,\n        ErrorBsonTooLarge,\n        ErrorMessageParseFailure,\n        ErrorInvalidArg,\n        ErrorBadClient,\n    }\n    let mut expected_response = match (data.client_allowed \u0026\u0026 data.endpoint_supported, data.begin_handshake) {\n        (true, BeginHandshakeMessage::Request{version: Argument::Valid, client_identity: Argument::Valid, endpoint: Argument::Valid}) =\u003e ExpectedSendResponseResponse::EndpointOnionServiceIdReceived,\n        _ =\u003e ExpectedSendResponseResponse::ErrorBadClient,\n    };\n\n    let message = match data.send_response {\n        SendResponseMessage::Noise(bytes) =\u003e {\n            expected_response = match bytes.len() {\n                0..=3 =\u003e ExpectedSendResponseResponse::ErrorTimedOut,\n                len =\u003e {\n                    let size: i32 = (bytes[0] as i32)\n                                  | (bytes[1] as i32) \u003c\u003c 8\n                                  | (bytes[2] as i32) \u003c\u003c 16\n                                  | (bytes[3] as i32) \u003c\u003c 24;\n                    if size \u003c= 4 {\n                        ExpectedSendResponseResponse::ErrorBsonTooSmall\n                    } else if size \u003e IDENTITY_MAX_MESSAGE_SIZE {\n                        ExpectedSendResponseResponse::ErrorBsonTooLarge\n                    } else if size as usize \u003e len {\n                        ExpectedSendResponseResponse::ErrorTimedOut\n                    } else {\n                        match bson::document::Document::from_reader(Cursor::new(bytes.clone())) {\n                            Ok(_) =\u003e ExpectedSendResponseResponse::ErrorMessageParseFailure,\n                            Err(_) =\u003e ExpectedSendResponseResponse::ErrorBsonParseFailure,\n                        }\n                    }\n                }\n            };\n            bytes\n        },\n        SendResponseMessage::Request{\n            client_cookie,\n            client_identity_proof_signature,\n            client_authorization_key,\n            client_authorization_key_signbit,\n            client_authorization_signature,\n            challenge_response} =\u003e {\n            match (\u0026client_cookie, \u0026client_identity_proof_signature, \u0026client_authorization_key, \u0026client_authorization_key_signbit, \u0026client_authorization_signature, \u0026challenge_response) {\n                (Argument::Valid, Argument::Valid, Argument::Valid, Argument::Valid, Argument::Valid, Argument::Valid) =\u003e (),\n                (Argument::Valid | Argument::Invalid(_),\n                 Argument::Valid | Argument::Invalid(_),\n                 Argument::Valid | Argument::Invalid(_),\n                 Argument::Valid | Argument::Invalid(_),\n                 Argument::Valid | Argument::Invalid(_),\n                 Argument::Valid | Argument::Invalid(_)) =\u003e expected_response = ExpectedSendResponseResponse::ErrorBadClient,\n                _ =\u003e expected_response = ExpectedSendResponseResponse::ErrorInvalidArg,\n            }\n\n            let mut message = Document::new();\n            message.insert(\"honk_rpc\", Bson::Int32(HONK_RPC));\n\n            let mut section = Document::new();\n            section.insert(\"id\", Bson::Int32(REQUEST_SECTION));\n            section.insert(\"namespace\", Bson::String(\"gosling_identity\".to_string()));\n            section.insert(\"function\", Bson::String(\"send_response\".to_string()));\n            section.insert(\"cookie\", Bson::Int64(data.send_response_cookie));\n\n            let mut arguments = Document::new();\n            let client_cookie = match client_cookie {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: data.client_cookie.to_vec()})),\n                Argument::Invalid(value) =\u003e {\n                    // ensure the cookie is actually invalid\n                    if value == data.client_cookie {\n                        Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: value.map(|x| !x).to_vec()}))\n                    } else {\n                        Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: value.to_vec()}))\n                    }\n                }\n                Argument::Random(ArbitraryBSON{value: Bson::Binary(_)}) =\u003e Some(Bson::Null),\n                Argument::Random(bson) =\u003e Some(bson.value),\n            };\n            if let Some(client_cookie) = client_cookie {\n                arguments.insert(\"client_cookie\", client_cookie);\n            }\n\n            let client_identity_proof_signature = match client_identity_proof_signature {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e {\n                    let client_identity_proof = build_client_proof(\"gosling-identity\", VALID_ENDPOINT, \u0026bob_onion_service_id, \u0026alice_onion_service_id, \u0026data.client_cookie, \u0026server_cookie);\n                    let client_identity_proof_signature = bob_private_key.sign_message(\u0026client_identity_proof);\n                    Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_identity_proof_signature.to_bytes().to_vec()}))\n                },\n                Argument::Invalid(invalid) =\u003e {\n                    Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: invalid.value.to_bytes().to_vec()}))\n                }\n                Argument::Random(ArbitraryBSON{value: Bson::Binary(_)}) =\u003e Some(Bson::Null),\n                Argument::Random(bson) =\u003e Some(bson.value),\n            };\n            if let Some(client_identity_proof_signature) = client_identity_proof_signature {\n                arguments.insert(\"client_identity_proof_signature\", client_identity_proof_signature);\n            }\n\n            let client_authorization_key = match client_authorization_key {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e {\n                    let client_authorization_key = X25519PublicKey::from_private_key(\u0026data.bob_private_x25519.value);\n                    Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_authorization_key.as_bytes().to_vec()}))\n                },\n                Argument::Invalid(invalid) =\u003e {\n                    let client_authorization_key = X25519PublicKey::from_private_key(\u0026invalid.value);\n                    Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_authorization_key.as_bytes().to_vec()}))\n                },\n                Argument::Random(bson) =\u003e Some(bson.value),\n            };\n            if let Some(client_authorization_key) = client_authorization_key {\n                arguments.insert(\"client_authorization_key\", client_authorization_key);\n            }\n\n            let client_authorization_signing_key_private = Ed25519PrivateKey::from_private_x25519(\u0026data.bob_private_x25519.value).unwrap();\n            let client_authorization_key_signbit = match client_authorization_key_signbit {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e {\n                    let signbit = client_authorization_signing_key_private.1;\n                    Some(Bson::Boolean(bool::from(signbit)))\n                },\n                Argument::Invalid(_) =\u003e {\n                    let signbit = client_authorization_signing_key_private.1;\n                    Some(Bson::Boolean(!bool::from(signbit)))\n                },\n                Argument::Random(ArbitraryBSON{value: Bson::Boolean(_)}) =\u003e Some(Bson::Null),\n                Argument::Random(bson) =\u003e Some(bson.value),\n            };\n            if let Some(client_authorization_key_signbit) = client_authorization_key_signbit {\n                arguments.insert(\"client_authorization_key_signbit\", client_authorization_key_signbit);\n            }\n\n            let client_authorization_signature = match client_authorization_signature {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e {\n                    let client_authorization_signature = client_authorization_signing_key_private.0.sign_message(bob_onion_service_id_string.as_bytes());\n                    Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_authorization_signature.to_bytes().to_vec()}))\n                },\n                Argument::Invalid(invalid) =\u003e {\n                    Some(Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: invalid.value.to_bytes().to_vec()}))\n                },\n                Argument::Random(bson) =\u003e Some(bson.value),\n            };\n            if let Some(client_authorization_signature) = client_authorization_signature {\n                arguments.insert(\"client_authorization_signature\", client_authorization_signature);\n            }\n\n            let challenge_response = match challenge_response {\n                Argument::Missing =\u003e None,\n                Argument::Valid =\u003e Some(Bson::Document(Document::new())),\n                Argument::Invalid(ArbitraryBSONDocument{value}) =\u003e {\n                    // server is expecting an empty response so to be invalid\n                    // it must contain *some* member\n                    if value == Document::new() {\n                        Some(Bson::Document(doc!{\"foo\": Bson::Null}))\n                    } else {\n                        Some(Bson::Document(value))\n                    }\n                },\n                Argument::Random(ArbitraryBSON{value: Bson::Document(_)}) =\u003e Some(Bson::Null),\n                Argument::Random(bson) =\u003e Some(bson.value),\n            };\n            if let Some(challenge_response) = challenge_response {\n                arguments.insert(\"challenge_response\", challenge_response);\n            }\n\n            section.insert(\"arguments\", arguments);\n            message.insert(\"sections\", vec![section]);\n            let mut bytes: Vec\u003cu8\u003e = Default::default();\n            message.to_writer(\u0026mut bytes).unwrap();\n            if bytes.len() \u003e IDENTITY_MAX_MESSAGE_SIZE as usize {\n                expected_response = ExpectedSendResponseResponse::ErrorBsonTooLarge;\n            }\n            bytes\n        },\n    };\n    bob_stream.write(message.as_slice()).unwrap();\n\n\n    //\n    // Alice handles send_response()\n    //\n\n    let mut alice_send_response_handled: bool = false;\n    while !alice_send_response_handled {\n        for event in alice.update().unwrap().drain(..) {\n            match event {\n                ContextEvent::IdentityServerHandshakeFailed{handle, reason} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    match reason {\n                        context::Error::IdentityServerError(\n                            identity_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageReadTimedOut(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedSendResponseResponse::ErrorTimedOut, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityServerError(\n                            identity_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentParseFailed(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedSendResponseResponse::ErrorBsonParseFailure, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityServerError(\n                            identity_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooSmall(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedSendResponseResponse::ErrorBsonTooSmall, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityServerError(\n                            identity_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::BsonDocumentSizeTooLarge(_, _))) =\u003e {\n                            assert_eq!(expected_response, ExpectedSendResponseResponse::ErrorBsonTooLarge, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityServerError(\n                            identity_server::Error::HonkRPCFailure(\n                                honk_rpc::honk_rpc::Error::MessageConversionFailed(_))) =\u003e {\n                            assert_eq!(expected_response, ExpectedSendResponseResponse::ErrorMessageParseFailure, \"{:?}\", reason);\n                        },\n                        context::Error::IdentityServerError(identity_server::Error::BadClient) =\u003e {\n                            assert!(expected_response == ExpectedSendResponseResponse::ErrorBadClient ||\n                                    expected_response == ExpectedSendResponseResponse::ErrorInvalidArg, \"{:?}\", reason);\n                        },\n                        error =\u003e panic!(\"unexpected error: {:?}\", error),\n                    }\n                    alice_send_response_handled = true;\n                },\n                ContextEvent::IdentityServerChallengeResponseReceived{handle, challenge_response} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    alice.identity_server_handle_challenge_response_received(handle, challenge_response == Document::new()).unwrap();\n                },\n                ContextEvent::IdentityServerHandshakeCompleted{handle, endpoint_private_key: _, endpoint_name, client_service_id: _, client_auth_public_key: _} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    assert_eq!(endpoint_name, VALID_ENDPOINT);\n                    alice_send_response_handled = true;\n                    assert_eq!(expected_response, ExpectedSendResponseResponse::EndpointOnionServiceIdReceived);\n                },\n                ContextEvent::IdentityServerHandshakeRejected { handle, client_allowed: _, client_requested_endpoint_valid: _, client_proof_signature_valid: _, client_auth_signature_valid: _, challenge_response_valid: _} =\u003e {\n                    assert_eq!(handle, alice_handshake_handle);\n                    alice_send_response_handled = true;\n                },\n                event =\u003e panic!(\"unexpected event: {:?}\", event),\n            }\n        }\n    }\n\n    //\n    // Bob reads send_response() response or error sections\n    //\n\n    // first read response (pending) or error section\n    let send_response_pending = bson::document::Document::from_reader(\u0026mut bob_stream);\n    match expected_response {\n        ExpectedSendResponseResponse::ErrorTimedOut |\n        ExpectedSendResponseResponse::ErrorBsonTooSmall |\n        ExpectedSendResponseResponse::ErrorBsonTooLarge |\n        ExpectedSendResponseResponse::ErrorBsonParseFailure |\n        ExpectedSendResponseResponse::ErrorMessageParseFailure =\u003e {\n            match send_response_pending {\n                Err(bson::de::Error::Io(_)) =\u003e return,\n                Ok(message) =\u003e panic!(\"unexpected message: {:?}\", message),\n                Err(error) =\u003e panic!(\"unexpected error: {:?}\", error),\n            }\n        },\n        ExpectedSendResponseResponse::ErrorInvalidArg =\u003e {\n            match send_response_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": ERROR_SECTION,\n                                \"cookie\": data.send_response_cookie,\n                                \"code\": ERROR_CODE_INVALID_ARG,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n        ExpectedSendResponseResponse::EndpointOnionServiceIdReceived |\n        ExpectedSendResponseResponse::ErrorBadClient =\u003e {\n            match send_response_pending {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": RESPONSE_SECTION,\n                                \"cookie\": data.send_response_cookie,\n                                \"state\": PENDING_REQUEST_STATE,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        }\n    }\n\n    // next read response (result) or error section\n    let send_response_result = bson::document::Document::from_reader(\u0026mut bob_stream);\n    match expected_response {\n        ExpectedSendResponseResponse::ErrorTimedOut |\n        ExpectedSendResponseResponse::ErrorBsonTooSmall |\n        ExpectedSendResponseResponse::ErrorBsonTooLarge |\n        ExpectedSendResponseResponse::ErrorBsonParseFailure |\n        ExpectedSendResponseResponse::ErrorMessageParseFailure |\n        ExpectedSendResponseResponse::ErrorInvalidArg =\u003e {\n            match send_response_result {\n                Err(bson::de::Error::Io(_)) =\u003e return,\n                Ok(message) =\u003e panic!(\"unexpected message: {:?}\", message),\n                Err(error) =\u003e panic!(\"unexpected error: {:?}\", error),\n            }\n        },\n        ExpectedSendResponseResponse::ErrorBadClient =\u003e {\n            match send_response_result {\n                Ok(message) =\u003e {\n                    assert_eq!(message, doc!{\n                        \"honk_rpc\": HONK_RPC,\n                        \"sections\": [\n                            {\n                                \"id\": ERROR_SECTION,\n                                \"cookie\": data.send_response_cookie,\n                                \"code\": ERROR_CODE_FAILURE,\n                            }\n                        ]\n                    }, \"expected response: {:?}\", expected_response);\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n        ExpectedSendResponseResponse::EndpointOnionServiceIdReceived =\u003e {\n            match send_response_result {\n                Ok(message) =\u003e {\n                    assert_eq!(message.get_i32(\"honk_rpc\").unwrap(), HONK_RPC);\n                    let sections = message.get_array(\"sections\").unwrap();\n                    assert_eq!(sections.len(), 1);\n                    let response = \u0026sections[0];\n                    match response {\n                        Bson::Document(response) =\u003e {\n                            assert_eq!(response.get_i32(\"id\").unwrap(), RESPONSE_SECTION, \"{:?}\", message);\n                            assert_eq!(response.get_i64(\"cookie\").unwrap(), data.send_response_cookie, \"{:?}\", message);\n                            assert_eq!(response.get_i32(\"state\").unwrap(), COMPLETE_REQUEST_STATE, \"{:?}\", message);\n                            match response.get(\"result\") {\n                                Some(Bson::String(serviceid)) =\u003e {\n                                    // ensure returned valueis a valid service id\n                                    V3OnionServiceId::from_string(serviceid).unwrap();\n                                },\n                                Some(bson) =\u003e panic!(\"unexpected result: {:?}\", bson),\n                                None =\u003e panic!(\"unexpected send_response result message: {:?}\", message),\n                            }\n                        },\n                        bson =\u003e panic!(\"unexpected section: {:?}\", bson),\n                    }\n                },\n                Err(error) =\u003e panic!(\"unexpected expected response and error: {:?}, {:?}\", expected_response, error),\n            }\n        },\n    }\n\n    // success!\n    ()\n});\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","fuzz","fuzz_targets","utils.rs"],"content":"// extern\nuse data_encoding::HEXLOWER;\nuse tor_interface::tor_crypto::*;\n\n\n// honk-rpc constants\npub(crate) const HONK_RPC: i32 = 0x00000100; // semver 0.1.0\npub(crate) const ERROR_SECTION: i32 = 0;\npub(crate) const ERROR_CODE_BAD_VERSION: i32 = 0;\npub(crate) const ERROR_CODE_REQUEST_COOKIE_REQUIRED: i32 = 1;\npub(crate) const ERROR_CODE_INVALID_ARG: i32 = 2;\npub(crate) const ERROR_CODE_FAILURE: i32 = 3;\npub(crate) const REQUEST_SECTION: i32 = 1;\npub(crate) const RESPONSE_SECTION: i32 = 2;\npub(crate) const PENDING_REQUEST_STATE: i32 = 0;\npub(crate) const COMPLETE_REQUEST_STATE: i32 = 1;\n\n// gosling constants\npub(crate) const INVALID_HANDSHAKE_HANDLE: gosling::context::HandshakeHandle = !0usize;\npub(crate) const GOSLING_PROTOCOL_VERSION: \u0026str = \"0.1.0\";\npub(crate) const GOSLING_IDENTITY_NAMESPACE: \u0026str = \"gosling_identity\";\npub(crate) const GOSLING_IDENTITY_BEGIN_HANDSHAKE_FUNCTION: \u0026str = \"begin_handshake\";\npub(crate) const GOSLING_IDENTITY_SEND_RESPONSE_FUNCTION: \u0026str = \"send_response\";\npub(crate) const GOSLING_ENDPOINT_NAMESPACE: \u0026str = \"gosling_endpoint\";\npub(crate) const GOSLING_ENDPOINT_BEGIN_HANDSHAKE_FUNCTION: \u0026str = \"begin_handshake\";\npub(crate) const GOSLING_ENDPOINT_SEND_RESPONSE_FUNCTION: \u0026str = \"send_response\";\npub(crate) const VALID_ENDPOINT: \u0026str = \"valid_endpoint\";\npub(crate) const VALID_CHANNEL: \u0026str = \"valid_channel\";\npub(crate) const IDENTITY_MAX_MESSAGE_SIZE: i32 = 1024;\npub(crate) const ENDPOINT_MAX_MESSAGE_SIZE: i32 = 384;\npub(crate) const COOKIE_SIZE: usize = 32usize;\npub(crate) type Cookie = [u8; COOKIE_SIZE];\n\n\npub(crate) fn build_client_proof(\n    domain_separator: \u0026str,\n    request: \u0026str,\n    client_service_id: \u0026V3OnionServiceId,\n    server_service_id: \u0026V3OnionServiceId,\n    client_cookie: \u0026Cookie,\n    server_cookie: \u0026Cookie,\n) -\u003e Vec\u003cu8\u003e {\n    let mut client_proof: Vec\u003cu8\u003e= Default::default();\n\n    client_proof.extend_from_slice(domain_separator.as_bytes());\n    client_proof.push(0u8);\n    client_proof.extend_from_slice(request.as_bytes());\n    client_proof.push(0u8);\n    client_proof.extend_from_slice(client_service_id.to_string().as_bytes());\n    client_proof.push(0u8);\n    client_proof.extend_from_slice(server_service_id.to_string().as_bytes());\n    client_proof.push(0u8);\n    client_proof.extend_from_slice(HEXLOWER.encode(client_cookie).as_bytes());\n    client_proof.push(0u8);\n    client_proof.extend_from_slice(HEXLOWER.encode(server_cookie).as_bytes());\n\n    client_proof\n}","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","src","ascii_string.rs"],"content":"#[cfg(test)]\nuse anyhow::bail;\nuse std::ops::Deref;\n\n#[derive(thiserror::Error, Debug)]\npub(crate) enum Error {\n    #[error(\"input string is not ASCII: {0}\")]\n    InvalidAscii(String),\n}\n\n/// An immutable wrapper around a String guaranteed to be ASCII encoded\n#[derive(Clone, PartialEq)]\npub(crate) struct AsciiString {\n    value: String,\n}\n\nimpl AsciiString {\n    pub fn new(value: String) -\u003e Result\u003cAsciiString, Error\u003e {\n        if value.is_ascii() {\n            Ok(Self { value })\n        } else {\n            Err(Error::InvalidAscii(value))\n        }\n    }\n}\n\nimpl Deref for AsciiString {\n    type Target = String;\n\n    fn deref(\u0026self) -\u003e \u0026Self::Target {\n        \u0026self.value\n    }\n}\n\nimpl std::fmt::Debug for AsciiString {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        self.value.fmt(f)\n    }\n}\n\nimpl std::fmt::Display for AsciiString {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        self.value.fmt(f)\n    }\n}\n\n#[test]\nfn test_ascii_string() -\u003e anyhow::Result\u003c()\u003e {\n    let valid_ascii: [String; 8] = [\n        \"\".to_string(),\n        \" !\\\"#$%\u0026'()*+,-./\".to_string(),\n        \"0123456789\".to_string(),\n        \":\u003c=\u003e?@\".to_string(),\n        \"ABCDEFGHIJKLMNOPQRSTUVWXYZ\".to_string(),\n        \"[\\\\]^_`\".to_string(),\n        \"abcdefghijklmnopqstuvwxyz\".to_string(),\n        \"{|}~\".to_string(),\n    ];\n\n    for string in valid_ascii {\n        match AsciiString::new(string) {\n            Ok(string) =\u003e println!(\"ascii: '{}'\", string),\n            Err(err) =\u003e bail!(\"unexpected error: {}\", err),\n        }\n    }\n\n    let utf8: [String; 2] = [\"❤\".to_string(), \"heart ❤\".to_string()];\n\n    for string in utf8 {\n        match AsciiString::new(string) {\n            Ok(string) =\u003e bail!(\"this is not ascii: {}\", string),\n            Err(_) =\u003e (),\n        }\n    }\n\n    Ok(())\n}\n","traces":[{"line":18,"address":[4407200,4406848],"length":1,"stats":{"Line":2}},{"line":19,"address":[1993982,1994050,1994189],"length":1,"stats":{"Line":5}},{"line":20,"address":[1994201],"length":1,"stats":{"Line":2}},{"line":22,"address":[1994081],"length":1,"stats":{"Line":1}},{"line":30,"address":[1994336],"length":1,"stats":{"Line":2}},{"line":36,"address":[1994352],"length":1,"stats":{"Line":0}},{"line":37,"address":[4367518],"length":1,"stats":{"Line":0}},{"line":42,"address":[1994384],"length":1,"stats":{"Line":2}},{"line":43,"address":[1994398],"length":1,"stats":{"Line":2}}],"covered":7,"coverable":9},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","src","context.rs"],"content":"// standard\nuse std::clone::Clone;\nuse std::collections::{BTreeMap, HashMap, VecDeque};\nuse std::net::TcpStream;\nuse std::time::Duration;\n\n// extern crates\nuse honk_rpc::honk_rpc::*;\nuse tor_interface::tor_crypto::*;\nuse tor_interface::tor_provider::*;\n\n// internal crates\nuse crate::ascii_string::*;\nuse crate::endpoint_client;\nuse crate::endpoint_client::*;\nuse crate::endpoint_server;\nuse crate::endpoint_server::*;\nuse crate::identity_client;\nuse crate::identity_client::*;\nuse crate::identity_server;\nuse crate::identity_server::*;\n\n/// A handle to an in-progres identity or endpoint handshake\npub type HandshakeHandle = usize;\nconst DEFAULT_ENDPOINT_TIMEOUT: Duration = Duration::from_secs(60);\nconst DEFAULT_ENDPOINT_MAX_MESSAGE_SIZE: i32 = 384;\n\n/// The error type for the [`Context`] type.\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    /// An invalid argument was provided to a function\n    #[error(\"invalid argument: {0}\")]\n    InvalidArgument(String),\n\n    /// Function requiring tor connectivity called before bootstrap\n    #[error(\n        \"context is not connected, must call bootstrap() and wait for TorBootstrapCompleted event\"\n    )]\n    TorNotConnected(),\n\n    /// Provided handle does not map to an in-flight handshake\n    #[error(\"handshake handle {0} not found\")]\n    HandshakeHandleNotFound(HandshakeHandle),\n\n    /// Requesting an invalid operation\n    #[error(\"incorrect usage: {0}\")]\n    IncorrectUsage(String),\n\n    /// An underlying `std::io::Error`\n    #[error(transparent)]\n    Io(#[from] std::io::Error),\n\n    /// An underlying `honk_rpc::honk_rpc::Error`\n    #[error(transparent)]\n    HonkRpc(#[from] honk_rpc::honk_rpc::Error),\n\n    /// An underlying `tor_interface::tor_crypto::Error`\n    #[error(transparent)]\n    TorCrypto(#[from] tor_interface::tor_crypto::Error),\n\n    /// An underlying `tor_interface::tor_provider::Error`\n    #[error(transparent)]\n    TorProvider(#[from] tor_interface::tor_provider::Error),\n\n    /// Failure ocurred in outgoing identity handshake\n    #[error(transparent)]\n    IdentityClientError(#[from] identity_client::Error),\n\n    /// Failure ocurred in incoming identity handshake\n    #[error(transparent)]\n    IdentityServerError(#[from] identity_server::Error),\n\n    /// Failure ocurred in outgoing endpoint handshake\n    #[error(transparent)]\n    EndpointClientError(#[from] endpoint_client::Error),\n\n    /// Failure ocurred in incoming endpoint handshake\n    #[error(transparent)]\n    EndpointServerError(#[from] endpoint_server::Error),\n}\n\n/// The gosling protocol implementation.\n///\n/// The `Context` object provides various methods for starting and progressing identity and endpoint handshakes. The general usage pattern developers will follow is to construct a `Context` object, connect to the Tor Network using [`Context::bootstrap()`], optionally start an identity or endpoint servers, and listen for and handle incoming identity and endpoint clients using [`Context::update()`] and the various associated methods. Depending on the application's requirements, the developer can also initiate identity and endpoint handshakes as necessary.\n///\n/// The Gosling Protocol specification can be found here:\n/// - [https://gosling.technology/gosling-spec.xhtml](https://gosling.technology/gosling-spec.xhtml)\npub struct Context {\n    // our tor instance\n    tor_provider: Box\u003cdyn TorProvider\u003e,\n    bootstrap_complete: bool,\n    identity_port: u16,\n    endpoint_port: u16,\n    identity_timeout: Duration,\n    identity_max_message_size: i32,\n    endpoint_timeout: Duration,\n\n    //\n    // Servers and Clients for in-process handshakes\n    //\n    next_handshake_handle: HandshakeHandle,\n    identity_clients: BTreeMap\u003cHandshakeHandle, IdentityClient\u003e,\n    identity_servers: BTreeMap\u003cHandshakeHandle, IdentityServer\u003e,\n    endpoint_clients: BTreeMap\u003cHandshakeHandle, EndpointClient\u003e,\n    endpoint_servers: BTreeMap\u003cHandshakeHandle, EndpointServer\u003e,\n\n    //\n    // Listeners for incoming connections\n    //\n    identity_listener: Option\u003cOnionListener\u003e,\n    identity_server_published: bool,\n    // maps the endpoint service id to the (enpdoint name, alowed client, onion listener tuple, published)\n    endpoint_listeners: HashMap\u003cV3OnionServiceId, (String, V3OnionServiceId, OnionListener, bool)\u003e,\n\n    //\n    // Server Config Data\n    //\n\n    // Private key behind the identity onion service\n    identity_private_key: Ed25519PrivateKey,\n    // Identity server's service id\n    identity_service_id: V3OnionServiceId,\n}\n\n/// Events to signal completion of asynchronous [`Context`] operations\n#[derive(Debug)]\npub enum ContextEvent {\n    //\n    // Tor Events\n    //\n\n    /// Tor bootstrap progress\n    TorBootstrapStatusReceived {\n        /// Bootstrap percent compeletion\n        progress: u32,\n        /// A short string indicating the completed bootstrap step\n        tag: String,\n        /// A longer human-readable summary of the bootstrap progress\n        summary: String,\n    },\n\n    /// Tor bootstrap completed\n    TorBootstrapCompleted,\n\n    /// Human-readable logs from the [`Context`]'s [`TorProvider`]\n    TorLogReceived {\n        /// Human-readable debug log\n        line: String,\n    },\n\n    //\n    // Identity Client Events\n    //\n\n    /// An identity client has received a challenge request from an identy server\n    ///\n    /// To continue the handshake, the client must call [`Context::identity_client_handle_challenge_received()`]\n    IdentityClientChallengeReceived {\n        /// The handle of the in-progress handshake\n        handle: HandshakeHandle,\n        /// An application specific challenge object used by the identity client to create a challenge response object\n        endpoint_challenge: bson::document::Document,\n    },\n\n    /// An identity client has successfully completed an identity handshake and may now access the requested endpoint server.\n    IdentityClientHandshakeCompleted {\n        /// The handle of the completed handshake\n        handle: HandshakeHandle,\n        /// The onion-service service-id of the identity server the client has completed an identity handshake with\n        identity_service_id: V3OnionServiceId,\n        /// The onion-service service-id of the requested endpoint server\n        endpoint_service_id: V3OnionServiceId,\n        /// The ASCII-encoded name of the requested endpoint server\n        endpoint_name: String,\n        /// The private x25519 client-auth key required to access the requested endpoint server\n        client_auth_private_key: X25519PrivateKey,\n    },\n\n    /// An incoming identit handshake has failed\n    IdentityClientHandshakeFailed {\n        /// The handle of the failed handshake\n        handle: HandshakeHandle,\n        /// The failure reason\n        reason: Error,\n    },\n\n    /// The identity server's onion-service has been published and may be reachable by identity clients\n    IdentityServerPublished,\n\n    /// An identity server has received an incoming connection and the handshake is ready to begin\n    IdentityServerHandshakeStarted {\n        /// The handle of the new handshake\n        handle: HandshakeHandle,\n    },\n\n    /// An identity server has received a request for an endpoint from an identity client.\n    ///\n    /// To continue the handshake, the server must call [`Context::identity_server_handle_endpoint_request_received()`]\n    IdentityServerEndpointRequestReceived {\n        /// The handle of the in-progress handshake\n        handle: HandshakeHandle,\n        /// The alleged onion-service service-id of the connecting client\n        client_service_id: V3OnionServiceId,\n        /// The ASCII-encoded name of the requested endpoint server\n        requested_endpoint: String,\n    },\n\n    /// An identity server has received a challenge response from an identity client.\n    ///\n    /// To continue the handshake, the server must call [`Context::identity_server_handle_challenge_response_received()`]\n    IdentityServerChallengeResponseReceived {\n        /// The handle of the in-progress handshake\n        handle: HandshakeHandle,\n        /// An application specific challenge response object created by the identity client in response to the identity server's challenge object\n        challenge_response: bson::document::Document,\n    },\n\n    /// An identity server's handshake has completed.\n    IdentityServerHandshakeCompleted {\n        /// The handle of the completed handshake\n        handle: HandshakeHandle,\n        /// The ed25519 private key of requested endpoint server\n        endpoint_private_key: Ed25519PrivateKey,\n        /// The ASCII-encoded name of the requested endpoint server\n        endpoint_name: String,\n        /// The onion-service service-id of the authenticated client\n        client_service_id: V3OnionServiceId,\n        /// The public x25519 client-auth key used to encrypt the endpoint server's onion-service descriptor\n        client_auth_public_key: X25519PublicKey,\n    },\n\n    /// An identity server has rejected an identity client's endpoint-request.\n    ///\n    /// There are multiple potential reasons why a handshake may be rejected and this event provides a breakdown on which part(s) failed specifically.\n    IdentityServerHandshakeRejected {\n        /// The handle of the rejected handshake\n        handle: HandshakeHandle,\n        /// `false` if the client was rejected based on their onion-service service-id\n        client_allowed: bool,\n        /// `false` if the requested endpoint name was not understood by the server\n        client_requested_endpoint_valid: bool,\n        /// `false` if the client failed its authentication proof (i.e. potential attempt at identity client impersonation)\n        client_proof_signature_valid: bool,\n        /// `false` if the client fails its x25519 key-ownership proof (i.e. potential attempt at use an x25519 public key not owned by the client)\n        client_auth_signature_valid: bool,\n        /// `false` if the client's challenge response was not suitable\n        challenge_response_valid: bool,\n    },\n\n    /// An incoming identity handshake has failed.\n    IdentityServerHandshakeFailed {\n        /// The handle of the failed handshake\n        handle: HandshakeHandle,\n        /// The failure reason\n        reason: Error,\n    },\n\n    //\n    // Endpoint Client Events\n    //\n\n    /// An endpoint client has successfully completed an endpoint handshake and may now communicate freely with the endpoint server.\n    EndpointClientHandshakeCompleted {\n        /// The handle of the completed handshake\n        handle: HandshakeHandle,\n        /// The onion-service service-id of the endpoint server the client has connected to\n        endpoint_service_id: V3OnionServiceId,\n        /// The ASCII-encoded name of the requested channel on the endpoint server\n        channel_name: String,\n        /// The resulting TCP connection to the endpoint server\n        stream: TcpStream,\n    },\n\n    /// An outgoing endpoint handshake has failed.\n    EndpointClientHandshakeFailed {\n        /// The handle of the failed handshake\n        handle: HandshakeHandle,\n        /// The failure reason\n        reason: Error,\n    },\n\n    //\n    // Endpint Server Events\n    //\n\n    /// The endpoint server’s onion-service has been published and may be reachable by endpoint clients.\n    EndpointServerPublished {\n        /// The onion-service service-id of the published endpoint server\n        endpoint_service_id: V3OnionServiceId,\n        /// The name of the published endpoint server\n        endpoint_name: String,\n    },\n\n    /// An endpoint server has received an incoming connection and the handshake is ready to begin.\n    EndpointServerHandshakeStarted {\n        /// The handle of the new handshake\n        handle: HandshakeHandle,\n    },\n\n    /// An endpoint server has received a request for a channel from an endpoint client.\n    ///\n    /// To continue the handshake, the server must call [`Context::endpoint_server_handle_channel_request_received()`]\n    EndpointServerChannelRequestReceived {\n        /// The handle of the in-progress handshake\n        handle: HandshakeHandle,\n        /// The alleged onion-service service-id of the connecting client\n        client_service_id: V3OnionServiceId,\n        /// The ASCII-encoded name of the requested channel\n        requested_channel: String,\n    },\n\n    /// An endpoint server's handshake has completed\n    EndpointServerHandshakeCompleted {\n        /// The handle of the completed handshake\n        handle: HandshakeHandle,\n        /// The onion-service service-id of the endpoint server which an endpoint client has connected to\n        endpoint_service_id: V3OnionServiceId,\n        /// The onion-service service-id of the connected client\n        client_service_id: V3OnionServiceId,\n        /// The ASCII-encoded name of the client's requested channel\n        channel_name: String,\n        /// The resulting TCP connection to tohe endpoint clientt\n        stream: TcpStream,\n    },\n\n    /// An endpoint server has rejected an endpoint client's channel request.\n    ///\n    /// There are multiple potential reasons why a handshake may be rejected and this event provides a breakdown on which part(s) failed specifically.\n    EndpointServerHandshakeRejected {\n        /// The handle of the rejected handshake\n        handle: HandshakeHandle,\n        /// `false` if the client was rejected based on their onion-service service-id\n        client_allowed: bool,\n        /// `false` if the requested channel name was not understood by the server\n        client_requested_channel_valid: bool,\n        /// `false` if the client failed its authentication proof (i.e. potential attempt at endpoint client impersonation)\n        client_proof_signature_valid: bool,\n    },\n\n    /// An incoming endpoint handshake has failed.\n    EndpointServerHandshakeFailed {\n        /// The handle of the failed handshake\n        handle: HandshakeHandle,\n        /// The failure reason\n        reason: Error,\n    },\n}\n\nimpl Context {\n    /// Construct a new `Context` object.\n    ///\n    /// # Parameters\n    /// - `tor_provider`: an implementation of the [`TorProvider`] trait which provides our Tor Network connectivity\n    /// - `identity_port`: the virt-port this `Context`'s identity server's onion-service will listen on for new identity handshakes.\n    /// - `endpoint_port`: the virt-port this `Context`'s endpoint servers' onion-services will listen on for new endpoint handshakes.\n    /// - `identity_timeout`: the maximum amount of time this `Context`' will allow an identity handshake to delay between steps before rejecting the request.\n    /// - `identity_max_message_size`: the maximum size of the underlying Honk-RPC BSON message this `Context`'s identity handshake will send and accept.\n    /// - `endpoint_timeout`: the maximum amount of time this `Context`' will allow an endpoint handshake to delay between steps before rejecting the request.\n    /// - `identity_private_key`: the ed25519 private key used to start this `Context`'s identity server's onion-service\n    /// # Returns\n    /// A newly constructed `Context`.\n    pub fn new(\n        tor_provider: Box\u003cdyn TorProvider\u003e,\n        identity_port: u16,\n        endpoint_port: u16,\n        identity_timeout: Duration,\n        identity_max_message_size: i32,\n        endpoint_timeout: Option\u003cDuration\u003e,\n        identity_private_key: Ed25519PrivateKey,\n    ) -\u003e Result\u003cSelf, Error\u003e {\n        let identity_service_id = V3OnionServiceId::from_private_key(\u0026identity_private_key);\n\n        Ok(Self {\n            tor_provider,\n            bootstrap_complete: false,\n            identity_port,\n            identity_max_message_size,\n            endpoint_port,\n            identity_timeout,\n            endpoint_timeout: match endpoint_timeout {\n                Some(timeout) =\u003e timeout,\n                None =\u003e DEFAULT_ENDPOINT_TIMEOUT,\n            },\n\n            next_handshake_handle: Default::default(),\n            identity_clients: Default::default(),\n            identity_servers: Default::default(),\n            endpoint_clients: Default::default(),\n            endpoint_servers: Default::default(),\n\n            identity_listener: None,\n            identity_server_published: false,\n            endpoint_listeners: Default::default(),\n\n            identity_private_key,\n            identity_service_id,\n        })\n    }\n\n    /// Initiate bootstrap of the `Context`'s owned [`TorProvider`]. Bootstrap status is communicated through [`ContextEvent`]s returned from the [`Context::update()`] method.\n    pub fn bootstrap(\u0026mut self) -\u003e Result\u003c(), Error\u003e {\n        self.tor_provider.bootstrap()?;\n        Ok(())\n    }\n\n    /// Initiate an identity handshake with an identity server. Handshake progression is communicated through  [`ContextEvent`]s returned from the [`Context::update()`] method.\n    ///\n    /// # Parameters\n    /// - `identitity_server_id`: the long term identity onion-service service-id of a remote peer\n    /// - `endpoint`: the ASCII-encoded requested endpoint\n    /// # Returns\n    /// A `HandshakeHandle` used to refer to this particular identity handshake.\n    pub fn identity_client_begin_handshake(\n        \u0026mut self,\n        identity_server_id: V3OnionServiceId,\n        endpoint: String,\n    ) -\u003e Result\u003cHandshakeHandle, Error\u003e {\n        let endpoint = match AsciiString::new(endpoint) {\n            Ok(endpoint) =\u003e endpoint,\n            Err(_) =\u003e {\n                return Err(Error::InvalidArgument(\n                    \"endpoint must be an ASCII string\".to_string(),\n                ))\n            }\n        };\n\n        if !self.bootstrap_complete {\n            return Err(Error::TorNotConnected());\n        }\n\n        // open tcp stream to remove ident server\n        let stream: TcpStream = self\n            .tor_provider\n            .connect(\n                (identity_server_id.clone(), self.identity_port).into(),\n                None,\n            )?\n            .into();\n        stream.set_nonblocking(true)?;\n        let mut client_rpc = Session::new(stream);\n        client_rpc.set_max_wait_time(self.identity_timeout);\n        client_rpc.set_max_message_size(self.identity_max_message_size)?;\n\n        let ident_client = IdentityClient::new(\n            client_rpc,\n            identity_server_id,\n            endpoint,\n            self.identity_private_key.clone(),\n            X25519PrivateKey::generate(),\n        )?;\n\n        let handshake_handle = self.next_handshake_handle;\n        self.next_handshake_handle += 1;\n        self.identity_clients.insert(handshake_handle, ident_client);\n\n        Ok(handshake_handle)\n    }\n\n    /// Abort an in-process outgoing identity handshake.\n    ///\n    /// # Parameters\n    /// - `handle`: the handle of the in-progress outoing identity handshake to abort\n    pub fn identity_client_abort_handshake(\n        \u0026mut self,\n        handle: HandshakeHandle,\n    ) -\u003e Result\u003c(), Error\u003e {\n        if let Some(_identity_client) = self.identity_clients.remove(\u0026handle) {\n            Ok(())\n        } else {\n            Err(Error::HandshakeHandleNotFound(handle))\n        }\n    }\n\n    /// Handle an identity server's endpoint challenge. Callers must construct an identity client's endpoint challenge-response. The particulars of creating and verifying the challenge-response BSON documents are undefined and application-specific.\n    ///\n    /// # Parameters\n    /// - `handle`: the handle of the in-progress outgoing identity handshake\n    /// - `challenge_response`: an application-specific BSON document which somehow responds to an identity server's challenge.\n    pub fn identity_client_handle_challenge_received(\n        \u0026mut self,\n        handle: HandshakeHandle,\n        challenge_response: bson::document::Document,\n    ) -\u003e Result\u003c(), Error\u003e {\n        if let Some(identity_client) = self.identity_clients.get_mut(\u0026handle) {\n            identity_client.send_response(challenge_response)?;\n            Ok(())\n        } else {\n            Err(Error::HandshakeHandleNotFound(handle))\n        }\n    }\n\n    /// Start this `Context`'s identity server. Publish status is communicated through [`ContextEvent`]s returned from the [`Context::update()`] method.\n    pub fn identity_server_start(\u0026mut self) -\u003e Result\u003c(), Error\u003e {\n        if !self.bootstrap_complete {\n            return Err(Error::TorNotConnected());\n        }\n        if self.identity_listener.is_some() {\n            return Err(Error::IncorrectUsage(\n                \"identity server already started\".to_string(),\n            ));\n        }\n\n        let identity_listener =\n            self.tor_provider\n                .listener(\u0026self.identity_private_key, self.identity_port, None)?;\n        identity_listener.set_nonblocking(true)?;\n\n        self.identity_listener = Some(identity_listener);\n        Ok(())\n    }\n\n    /// Stops this `Context`'s identity server and ends any in-progress incoming identity handshakes.\n    pub fn identity_server_stop(\u0026mut self) -\u003e Result\u003c(), Error\u003e {\n        if self.identity_listener.is_none() {\n            return Err(Error::IncorrectUsage(\n                \"identity server is not started\".to_string(),\n            ));\n        }\n\n        // clear out current identity listener\n        self.identity_listener = None;\n        // clear out published flag\n        self.identity_server_published = false;\n        // clear out any in-process identity handshakes\n        self.identity_servers = Default::default();\n        Ok(())\n    }\n\n    /// Handle an identity client's incoming endpoint request. Callers must determine whether the connected identity client is allowed to access the requested endpoint, decide whether the requested endpoint is supported by this `Context`, and build an endpoint challenge for the identity client. The particulars of creating the endpoint challenge is undefined and application-specific.\n    ///\n    /// # Parameters\n    /// - `handle`: the handle of the in-progress incoming identity handshake\n    /// - `client_allowed`: whether the connected identity client is allowed to access the requested endpoint\n    /// - `endpoint_supported`: whether the requested endpoint is supported\n    /// - `endpoint_challenge`: an application-specific BSON document which the connected identity client must respond to\n    pub fn identity_server_handle_endpoint_request_received(\n        \u0026mut self,\n        handle: HandshakeHandle,\n        client_allowed: bool,\n        endpoint_supported: bool,\n        endpoint_challenge: bson::document::Document,\n    ) -\u003e Result\u003c(), Error\u003e {\n        if let Some(identity_server) = self.identity_servers.get_mut(\u0026handle) {\n            Ok(identity_server.handle_endpoint_request_received(\n                client_allowed,\n                endpoint_supported,\n                endpoint_challenge,\n            )?)\n        } else {\n            Err(Error::HandshakeHandleNotFound(handle))\n        }\n    }\n\n    // confirm that a received endpoint challenge response is valid\n\n    /// Handle an identity client's incoming endpoint challenge-response. Callers must determine whether the connected identity client's challenge-response is valid. The particulars of verifying the challenge-response is undefined and application-specific.\n    ///\n    /// # Parameters\n    /// - `handle`: the handle of the in-progress incoming identity handshake\n    /// - `challenge_response_valid`: whether the received challenge-response is valid\n    pub fn identity_server_handle_challenge_response_received(\n        \u0026mut self,\n        handle: HandshakeHandle,\n        challenge_response_valid: bool,\n    ) -\u003e Result\u003c(), Error\u003e {\n        if let Some(identity_server) = self.identity_servers.get_mut(\u0026handle) {\n            Ok(identity_server.handle_challenge_response_received(challenge_response_valid)?)\n        } else {\n            Err(Error::HandshakeHandleNotFound(handle))\n        }\n    }\n\n    /// Initiate an endpoint handshake with an identity server. An endpoint client acquires the `endpoint_server_id` and `client_auth_key` by completing an identity handshake or through some other side-channnel. Handshake progression is communicated through [`ContextEvent`]s returned from the [`Context::update()`] method.\n    ///\n    /// # Parameters\n    /// - `endpoint_server_id`: the endpoint onion-service service-id of a remote peer\n    /// - `client_uath_key`: the x25519 private-key required to decrypt the endpoint server's onion-service descriptor\n    /// - `channel`: the ASCII-encoded requested channel\n    pub fn endpoint_client_begin_handshake(\n        \u0026mut self,\n        endpoint_server_id: V3OnionServiceId,\n        client_auth_key: X25519PrivateKey,\n        channel: String,\n    ) -\u003e Result\u003cHandshakeHandle, Error\u003e {\n        let channel = match AsciiString::new(channel) {\n            Ok(channel) =\u003e channel,\n            Err(_) =\u003e {\n                return Err(Error::InvalidArgument(\n                    \"channel must be an ASCII string\".to_string(),\n                ))\n            }\n        };\n\n        if !self.bootstrap_complete {\n            return Err(Error::TorNotConnected());\n        }\n\n        self.tor_provider\n            .add_client_auth(\u0026endpoint_server_id, \u0026client_auth_key)?;\n        let stream: TcpStream = self\n            .tor_provider\n            .connect(\n                (endpoint_server_id.clone(), self.endpoint_port).into(),\n                None,\n            )?\n            .into();\n        stream.set_nonblocking(true)?;\n\n        let mut session = Session::new(stream);\n        session.set_max_wait_time(self.endpoint_timeout);\n        session.set_max_message_size(DEFAULT_ENDPOINT_MAX_MESSAGE_SIZE)?;\n\n        let endpoint_client = EndpointClient::new(\n            session,\n            endpoint_server_id,\n            channel,\n            self.identity_private_key.clone(),\n        );\n\n        let handshake_handle = self.next_handshake_handle;\n        self.next_handshake_handle += 1;\n        self.endpoint_clients\n            .insert(handshake_handle, endpoint_client);\n        Ok(handshake_handle)\n    }\n\n    /// Abort an in-process outgoing endpoint handshake\n    ///\n    /// # Parameters\n    /// - `handle`: the handle of the in-progress outoing identity handshake to abort\n    pub fn endpoint_client_abort_handshake(\n        \u0026mut self,\n        handle: HandshakeHandle,\n    ) -\u003e Result\u003c(), Error\u003e {\n        if let Some(_endpoint_client) = self.endpoint_clients.remove(\u0026handle) {\n            Ok(())\n        } else {\n            Err(Error::HandshakeHandleNotFound(handle))\n        }\n    }\n\n    /// Start one of this `Context`'s endpoint servers. Publish status is communicated through [`ContextEvent`]s returned from the [`Context::update()`] method.\n    ///\n    /// # Parameters\n    /// - `endpoint_private_key`: the ed25519 private key used to start this endpoint server's onion-service\n    /// - `endpoint_name`: the ASCII-encoded endpoint name\n    /// - `client_identity`: the onion-service service-id of the client which will be connecting to this endpoint server\n    /// - `client_auth`: the x25519 public-key used to encrypt the endpoint server's onion-service descriptor\n    pub fn endpoint_server_start(\n        \u0026mut self,\n        endpoint_private_key: Ed25519PrivateKey,\n        endpoint_name: String,\n        client_identity: V3OnionServiceId,\n        client_auth: X25519PublicKey,\n    ) -\u003e Result\u003c(), Error\u003e {\n        if !self.bootstrap_complete {\n            return Err(Error::TorNotConnected());\n        }\n\n        let endpoint_public_key = Ed25519PublicKey::from_private_key(\u0026endpoint_private_key);\n        let endpoint_service_id = V3OnionServiceId::from_public_key(\u0026endpoint_public_key);\n\n        if endpoint_service_id == self.identity_service_id {\n            return Err(Error::InvalidArgument(\n                \"endpoint server must be different from identity server\".to_string(),\n            ));\n        }\n\n        if self.endpoint_listeners.contains_key(\u0026endpoint_service_id) {\n            return Err(Error::IncorrectUsage(\n                \"endpoint server already started\".to_string(),\n            ));\n        }\n\n        let endpoint_listener = self.tor_provider.listener(\n            \u0026endpoint_private_key,\n            self.endpoint_port,\n            Some(\u0026[client_auth]),\n        )?;\n        endpoint_listener.set_nonblocking(true)?;\n\n        self.endpoint_listeners.insert(\n            endpoint_service_id,\n            (endpoint_name, client_identity, endpoint_listener, false),\n        );\n        Ok(())\n    }\n\n    /// Handle an endpoint client's incoming channel request. Callers must determine whether the requested channel is supported by this `Context`. The particulars of making this determination is undefined and application-specific.\n    ///\n    /// # Parameters\n    /// - `handle`: the handle of the in-progress incoming endpoint handshake\n    /// - `channel_supported`: whether the requested channel is supported\n    pub fn endpoint_server_handle_channel_request_received(\n        \u0026mut self,\n        handle: HandshakeHandle,\n        channel_supported: bool,\n    ) -\u003e Result\u003c(), Error\u003e {\n        if let Some(endpoint_server) = self.endpoint_servers.get_mut(\u0026handle) {\n            Ok(endpoint_server.handle_channel_request_received(channel_supported)?)\n        } else {\n            Err(Error::HandshakeHandleNotFound(handle))\n        }\n    }\n\n    /// Stop one of this `Context`'s endpoint servers and ends any of its in-progress incoming endpoint handshakes.\n    ///\n    /// # Parameters\n    /// - `endpoint_identity`: the onion-service service-id of the enpdoint server to stop\n    pub fn endpoint_server_stop(\n        \u0026mut self,\n        endpoint_identity: V3OnionServiceId,\n    ) -\u003e Result\u003c(), Error\u003e {\n        if !self.bootstrap_complete {\n            return Err(Error::TorNotConnected());\n        }\n\n        if let Some(_listener) = self.endpoint_listeners.remove(\u0026endpoint_identity) {\n            Ok(())\n        } else {\n            Err(Error::InvalidArgument(format!(\n                \"endpoint server with service id {} not found\",\n                endpoint_identity\n            )))\n        }\n    }\n\n    fn identity_server_handle_accept(\n        identity_listener: \u0026OnionListener,\n        identity_timeout: Duration,\n        identity_max_message_size: i32,\n        identity_private_key: \u0026Ed25519PrivateKey,\n    ) -\u003e Result\u003cOption\u003cIdentityServer\u003e, Error\u003e {\n        if let Some(stream) = identity_listener.accept()? {\n            let stream: TcpStream = stream.into();\n            if stream.set_nonblocking(true).is_err() {\n                return Ok(None);\n            }\n\n            let mut server_rpc = Session::new(stream);\n            server_rpc.set_max_wait_time(identity_timeout);\n            server_rpc.set_max_message_size(identity_max_message_size)?;\n            let service_id = V3OnionServiceId::from_private_key(identity_private_key);\n            let identity_server = IdentityServer::new(server_rpc, service_id);\n\n            Ok(Some(identity_server))\n        } else {\n            Ok(None)\n        }\n    }\n\n    fn endpoint_server_handle_accept(\n        endpoint_listener: \u0026OnionListener,\n        endpoint_timeout: Duration,\n        client_service_id: \u0026V3OnionServiceId,\n        endpoint_service_id: \u0026V3OnionServiceId,\n    ) -\u003e Result\u003cOption\u003cEndpointServer\u003e, Error\u003e {\n        if let Some(stream) = endpoint_listener.accept()? {\n            let stream: TcpStream = stream.into();\n            if stream.set_nonblocking(true).is_err() {\n                return Ok(None);\n            }\n\n            let mut server_rpc = Session::new(stream);\n            server_rpc.set_max_wait_time(endpoint_timeout);\n            server_rpc.set_max_message_size(DEFAULT_ENDPOINT_MAX_MESSAGE_SIZE)?;\n\n            let endpoint_server = EndpointServer::new(\n                server_rpc,\n                client_service_id.clone(),\n                endpoint_service_id.clone(),\n            );\n\n            Ok(Some(endpoint_server))\n        } else {\n            Ok(None)\n        }\n    }\n\n    /// A direct pass-through to the underlying [`TorProvider`]'s [`TorProvider::connect()`] method.\n    pub fn connect(\n        \u0026mut self,\n        target_addr: TargetAddr,\n        circuit_token: Option\u003cCircuitToken\u003e,\n    ) -\u003e Result\u003cOnionStream, Error\u003e {\n        Ok(self.tor_provider.connect(target_addr, circuit_token)?)\n    }\n\n    /// A direct pass-through to the underlying [`TorProvider`]'s [`TorProvider::generate_token()`] method.\n    pub fn generate_circuit_token(\u0026mut self) -\u003e CircuitToken {\n        self.tor_provider.generate_token()\n    }\n\n    /// A direct pass-through to the underlying [`TorProvider`]'s [`TorProvider::release_token()`] method.\n    pub fn release_circuit_token(\u0026mut self, circuit_token: CircuitToken) {\n        self.tor_provider.release_token(circuit_token)\n    }\n\n    /// This function updates the `Context`'s underlying [`TorProvider`], handles new handshakes requests, and updates in-progress handshakes. This function needs to be regularly called to process the returned [`ContextEvent`]s.\n    pub fn update(\u0026mut self) -\u003e Result\u003cVecDeque\u003cContextEvent\u003e, Error\u003e {\n        // events to return\n        let mut events: VecDeque\u003cContextEvent\u003e = Default::default();\n\n        // first handle new identity connections\n        if let Some(identity_listener) = \u0026self.identity_listener {\n            match Self::identity_server_handle_accept(\n                identity_listener,\n                self.identity_timeout,\n                self.identity_max_message_size,\n                \u0026self.identity_private_key,\n            ) {\n                Ok(Some(identity_server)) =\u003e {\n                    let handle = self.next_handshake_handle;\n                    self.next_handshake_handle += 1;\n                    self.identity_servers.insert(handle, identity_server);\n                    events.push_back(ContextEvent::IdentityServerHandshakeStarted { handle });\n                }\n                Ok(None) =\u003e {}\n                // identity listener failed, remove it\n                // TODO: signal caller identity listener is down\n                Err(_) =\u003e self.identity_listener = None,\n            }\n        }\n\n        // next handle new endpoint connections\n        self.endpoint_listeners.retain(\n            |endpoint_service_id, (_endpoint_name, allowed_client, listener, _published)| -\u003e bool {\n                match Self::endpoint_server_handle_accept(\n                    listener,\n                    self.endpoint_timeout,\n                    allowed_client,\n                    endpoint_service_id,\n                ) {\n                    Ok(Some(endpoint_server)) =\u003e {\n                        let handle = self.next_handshake_handle;\n                        self.next_handshake_handle += 1;\n                        self.endpoint_servers.insert(handle, endpoint_server);\n                        events.push_back(ContextEvent::EndpointServerHandshakeStarted { handle });\n                        true\n                    }\n                    Ok(None) =\u003e true,\n                    // endpoint listener failed, remove it\n                    // TODO: signal caller endpoint listener is down\n                    Err(_) =\u003e false,\n                }\n            },\n        );\n\n        // consume tor events\n        // TODO: so curently the only failure mode of this function is a result of the\n        // LegacyTorClient failing; we should probably consider a LegacyTorClient failure fatal, since\n        // reading the LegacyTorClient::update() function it seems the only failure modes are a\n        // failure to DEL_ONION (which realistically speaking could only be due to a logic\n        // error on our part by deleting an onion that doesn't exist, or a parse error of\n        // the response) and a failure to read async events which is either again a parsing\n        // bug on our end or a malformed/buggy tor daemon which we also cannot recover\n        // from.\n        for event in self.tor_provider.update()?.drain(..) {\n            match event {\n                TorEvent::BootstrapStatus {\n                    progress,\n                    tag,\n                    summary,\n                } =\u003e {\n                    events.push_back(ContextEvent::TorBootstrapStatusReceived {\n                        progress,\n                        tag,\n                        summary,\n                    });\n                }\n                TorEvent::BootstrapComplete =\u003e {\n                    events.push_back(ContextEvent::TorBootstrapCompleted);\n                    self.bootstrap_complete = true;\n                }\n                TorEvent::LogReceived { line } =\u003e {\n                    events.push_back(ContextEvent::TorLogReceived { line });\n                }\n                TorEvent::OnionServicePublished { service_id } =\u003e {\n                    if service_id == self.identity_service_id {\n                        if !self.identity_server_published {\n                            events.push_back(ContextEvent::IdentityServerPublished);\n                            self.identity_server_published = true;\n                        }\n                    } else if let Some((endpoint_name, _, _, published)) =\n                        self.endpoint_listeners.get_mut(\u0026service_id)\n                    {\n                        // ingore duplicate publish events\n                        if !*published {\n                            events.push_back(ContextEvent::EndpointServerPublished {\n                                endpoint_service_id: service_id,\n                                endpoint_name: endpoint_name.clone(),\n                            });\n                            *published = true;\n                        }\n                    }\n                }\n            }\n        }\n\n        // update the ident client handshakes\n        self.identity_clients\n            .retain(|handle, identity_client| -\u003e bool {\n                let handle = *handle;\n                match identity_client.update() {\n                    Ok(Some(IdentityClientEvent::ChallengeReceived { endpoint_challenge })) =\u003e {\n                        events.push_back(ContextEvent::IdentityClientChallengeReceived {\n                            handle,\n                            endpoint_challenge,\n                        });\n                        true\n                    }\n                    Ok(Some(IdentityClientEvent::HandshakeCompleted {\n                        identity_service_id,\n                        endpoint_service_id,\n                        endpoint_name,\n                        client_auth_private_key,\n                    })) =\u003e {\n                        events.push_back(ContextEvent::IdentityClientHandshakeCompleted {\n                            handle,\n                            identity_service_id,\n                            endpoint_service_id,\n                            endpoint_name,\n                            client_auth_private_key,\n                        });\n                        false\n                    }\n                    Err(err) =\u003e {\n                        events.push_back(ContextEvent::IdentityClientHandshakeFailed {\n                            handle,\n                            reason: err.into(),\n                        });\n                        false\n                    }\n                    Ok(None) =\u003e true,\n                }\n            });\n\n        // update the ident server handshakes\n        self.identity_servers\n            .retain(|handle, identity_server| -\u003e bool {\n                let handle = *handle;\n                match identity_server.update() {\n                    Ok(Some(IdentityServerEvent::EndpointRequestReceived {\n                        client_service_id,\n                        requested_endpoint,\n                    })) =\u003e {\n                        events.push_back(ContextEvent::IdentityServerEndpointRequestReceived {\n                            handle,\n                            client_service_id,\n                            requested_endpoint: requested_endpoint.to_string(),\n                        });\n                        true\n                    }\n                    Ok(Some(IdentityServerEvent::ChallengeResponseReceived {\n                        challenge_response,\n                    })) =\u003e {\n                        events.push_back(ContextEvent::IdentityServerChallengeResponseReceived {\n                            handle,\n                            challenge_response,\n                        });\n                        true\n                    }\n                    Ok(Some(IdentityServerEvent::HandshakeCompleted {\n                        endpoint_private_key,\n                        endpoint_name,\n                        client_service_id,\n                        client_auth_public_key,\n                    })) =\u003e {\n                        events.push_back(ContextEvent::IdentityServerHandshakeCompleted {\n                            handle,\n                            endpoint_private_key,\n                            endpoint_name: endpoint_name.to_string(),\n                            client_service_id,\n                            client_auth_public_key,\n                        });\n                        false\n                    }\n                    Ok(Some(IdentityServerEvent::HandshakeRejected {\n                        client_allowed,\n                        client_requested_endpoint_valid,\n                        client_proof_signature_valid,\n                        client_auth_signature_valid,\n                        challenge_response_valid,\n                    })) =\u003e {\n                        events.push_back(ContextEvent::IdentityServerHandshakeRejected {\n                            handle,\n                            client_allowed,\n                            client_requested_endpoint_valid,\n                            client_proof_signature_valid,\n                            client_auth_signature_valid,\n                            challenge_response_valid,\n                        });\n                        false\n                    }\n                    Err(err) =\u003e {\n                        events.push_back(ContextEvent::IdentityServerHandshakeFailed {\n                            handle,\n                            reason: err.into(),\n                        });\n                        false\n                    }\n                    Ok(None) =\u003e true,\n                }\n            });\n\n        // update the endpoint client handshakes\n        self.endpoint_clients\n            .retain(|handle, endpoint_client| -\u003e bool {\n                let handle = *handle;\n                match endpoint_client.update() {\n                    Ok(Some(EndpointClientEvent::HandshakeCompleted { stream })) =\u003e {\n                        events.push_back(ContextEvent::EndpointClientHandshakeCompleted {\n                            handle,\n                            endpoint_service_id: endpoint_client.server_service_id.clone(),\n                            channel_name: endpoint_client.requested_channel.to_string(),\n                            stream,\n                        });\n                        false\n                    }\n                    Err(err) =\u003e {\n                        events.push_back(ContextEvent::EndpointClientHandshakeFailed {\n                            handle,\n                            reason: err.into(),\n                        });\n                        false\n                    }\n                    Ok(None) =\u003e true,\n                }\n            });\n\n        // update the endpoint server handshakes\n        self.endpoint_servers\n            .retain(|handle, endpoint_server| -\u003e bool {\n                let handle = *handle;\n                match endpoint_server.update() {\n                    Ok(Some(EndpointServerEvent::ChannelRequestReceived {\n                        requested_channel,\n                        client_service_id,\n                    })) =\u003e {\n                        events.push_back(ContextEvent::EndpointServerChannelRequestReceived {\n                            handle,\n                            client_service_id,\n                            requested_channel: requested_channel.to_string(),\n                        });\n                        true\n                    }\n                    Ok(Some(EndpointServerEvent::HandshakeCompleted {\n                        client_service_id,\n                        channel_name,\n                        stream,\n                    })) =\u003e {\n                        events.push_back(ContextEvent::EndpointServerHandshakeCompleted {\n                            handle,\n                            endpoint_service_id: endpoint_server.server_identity.clone(),\n                            client_service_id,\n                            channel_name: channel_name.to_string(),\n                            stream,\n                        });\n                        false\n                    }\n                    Ok(Some(EndpointServerEvent::HandshakeRejected {\n                        client_allowed,\n                        client_requested_channel_valid,\n                        client_proof_signature_valid,\n                    })) =\u003e {\n                        events.push_back(ContextEvent::EndpointServerHandshakeRejected {\n                            handle,\n                            client_allowed,\n                            client_requested_channel_valid,\n                            client_proof_signature_valid,\n                        });\n                        false\n                    }\n                    Err(err) =\u003e {\n                        events.push_back(ContextEvent::EndpointServerHandshakeFailed {\n                            handle,\n                            reason: err.into(),\n                        });\n                        false\n                    }\n                    Ok(None) =\u003e true,\n                }\n            });\n\n        Ok(events)\n    }\n}\n","traces":[{"line":362,"address":[3906464,3907654,3907695],"length":1,"stats":{"Line":1}},{"line":371,"address":[1902451],"length":1,"stats":{"Line":1}},{"line":373,"address":[1903012],"length":1,"stats":{"Line":1}},{"line":374,"address":[3906684],"length":1,"stats":{"Line":1}},{"line":380,"address":[3906718],"length":1,"stats":{"Line":1}},{"line":381,"address":[2623104],"length":1,"stats":{"Line":1}},{"line":382,"address":[1902583],"length":1,"stats":{"Line":0}},{"line":386,"address":[3906853],"length":1,"stats":{"Line":1}},{"line":387,"address":[3946616],"length":1,"stats":{"Line":1}},{"line":388,"address":[2623260],"length":1,"stats":{"Line":1}},{"line":389,"address":[1902832],"length":1,"stats":{"Line":1}},{"line":391,"address":[3907052],"length":1,"stats":{"Line":1}},{"line":393,"address":[3907063],"length":1,"stats":{"Line":1}},{"line":395,"address":[1902971],"length":1,"stats":{"Line":1}},{"line":401,"address":[1903568],"length":1,"stats":{"Line":1}},{"line":402,"address":[3947492,3947578],"length":1,"stats":{"Line":1}},{"line":403,"address":[3947569],"length":1,"stats":{"Line":1}},{"line":413,"address":[1906164,1906423,1903744],"length":1,"stats":{"Line":1}},{"line":418,"address":[3947726],"length":1,"stats":{"Line":1}},{"line":419,"address":[1903902],"length":1,"stats":{"Line":1}},{"line":421,"address":[3910658],"length":1,"stats":{"Line":0}},{"line":422,"address":[1904019],"length":1,"stats":{"Line":0}},{"line":427,"address":[2624502],"length":1,"stats":{"Line":1}},{"line":428,"address":[3908290],"length":1,"stats":{"Line":0}},{"line":432,"address":[1904672,1904172,1904364,1906392],"length":1,"stats":{"Line":2}},{"line":435,"address":[3948133,3948102],"length":1,"stats":{"Line":2}},{"line":436,"address":[2624792],"length":1,"stats":{"Line":1}},{"line":439,"address":[3909052,3908880,3908955,3910496],"length":1,"stats":{"Line":2}},{"line":440,"address":[3948838,3948757],"length":1,"stats":{"Line":2}},{"line":441,"address":[2625362],"length":1,"stats":{"Line":1}},{"line":442,"address":[3907974,3909405,3910431,3909173],"length":1,"stats":{"Line":2}},{"line":445,"address":[2625524],"length":1,"stats":{"Line":1}},{"line":447,"address":[2625575],"length":1,"stats":{"Line":1}},{"line":448,"address":[3949115,3949331],"length":1,"stats":{"Line":2}},{"line":449,"address":[2625843],"length":1,"stats":{"Line":1}},{"line":452,"address":[3909870],"length":1,"stats":{"Line":1}},{"line":453,"address":[3949631,3949814,3949904],"length":1,"stats":{"Line":2}},{"line":454,"address":[1905914,1906057],"length":1,"stats":{"Line":2}},{"line":456,"address":[2626478],"length":1,"stats":{"Line":1}},{"line":463,"address":[1906640],"length":1,"stats":{"Line":0}},{"line":467,"address":[2627038],"length":1,"stats":{"Line":0}},{"line":468,"address":[3910925],"length":1,"stats":{"Line":0}},{"line":470,"address":[3910953],"length":1,"stats":{"Line":0}},{"line":479,"address":[2627845,2627280,2627873],"length":1,"stats":{"Line":1}},{"line":484,"address":[2627327,2627410,2627608,2627677],"length":1,"stats":{"Line":3}},{"line":485,"address":[2627626,2627314,2627818,2627684,2627458],"length":1,"stats":{"Line":3}},{"line":486,"address":[2627670],"length":1,"stats":{"Line":1}},{"line":488,"address":[3911361],"length":1,"stats":{"Line":0}},{"line":493,"address":[2629035,2629067,2627888],"length":1,"stats":{"Line":1}},{"line":494,"address":[3951470],"length":1,"stats":{"Line":1}},{"line":495,"address":[2627940],"length":1,"stats":{"Line":0}},{"line":497,"address":[3911779],"length":1,"stats":{"Line":1}},{"line":498,"address":[3951716],"length":1,"stats":{"Line":0}},{"line":499,"address":[2628132],"length":1,"stats":{"Line":0}},{"line":503,"address":[2628048,2628509,2628011,2628245],"length":1,"stats":{"Line":3}},{"line":505,"address":[2628019,2628474],"length":1,"stats":{"Line":1}},{"line":506,"address":[3911718,3912255,3912391,3912681],"length":1,"stats":{"Line":3}},{"line":508,"address":[2628647,2628901],"length":1,"stats":{"Line":1}},{"line":509,"address":[3952551],"length":1,"stats":{"Line":1}},{"line":513,"address":[1909263,1908736],"length":1,"stats":{"Line":0}},{"line":514,"address":[1908772],"length":1,"stats":{"Line":0}},{"line":515,"address":[2629202],"length":1,"stats":{"Line":0}},{"line":516,"address":[3912985],"length":1,"stats":{"Line":0}},{"line":521,"address":[3912953,3913087],"length":1,"stats":{"Line":0}},{"line":523,"address":[3952977],"length":1,"stats":{"Line":0}},{"line":525,"address":[1909080],"length":1,"stats":{"Line":0}},{"line":526,"address":[1909243],"length":1,"stats":{"Line":0}},{"line":536,"address":[3953184,3953824,3953853],"length":1,"stats":{"Line":1}},{"line":543,"address":[1909445,1909741,1909358,1909668],"length":1,"stats":{"Line":3}},{"line":544,"address":[3913833,3914014,3914052,3913486,3913745],"length":1,"stats":{"Line":3}},{"line":547,"address":[2629838],"length":1,"stats":{"Line":1}},{"line":550,"address":[3913785],"length":1,"stats":{"Line":0}},{"line":561,"address":[1909968],"length":1,"stats":{"Line":1}},{"line":566,"address":[3914184,3914370,3914384],"length":1,"stats":{"Line":2}},{"line":567,"address":[2630322,2630409,2630535,2630544],"length":1,"stats":{"Line":3}},{"line":569,"address":[3914327],"length":1,"stats":{"Line":0}},{"line":579,"address":[3914448,3916738,3917157],"length":1,"stats":{"Line":1}},{"line":585,"address":[3954260,3954364],"length":1,"stats":{"Line":2}},{"line":586,"address":[1910471],"length":1,"stats":{"Line":1}},{"line":588,"address":[3917020],"length":1,"stats":{"Line":0}},{"line":589,"address":[1910588],"length":1,"stats":{"Line":0}},{"line":594,"address":[3954527],"length":1,"stats":{"Line":1}},{"line":595,"address":[3914859],"length":1,"stats":{"Line":0}},{"line":598,"address":[3954854,3954696,3954650,3956666],"length":1,"stats":{"Line":2}},{"line":599,"address":[2631210],"length":1,"stats":{"Line":0}},{"line":600,"address":[3956664,3955023,3954768,3955331],"length":1,"stats":{"Line":2}},{"line":603,"address":[3954794,3954888],"length":1,"stats":{"Line":2}},{"line":604,"address":[3915267],"length":1,"stats":{"Line":1}},{"line":607,"address":[2631838,2632944,2631763,2631931],"length":1,"stats":{"Line":2}},{"line":609,"address":[3955512,3955593],"length":1,"stats":{"Line":2}},{"line":610,"address":[3915857],"length":1,"stats":{"Line":1}},{"line":611,"address":[1910348,1911995,1911764],"length":1,"stats":{"Line":2}},{"line":614,"address":[1911862],"length":1,"stats":{"Line":1}},{"line":616,"address":[1911913],"length":1,"stats":{"Line":1}},{"line":617,"address":[3916121],"length":1,"stats":{"Line":1}},{"line":620,"address":[2632534],"length":1,"stats":{"Line":1}},{"line":621,"address":[3956307,3956187],"length":1,"stats":{"Line":1}},{"line":622,"address":[2632660,2632583],"length":1,"stats":{"Line":2}},{"line":623,"address":[3916620,3916486],"length":1,"stats":{"Line":2}},{"line":624,"address":[1912494],"length":1,"stats":{"Line":1}},{"line":631,"address":[3956928],"length":1,"stats":{"Line":0}},{"line":635,"address":[2633278],"length":1,"stats":{"Line":0}},{"line":636,"address":[1913152],"length":1,"stats":{"Line":0}},{"line":638,"address":[2633402],"length":1,"stats":{"Line":0}},{"line":649,"address":[3919197,3918940,3917456],"length":1,"stats":{"Line":1}},{"line":656,"address":[3917506],"length":1,"stats":{"Line":1}},{"line":657,"address":[1913384],"length":1,"stats":{"Line":0}},{"line":660,"address":[3917575],"length":1,"stats":{"Line":1}},{"line":661,"address":[1913494],"length":1,"stats":{"Line":1}},{"line":663,"address":[3917686],"length":1,"stats":{"Line":1}},{"line":664,"address":[3958788],"length":1,"stats":{"Line":0}},{"line":665,"address":[2633814],"length":1,"stats":{"Line":0}},{"line":669,"address":[3957532,3957471],"length":1,"stats":{"Line":2}},{"line":670,"address":[1914796],"length":1,"stats":{"Line":0}},{"line":671,"address":[1913747],"length":1,"stats":{"Line":0}},{"line":675,"address":[1913649,1913715,1914115,1913777,1914789],"length":1,"stats":{"Line":3}},{"line":678,"address":[3917824],"length":1,"stats":{"Line":1}},{"line":680,"address":[2633562,2634837,2634402,2634249],"length":1,"stats":{"Line":3}},{"line":682,"address":[3918749,3918427],"length":1,"stats":{"Line":2}},{"line":684,"address":[1914271],"length":1,"stats":{"Line":1}},{"line":686,"address":[3918852],"length":1,"stats":{"Line":1}},{"line":694,"address":[1915056],"length":1,"stats":{"Line":1}},{"line":699,"address":[3919272,3919458,3919472],"length":1,"stats":{"Line":2}},{"line":700,"address":[2635385,2635298,2635520,2635511],"length":1,"stats":{"Line":3}},{"line":702,"address":[3919415],"length":1,"stats":{"Line":0}},{"line":710,"address":[1915376,1916112,1916080],"length":1,"stats":{"Line":0}},{"line":714,"address":[3959315],"length":1,"stats":{"Line":0}},{"line":715,"address":[3919593],"length":1,"stats":{"Line":0}},{"line":718,"address":[3919705,3919629],"length":1,"stats":{"Line":0}},{"line":719,"address":[1915598],"length":1,"stats":{"Line":0}},{"line":721,"address":[3959726,3959852],"length":1,"stats":{"Line":0}},{"line":728,"address":[1916128,1917444,1917526],"length":1,"stats":{"Line":1}},{"line":734,"address":[2636847,2636410],"length":1,"stats":{"Line":2}},{"line":735,"address":[2636748],"length":1,"stats":{"Line":1}},{"line":736,"address":[3920872,3920757],"length":1,"stats":{"Line":2}},{"line":737,"address":[2637616],"length":1,"stats":{"Line":0}},{"line":740,"address":[1916835],"length":1,"stats":{"Line":1}},{"line":741,"address":[2637072],"length":1,"stats":{"Line":1}},{"line":742,"address":[3960854,3960975,3960083],"length":1,"stats":{"Line":2}},{"line":743,"address":[1917044],"length":1,"stats":{"Line":1}},{"line":744,"address":[1917212],"length":1,"stats":{"Line":1}},{"line":746,"address":[2637449],"length":1,"stats":{"Line":1}},{"line":748,"address":[2636817],"length":1,"stats":{"Line":1}},{"line":752,"address":[1917616,1918974,1919117],"length":1,"stats":{"Line":1}},{"line":758,"address":[1917691,1918142],"length":1,"stats":{"Line":2}},{"line":759,"address":[2638197],"length":1,"stats":{"Line":1}},{"line":760,"address":[3922238,3922353],"length":1,"stats":{"Line":2}},{"line":761,"address":[2639171],"length":1,"stats":{"Line":0}},{"line":764,"address":[1918316],"length":1,"stats":{"Line":1}},{"line":765,"address":[1918367],"length":1,"stats":{"Line":1}},{"line":766,"address":[2638733,2638590,2637812],"length":1,"stats":{"Line":2}},{"line":769,"address":[3922681],"length":1,"stats":{"Line":1}},{"line":770,"address":[1918580],"length":1,"stats":{"Line":1}},{"line":771,"address":[3922950],"length":1,"stats":{"Line":1}},{"line":774,"address":[2638986],"length":1,"stats":{"Line":1}},{"line":776,"address":[2638266],"length":1,"stats":{"Line":1}},{"line":781,"address":[2639328],"length":1,"stats":{"Line":0}},{"line":786,"address":[2639493,2639371],"length":1,"stats":{"Line":0}},{"line":790,"address":[1919440],"length":1,"stats":{"Line":0}},{"line":791,"address":[3923608],"length":1,"stats":{"Line":0}},{"line":795,"address":[2639600],"length":1,"stats":{"Line":0}},{"line":796,"address":[1919489],"length":1,"stats":{"Line":0}},{"line":800,"address":[1920315,1919520,1922182],"length":1,"stats":{"Line":1}},{"line":802,"address":[2639693],"length":1,"stats":{"Line":1}},{"line":805,"address":[3923749,3924594],"length":1,"stats":{"Line":2}},{"line":806,"address":[3923834,3925448,3923976],"length":1,"stats":{"Line":2}},{"line":808,"address":[3923805],"length":1,"stats":{"Line":1}},{"line":809,"address":[3963556],"length":1,"stats":{"Line":1}},{"line":810,"address":[2639786],"length":1,"stats":{"Line":1}},{"line":812,"address":[3924102],"length":1,"stats":{"Line":1}},{"line":813,"address":[1919981],"length":1,"stats":{"Line":1}},{"line":814,"address":[3924158,3924276],"length":1,"stats":{"Line":1}},{"line":815,"address":[3964078,3963934],"length":1,"stats":{"Line":2}},{"line":816,"address":[2640302],"length":1,"stats":{"Line":1}},{"line":821,"address":[1919875,1920329],"length":1,"stats":{"Line":0}},{"line":826,"address":[3963657,3963593],"length":1,"stats":{"Line":2}},{"line":827,"address":[2816279,2815735,2815696],"length":1,"stats":{"Line":3}},{"line":828,"address":[3869709],"length":1,"stats":{"Line":1}},{"line":830,"address":[3909444],"length":1,"stats":{"Line":1}},{"line":834,"address":[1896085],"length":1,"stats":{"Line":1}},{"line":835,"address":[3909561],"length":1,"stats":{"Line":1}},{"line":836,"address":[3909652,3909745,3909581],"length":1,"stats":{"Line":2}},{"line":837,"address":[1896219,1896363],"length":1,"stats":{"Line":2}},{"line":838,"address":[3870088],"length":1,"stats":{"Line":1}},{"line":839,"address":[1896441],"length":1,"stats":{"Line":1}},{"line":841,"address":[3869774],"length":1,"stats":{"Line":1}},{"line":844,"address":[3869767],"length":1,"stats":{"Line":0}},{"line":858,"address":[3964673,3964841,3964370,3964797],"length":1,"stats":{"Line":4}},{"line":859,"address":[3925161],"length":1,"stats":{"Line":1}},{"line":860,"address":[2641348],"length":1,"stats":{"Line":1}},{"line":865,"address":[2641412,2641762],"length":1,"stats":{"Line":2}},{"line":871,"address":[1921747],"length":1,"stats":{"Line":1}},{"line":872,"address":[2641534],"length":1,"stats":{"Line":1}},{"line":873,"address":[3925900],"length":1,"stats":{"Line":1}},{"line":875,"address":[3925689],"length":1,"stats":{"Line":1}},{"line":876,"address":[2641784,2641597],"length":1,"stats":{"Line":2}},{"line":878,"address":[3965544],"length":1,"stats":{"Line":1}},{"line":879,"address":[1921704,1921761],"length":1,"stats":{"Line":2}},{"line":880,"address":[2641833,2642181],"length":1,"stats":{"Line":2}},{"line":881,"address":[3926277],"length":1,"stats":{"Line":1}},{"line":882,"address":[3966058],"length":1,"stats":{"Line":1}},{"line":884,"address":[3925988,3925932],"length":1,"stats":{"Line":1}},{"line":888,"address":[3926080,3926262],"length":1,"stats":{"Line":2}},{"line":889,"address":[3926116],"length":1,"stats":{"Line":1}},{"line":891,"address":[3926097],"length":1,"stats":{"Line":1}},{"line":893,"address":[3926259],"length":1,"stats":{"Line":1}},{"line":901,"address":[1921059],"length":1,"stats":{"Line":1}},{"line":902,"address":[3910016],"length":1,"stats":{"Line":1}},{"line":903,"address":[3870321],"length":1,"stats":{"Line":1}},{"line":904,"address":[1896649,1896903],"length":1,"stats":{"Line":2}},{"line":905,"address":[1896981],"length":1,"stats":{"Line":1}},{"line":906,"address":[3910458],"length":1,"stats":{"Line":1}},{"line":910,"address":[2816874],"length":1,"stats":{"Line":1}},{"line":913,"address":[3910551],"length":1,"stats":{"Line":1}},{"line":914,"address":[3870834],"length":1,"stats":{"Line":1}},{"line":915,"address":[3870871],"length":1,"stats":{"Line":1}},{"line":916,"address":[3910654],"length":1,"stats":{"Line":1}},{"line":918,"address":[1897278],"length":1,"stats":{"Line":1}},{"line":925,"address":[3871197],"length":1,"stats":{"Line":1}},{"line":927,"address":[1896740],"length":1,"stats":{"Line":0}},{"line":928,"address":[3870468,3870510],"length":1,"stats":{"Line":0}},{"line":930,"address":[1896780],"length":1,"stats":{"Line":0}},{"line":932,"address":[3870585],"length":1,"stats":{"Line":0}},{"line":934,"address":[3870592],"length":1,"stats":{"Line":1}},{"line":939,"address":[2641140],"length":1,"stats":{"Line":1}},{"line":940,"address":[2817376,2818696],"length":1,"stats":{"Line":1}},{"line":941,"address":[3871345],"length":1,"stats":{"Line":1}},{"line":942,"address":[2817701,2817449,2817802],"length":1,"stats":{"Line":2}},{"line":944,"address":[1898035],"length":1,"stats":{"Line":1}},{"line":945,"address":[3871795],"length":1,"stats":{"Line":1}},{"line":947,"address":[2818536,2817899],"length":1,"stats":{"Line":2}},{"line":950,"address":[3911573],"length":1,"stats":{"Line":1}},{"line":952,"address":[2818673],"length":1,"stats":{"Line":1}},{"line":955,"address":[2817933],"length":1,"stats":{"Line":1}},{"line":957,"address":[2817970],"length":1,"stats":{"Line":1}},{"line":961,"address":[1898283],"length":1,"stats":{"Line":1}},{"line":964,"address":[1898293],"length":1,"stats":{"Line":1}},{"line":965,"address":[1898353],"length":1,"stats":{"Line":1}},{"line":966,"address":[3911819],"length":1,"stats":{"Line":1}},{"line":967,"address":[1898443],"length":1,"stats":{"Line":1}},{"line":969,"address":[3911915,3912452],"length":1,"stats":{"Line":2}},{"line":971,"address":[2818260],"length":1,"stats":{"Line":1}},{"line":972,"address":[3872189],"length":1,"stats":{"Line":1}},{"line":976,"address":[3912686],"length":1,"stats":{"Line":1}},{"line":979,"address":[3911973],"length":1,"stats":{"Line":0}},{"line":980,"address":[1898550],"length":1,"stats":{"Line":0}},{"line":981,"address":[3912007],"length":1,"stats":{"Line":0}},{"line":982,"address":[1898582],"length":1,"stats":{"Line":0}},{"line":983,"address":[3912037],"length":1,"stats":{"Line":0}},{"line":985,"address":[3912056],"length":1,"stats":{"Line":0}},{"line":993,"address":[3872408],"length":1,"stats":{"Line":0}},{"line":995,"address":[1897764],"length":1,"stats":{"Line":0}},{"line":996,"address":[3911236,3911278],"length":1,"stats":{"Line":0}},{"line":998,"address":[3871500],"length":1,"stats":{"Line":0}},{"line":1000,"address":[3911353],"length":1,"stats":{"Line":0}},{"line":1002,"address":[3871616],"length":1,"stats":{"Line":1}},{"line":1007,"address":[3965013],"length":1,"stats":{"Line":1}},{"line":1008,"address":[2819104,2819783,2819815],"length":1,"stats":{"Line":1}},{"line":1009,"address":[3912854],"length":1,"stats":{"Line":1}},{"line":1010,"address":[3873142],"length":1,"stats":{"Line":1}},{"line":1011,"address":[3913136],"length":1,"stats":{"Line":1}},{"line":1012,"address":[3913323,3913155],"length":1,"stats":{"Line":2}},{"line":1014,"address":[1899723],"length":1,"stats":{"Line":1}},{"line":1015,"address":[2819574],"length":1,"stats":{"Line":1}},{"line":1016,"address":[3913308],"length":1,"stats":{"Line":1}},{"line":1018,"address":[3873727],"length":1,"stats":{"Line":1}},{"line":1020,"address":[1899527],"length":1,"stats":{"Line":0}},{"line":1021,"address":[1899597,1899555],"length":1,"stats":{"Line":0}},{"line":1023,"address":[3873259],"length":1,"stats":{"Line":0}},{"line":1025,"address":[1899672],"length":1,"stats":{"Line":0}},{"line":1027,"address":[1899679],"length":1,"stats":{"Line":1}},{"line":1032,"address":[3925297],"length":1,"stats":{"Line":1}},{"line":1033,"address":[3913616,3914705],"length":1,"stats":{"Line":1}},{"line":1034,"address":[1900230],"length":1,"stats":{"Line":1}},{"line":1035,"address":[3874317,3874208,3873958],"length":1,"stats":{"Line":2}},{"line":1037,"address":[3914068],"length":1,"stats":{"Line":1}},{"line":1038,"address":[2820380],"length":1,"stats":{"Line":1}},{"line":1040,"address":[3914155,3914540],"length":1,"stats":{"Line":2}},{"line":1043,"address":[1900723],"length":1,"stats":{"Line":1}},{"line":1045,"address":[3914681],"length":1,"stats":{"Line":1}},{"line":1048,"address":[2820485],"length":1,"stats":{"Line":1}},{"line":1049,"address":[1900824],"length":1,"stats":{"Line":1}},{"line":1050,"address":[3874546],"length":1,"stats":{"Line":1}},{"line":1052,"address":[2820594,2821088],"length":1,"stats":{"Line":2}},{"line":1054,"address":[2820602],"length":1,"stats":{"Line":1}},{"line":1056,"address":[1901328],"length":1,"stats":{"Line":1}},{"line":1057,"address":[3914805],"length":1,"stats":{"Line":1}},{"line":1059,"address":[1901592],"length":1,"stats":{"Line":1}},{"line":1062,"address":[1900915],"length":1,"stats":{"Line":0}},{"line":1063,"address":[1900930],"length":1,"stats":{"Line":0}},{"line":1064,"address":[2820667],"length":1,"stats":{"Line":0}},{"line":1066,"address":[3914404],"length":1,"stats":{"Line":0}},{"line":1072,"address":[3914476],"length":1,"stats":{"Line":0}},{"line":1074,"address":[2820081],"length":1,"stats":{"Line":0}},{"line":1075,"address":[3874119,3874077],"length":1,"stats":{"Line":0}},{"line":1077,"address":[3874085],"length":1,"stats":{"Line":0}},{"line":1079,"address":[3874194],"length":1,"stats":{"Line":0}},{"line":1081,"address":[1900505],"length":1,"stats":{"Line":1}},{"line":1085,"address":[1921165],"length":1,"stats":{"Line":1}}],"covered":219,"coverable":299},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","src","endpoint_client.rs"],"content":"// standard\nuse std::clone::Clone;\nuse std::convert::TryInto;\nuse std::net::TcpStream;\n\n// extern crates\nuse bson::doc;\nuse bson::spec::BinarySubtype;\nuse bson::{Binary, Bson};\nuse honk_rpc::honk_rpc::{RequestCookie, Response, Session};\nuse rand::rngs::OsRng;\nuse rand::RngCore;\nuse tor_interface::tor_crypto::*;\n\n// internal crates\nuse crate::ascii_string::*;\nuse crate::gosling::*;\n\n//\n// Endpoint Client\n//\n\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"HonkRPC method failed: {0}\")]\n    HonkRPCFailure(#[from] honk_rpc::honk_rpc::Error),\n\n    #[error(\"client received unexpected response: {0}\")]\n    UnexpectedResponseReceived(String),\n\n    #[error(\"client is in invalid state: {0}\")]\n    InvalidState(String),\n\n    #[error(\"incorrect usage: {0}\")]\n    IncorrectUsage(String),\n}\n\npub(crate) enum EndpointClientEvent {\n    HandshakeCompleted { stream: TcpStream },\n}\n\n#[derive(Debug, PartialEq)]\nenum EndpointClientState {\n    BeginHandshake,\n    WaitingForServerCookie,\n    WaitingForProofVerification,\n    HandshakeComplete,\n}\n\npub(crate) struct EndpointClient {\n    // session data\n    rpc: Option\u003cSession\u003cTcpStream\u003e\u003e,\n    pub server_service_id: V3OnionServiceId,\n    pub requested_channel: AsciiString,\n    client_service_id: V3OnionServiceId,\n    client_ed25519_private: Ed25519PrivateKey,\n\n    // state machine data\n    state: EndpointClientState,\n    begin_handshake_request_cookie: Option\u003cRequestCookie\u003e,\n    send_response_request_cookie: Option\u003cRequestCookie\u003e,\n}\n\nimpl EndpointClient {\n    fn get_state(\u0026self) -\u003e String {\n        format!(\"{{ state: {:?}, begin_handshake_request_cookie: {:?}, send_response_request_cookie: {:?} }}\", self.state, self.begin_handshake_request_cookie, self.send_response_request_cookie)\n    }\n\n    pub fn new(\n        rpc: Session\u003cTcpStream\u003e,\n        server_service_id: V3OnionServiceId,\n        requested_channel: AsciiString,\n        client_ed25519_private: Ed25519PrivateKey,\n    ) -\u003e Self {\n        Self {\n            rpc: Some(rpc),\n            server_service_id,\n            requested_channel,\n            client_service_id: V3OnionServiceId::from_private_key(\u0026client_ed25519_private),\n            client_ed25519_private,\n\n            state: EndpointClientState::BeginHandshake,\n            begin_handshake_request_cookie: None,\n            send_response_request_cookie: None,\n        }\n    }\n\n    pub fn update(\u0026mut self) -\u003e Result\u003cOption\u003cEndpointClientEvent\u003e, Error\u003e {\n        if self.state == EndpointClientState::HandshakeComplete {\n            return Err(Error::IncorrectUsage(\"update() may not be called after HandshakeComplete has been returned from previous update() call\".to_string()));\n        }\n\n        // update our rpc session\n        if let Some(rpc) = self.rpc.as_mut() {\n            rpc.update(None)?;\n\n            // client state machine\n            match (\n                \u0026self.state,\n                self.begin_handshake_request_cookie,\n                self.send_response_request_cookie,\n            ) {\n                (\u0026EndpointClientState::BeginHandshake, None, None) =\u003e {\n                    self.begin_handshake_request_cookie = Some(rpc.client_call(\n                        \"gosling_endpoint\",\n                        \"begin_handshake\",\n                        0,\n                        doc! {\n                            \"version\" : bson::Bson::String(GOSLING_PROTOCOL_VERSION.to_string()),\n                            \"client_identity\" : bson::Bson::String(self.client_service_id.to_string()),\n                            \"channel\" : bson::Bson::String(self.requested_channel.to_string()),\n                        },\n                    ).unwrap());\n                    self.state = EndpointClientState::WaitingForServerCookie;\n                    Ok(None)\n                }\n                (\n                    \u0026EndpointClientState::WaitingForServerCookie,\n                    Some(begin_handshake_request_cookie),\n                    None, // send_response_request_cookie\n                ) =\u003e {\n                    if let Some(response) = rpc.client_next_response() {\n                        let result = match response {\n                            Response::Pending { cookie } =\u003e {\n                                if cookie == begin_handshake_request_cookie {\n                                    return Ok(None);\n                                } else {\n                                    return Err(Error::UnexpectedResponseReceived(\n                                        \"received unexpected pending response\".to_string(),\n                                    ));\n                                }\n                            }\n                            Response::Error { cookie, error_code } =\u003e {\n                                if cookie != begin_handshake_request_cookie {\n                                    return Err(Error::UnexpectedResponseReceived(format!(\n                                        \"received unexpected error response; rpc error_code: {}\",\n                                        error_code\n                                    )));\n                                }\n                                return Err(Error::UnexpectedResponseReceived(format!(\n                                    \"received unexpected rpc error_code: {}\",\n                                    error_code\n                                )));\n                            }\n                            Response::Success { cookie, result } =\u003e {\n                                if cookie == begin_handshake_request_cookie {\n                                    result\n                                } else {\n                                    return Err(Error::UnexpectedResponseReceived(\n                                        \"received unexpected success response\".to_string(),\n                                    ));\n                                }\n                            }\n                        };\n\n                        if let Some(bson::Bson::Document(result)) = result {\n                            if let Some(Bson::Binary(Binary {\n                                subtype: BinarySubtype::Generic,\n                                bytes: server_cookie,\n                            })) = result.get(\"server_cookie\")\n                            {\n                                // build arguments for send_response()\n\n                                // client_cookie\n                                let mut client_cookie: ClientCookie = Default::default();\n                                OsRng.fill_bytes(\u0026mut client_cookie);\n\n                                // client_identity_proof_signature\n                                let server_cookie: ServerCookie =\n                                    match server_cookie.clone().try_into() {\n                                        Ok(server_cookie) =\u003e server_cookie,\n                                        Err(_) =\u003e {\n                                            return Err(Error::UnexpectedResponseReceived(format!(\n                                                \"unable to convert '{:?}' to server cookie\",\n                                                server_cookie\n                                            )))\n                                        }\n                                    };\n                                let client_identity_proof = build_client_proof(\n                                    DomainSeparator::GoslingEndpoint,\n                                    \u0026self.requested_channel,\n                                    \u0026self.client_service_id,\n                                    \u0026self.server_service_id,\n                                    \u0026client_cookie,\n                                    \u0026server_cookie,\n                                );\n                                let client_identity_proof_signature = self\n                                    .client_ed25519_private\n                                    .sign_message(\u0026client_identity_proof);\n\n                                // build our args object for rpc call\n                                let args = doc! {\n                                    \"client_cookie\" : Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_cookie.to_vec()}),\n                                    \"client_identity_proof_signature\" : Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_identity_proof_signature.to_bytes().to_vec()}),\n                                };\n\n                                // make rpc call\n                                self.send_response_request_cookie = Some(\n                                    rpc.client_call(\"gosling_endpoint\", \"send_response\", 0, args)\n                                        .unwrap(),\n                                );\n\n                                self.state = EndpointClientState::WaitingForProofVerification;\n                            } else {\n                                return Err(Error::UnexpectedResponseReceived(format!(\n                                    \"begin_handshake() returned unexpected value: {}\",\n                                    result\n                                )));\n                            }\n                        } else {\n                            return Err(Error::UnexpectedResponseReceived(format!(\n                                \"begin_handshake() returned unexpected value: {:?}\",\n                                result\n                            )));\n                        }\n                    }\n                    Ok(None)\n                }\n                (\n                    \u0026EndpointClientState::WaitingForProofVerification,\n                    Some(_begin_handshake_request_cookie),\n                    Some(send_response_request_cookie),\n                ) =\u003e {\n                    if let Some(response) = rpc.client_next_response() {\n                        let result = match response {\n                            Response::Pending { cookie } =\u003e {\n                                if cookie == send_response_request_cookie {\n                                    return Ok(None);\n                                } else {\n                                    return Err(Error::UnexpectedResponseReceived(\n                                        \"received unexpected pending response\".to_string(),\n                                    ));\n                                }\n                            }\n                            Response::Error { cookie, error_code } =\u003e {\n                                if cookie == send_response_request_cookie {\n                                    return Err(Error::UnexpectedResponseReceived(format!(\n                                        \"received unexpected error response; rpc error_code: {}\",\n                                        error_code\n                                    )));\n                                }\n                                return Err(Error::UnexpectedResponseReceived(format!(\n                                    \"received unexpected rpc error_code: {}\",\n                                    error_code\n                                )));\n                            }\n                            Response::Success { cookie, result } =\u003e {\n                                if cookie == send_response_request_cookie {\n                                    result\n                                } else {\n                                    return Err(Error::UnexpectedResponseReceived(\n                                        \"received unexpected success response\".to_string(),\n                                    ));\n                                }\n                            }\n                        };\n\n                        if let Some(Bson::Document(result)) = result {\n                            if result.is_empty() {\n                                self.state = EndpointClientState::HandshakeComplete;\n                                let stream = std::mem::take(\u0026mut self.rpc).unwrap().into_stream();\n                                return Ok(Some(EndpointClientEvent::HandshakeCompleted {\n                                    stream,\n                                }));\n                            } else {\n                                return Err(Error::UnexpectedResponseReceived(format!(\n                                    \"received unexpected data from send_response(): {:?}\",\n                                    result\n                                )));\n                            }\n                        } else {\n                            return Err(Error::UnexpectedResponseReceived(format!(\n                                \"received unexpected data from send_response(): {:?}\",\n                                result\n                            )));\n                        }\n                    }\n                    Ok(None)\n                }\n                _ =\u003e Err(Error::InvalidState(self.get_state())),\n            }\n        } else {\n            Err(Error::InvalidState(self.get_state()))\n        }\n    }\n}\n","traces":[{"line":65,"address":[4413040],"length":1,"stats":{"Line":0}},{"line":66,"address":[2122471,2122200,2122381],"length":1,"stats":{"Line":0}},{"line":69,"address":[4373760,4374237,4374196],"length":1,"stats":{"Line":2}},{"line":76,"address":[4373809],"length":1,"stats":{"Line":2}},{"line":79,"address":[2122724],"length":1,"stats":{"Line":2}},{"line":88,"address":[4374256,4376275],"length":1,"stats":{"Line":2}},{"line":89,"address":[1995920],"length":1,"stats":{"Line":2}},{"line":90,"address":[4414187],"length":1,"stats":{"Line":0}},{"line":94,"address":[1996149,1995975,1996390],"length":1,"stats":{"Line":4}},{"line":95,"address":[1995912,1996511,1996173],"length":1,"stats":{"Line":4}},{"line":98,"address":[4374844,4375156,4381528,4374989,4376305],"length":1,"stats":{"Line":10}},{"line":99,"address":[2123697],"length":1,"stats":{"Line":2}},{"line":100,"address":[4414573],"length":1,"stats":{"Line":2}},{"line":101,"address":[2123714],"length":1,"stats":{"Line":2}},{"line":104,"address":[4376161,4375811],"length":1,"stats":{"Line":4}},{"line":108,"address":[2124092,2124370,2124550,2124186,2124048],"length":1,"stats":{"Line":8}},{"line":109,"address":[2124136,2124065],"length":1,"stats":{"Line":4}},{"line":110,"address":[4415161],"length":1,"stats":{"Line":2}},{"line":111,"address":[4375601],"length":1,"stats":{"Line":2}},{"line":114,"address":[4376204],"length":1,"stats":{"Line":2}},{"line":115,"address":[1997809],"length":1,"stats":{"Line":2}},{"line":117,"address":[4376328],"length":1,"stats":{"Line":2}},{"line":122,"address":[2128596,2125224],"length":1,"stats":{"Line":4}},{"line":123,"address":[4416293],"length":1,"stats":{"Line":2}},{"line":124,"address":[4416412],"length":1,"stats":{"Line":2}},{"line":125,"address":[1998268],"length":1,"stats":{"Line":2}},{"line":126,"address":[2125836],"length":1,"stats":{"Line":2}},{"line":128,"address":[1998455],"length":1,"stats":{"Line":0}},{"line":129,"address":[1998422],"length":1,"stats":{"Line":0}},{"line":133,"address":[4376780],"length":1,"stats":{"Line":0}},{"line":134,"address":[1998408],"length":1,"stats":{"Line":0}},{"line":135,"address":[2130087,2130225],"length":1,"stats":{"Line":0}},{"line":140,"address":[4381021,4380883],"length":1,"stats":{"Line":0}},{"line":145,"address":[2125569],"length":1,"stats":{"Line":2}},{"line":146,"address":[4416502],"length":1,"stats":{"Line":2}},{"line":147,"address":[2125918],"length":1,"stats":{"Line":2}},{"line":149,"address":[2126048],"length":1,"stats":{"Line":0}},{"line":150,"address":[1998604],"length":1,"stats":{"Line":0}},{"line":156,"address":[2126151,2126306,2125952],"length":1,"stats":{"Line":6}},{"line":157,"address":[4417405,4417283,4417368,4417563],"length":1,"stats":{"Line":8}},{"line":159,"address":[2126712],"length":1,"stats":{"Line":2}},{"line":165,"address":[2126732],"length":1,"stats":{"Line":2}},{"line":166,"address":[1999464],"length":1,"stats":{"Line":2}},{"line":169,"address":[4417656],"length":1,"stats":{"Line":2}},{"line":171,"address":[4417728],"length":1,"stats":{"Line":2}},{"line":173,"address":[4379794,4379923],"length":1,"stats":{"Line":0}},{"line":180,"address":[2127061],"length":1,"stats":{"Line":2}},{"line":181,"address":[4378198],"length":1,"stats":{"Line":2}},{"line":182,"address":[1999792],"length":1,"stats":{"Line":2}},{"line":183,"address":[1999802],"length":1,"stats":{"Line":2}},{"line":187,"address":[1999865,1999984],"length":1,"stats":{"Line":4}},{"line":189,"address":[4418036],"length":1,"stats":{"Line":2}},{"line":192,"address":[4418163,4418376,4418653,4418222],"length":1,"stats":{"Line":6}},{"line":193,"address":[4418182,4418266],"length":1,"stats":{"Line":4}},{"line":194,"address":[4378732],"length":1,"stats":{"Line":2}},{"line":198,"address":[4379477],"length":1,"stats":{"Line":2}},{"line":199,"address":[2000697],"length":1,"stats":{"Line":2}},{"line":203,"address":[4419265],"length":1,"stats":{"Line":2}},{"line":205,"address":[2001810,2001681],"length":1,"stats":{"Line":0}},{"line":211,"address":[2001943,2002072],"length":1,"stats":{"Line":0}},{"line":217,"address":[4381473],"length":1,"stats":{"Line":2}},{"line":219,"address":[4381551],"length":1,"stats":{"Line":2}},{"line":224,"address":[4381588],"length":1,"stats":{"Line":2}},{"line":225,"address":[2130635],"length":1,"stats":{"Line":2}},{"line":226,"address":[2130767],"length":1,"stats":{"Line":0}},{"line":227,"address":[2130783],"length":1,"stats":{"Line":0}},{"line":228,"address":[2131058],"length":1,"stats":{"Line":0}},{"line":230,"address":[4382099],"length":1,"stats":{"Line":0}},{"line":231,"address":[2003650],"length":1,"stats":{"Line":0}},{"line":235,"address":[2003592],"length":1,"stats":{"Line":1}},{"line":236,"address":[2130917],"length":1,"stats":{"Line":1}},{"line":237,"address":[2005948,2006086],"length":1,"stats":{"Line":2}},{"line":242,"address":[2005749,2005611],"length":1,"stats":{"Line":0}},{"line":247,"address":[4381932],"length":1,"stats":{"Line":2}},{"line":248,"address":[2130854],"length":1,"stats":{"Line":2}},{"line":249,"address":[4382267],"length":1,"stats":{"Line":2}},{"line":251,"address":[2003981],"length":1,"stats":{"Line":0}},{"line":252,"address":[2003824],"length":1,"stats":{"Line":0}},{"line":258,"address":[2131365,2131520,2131166],"length":1,"stats":{"Line":6}},{"line":259,"address":[4422574,4422503],"length":1,"stats":{"Line":4}},{"line":260,"address":[2131821],"length":1,"stats":{"Line":2}},{"line":261,"address":[2004561,2004886],"length":1,"stats":{"Line":4}},{"line":262,"address":[2132201],"length":1,"stats":{"Line":2}},{"line":266,"address":[2004587,2004716],"length":1,"stats":{"Line":0}},{"line":272,"address":[4383632,4383503],"length":1,"stats":{"Line":0}},{"line":278,"address":[4381858],"length":1,"stats":{"Line":2}},{"line":280,"address":[1996630],"length":1,"stats":{"Line":0}},{"line":283,"address":[1996285],"length":1,"stats":{"Line":0}}],"covered":62,"coverable":88},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","src","endpoint_server.rs"],"content":"// standard\nuse std::clone::Clone;\nuse std::convert::TryInto;\nuse std::net::TcpStream;\n\n// extern crates\nuse bson::doc;\nuse bson::spec::BinarySubtype;\nuse bson::{Binary, Bson};\nuse honk_rpc::honk_rpc::{ApiSet, ErrorCode, RequestCookie, Session};\nuse rand::rngs::OsRng;\nuse rand::RngCore;\nuse tor_interface::tor_crypto::*;\n\n// internal crates\nuse crate::ascii_string::*;\nuse crate::gosling::*;\n\n//\n// Endpoint Server\n//\n\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"HonkRPC method failed: {0}\")]\n    HonkRPCFailure(#[from] honk_rpc::honk_rpc::Error),\n\n    #[error(\"server is in invalid state: {0}\")]\n    InvalidState(String),\n\n    #[error(\"incorrect usage: {0}\")]\n    IncorrectUsage(String),\n\n    #[error(\"client sent invalid request\")]\n    BadClient,\n}\n\npub(crate) enum EndpointServerEvent {\n    ChannelRequestReceived {\n        client_service_id: V3OnionServiceId,\n        requested_channel: AsciiString,\n    },\n    // endpoint server has acepted incoming channel request from identity client\n    HandshakeCompleted {\n        client_service_id: V3OnionServiceId,\n        channel_name: AsciiString,\n        stream: TcpStream,\n    },\n    // endpoint server has reject an incoming channel request\n    HandshakeRejected {\n        client_allowed: bool,\n        client_requested_channel_valid: bool,\n        client_proof_signature_valid: bool,\n    },\n}\n\n#[derive(Debug, PartialEq)]\nenum EndpointServerState {\n    // valid/expected states\n    WaitingForBeginHandshake,\n    ValidatingChannelRequest,\n    ChannelRequestValidated,\n    WaitingForSendResponse,\n    HandledSendResponse,\n    HandshakeComplete,\n    // failure state\n    HandshakeFailed,\n}\n\npub(crate) struct EndpointServer {\n    // Session Data\n    rpc: Option\u003cSession\u003cTcpStream\u003e\u003e,\n    pub server_identity: V3OnionServiceId,\n    allowed_client_identity: V3OnionServiceId,\n\n    // State Machine Data\n    state: EndpointServerState,\n    begin_handshake_request_cookie: Option\u003cRequestCookie\u003e,\n    client_identity: Option\u003cV3OnionServiceId\u003e,\n    requested_channel: Option\u003cAsciiString\u003e,\n    server_cookie: Option\u003cServerCookie\u003e,\n    handshake_succeeded: Option\u003cbool\u003e,\n\n    // Verification flags\n\n    // Client not on the block-list\n    client_allowed: bool,\n    // The requested endpoint is valid\n    client_requested_channel_valid: bool,\n    // The client proof is valid and signed with client's public key\n    client_proof_signature_valid: bool,\n}\n\nimpl EndpointServer {\n    fn get_state(\u0026self) -\u003e String {\n        format!(\"{{ state: {:?}, begin_handshake_request_cookie: {:?}, client_identity: {:?}, requested_channel: {:?}, server_cookie: {:?}, handshake_succeeded:{:?} }}\", self.state, self.begin_handshake_request_cookie, self.client_identity, self.requested_channel, self.server_cookie, self.handshake_succeeded)\n    }\n\n    pub fn new(\n        rpc: Session\u003cTcpStream\u003e,\n        client_identity: V3OnionServiceId,\n        server_identity: V3OnionServiceId,\n    ) -\u003e Self {\n        // generate server cookie\n        let mut server_cookie: ServerCookie = Default::default();\n        OsRng.fill_bytes(\u0026mut server_cookie);\n\n        EndpointServer {\n            rpc: Some(rpc),\n            server_identity,\n            allowed_client_identity: client_identity,\n            state: EndpointServerState::WaitingForBeginHandshake,\n            begin_handshake_request_cookie: None,\n            requested_channel: None,\n            client_identity: None,\n            server_cookie: None,\n            handshake_succeeded: None,\n            client_allowed: false,\n            // TODO: hookup this to event and callback\n            client_requested_channel_valid: true,\n            client_proof_signature_valid: false,\n        }\n    }\n\n    pub fn update(\u0026mut self) -\u003e Result\u003cOption\u003cEndpointServerEvent\u003e, Error\u003e {\n        if let Some(mut rpc) = std::mem::take(\u0026mut self.rpc) {\n            match rpc.update(Some(\u0026mut [self])) {\n                Ok(()) =\u003e {\n                    self.rpc = Some(rpc);\n                }\n                Err(err) =\u003e {\n                    self.rpc = Some(rpc);\n                    return Err(err.into());\n                }\n            }\n        }\n\n        match(\u0026self.state,\n              self.begin_handshake_request_cookie,\n              self.client_identity.as_ref(),\n              self.requested_channel.as_ref(),\n              self.server_cookie.as_ref(),\n              self.handshake_succeeded) {\n            (\u0026EndpointServerState::WaitingForBeginHandshake,\n             None, // begin_handshake_request_cookie\n             None, // client_identity\n             None, // requested_channel\n             None, // server_cookie\n             None) // handshake_succeeded\n            =\u003e {},\n            (\u0026EndpointServerState::WaitingForBeginHandshake,\n             Some(_begin_handshake_request_cookie),\n             Some(client_identity),\n             Some(requested_channel),\n             None, // server_cookie\n             None) // handshake_succeeded\n            =\u003e {\n                self.state = EndpointServerState::ValidatingChannelRequest;\n                return Ok(\n                        Some(\n                            EndpointServerEvent::ChannelRequestReceived\n                            {\n                                client_service_id: client_identity.clone(),\n                                requested_channel: requested_channel.clone()\n                            }));\n            },\n            (\u0026EndpointServerState::ValidatingChannelRequest,\n             Some(_begin_handshake_request_cookie),\n             Some(_client_identity),\n             Some(_requested_channel),\n             None, // server_cookie\n             None) // handshake_succeeded\n            =\u003e {},\n            (\u0026EndpointServerState::ChannelRequestValidated,\n             Some(_begin_handshake_request_cookie),\n             Some(_client_identity),\n             Some(_requested_channel),\n             Some(_server_cookie),\n             None) // handshake_succeeded\n            =\u003e {},\n            (\u0026EndpointServerState::WaitingForSendResponse,\n             Some(_begin_handshake_request_cookie),\n             Some(_client_identity),\n             Some(_requested_channel),\n             Some(_server_cookie),\n             None) // handshake_succeeded\n            =\u003e {},\n            (\u0026EndpointServerState::HandledSendResponse,\n             Some(_begin_handshake_request_cookie),\n             Some(client_identity),\n             Some(requested_channel),\n             Some(_server_cookie),\n             Some(handshake_succeeded))\n            =\u003e {\n                self.state = EndpointServerState::HandshakeComplete;\n                if handshake_succeeded {\n                    let stream = std::mem::take(\u0026mut self.rpc).unwrap().into_stream();\n                    return Ok(Some(EndpointServerEvent::HandshakeCompleted{\n                        client_service_id: client_identity.clone(),\n                        channel_name: requested_channel.clone(),\n                        stream}));\n                } else {\n                    return Ok(Some(EndpointServerEvent::HandshakeRejected{\n                        client_allowed: self.client_allowed,\n                        client_requested_channel_valid: self.client_requested_channel_valid,\n                        client_proof_signature_valid: self.client_proof_signature_valid}));\n                }\n            },\n            _ =\u003e {\n                if self.state == EndpointServerState::HandshakeFailed {\n                    return Err(Error::BadClient);\n                } else {\n                    return Err(Error::InvalidState(self.get_state()));\n                }\n            }\n        }\n\n        Ok(None)\n    }\n\n    pub fn handle_channel_request_received(\n        \u0026mut self,\n        client_requested_channel_valid: bool,\n    ) -\u003e Result\u003c(), Error\u003e {\n        match(\u0026self.state,\n              self.begin_handshake_request_cookie,\n              self.client_identity.as_ref(),\n              self.requested_channel.as_ref(),\n              self.server_cookie.as_ref(),\n              self.handshake_succeeded) {\n            (\u0026EndpointServerState::ValidatingChannelRequest,\n             Some(_begin_handshake_request_cookie),\n             Some(client_identity),\n             Some(_requested_channel),\n             None, // server_cookie\n             None) // handshake_succeeded\n            =\u003e {\n                let mut server_cookie: ServerCookie = Default::default();\n                OsRng.fill_bytes(\u0026mut server_cookie);\n                self.server_cookie = Some(server_cookie);\n                self.client_allowed = *client_identity == self.allowed_client_identity;\n                self.client_requested_channel_valid = client_requested_channel_valid;\n                self.state = EndpointServerState::ChannelRequestValidated;\n                Ok(())\n            },\n            _ =\u003e Err(Error::IncorrectUsage(\"handle_channel_request_received() may only be called after ChannelRequestReceived has been returned from update(), and it may only be called once\".to_string()))\n        }\n    }\n}\n\nimpl ApiSet for EndpointServer {\n    fn namespace(\u0026self) -\u003e \u0026str {\n        \"gosling_endpoint\"\n    }\n\n    fn exec_function(\n        \u0026mut self,\n        name: \u0026str,\n        version: i32,\n        mut args: bson::document::Document,\n        request_cookie: Option\u003cRequestCookie\u003e,\n    ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n        let request_cookie = match request_cookie {\n            Some(request_cookie) =\u003e request_cookie,\n            None =\u003e {\n                return Some(Err(ErrorCode::Runtime(\n                    RpcError::RequestCookieRequired as i32,\n                )))\n            }\n        };\n\n        match\n            (name, version,\n             \u0026self.state,\n             self.client_identity.as_ref(),\n             self.requested_channel.as_ref(),\n             self.server_cookie.as_ref()) {\n            // handle begin_handshake call\n            (\"begin_handshake\", 0,\n            \u0026EndpointServerState::WaitingForBeginHandshake,\n            None, // client_identity\n            None, // requested_channel\n            None) // server_cookie\n            =\u003e {\n                let valid_version = match args.remove(\"version\") {\n                    Some(Bson::String(value)) =\u003e value == GOSLING_PROTOCOL_VERSION,\n                    _ =\u003e false,\n                };\n                if !valid_version {\n                    self.state = EndpointServerState::HandshakeFailed;\n                    return Some(Err(ErrorCode::Runtime(RpcError::BadVersion as i32)));\n                }\n\n                if let (\n                    Some(Bson::String(client_identity)),\n                    Some(Bson::String(channel_name))\n                ) = (\n                    args.remove(\"client_identity\"),\n                    args.remove(\"channel\")\n                ) {\n                    // client_identiity\n                    self.client_identity = match V3OnionServiceId::from_string(\u0026client_identity) {\n                        Ok(client_identity) =\u003e Some(client_identity),\n                        Err(_) =\u003e {\n                            self.state = EndpointServerState::HandshakeFailed;\n                            return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                        }\n                    };\n\n                    let channel_name = match AsciiString::new(channel_name) {\n                        Ok(channel_name) =\u003e channel_name,\n                        Err(_) =\u003e {\n                            self.state = EndpointServerState::HandshakeFailed;\n                            return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                        }\n                    };\n\n                    // save cookie\n                    self.begin_handshake_request_cookie = Some(request_cookie);\n\n                    // save channel name\n                    self.requested_channel = Some(channel_name);\n\n                    None\n                } else {\n                    self.state = EndpointServerState::HandshakeFailed;\n                    Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)))\n                }\n            },\n            (\"send_response\", 0,\n            \u0026EndpointServerState::WaitingForSendResponse,\n            Some(client_identity),\n            Some(requested_channel),\n            Some(server_cookie))\n            =\u003e {\n                if let (Some(Bson::Binary(Binary{subtype: BinarySubtype::Generic, bytes: client_cookie})),\n                        Some(Bson::Binary(Binary{subtype: BinarySubtype::Generic, bytes: client_identity_proof_signature}))) =\n                       (args.remove(\"client_cookie\"),\n                        args.remove(\"client_identity_proof_signature\")) {\n                    // client_cookie\n                    let client_cookie : ClientCookie = match client_cookie.try_into() {\n                        Ok(client_cookie) =\u003e client_cookie,\n                        Err(_) =\u003e {\n                            self.state = EndpointServerState::HandshakeFailed;\n                            return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                        }\n                    };\n\n                    // client_identity_proof_signature\n                    let client_identity_proof_signature : [u8; ED25519_SIGNATURE_SIZE] = match client_identity_proof_signature.try_into() {\n                        Ok(client_identity_proof_signature) =\u003e client_identity_proof_signature,\n                        Err(_) =\u003e {\n                            self.state = EndpointServerState::HandshakeFailed;\n                            return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                        }\n                    };\n                    let client_identity_proof_signature = match Ed25519Signature::from_raw(\u0026client_identity_proof_signature) {\n                        Ok(client_identity_proof_signature) =\u003e client_identity_proof_signature,\n                        Err(_) =\u003e {\n                            self.state = EndpointServerState::HandshakeFailed;\n                            return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                        }\n                    };\n\n                    // convert client_identity to client's public ed25519 key\n                    let client_identity_key = match Ed25519PublicKey::from_service_id(client_identity) {\n                        Ok(client_identity_key) =\u003e client_identity_key,\n                        Err(_) =\u003e {\n                            self.state = EndpointServerState::HandshakeFailed;\n                            return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                        }\n                    };\n\n                    // construct + verify client proof\n                    let client_proof = build_client_proof(\n                        DomainSeparator::GoslingEndpoint,\n                        requested_channel,\n                        client_identity,\n                        \u0026self.server_identity,\n                        \u0026client_cookie,\n                        server_cookie,\n                    );\n                    self.client_proof_signature_valid =\n                        client_identity_proof_signature.verify(\u0026client_proof, \u0026client_identity_key);\n\n                    if self.client_allowed\n                        \u0026\u0026 self.client_requested_channel_valid\n                        \u0026\u0026 self.client_proof_signature_valid\n                    {\n                        self.handshake_succeeded = Some(true);\n                        self.state = EndpointServerState::HandledSendResponse;\n                        // success, return empty doc\n                        Some(Ok(Some(Bson::Document(doc! {}))))\n                    } else {\n                        self.handshake_succeeded = Some(false);\n                        self.state = EndpointServerState::HandledSendResponse;\n                        Some(Err(ErrorCode::Runtime(RpcError::Failure as i32)))\n                    }\n                } else {\n                    self.state = EndpointServerState::HandshakeFailed;\n                    Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)))\n                }\n            },\n            _ =\u003e {\n                self.state = EndpointServerState::HandshakeFailed;\n                Some(Err(ErrorCode::Runtime(RpcError::Failure as i32)))\n            }\n        }\n    }\n\n    fn next_result(\u0026mut self) -\u003e Option\u003c(RequestCookie, Result\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e)\u003e {\n        match (\n            \u0026self.state,\n            self.begin_handshake_request_cookie,\n            self.server_cookie.as_ref(),\n        ) {\n            (\n                \u0026EndpointServerState::ChannelRequestValidated,\n                Some(begin_handshake_request_cookie),\n                Some(server_cookie),\n            ) =\u003e {\n                self.state = EndpointServerState::WaitingForSendResponse;\n                Some((\n                    begin_handshake_request_cookie,\n                    Ok(Some(Bson::Document(doc! {\n                        \"server_cookie\" : Bson::Binary(Binary{subtype: BinarySubtype::Generic, bytes: server_cookie.to_vec()}),\n                    }))),\n                ))\n            }\n            _ =\u003e None,\n        }\n    }\n}\n","traces":[{"line":95,"address":[4381808],"length":1,"stats":{"Line":0}},{"line":96,"address":[2103416,2102857,2103323,2103228,2103038,2103133],"length":1,"stats":{"Line":0}},{"line":99,"address":[1973118,1972624],"length":1,"stats":{"Line":2}},{"line":105,"address":[2103712],"length":1,"stats":{"Line":2}},{"line":106,"address":[2103765],"length":1,"stats":{"Line":2}},{"line":109,"address":[1972744],"length":1,"stats":{"Line":2}},{"line":125,"address":[1973152,1974360],"length":1,"stats":{"Line":2}},{"line":126,"address":[1973203],"length":1,"stats":{"Line":2}},{"line":127,"address":[4343641,4343803],"length":1,"stats":{"Line":4}},{"line":129,"address":[2104585,2104925],"length":1,"stats":{"Line":2}},{"line":131,"address":[4343954],"length":1,"stats":{"Line":0}},{"line":132,"address":[1973998,1973786],"length":1,"stats":{"Line":0}},{"line":133,"address":[4344369,4344568],"length":1,"stats":{"Line":0}},{"line":138,"address":[2106449,2106063,2105741,2105585,2107024,2105450,2106630,2106827],"length":1,"stats":{"Line":12}},{"line":139,"address":[4384477],"length":1,"stats":{"Line":2}},{"line":140,"address":[4384494],"length":1,"stats":{"Line":2}},{"line":141,"address":[2105506],"length":1,"stats":{"Line":2}},{"line":142,"address":[2105531],"length":1,"stats":{"Line":2}},{"line":143,"address":[2105579],"length":1,"stats":{"Line":2}},{"line":151,"address":[4345480],"length":1,"stats":{"Line":2}},{"line":158,"address":[4345501],"length":1,"stats":{"Line":2}},{"line":159,"address":[1975395],"length":1,"stats":{"Line":2}},{"line":160,"address":[4385393],"length":1,"stats":{"Line":2}},{"line":161,"address":[2106271],"length":1,"stats":{"Line":2}},{"line":163,"address":[1975234],"length":1,"stats":{"Line":2}},{"line":164,"address":[2106258],"length":1,"stats":{"Line":2}},{"line":167,"address":[2106609],"length":1,"stats":{"Line":0}},{"line":173,"address":[4345907],"length":1,"stats":{"Line":0}},{"line":174,"address":[4346088],"length":1,"stats":{"Line":0}},{"line":180,"address":[4346104],"length":1,"stats":{"Line":0}},{"line":181,"address":[2106971],"length":1,"stats":{"Line":2}},{"line":187,"address":[2107019],"length":1,"stats":{"Line":2}},{"line":188,"address":[2107176],"length":1,"stats":{"Line":2}},{"line":195,"address":[4386279],"length":1,"stats":{"Line":2}},{"line":196,"address":[1976268],"length":1,"stats":{"Line":2}},{"line":197,"address":[4386563,4386471],"length":1,"stats":{"Line":4}},{"line":198,"address":[2107643],"length":1,"stats":{"Line":2}},{"line":199,"address":[4386592],"length":1,"stats":{"Line":2}},{"line":200,"address":[4346912],"length":1,"stats":{"Line":2}},{"line":201,"address":[1976631],"length":1,"stats":{"Line":2}},{"line":203,"address":[2107308],"length":1,"stats":{"Line":1}},{"line":204,"address":[1976284],"length":1,"stats":{"Line":1}},{"line":205,"address":[1976290],"length":1,"stats":{"Line":1}},{"line":206,"address":[4346584],"length":1,"stats":{"Line":1}},{"line":210,"address":[1974703],"length":1,"stats":{"Line":0}},{"line":211,"address":[1976939],"length":1,"stats":{"Line":0}},{"line":213,"address":[4347109],"length":1,"stats":{"Line":0}},{"line":218,"address":[2105997],"length":1,"stats":{"Line":2}},{"line":221,"address":[2107984],"length":1,"stats":{"Line":2}},{"line":225,"address":[4387207,4387077,4387388],"length":1,"stats":{"Line":6}},{"line":226,"address":[4347348],"length":1,"stats":{"Line":2}},{"line":227,"address":[1977077],"length":1,"stats":{"Line":2}},{"line":228,"address":[1977100],"length":1,"stats":{"Line":2}},{"line":229,"address":[2108113],"length":1,"stats":{"Line":2}},{"line":230,"address":[4347457],"length":1,"stats":{"Line":2}},{"line":231,"address":[2108467],"length":1,"stats":{"Line":2}},{"line":238,"address":[4347810],"length":1,"stats":{"Line":2}},{"line":239,"address":[4387568],"length":1,"stats":{"Line":2}},{"line":240,"address":[1977568],"length":1,"stats":{"Line":2}},{"line":241,"address":[4387771],"length":1,"stats":{"Line":2}},{"line":242,"address":[2108768],"length":1,"stats":{"Line":2}},{"line":243,"address":[1977788],"length":1,"stats":{"Line":2}},{"line":244,"address":[2108798],"length":1,"stats":{"Line":2}},{"line":246,"address":[1977237],"length":1,"stats":{"Line":0}},{"line":252,"address":[4348128],"length":1,"stats":{"Line":2}},{"line":256,"address":[1977872,1981675,1986621],"length":1,"stats":{"Line":2}},{"line":263,"address":[2109006],"length":1,"stats":{"Line":2}},{"line":264,"address":[4388225],"length":1,"stats":{"Line":2}},{"line":266,"address":[4348385],"length":1,"stats":{"Line":0}},{"line":272,"address":[4353120,4349144,4353087,4348862,4349111,4349078,4353186,4353153,4349045,4349020],"length":1,"stats":{"Line":20}},{"line":273,"address":[4349121,4349034,4349055,4353097,4348719,4349088,4353076,4353163,4353130],"length":1,"stats":{"Line":18}},{"line":274,"address":[4348502],"length":1,"stats":{"Line":2}},{"line":275,"address":[4348519],"length":1,"stats":{"Line":2}},{"line":276,"address":[1978328],"length":1,"stats":{"Line":2}},{"line":277,"address":[4388391],"length":1,"stats":{"Line":2}},{"line":279,"address":[4348774],"length":1,"stats":{"Line":2}},{"line":285,"address":[1982916],"length":1,"stats":{"Line":2}},{"line":286,"address":[4393075],"length":1,"stats":{"Line":2}},{"line":287,"address":[1983030],"length":1,"stats":{"Line":0}},{"line":289,"address":[2114357],"length":1,"stats":{"Line":2}},{"line":290,"address":[1983479],"length":1,"stats":{"Line":0}},{"line":291,"address":[4353788],"length":1,"stats":{"Line":0}},{"line":294,"address":[4394019,4393745,4393852,4394063],"length":1,"stats":{"Line":8}},{"line":295,"address":[4354363],"length":1,"stats":{"Line":2}},{"line":296,"address":[2115067],"length":1,"stats":{"Line":2}},{"line":298,"address":[2114559],"length":1,"stats":{"Line":2}},{"line":299,"address":[1983638],"length":1,"stats":{"Line":2}},{"line":302,"address":[2115376,2115191,2115123],"length":1,"stats":{"Line":6}},{"line":303,"address":[2115240],"length":1,"stats":{"Line":2}},{"line":305,"address":[1984522],"length":1,"stats":{"Line":0}},{"line":306,"address":[4394575],"length":1,"stats":{"Line":0}},{"line":310,"address":[4394688],"length":1,"stats":{"Line":2}},{"line":311,"address":[2115682],"length":1,"stats":{"Line":2}},{"line":313,"address":[2115822],"length":1,"stats":{"Line":0}},{"line":314,"address":[4355179],"length":1,"stats":{"Line":0}},{"line":319,"address":[2115962],"length":1,"stats":{"Line":2}},{"line":322,"address":[1985053,1985217],"length":1,"stats":{"Line":2}},{"line":324,"address":[1985342],"length":1,"stats":{"Line":2}},{"line":326,"address":[2114827],"length":1,"stats":{"Line":0}},{"line":327,"address":[1983896],"length":1,"stats":{"Line":0}},{"line":330,"address":[2109854],"length":1,"stats":{"Line":3}},{"line":336,"address":[1979439,1979187,1979152,1979403,1979320,1979359,1979421],"length":1,"stats":{"Line":7}},{"line":339,"address":[2109952],"length":1,"stats":{"Line":2}},{"line":341,"address":[2110577,2110509],"length":1,"stats":{"Line":4}},{"line":342,"address":[2110595],"length":1,"stats":{"Line":2}},{"line":344,"address":[4350013],"length":1,"stats":{"Line":0}},{"line":345,"address":[2110718],"length":1,"stats":{"Line":0}},{"line":350,"address":[1979919],"length":1,"stats":{"Line":2}},{"line":351,"address":[4350296],"length":1,"stats":{"Line":2}},{"line":353,"address":[4390206],"length":1,"stats":{"Line":0}},{"line":354,"address":[2111167],"length":1,"stats":{"Line":0}},{"line":357,"address":[4350656],"length":1,"stats":{"Line":2}},{"line":358,"address":[4350705],"length":1,"stats":{"Line":2}},{"line":360,"address":[4390615],"length":1,"stats":{"Line":0}},{"line":361,"address":[2111572],"length":1,"stats":{"Line":0}},{"line":366,"address":[4351010],"length":1,"stats":{"Line":2}},{"line":367,"address":[1980752],"length":1,"stats":{"Line":2}},{"line":369,"address":[1980860],"length":1,"stats":{"Line":0}},{"line":370,"address":[4390913],"length":1,"stats":{"Line":0}},{"line":376,"address":[4351298],"length":1,"stats":{"Line":2}},{"line":379,"address":[1981018],"length":1,"stats":{"Line":2}},{"line":383,"address":[2112159],"length":1,"stats":{"Line":2}},{"line":384,"address":[4351436,4351353],"length":1,"stats":{"Line":4}},{"line":386,"address":[1981200,1981618,1981357],"length":1,"stats":{"Line":5}},{"line":387,"address":[4391399],"length":1,"stats":{"Line":2}},{"line":388,"address":[4351676],"length":1,"stats":{"Line":2}},{"line":390,"address":[2112377],"length":1,"stats":{"Line":2}},{"line":391,"address":[2112398],"length":1,"stats":{"Line":2}},{"line":393,"address":[2112419,2112460],"length":1,"stats":{"Line":4}},{"line":395,"address":[2112197],"length":1,"stats":{"Line":1}},{"line":396,"address":[1981250],"length":1,"stats":{"Line":1}},{"line":397,"address":[1981271],"length":1,"stats":{"Line":1}},{"line":400,"address":[2110185],"length":1,"stats":{"Line":0}},{"line":401,"address":[2110206],"length":1,"stats":{"Line":0}},{"line":405,"address":[1978620],"length":1,"stats":{"Line":0}},{"line":406,"address":[2109621],"length":1,"stats":{"Line":0}},{"line":411,"address":[1987388,1986640],"length":1,"stats":{"Line":2}},{"line":412,"address":[4357092,4357026],"length":1,"stats":{"Line":4}},{"line":413,"address":[2117622],"length":1,"stats":{"Line":2}},{"line":414,"address":[4396725],"length":1,"stats":{"Line":2}},{"line":415,"address":[4356998],"length":1,"stats":{"Line":2}},{"line":417,"address":[1986835],"length":1,"stats":{"Line":2}},{"line":422,"address":[1986870],"length":1,"stats":{"Line":2}},{"line":423,"address":[1987323],"length":1,"stats":{"Line":2}},{"line":425,"address":[1986885,1986939,1987093],"length":1,"stats":{"Line":4}},{"line":426,"address":[1986907,1986983],"length":1,"stats":{"Line":4}},{"line":430,"address":[1986785],"length":1,"stats":{"Line":2}}],"covered":112,"coverable":147},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","src","gosling.rs"],"content":"// standard\n#[cfg(test)]\nuse std::net::{SocketAddr, TcpListener, TcpStream};\n\n// extern crates\n#[cfg(test)]\nuse bson::doc;\nuse data_encoding::HEXLOWER;\n#[cfg(test)]\nuse honk_rpc::honk_rpc::Session;\nuse num_enum::TryFromPrimitive;\nuse tor_interface::tor_crypto::*;\n\n// internal crates\nuse crate::ascii_string::*;\n#[cfg(test)]\nuse crate::endpoint_client::*;\n#[cfg(test)]\nuse crate::endpoint_server::*;\n#[cfg(test)]\nuse crate::identity_client::*;\n#[cfg(test)]\nuse crate::identity_server::*;\n\n#[derive(Debug, Eq, PartialEq, TryFromPrimitive)]\n#[repr(i32)]\n/// cbindgen:ignore\npub(crate) enum RpcError {\n    // bad gosling version\n    BadVersion,\n    // cookie required\n    RequestCookieRequired,\n    // invalid or missing arguments\n    InvalidArg,\n    // generic runtime error\n    Failure,\n}\n\npub(crate) const GOSLING_PROTOCOL_VERSION: \u0026str = \"0.1.0\";\n\npub(crate) const CLIENT_COOKIE_SIZE: usize = 32usize;\npub(crate) const SERVER_COOKIE_SIZE: usize = 32usize;\n\npub(crate) type ClientCookie = [u8; CLIENT_COOKIE_SIZE];\npub(crate) type ServerCookie = [u8; SERVER_COOKIE_SIZE];\npub(crate) type ClientProof = Vec\u003cu8\u003e;\n\npub(crate) enum DomainSeparator {\n    GoslingIdentity,\n    GoslingEndpoint,\n}\n\nimpl From\u003cDomainSeparator\u003e for \u0026[u8] {\n    fn from(sep: DomainSeparator) -\u003e \u0026'static [u8] {\n        match sep {\n            DomainSeparator::GoslingIdentity =\u003e b\"gosling-identity\",\n            DomainSeparator::GoslingEndpoint =\u003e b\"gosling-endpoint\",\n        }\n    }\n}\n\npub(crate) fn build_client_proof(\n    domain_separator: DomainSeparator,\n    request: \u0026AsciiString,\n    client_service_id: \u0026V3OnionServiceId,\n    server_service_id: \u0026V3OnionServiceId,\n    client_cookie: \u0026ClientCookie,\n    server_cookie: \u0026ServerCookie,\n) -\u003e ClientProof {\n    let mut client_proof: ClientProof = Default::default();\n\n    client_proof.extend_from_slice(domain_separator.into());\n    client_proof.push(0u8);\n    client_proof.extend_from_slice(request.as_bytes());\n    client_proof.push(0u8);\n    client_proof.extend_from_slice(client_service_id.to_string().as_bytes());\n    client_proof.push(0u8);\n    client_proof.extend_from_slice(server_service_id.to_string().as_bytes());\n    client_proof.push(0u8);\n    client_proof.extend_from_slice(HEXLOWER.encode(client_cookie).as_bytes());\n    client_proof.push(0u8);\n    client_proof.extend_from_slice(HEXLOWER.encode(server_cookie).as_bytes());\n\n    client_proof\n}\n\n//\n// Tests\n//\n\n#[cfg(test)]\nfn identity_test(\n    client_blocked: bool,\n    client_requested_endpoint: \u0026str,\n    client_requested_endpoint_valid: bool,\n    server_challenge: bson::document::Document,\n    client_response: bson::document::Document,\n    server_expected_response: bson::document::Document,\n    should_fail: bool,\n) -\u003e anyhow::Result\u003c()\u003e {\n    // test sockets\n    let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n    let listener = TcpListener::bind(socket_addr)?;\n    let socket_addr = listener.local_addr()?;\n\n    let stream1 = TcpStream::connect(socket_addr)?;\n    stream1.set_nonblocking(true)?;\n    let (stream2, _socket_addr) = listener.accept()?;\n    stream2.set_nonblocking(true)?;\n\n    // client setup\n    let client_ed25519_private = Ed25519PrivateKey::generate();\n\n    // server setup\n    let server_ed25519_private = Ed25519PrivateKey::generate();\n    let server_ed25519_public = Ed25519PublicKey::from_private_key(\u0026server_ed25519_private);\n    let server_service_id = V3OnionServiceId::from_public_key(\u0026server_ed25519_public);\n\n    let client_requested_endpoint = match AsciiString::new(client_requested_endpoint.to_string()) {\n        Ok(ascii) =\u003e ascii,\n        Err(_) =\u003e {\n            assert!(should_fail);\n            return Ok(());\n        }\n    };\n\n    // rpc setup\n    let client_rpc = Session::new(stream1);\n    let mut ident_client = IdentityClient::new(\n        client_rpc,\n        server_service_id.clone(),\n        client_requested_endpoint.clone(),\n        client_ed25519_private,\n        X25519PrivateKey::generate(),\n    )\n    .unwrap();\n\n    let server_rpc = Session::new(stream2);\n    let mut ident_server = IdentityServer::new(server_rpc, server_service_id.clone());\n\n    let mut failure_ocurred = false;\n    let mut server_complete = false;\n    let mut client_complete = false;\n    while !server_complete \u0026\u0026 !client_complete {\n        if !server_complete {\n            match ident_server.update() {\n                Ok(Some(IdentityServerEvent::EndpointRequestReceived {\n                    client_service_id,\n                    requested_endpoint,\n                })) =\u003e {\n                    println!(\n                        \"server challenge send: client_service_id {}, requested_endpoint: {}\",\n                        client_service_id.to_string(),\n                        requested_endpoint\n                    );\n                    let client_allowed = !client_blocked;\n                    ident_server.handle_endpoint_request_received(\n                        client_allowed,\n                        client_requested_endpoint_valid,\n                        server_challenge.clone(),\n                    )?;\n                }\n                Ok(Some(IdentityServerEvent::ChallengeResponseReceived { challenge_response })) =\u003e {\n                    println!(\"server challenge repsonse received\");\n                    ident_server.handle_challenge_response_received(\n                        challenge_response == server_expected_response,\n                    )?;\n                }\n                Ok(Some(IdentityServerEvent::HandshakeCompleted {\n                    endpoint_private_key: _,\n                    endpoint_name,\n                    client_service_id,\n                    client_auth_public_key: _,\n                })) =\u003e {\n                    assert!(endpoint_name == client_requested_endpoint);\n                    println!(\n                        \"server complete! client_service_id : {}\",\n                        client_service_id.to_string()\n                    );\n                    server_complete = true;\n                }\n                Ok(Some(IdentityServerEvent::HandshakeRejected {\n                    client_allowed,\n                    client_requested_endpoint_valid,\n                    client_proof_signature_valid,\n                    client_auth_signature_valid,\n                    challenge_response_valid,\n                })) =\u003e {\n                    println!(\"server complete! client request rejected\");\n                    println!(\" client_allowed: {}\", client_allowed);\n                    println!(\n                        \" client_requested_endpoint_valid: {}\",\n                        client_requested_endpoint_valid\n                    );\n                    println!(\n                        \" client_proof_signature_valid: {}\",\n                        client_proof_signature_valid\n                    );\n                    println!(\n                        \" client_auth_signature_valid: {}\",\n                        client_auth_signature_valid\n                    );\n                    println!(\" client_response_valid: {}\", challenge_response_valid);\n                    server_complete = true;\n                    failure_ocurred = true;\n                }\n                Ok(None) =\u003e {}\n                Err(err) =\u003e {\n                    println!(\"server failure: {:?}\", err);\n                    server_complete = true;\n                    failure_ocurred = true;\n                }\n            }\n        }\n\n        if !client_complete {\n            match ident_client.update() {\n                Ok(Some(IdentityClientEvent::ChallengeReceived { endpoint_challenge })) =\u003e {\n                    println!(\n                        \"client challenge request received: endpoint_challenge: {}\",\n                        endpoint_challenge\n                    );\n                    ident_client.send_response(client_response.clone())?;\n                }\n                Ok(Some(IdentityClientEvent::HandshakeCompleted {\n                    identity_service_id,\n                    endpoint_service_id,\n                    endpoint_name,\n                    client_auth_private_key: _,\n                })) =\u003e {\n                    assert!(identity_service_id == server_service_id);\n                    assert!(endpoint_name == client_requested_endpoint.clone().to_string());\n                    println!(\n                        \"client complete! endpoint_server : {}\",\n                        endpoint_service_id.to_string()\n                    );\n                    client_complete = true;\n                }\n                Ok(None) =\u003e {}\n                Err(err) =\u003e {\n                    println!(\"client failure: {:?}\", err);\n                    client_complete = true;\n                    failure_ocurred = true;\n                }\n            }\n        }\n    }\n\n    assert!(failure_ocurred == should_fail);\n    Ok(())\n}\n\n#[test]\nfn test_identity_handshake() -\u003e anyhow::Result\u003c()\u003e {\n    println!(\"Sucessful ---\");\n    {\n        let client_blocked: bool = false;\n        let client_requested_endpoint: \u0026str = \"endpoint\";\n        let client_requested_endpoint_valid: bool = true;\n        let server_challenge: bson::document::Document = doc!(\"msg\": \"Speak friend and enter\");\n        let client_response: bson::document::Document = doc!(\"msg\": \"Mellon\");\n        let server_expected_response: bson::document::Document = doc!(\"msg\": \"Mellon\");\n        let should_fail: bool = false;\n        identity_test(\n            client_blocked,\n            client_requested_endpoint,\n            client_requested_endpoint_valid,\n            server_challenge,\n            client_response,\n            server_expected_response,\n            should_fail,\n        )?;\n    }\n    println!(\"Bad Endpoint ---\");\n    {\n        let client_blocked: bool = false;\n        let client_requested_endpoint: \u0026str = \"endpoint\";\n        let client_requested_endpoint_valid: bool = false;\n        let server_challenge: bson::document::Document = doc!(\"msg\": \"Speak friend and enter\");\n        let client_response: bson::document::Document = doc!(\"msg\": \"Mellon\");\n        let server_expected_response: bson::document::Document = doc!(\"msg\": \"Mellon\");\n        let should_fail: bool = true;\n        identity_test(\n            client_blocked,\n            client_requested_endpoint,\n            client_requested_endpoint_valid,\n            server_challenge,\n            client_response,\n            server_expected_response,\n            should_fail,\n        )?;\n    }\n    println!(\"Bad Challenge Response ---\");\n    {\n        let client_blocked: bool = false;\n        let client_requested_endpoint: \u0026str = \"endpoint\";\n        let client_requested_endpoint_valid: bool = true;\n        let server_challenge: bson::document::Document = doc!(\"msg\": \"Speak friend and enter\");\n        let client_response: bson::document::Document = doc!(\"msg\": \"Friend?\");\n        let server_expected_response: bson::document::Document = doc!(\"msg\": \"Mellon\");\n        let should_fail: bool = true;\n        identity_test(\n            client_blocked,\n            client_requested_endpoint,\n            client_requested_endpoint_valid,\n            server_challenge,\n            client_response,\n            server_expected_response,\n            should_fail,\n        )?;\n    }\n    println!(\"Blocked Client ---\");\n    {\n        let client_blocked: bool = true;\n        let client_requested_endpoint: \u0026str = \"endpoint\";\n        let client_requested_endpoint_valid: bool = true;\n        let server_challenge: bson::document::Document = doc!(\"msg\": \"Speak friend and enter\");\n        let client_response: bson::document::Document = doc!(\"msg\": \"Mellon\");\n        let server_expected_response: bson::document::Document = doc!(\"msg\": \"Mellon\");\n        let should_fail: bool = true;\n        identity_test(\n            client_blocked,\n            client_requested_endpoint,\n            client_requested_endpoint_valid,\n            server_challenge,\n            client_response,\n            server_expected_response,\n            should_fail,\n        )?;\n    }\n    println!(\"Non-ASCII endpoint ---\");\n    {\n        let client_blocked: bool = false;\n        let client_requested_endpoint: \u0026str = \"𝕦𝕥𝕗𝟠\";\n        let client_requested_endpoint_valid: bool = true;\n        let server_challenge: bson::document::Document = doc!(\"msg\": \"Speak friend and enter\");\n        let client_response: bson::document::Document = doc!(\"msg\": \"Mellon\");\n        let server_expected_response: bson::document::Document = doc!(\"msg\": \"Mellon\");\n        let should_fail: bool = true;\n        identity_test(\n            client_blocked,\n            client_requested_endpoint,\n            client_requested_endpoint_valid,\n            server_challenge,\n            client_response,\n            server_expected_response,\n            should_fail,\n        )?;\n    }\n    Ok(())\n}\n\n#[cfg(test)]\nfn endpoint_test(\n    should_fail: bool,\n    client_allowed: bool,\n    channel: \u0026str,\n    channel_allowed: bool,\n) -\u003e anyhow::Result\u003c()\u003e {\n    // test sockets\n    let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n    let listener = TcpListener::bind(socket_addr)?;\n    let socket_addr = listener.local_addr()?;\n\n    let stream1 = TcpStream::connect(socket_addr)?;\n    stream1.set_nonblocking(true)?;\n    let (stream2, _socket_addr) = listener.accept()?;\n    stream2.set_nonblocking(true)?;\n\n    // server+client setup\n    let server_ed25519_private = Ed25519PrivateKey::generate();\n    let server_ed25519_public = Ed25519PublicKey::from_private_key(\u0026server_ed25519_private);\n    let server_service_id = V3OnionServiceId::from_public_key(\u0026server_ed25519_public);\n\n    let client_ed25519_private = Ed25519PrivateKey::generate();\n    let client_ed25519_public = Ed25519PublicKey::from_private_key(\u0026client_ed25519_private);\n    let client_service_id = V3OnionServiceId::from_public_key(\u0026client_ed25519_public);\n\n    // ensure our client is in the allow list\n    let allowed_client = if client_allowed {\n        client_service_id.clone()\n    } else {\n        let ed25519_private = Ed25519PrivateKey::generate();\n        let ed25519_public = Ed25519PublicKey::from_private_key(\u0026ed25519_private);\n        V3OnionServiceId::from_public_key(\u0026ed25519_public)\n    };\n\n    let server_rpc = Session::new(stream1);\n\n    let mut endpoint_server = EndpointServer::new(\n        server_rpc,\n        allowed_client.clone(),\n        server_service_id.clone(),\n    );\n\n    let client_rpc = Session::new(stream2);\n\n    let channel = match AsciiString::new(channel.to_string()) {\n        Ok(channel) =\u003e channel,\n        Err(_) =\u003e {\n            assert!(should_fail);\n            return Ok(());\n        }\n    };\n\n    let mut endpoint_client = EndpointClient::new(\n        client_rpc,\n        server_service_id.clone(),\n        channel.clone(),\n        client_ed25519_private,\n    );\n\n    let mut failure_ocurred = false;\n    let mut server_complete = false;\n    let mut client_complete = false;\n    while !server_complete \u0026\u0026 !client_complete {\n        if !server_complete {\n            match endpoint_server.update() {\n                Ok(Some(EndpointServerEvent::ChannelRequestReceived {\n                    client_service_id: ret_client_service_id,\n                    requested_channel,\n                })) =\u003e {\n                    assert_eq!(ret_client_service_id, client_service_id);\n                    assert!(requested_channel == channel);\n                    endpoint_server.handle_channel_request_received(channel_allowed)?;\n                }\n                Ok(Some(EndpointServerEvent::HandshakeCompleted {\n                    client_service_id: ret_client_service_id,\n                    channel_name: ret_channel,\n                    stream: _,\n                })) =\u003e {\n                    assert!(ret_client_service_id == client_service_id);\n                    assert!(ret_channel == channel);\n                    server_complete = true;\n                }\n                Ok(Some(EndpointServerEvent::HandshakeRejected {\n                    client_allowed,\n                    client_requested_channel_valid,\n                    client_proof_signature_valid,\n                })) =\u003e {\n                    println!(\"handshake rejected: client_allowed: {}, client_requested_channel_valid: {}, client_proof_signature_valid: {}\", client_allowed, client_requested_channel_valid, client_proof_signature_valid);\n                    server_complete = true;\n                    failure_ocurred = true;\n                }\n                Ok(None) =\u003e {}\n                Err(err) =\u003e {\n                    println!(\"server failure: {:?}\", err);\n                    server_complete = true;\n                    failure_ocurred = true;\n                }\n            }\n        }\n\n        if !client_complete {\n            match endpoint_client.update() {\n                Ok(Some(EndpointClientEvent::HandshakeCompleted { stream: _ })) =\u003e {\n                    client_complete = true;\n                }\n                Ok(None) =\u003e {}\n                Err(err) =\u003e {\n                    println!(\"client failure: {:?}\", err);\n                    client_complete = true;\n                    failure_ocurred = true;\n                }\n            }\n        }\n    }\n\n    println!(\"server_complete: {}\", server_complete);\n    println!(\"client_complete: {}\", client_complete);\n\n    assert!(should_fail == failure_ocurred);\n\n    Ok(())\n}\n\n#[test]\nfn test_endpoint_handshake() -\u003e anyhow::Result\u003c()\u003e {\n    println!(\"Success ---\");\n    {\n        let should_fail = false;\n        let client_allowed = true;\n        let channel = \"channel\";\n        let channel_allowed = true;\n        endpoint_test(should_fail, client_allowed, channel, channel_allowed)?;\n    }\n    println!(\"Client Not Allowed ---\");\n    {\n        let should_fail = true;\n        let client_allowed = false;\n        let channel = \"channel\";\n        let channel_allowed = true;\n        endpoint_test(should_fail, client_allowed, channel, channel_allowed)?;\n    }\n    println!(\"Channel Not Allowed ---\");\n    {\n        let should_fail = true;\n        let client_allowed = true;\n        let channel = \"channel\";\n        let channel_allowed = false;\n        endpoint_test(should_fail, client_allowed, channel, channel_allowed)?;\n    }\n    println!(\"Client and Channel Not Allowed ---\");\n    {\n        let should_fail = true;\n        let client_allowed = false;\n        let channel = \"channel\";\n        let channel_allowed = false;\n        endpoint_test(should_fail, client_allowed, channel, channel_allowed)?;\n    }\n    println!(\"Non-Ascii Channel ---\");\n    {\n        let should_fail = true;\n        let client_allowed = true;\n        let channel = \"𝕦𝕥𝕗𝟠\";\n        let channel_allowed = true;\n        endpoint_test(should_fail, client_allowed, channel, channel_allowed)?;\n    }\n\n    Ok(())\n}\n","traces":[{"line":54,"address":[4434048],"length":1,"stats":{"Line":2}},{"line":55,"address":[2007993,2008052],"length":1,"stats":{"Line":4}},{"line":56,"address":[2058456],"length":1,"stats":{"Line":2}},{"line":57,"address":[2058479],"length":1,"stats":{"Line":2}},{"line":62,"address":[2059766,2058512],"length":1,"stats":{"Line":2}},{"line":70,"address":[4394494],"length":1,"stats":{"Line":2}},{"line":72,"address":[2058646,2058742],"length":1,"stats":{"Line":4}},{"line":73,"address":[2058761],"length":1,"stats":{"Line":2}},{"line":74,"address":[4394663],"length":1,"stats":{"Line":2}},{"line":75,"address":[4394730],"length":1,"stats":{"Line":2}},{"line":76,"address":[4434500],"length":1,"stats":{"Line":2}},{"line":77,"address":[4394892],"length":1,"stats":{"Line":2}},{"line":78,"address":[4394918],"length":1,"stats":{"Line":2}},{"line":79,"address":[4395054],"length":1,"stats":{"Line":2}},{"line":80,"address":[4395080],"length":1,"stats":{"Line":2}},{"line":81,"address":[4435063],"length":1,"stats":{"Line":2}},{"line":82,"address":[2009028],"length":1,"stats":{"Line":2}},{"line":84,"address":[2059723],"length":1,"stats":{"Line":2}},{"line":92,"address":[2070226,2064486,2059792],"length":1,"stats":{"Line":1}},{"line":102,"address":[2059953],"length":1,"stats":{"Line":1}},{"line":103,"address":[2063136,2060213,2070178,2060356],"length":1,"stats":{"Line":1}},{"line":104,"address":[2060441,2070141,2060329,2060585],"length":1,"stats":{"Line":2}},{"line":106,"address":[2070104,2060727,2060526,2060626],"length":1,"stats":{"Line":2}},{"line":107,"address":[2060695,2070035,2060908,2060817],"length":1,"stats":{"Line":2}},{"line":108,"address":[2060881,2060965,2061118,2070017],"length":1,"stats":{"Line":2}},{"line":109,"address":[2061089,2061202,2069939,2061279],"length":1,"stats":{"Line":2}},{"line":112,"address":[2061260],"length":1,"stats":{"Line":1}},{"line":115,"address":[2061317],"length":1,"stats":{"Line":1}},{"line":116,"address":[2061385],"length":1,"stats":{"Line":1}},{"line":117,"address":[2061453],"length":1,"stats":{"Line":1}},{"line":119,"address":[2061504],"length":1,"stats":{"Line":1}},{"line":120,"address":[2061545],"length":1,"stats":{"Line":1}},{"line":122,"address":[2069724,2061661],"length":1,"stats":{"Line":1}},{"line":123,"address":[2069757],"length":1,"stats":{"Line":1}},{"line":128,"address":[2061674],"length":1,"stats":{"Line":1}},{"line":130,"address":[2061779],"length":1,"stats":{"Line":1}},{"line":131,"address":[2061833],"length":1,"stats":{"Line":1}},{"line":132,"address":[2061897],"length":1,"stats":{"Line":1}},{"line":133,"address":[2061912],"length":1,"stats":{"Line":1}},{"line":134,"address":[2061958],"length":1,"stats":{"Line":1}},{"line":138,"address":[2062409],"length":1,"stats":{"Line":1}},{"line":139,"address":[2069644,2062479],"length":1,"stats":{"Line":1}},{"line":141,"address":[2062625],"length":1,"stats":{"Line":1}},{"line":142,"address":[2062633],"length":1,"stats":{"Line":1}},{"line":143,"address":[2062641],"length":1,"stats":{"Line":1}},{"line":144,"address":[2062649],"length":1,"stats":{"Line":1}},{"line":145,"address":[2066534,2062701],"length":1,"stats":{"Line":2}},{"line":146,"address":[2062789,2063073,2062727],"length":1,"stats":{"Line":3}},{"line":147,"address":[2063202],"length":1,"stats":{"Line":1}},{"line":151,"address":[2063234],"length":1,"stats":{"Line":1}},{"line":156,"address":[2064049],"length":1,"stats":{"Line":1}},{"line":157,"address":[2064321,2064419,2064090],"length":1,"stats":{"Line":1}},{"line":160,"address":[2064072],"length":1,"stats":{"Line":1}},{"line":163,"address":[2063264],"length":1,"stats":{"Line":1}},{"line":164,"address":[2064539,2063360],"length":1,"stats":{"Line":2}},{"line":165,"address":[2064589,2064810],"length":1,"stats":{"Line":1}},{"line":166,"address":[2064574],"length":1,"stats":{"Line":1}},{"line":169,"address":[2063389],"length":1,"stats":{"Line":1}},{"line":175,"address":[2063501,2065093],"length":1,"stats":{"Line":2}},{"line":176,"address":[2065270],"length":1,"stats":{"Line":0}},{"line":180,"address":[2065402],"length":1,"stats":{"Line":1}},{"line":182,"address":[2063579],"length":1,"stats":{"Line":1}},{"line":189,"address":[2063595,2065428],"length":1,"stats":{"Line":2}},{"line":190,"address":[2065557],"length":1,"stats":{"Line":1}},{"line":191,"address":[2065736],"length":1,"stats":{"Line":1}},{"line":195,"address":[2065915],"length":1,"stats":{"Line":1}},{"line":199,"address":[2066094],"length":1,"stats":{"Line":1}},{"line":203,"address":[2066273],"length":1,"stats":{"Line":1}},{"line":204,"address":[2066342],"length":1,"stats":{"Line":1}},{"line":205,"address":[2066350],"length":1,"stats":{"Line":1}},{"line":208,"address":[2062884],"length":1,"stats":{"Line":0}},{"line":209,"address":[2066403],"length":1,"stats":{"Line":0}},{"line":210,"address":[2066472],"length":1,"stats":{"Line":0}},{"line":211,"address":[2066480],"length":1,"stats":{"Line":0}},{"line":216,"address":[2069055,2062734],"length":1,"stats":{"Line":2}},{"line":217,"address":[2067152,2066861],"length":1,"stats":{"Line":2}},{"line":218,"address":[2067191],"length":1,"stats":{"Line":1}},{"line":219,"address":[2067570],"length":1,"stats":{"Line":1}},{"line":223,"address":[2067655,2059906,2067773,2067983],"length":1,"stats":{"Line":2}},{"line":225,"address":[2067400],"length":1,"stats":{"Line":0}},{"line":231,"address":[2067512,2068279],"length":1,"stats":{"Line":0}},{"line":232,"address":[2068334],"length":1,"stats":{"Line":0}},{"line":233,"address":[2068583],"length":1,"stats":{"Line":0}},{"line":237,"address":[2068854],"length":1,"stats":{"Line":0}},{"line":240,"address":[2066963],"length":1,"stats":{"Line":0}},{"line":241,"address":[2068924],"length":1,"stats":{"Line":0}},{"line":242,"address":[2068993],"length":1,"stats":{"Line":0}},{"line":243,"address":[2069001],"length":1,"stats":{"Line":0}},{"line":249,"address":[2069331,2062676],"length":1,"stats":{"Line":1}},{"line":250,"address":[2069364],"length":1,"stats":{"Line":1}},{"line":354,"address":[2072076,2077164,2070240],"length":1,"stats":{"Line":1}},{"line":361,"address":[2070353],"length":1,"stats":{"Line":1}},{"line":362,"address":[2070711,2073467,2070543],"length":1,"stats":{"Line":1}},{"line":363,"address":[2077154,2070796,2070940,2070684],"length":1,"stats":{"Line":2}},{"line":365,"address":[2070881,2077120,2071076,2070978],"length":1,"stats":{"Line":2}},{"line":366,"address":[2077054,2071047,2071160,2071245],"length":1,"stats":{"Line":2}},{"line":367,"address":[2071452,2077039,2071218,2071299],"length":1,"stats":{"Line":2}},{"line":368,"address":[2071536,2076961,2071423,2071613],"length":1,"stats":{"Line":2}},{"line":371,"address":[2071594],"length":1,"stats":{"Line":1}},{"line":372,"address":[2071651],"length":1,"stats":{"Line":1}},{"line":373,"address":[2071722],"length":1,"stats":{"Line":1}},{"line":375,"address":[2071749],"length":1,"stats":{"Line":1}},{"line":376,"address":[2071768],"length":1,"stats":{"Line":1}},{"line":377,"address":[2071844],"length":1,"stats":{"Line":1}},{"line":380,"address":[2071878],"length":1,"stats":{"Line":1}},{"line":381,"address":[2071919,2072085],"length":1,"stats":{"Line":2}},{"line":383,"address":[2071884],"length":1,"stats":{"Line":1}},{"line":384,"address":[2071929],"length":1,"stats":{"Line":1}},{"line":385,"address":[2072000],"length":1,"stats":{"Line":1}},{"line":388,"address":[2072046],"length":1,"stats":{"Line":1}},{"line":391,"address":[2072087],"length":1,"stats":{"Line":1}},{"line":392,"address":[2072141],"length":1,"stats":{"Line":1}},{"line":393,"address":[2072205],"length":1,"stats":{"Line":1}},{"line":396,"address":[2072353,2072267],"length":1,"stats":{"Line":2}},{"line":398,"address":[2072369,2072430],"length":1,"stats":{"Line":2}},{"line":399,"address":[2072448],"length":1,"stats":{"Line":1}},{"line":401,"address":[2072564,2076655],"length":1,"stats":{"Line":1}},{"line":402,"address":[2076688],"length":1,"stats":{"Line":1}},{"line":407,"address":[2072577],"length":1,"stats":{"Line":1}},{"line":408,"address":[2072639],"length":1,"stats":{"Line":1}},{"line":409,"address":[2072755],"length":1,"stats":{"Line":1}},{"line":410,"address":[2072762],"length":1,"stats":{"Line":1}},{"line":413,"address":[2072865],"length":1,"stats":{"Line":1}},{"line":414,"address":[2072873],"length":1,"stats":{"Line":1}},{"line":415,"address":[2072881],"length":1,"stats":{"Line":1}},{"line":416,"address":[2072889],"length":1,"stats":{"Line":1}},{"line":417,"address":[2075362,2073024],"length":1,"stats":{"Line":2}},{"line":418,"address":[2073116,2073050,2073396],"length":1,"stats":{"Line":3}},{"line":419,"address":[2073469],"length":1,"stats":{"Line":1}},{"line":423,"address":[2073944,2073573],"length":1,"stats":{"Line":2}},{"line":424,"address":[2074032],"length":1,"stats":{"Line":1}},{"line":425,"address":[2070304,2074092,2074197,2074407],"length":1,"stats":{"Line":2}},{"line":427,"address":[2073611],"length":1,"stats":{"Line":1}},{"line":432,"address":[2073723,2074714],"length":1,"stats":{"Line":2}},{"line":433,"address":[2074769],"length":1,"stats":{"Line":1}},{"line":434,"address":[2074823],"length":1,"stats":{"Line":1}},{"line":436,"address":[2073737],"length":1,"stats":{"Line":1}},{"line":441,"address":[2075069],"length":1,"stats":{"Line":1}},{"line":442,"address":[2075170],"length":1,"stats":{"Line":1}},{"line":443,"address":[2075178],"length":1,"stats":{"Line":1}},{"line":446,"address":[2073211],"length":1,"stats":{"Line":0}},{"line":447,"address":[2075231],"length":1,"stats":{"Line":0}},{"line":448,"address":[2075300],"length":1,"stats":{"Line":0}},{"line":449,"address":[2075308],"length":1,"stats":{"Line":0}},{"line":454,"address":[2073057],"length":1,"stats":{"Line":1}},{"line":455,"address":[2075686],"length":1,"stats":{"Line":1}},{"line":456,"address":[2075952],"length":1,"stats":{"Line":1}},{"line":457,"address":[2075944],"length":1,"stats":{"Line":1}},{"line":460,"address":[2075762],"length":1,"stats":{"Line":1}},{"line":461,"address":[2075991],"length":1,"stats":{"Line":1}},{"line":462,"address":[2076060],"length":1,"stats":{"Line":1}},{"line":463,"address":[2076068],"length":1,"stats":{"Line":1}},{"line":469,"address":[2076193],"length":1,"stats":{"Line":1}},{"line":470,"address":[2076372],"length":1,"stats":{"Line":1}},{"line":472,"address":[2076448],"length":1,"stats":{"Line":1}},{"line":474,"address":[2076499],"length":1,"stats":{"Line":1}}],"covered":138,"coverable":156},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","src","identity_client.rs"],"content":"// standard\nuse std::clone::Clone;\nuse std::convert::TryInto;\nuse std::net::TcpStream;\n\n// extern crates\nuse bson::doc;\nuse bson::spec::BinarySubtype;\nuse bson::{Binary, Bson};\nuse honk_rpc::honk_rpc::{\n    get_message_overhead, get_request_section_size, RequestCookie, Response, Session,\n};\nuse rand::rngs::OsRng;\nuse rand::RngCore;\nuse tor_interface::tor_crypto::*;\n\n// internal crates\nuse crate::ascii_string::*;\nuse crate::gosling::*;\n\n//\n// Identity Client\n//\n\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"failed to convert x25519 private key to ed25519 private key\")]\n    ClientCreationFailed(#[source] tor_interface::tor_crypto::Error),\n\n    #[error(\"HonkRPC method failed: {0}\")]\n    HonkRPCFailure(#[from] honk_rpc::honk_rpc::Error),\n\n    #[error(\"client received unexpected response: {0}\")]\n    UnexpectedResponseReceived(String),\n\n    #[error(\"client is in invalid state: {0}\")]\n    InvalidState(String),\n\n    #[error(\"incorrect usage: {0}\")]\n    IncorrectUsage(String),\n\n    #[error(\"provided endpoint challenge response too large; encoded size would be {0} but session's maximum honk-rpc message size is {1}\")]\n    EndpointChallengeResponseTooLarge(usize, usize),\n}\n\npub(crate) enum IdentityClientEvent {\n    ChallengeReceived {\n        endpoint_challenge: bson::document::Document,\n    },\n    HandshakeCompleted {\n        identity_service_id: V3OnionServiceId,\n        endpoint_service_id: V3OnionServiceId,\n        endpoint_name: String,\n        client_auth_private_key: X25519PrivateKey,\n    },\n}\n\n#[derive(Debug, PartialEq)]\npub(crate) enum IdentityClientState {\n    BeginHandshake,\n    WaitingForChallenge,\n    WaitingForChallengeResponse,\n    WaitingForChallengeVerification,\n    HandshakeComplete,\n}\n\n//\n// An identity client object used for connecting\n// to an identity server\n//\npub(crate) struct IdentityClient {\n    // session data\n    rpc: Session\u003cTcpStream\u003e,\n    server_service_id: V3OnionServiceId,\n    requested_endpoint: AsciiString,\n    client_service_id: V3OnionServiceId,\n    client_identity_ed25519_private: Ed25519PrivateKey,\n    client_authorization_key_private: X25519PrivateKey,\n    client_authorization_signing_key_private: (Ed25519PrivateKey, SignBit),\n\n    // state machine data\n    state: IdentityClientState,\n    begin_handshake_request_cookie: Option\u003cRequestCookie\u003e,\n    server_cookie: Option\u003cServerCookie\u003e,\n    endpoint_challenge_response: Option\u003cbson::document::Document\u003e,\n    send_response_request_cookie: Option\u003cRequestCookie\u003e,\n}\n\nimpl IdentityClient {\n    fn get_state(\u0026self) -\u003e String {\n        format!(\"{{ state: {:?},  begin_handshake_request_cookie: {:?},  server_cookie: {:?}, endpoint_challenge_response: {:?},  send_response_request_cookie: {:?} }}\", self.state,  self.begin_handshake_request_cookie, self.server_cookie, self.endpoint_challenge_response, self.send_response_request_cookie)\n    }\n\n    pub fn new(\n        rpc: Session\u003cTcpStream\u003e,\n        server_service_id: V3OnionServiceId,\n        requested_endpoint: AsciiString,\n        client_identity_ed25519_private: Ed25519PrivateKey,\n        client_authorization_key_private: X25519PrivateKey,\n    ) -\u003e Result\u003cSelf, Error\u003e {\n        Ok(Self {\n            rpc,\n            server_service_id,\n            requested_endpoint,\n            client_service_id: V3OnionServiceId::from_private_key(\u0026client_identity_ed25519_private),\n            client_identity_ed25519_private,\n            client_authorization_signing_key_private: Ed25519PrivateKey::from_private_x25519(\n                \u0026client_authorization_key_private,\n            )\n            .map_err(Error::ClientCreationFailed)?,\n            client_authorization_key_private,\n\n            state: IdentityClientState::BeginHandshake,\n            begin_handshake_request_cookie: None,\n            server_cookie: None,\n            send_response_request_cookie: None,\n            endpoint_challenge_response: None,\n        })\n    }\n\n    pub fn update(\u0026mut self) -\u003e Result\u003cOption\u003cIdentityClientEvent\u003e, Error\u003e {\n        if self.state == IdentityClientState::HandshakeComplete {\n            return Err(Error::IncorrectUsage(\"update() may not be called after HandshakeComplete has been returned from previous update() call\".to_string()));\n        }\n\n        // update our rpc session\n        self.rpc.update(None)?;\n\n        // client state machine\n        match (\n            \u0026self.state,\n            self.begin_handshake_request_cookie,\n            self.server_cookie,\n            self.endpoint_challenge_response.take(),\n            self.send_response_request_cookie,\n        ) {\n            // send initial handshake request\n            (\n                \u0026IdentityClientState::BeginHandshake,\n                None, // begin_handshake_request_cookie\n                None, // server_cookie\n                None, // endpoint_challenge_response\n                None, // send_response_request_cookie\n            ) =\u003e {\n                self.begin_handshake_request_cookie = Some(self.rpc.client_call(\n                    \"gosling_identity\",\n                    \"begin_handshake\",\n                    0,\n                    doc! {\n                        \"version\" : bson::Bson::String(GOSLING_PROTOCOL_VERSION.to_string()),\n                        \"client_identity\" : bson::Bson::String(self.client_service_id.to_string()),\n                        \"endpoint\" : bson::Bson::String(self.requested_endpoint.clone().to_string()),\n                    },\n                )?);\n                self.state = IdentityClientState::WaitingForChallenge;\n            }\n            (\n                \u0026IdentityClientState::WaitingForChallenge,\n                Some(begin_handshake_request_cookie),\n                None, // server_cookie\n                None, // endpoint_challenge_response\n                None, // send_response_request_cookie\n            ) =\u003e {\n                if let Some(response) = self.rpc.client_next_response() {\n                    // check for response for the begin_handshake() call\n                    let mut response = match response {\n                        Response::Pending { cookie } =\u003e {\n                            if cookie != begin_handshake_request_cookie {\n                                return Err(Error::UnexpectedResponseReceived(\n                                    \"received unexpected pending response\".to_string(),\n                                ));\n                            }\n                            return Ok(None);\n                        }\n                        Response::Error { cookie, error_code } =\u003e {\n                            if cookie != begin_handshake_request_cookie {\n                                return Err(Error::UnexpectedResponseReceived(format!(\n                                    \"received unexpected error response; rpc error_code: {}\",\n                                    error_code\n                                )));\n                            }\n                            return Err(Error::UnexpectedResponseReceived(format!(\n                                \"received unexpected rpc error_code: {}\",\n                                error_code\n                            )));\n                        }\n                        Response::Success { cookie, result } =\u003e {\n                            if cookie != begin_handshake_request_cookie {\n                                return Err(Error::UnexpectedResponseReceived(\n                                    \"received unexpected success response\".to_string(),\n                                ));\n                            }\n                            match result {\n                                Some(Bson::Document(result)) =\u003e result,\n                                _ =\u003e {\n                                    return Err(Error::UnexpectedResponseReceived(\n                                        \"begin_handshake() response is unexpected bson type\"\n                                            .to_string(),\n                                    ))\n                                }\n                            }\n                        }\n                    };\n\n                    // save off the server cookie\n                    self.server_cookie = match response.get(\"server_cookie\") {\n                        Some(Bson::Binary(Binary {\n                            subtype: BinarySubtype::Generic,\n                            bytes: server_cookie,\n                        })) =\u003e match server_cookie.clone().try_into() {\n                            Ok(server_cookie) =\u003e Some(server_cookie),\n                            Err(_) =\u003e {\n                                return Err(Error::UnexpectedResponseReceived(format!(\n                                    \"unable to convert '{:?}' to server cookie\",\n                                    server_cookie\n                                )))\n                            }\n                        },\n                        Some(_) =\u003e {\n                            return Err(Error::UnexpectedResponseReceived(\n                                \"server_cookie is unxpected bson type\".to_string(),\n                            ))\n                        }\n                        None =\u003e {\n                            return Err(Error::UnexpectedResponseReceived(\n                                \"missing server_cookie\".to_string(),\n                            ))\n                        }\n                    };\n\n                    // get the endpoint challenge\n                    let endpoint_challenge = match response.get_mut(\"endpoint_challenge\") {\n                        Some(Bson::Document(endpoint_challenge)) =\u003e {\n                            std::mem::take(endpoint_challenge)\n                        }\n                        Some(_) =\u003e {\n                            return Err(Error::UnexpectedResponseReceived(\n                                \"endpoint challenge is unexpected bson type\".to_string(),\n                            ))\n                        }\n                        None =\u003e {\n                            return Err(Error::UnexpectedResponseReceived(\n                                \"missing endpoint_challenge\".to_string(),\n                            ))\n                        }\n                    };\n\n                    self.state = IdentityClientState::WaitingForChallengeResponse;\n                    return Ok(Some(IdentityClientEvent::ChallengeReceived {\n                        endpoint_challenge,\n                    }));\n                }\n            }\n            (\n                \u0026IdentityClientState::WaitingForChallengeResponse,\n                Some(_begin_handshake_request_cookie),\n                Some(_server_cookie),\n                None, // endpoint_challenge_response\n                None, // send_response_request_cookie\n            ) =\u003e {\n                // no-op, waiting for response for challenge response from caller\n            }\n            (\n                \u0026IdentityClientState::WaitingForChallengeResponse,\n                Some(_begin_handshake_request_cookie),\n                Some(server_cookie),\n                Some(endpoint_challenge_response),\n                None,\n            ) =\u003e {\n                // client_cookie\n                let mut client_cookie: ClientCookie = Default::default();\n                OsRng.fill_bytes(\u0026mut client_cookie);\n                let client_cookie = client_cookie;\n\n                // client_identity_proof_signature\n                let client_identity_proof = build_client_proof(\n                    DomainSeparator::GoslingIdentity,\n                    \u0026self.requested_endpoint,\n                    \u0026self.client_service_id,\n                    \u0026self.server_service_id,\n                    \u0026client_cookie,\n                    \u0026server_cookie,\n                );\n                let client_identity_proof_signature = self\n                    .client_identity_ed25519_private\n                    .sign_message(\u0026client_identity_proof);\n\n                // client_authorization_key\n                let client_authorization_key =\n                    X25519PublicKey::from_private_key(\u0026self.client_authorization_key_private);\n\n                // client_authorization_signature\n                let client_identity = self.client_service_id.to_string();\n                let (client_authorization_signature, signbit) = (\n                    self.client_authorization_signing_key_private\n                        .0\n                        .sign_message(client_identity.as_bytes()),\n                    self.client_authorization_signing_key_private.1,\n                );\n\n                // build our args object for rpc call\n                let args = doc! {\n                    \"client_cookie\" : bson::Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_cookie.to_vec()}),\n                    \"client_identity_proof_signature\" : bson::Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_identity_proof_signature.to_bytes().to_vec()}),\n                    \"client_authorization_key\" : bson::Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_authorization_key.as_bytes().to_vec()}),\n                    \"client_authorization_key_signbit\" : bson::Bson::Boolean(signbit.into()),\n                    \"client_authorization_signature\" : bson::Bson::Binary(bson::Binary{subtype: BinarySubtype::Generic, bytes: client_authorization_signature.to_bytes().to_vec()}),\n                    \"challenge_response\" : endpoint_challenge_response,\n                };\n\n                // make rpc call\n                self.send_response_request_cookie =\n                    Some(\n                        self.rpc\n                            .client_call(\"gosling_identity\", \"send_response\", 0, args)?,\n                    );\n                self.state = IdentityClientState::WaitingForChallengeVerification;\n            }\n            (\n                \u0026IdentityClientState::WaitingForChallengeVerification,\n                Some(_begin_handshake_request_cookie),\n                Some(_server_cookie),\n                None, // endpoint_challenge_response\n                Some(send_response_request_cookie),\n            ) =\u003e {\n                if let Some(response) = self.rpc.client_next_response() {\n                    let endpoint_service_id = match response {\n                        Response::Pending { cookie } =\u003e {\n                            if cookie == send_response_request_cookie {\n                                return Ok(None);\n                            } else {\n                                return Err(Error::UnexpectedResponseReceived(\n                                    \"received unexpectd pending response\".to_string(),\n                                ));\n                            }\n                        }\n                        Response::Error { cookie, error_code } =\u003e {\n                            if cookie == send_response_request_cookie {\n                                return Err(Error::UnexpectedResponseReceived(format!(\n                                    \"received unexpected error response; rpc error_code: {}\",\n                                    error_code\n                                )));\n                            } else {\n                                return Err(Error::UnexpectedResponseReceived(format!(\n                                    \"received unexpected rpc error_code: {}\",\n                                    error_code\n                                )));\n                            }\n                        }\n                        Response::Success { cookie, result } =\u003e {\n                            if cookie == send_response_request_cookie {\n                                match result {\n                                    Some(Bson::String(endpoint_service_id)) =\u003e {\n                                        match V3OnionServiceId::from_string(\u0026endpoint_service_id) {\n                                            Ok(endpoint_service_id) =\u003e endpoint_service_id,\n                                            Err(_) =\u003e return Err(Error::UnexpectedResponseReceived(format!(\"unable to parse received endpoint service id '{}' as v3 onion service id\", endpoint_service_id))),\n                                        }\n                                    }\n                                    _ =\u003e {\n                                        return Err(Error::UnexpectedResponseReceived(\n                                            \"endpoint service id is unexpected bson type\".to_string(),\n                                        ))\n                                    }\n                                }\n                            } else {\n                                return Err(Error::UnexpectedResponseReceived(\n                                    \"received unexpected success response\".to_string(),\n                                ));\n                            }\n                        }\n                    };\n                    self.state = IdentityClientState::HandshakeComplete;\n                    return Ok(Some(IdentityClientEvent::HandshakeCompleted {\n                        identity_service_id: self.server_service_id.clone(),\n                        endpoint_service_id,\n                        endpoint_name: self.requested_endpoint.clone().to_string(),\n                        client_auth_private_key: self.client_authorization_key_private.clone(),\n                    }));\n                }\n            }\n            _ =\u003e {\n                return Err(Error::InvalidState(self.get_state()));\n            }\n        }\n        Ok(None)\n    }\n\n    pub fn send_response(\n        \u0026mut self,\n        challenge_response: bson::document::Document,\n    ) -\u003e Result\u003c(), Error\u003e {\n        match (\n            \u0026self.state,\n            self.begin_handshake_request_cookie,\n            self.server_cookie,\n            self.endpoint_challenge_response.as_ref(),\n            self.send_response_request_cookie,\n        ) {\n            (\u0026IdentityClientState::WaitingForChallengeResponse,\n             Some(_begin_handshake_request_cookie),\n             Some(_server_cookie),\n             None, // endpoint_challenge_response\n             None  // end_response_request_cookie\n            ) =\u003e {\n                // calculate required size of request message and ensure it fits our\n                // specified message size budget\n                let arguments = doc!{\n                    \"client_cookie\" : Bson::Binary(Binary{subtype: BinarySubtype::Generic, bytes: [0u8; CLIENT_COOKIE_SIZE].to_vec()}),\n                    \"client_identity_proof_signature\" : Bson::Binary(Binary{subtype: BinarySubtype::Generic, bytes: [0u8; ED25519_SIGNATURE_SIZE].to_vec()}),\n                    \"client_authorization_key\" : Bson::Binary(Binary{subtype: BinarySubtype::Generic, bytes: [0u8; X25519_PUBLIC_KEY_SIZE].to_vec()}),\n                    \"client_authorization_key_signbit\" : Bson::Boolean(false),\n                    \"client_authorization_signature\" : Bson::Binary(Binary{subtype: BinarySubtype::Generic, bytes: [0u8; ED25519_SIGNATURE_SIZE].to_vec()}),\n                    \"challenge_response\" : challenge_response.clone(),\n                };\n                let request_section_size = get_request_section_size(Some(0i64), Some(\"gosling_identity\".to_string()), \"send_response\".to_string(), Some(0i32), Some(arguments))?;\n                let message_size = get_message_overhead()? + request_section_size;\n                let max_message_size = self.rpc.get_max_message_size();\n                if message_size \u003e max_message_size {\n                    Err(Error::EndpointChallengeResponseTooLarge(message_size, max_message_size))\n                } else {\n                    self.endpoint_challenge_response = Some(challenge_response);\n                    Ok(())\n                }\n            }\n            _ =\u003e Err(Error::IncorrectUsage(\"send_response() may only be called after ChallengeReceived event has been returned from update(), and it may only be called once\".to_string()))\n        }\n    }\n}\n","traces":[{"line":90,"address":[3993824],"length":1,"stats":{"Line":0}},{"line":91,"address":[3954104,3954294,3954484,3954389,3954199,3954577],"length":1,"stats":{"Line":0}},{"line":94,"address":[1950160,1951508,1951551],"length":1,"stats":{"Line":2}},{"line":101,"address":[1950196,1950671],"length":1,"stats":{"Line":4}},{"line":102,"address":[1950248],"length":1,"stats":{"Line":2}},{"line":104,"address":[1740116],"length":1,"stats":{"Line":2}},{"line":105,"address":[3954939],"length":1,"stats":{"Line":2}},{"line":106,"address":[3994751],"length":1,"stats":{"Line":2}},{"line":107,"address":[1740237,1740313,1741047],"length":1,"stats":{"Line":4}},{"line":110,"address":[1740935],"length":1,"stats":{"Line":0}},{"line":111,"address":[3955214],"length":1,"stats":{"Line":2}},{"line":113,"address":[3955269],"length":1,"stats":{"Line":2}},{"line":114,"address":[1740465],"length":1,"stats":{"Line":2}},{"line":115,"address":[1740477],"length":1,"stats":{"Line":2}},{"line":116,"address":[3955297],"length":1,"stats":{"Line":2}},{"line":117,"address":[1950653],"length":1,"stats":{"Line":2}},{"line":121,"address":[1743720,1754483,1741408],"length":1,"stats":{"Line":2}},{"line":122,"address":[1951664],"length":1,"stats":{"Line":2}},{"line":123,"address":[3956483],"length":1,"stats":{"Line":0}},{"line":127,"address":[1951656,1951719,1952375],"length":1,"stats":{"Line":4}},{"line":130,"address":[4002224,3996837,4005382,3996542,3996925,3998335],"length":1,"stats":{"Line":12}},{"line":131,"address":[1951982],"length":1,"stats":{"Line":2}},{"line":132,"address":[1951999],"length":1,"stats":{"Line":2}},{"line":133,"address":[1952029],"length":1,"stats":{"Line":2}},{"line":134,"address":[3956728],"length":1,"stats":{"Line":2}},{"line":135,"address":[3996528],"length":1,"stats":{"Line":2}},{"line":138,"address":[1743470],"length":1,"stats":{"Line":2}},{"line":145,"address":[1743256,1743674,1743595],"length":1,"stats":{"Line":2}},{"line":149,"address":[1742955,1742407,1742519,1742794,1743037,1742610],"length":1,"stats":{"Line":8}},{"line":150,"address":[3957330,3957398],"length":1,"stats":{"Line":4}},{"line":151,"address":[3997300],"length":1,"stats":{"Line":2}},{"line":152,"address":[1742902,1742987],"length":1,"stats":{"Line":4}},{"line":155,"address":[3958307],"length":1,"stats":{"Line":2}},{"line":157,"address":[1743813],"length":1,"stats":{"Line":2}},{"line":164,"address":[3998443],"length":1,"stats":{"Line":2}},{"line":166,"address":[1744019],"length":1,"stats":{"Line":2}},{"line":167,"address":[3958988],"length":1,"stats":{"Line":2}},{"line":168,"address":[1954348],"length":1,"stats":{"Line":2}},{"line":169,"address":[1954592],"length":1,"stats":{"Line":0}},{"line":170,"address":[3959213],"length":1,"stats":{"Line":0}},{"line":173,"address":[1744302],"length":1,"stats":{"Line":2}},{"line":175,"address":[3959106],"length":1,"stats":{"Line":0}},{"line":176,"address":[3998894],"length":1,"stats":{"Line":0}},{"line":177,"address":[4001981,4002110],"length":1,"stats":{"Line":0}},{"line":182,"address":[4001738,4001867],"length":1,"stats":{"Line":0}},{"line":187,"address":[1954362],"length":1,"stats":{"Line":2}},{"line":188,"address":[3998828],"length":1,"stats":{"Line":2}},{"line":189,"address":[1956997],"length":1,"stats":{"Line":0}},{"line":190,"address":[3999143],"length":1,"stats":{"Line":0}},{"line":193,"address":[3999173,3999106],"length":1,"stats":{"Line":4}},{"line":194,"address":[3959499],"length":1,"stats":{"Line":2}},{"line":196,"address":[4001258],"length":1,"stats":{"Line":0}},{"line":197,"address":[1954813],"length":1,"stats":{"Line":0}},{"line":206,"address":[4000093,3999548,3999374,3999484,3999739],"length":1,"stats":{"Line":10}},{"line":209,"address":[1955387],"length":1,"stats":{"Line":2}},{"line":210,"address":[3999807],"length":1,"stats":{"Line":2}},{"line":211,"address":[1745265],"length":1,"stats":{"Line":2}},{"line":213,"address":[1956386,1956515],"length":1,"stats":{"Line":0}},{"line":220,"address":[1746478],"length":1,"stats":{"Line":0}},{"line":221,"address":[3960013],"length":1,"stats":{"Line":0}},{"line":225,"address":[1955208],"length":1,"stats":{"Line":0}},{"line":226,"address":[1955121],"length":1,"stats":{"Line":0}},{"line":232,"address":[1955847,1955736],"length":1,"stats":{"Line":4}},{"line":233,"address":[1745803],"length":1,"stats":{"Line":2}},{"line":234,"address":[4000437],"length":1,"stats":{"Line":2}},{"line":237,"address":[1746014],"length":1,"stats":{"Line":0}},{"line":238,"address":[1956056],"length":1,"stats":{"Line":0}},{"line":242,"address":[1745689],"length":1,"stats":{"Line":0}},{"line":243,"address":[3960476],"length":1,"stats":{"Line":0}},{"line":248,"address":[3960750],"length":1,"stats":{"Line":2}},{"line":249,"address":[1956115],"length":1,"stats":{"Line":2}},{"line":254,"address":[1747715],"length":1,"stats":{"Line":0}},{"line":263,"address":[3962654],"length":1,"stats":{"Line":2}},{"line":271,"address":[1958158],"length":1,"stats":{"Line":2}},{"line":272,"address":[1958218],"length":1,"stats":{"Line":2}},{"line":273,"address":[3962914],"length":1,"stats":{"Line":2}},{"line":277,"address":[3962946],"length":1,"stats":{"Line":2}},{"line":278,"address":[4002698],"length":1,"stats":{"Line":2}},{"line":279,"address":[3962964],"length":1,"stats":{"Line":2}},{"line":280,"address":[1748104],"length":1,"stats":{"Line":2}},{"line":284,"address":[3963154,3963037],"length":1,"stats":{"Line":4}},{"line":286,"address":[1748181],"length":1,"stats":{"Line":2}},{"line":289,"address":[3963181],"length":1,"stats":{"Line":2}},{"line":293,"address":[1958559],"length":1,"stats":{"Line":2}},{"line":294,"address":[3963377],"length":1,"stats":{"Line":2}},{"line":295,"address":[3963249,3963344],"length":1,"stats":{"Line":4}},{"line":297,"address":[1748398],"length":1,"stats":{"Line":2}},{"line":298,"address":[1958715],"length":1,"stats":{"Line":2}},{"line":302,"address":[4003278,4003768,4004683,4004202,4003491,4004039,4003337,4004479],"length":1,"stats":{"Line":14}},{"line":303,"address":[1958981,1958897],"length":1,"stats":{"Line":4}},{"line":304,"address":[1959191],"length":1,"stats":{"Line":2}},{"line":305,"address":[3964124],"length":1,"stats":{"Line":2}},{"line":306,"address":[1749529],"length":1,"stats":{"Line":2}},{"line":307,"address":[4004302],"length":1,"stats":{"Line":2}},{"line":308,"address":[4004579],"length":1,"stats":{"Line":2}},{"line":312,"address":[3965314],"length":1,"stats":{"Line":2}},{"line":313,"address":[1960638],"length":1,"stats":{"Line":2}},{"line":314,"address":[3965507,3965143],"length":1,"stats":{"Line":2}},{"line":315,"address":[1960739],"length":1,"stats":{"Line":0}},{"line":317,"address":[3965344],"length":1,"stats":{"Line":2}},{"line":319,"address":[1750836],"length":1,"stats":{"Line":2}},{"line":326,"address":[3965791],"length":1,"stats":{"Line":2}},{"line":327,"address":[1961321],"length":1,"stats":{"Line":2}},{"line":328,"address":[3966071],"length":1,"stats":{"Line":2}},{"line":329,"address":[3966087],"length":1,"stats":{"Line":2}},{"line":330,"address":[4006022],"length":1,"stats":{"Line":2}},{"line":332,"address":[4006071],"length":1,"stats":{"Line":0}},{"line":333,"address":[1751349],"length":1,"stats":{"Line":0}},{"line":337,"address":[3966185],"length":1,"stats":{"Line":0}},{"line":338,"address":[4005973],"length":1,"stats":{"Line":0}},{"line":339,"address":[1754049,1754178],"length":1,"stats":{"Line":0}},{"line":344,"address":[3968841,3968712],"length":1,"stats":{"Line":0}},{"line":350,"address":[1961445],"length":1,"stats":{"Line":1}},{"line":351,"address":[3966166],"length":1,"stats":{"Line":1}},{"line":352,"address":[1961812,1962083],"length":1,"stats":{"Line":2}},{"line":353,"address":[3966809],"length":1,"stats":{"Line":1}},{"line":354,"address":[1962272,1962201],"length":1,"stats":{"Line":2}},{"line":355,"address":[3966965],"length":1,"stats":{"Line":1}},{"line":356,"address":[3967840,3967969],"length":1,"stats":{"Line":0}},{"line":360,"address":[1963511],"length":1,"stats":{"Line":0}},{"line":361,"address":[1962123],"length":1,"stats":{"Line":0}},{"line":366,"address":[3966586],"length":1,"stats":{"Line":0}},{"line":367,"address":[1961785],"length":1,"stats":{"Line":0}},{"line":372,"address":[3967273],"length":1,"stats":{"Line":1}},{"line":373,"address":[3967507],"length":1,"stats":{"Line":1}},{"line":374,"address":[3967294],"length":1,"stats":{"Line":1}},{"line":376,"address":[3967343],"length":1,"stats":{"Line":1}},{"line":377,"address":[1752542],"length":1,"stats":{"Line":1}},{"line":382,"address":[4008966,3996915],"length":1,"stats":{"Line":0}},{"line":385,"address":[3958495],"length":1,"stats":{"Line":2}},{"line":388,"address":[1758137,1754528,1757996],"length":1,"stats":{"Line":2}},{"line":392,"address":[3969479,3969701,3969843],"length":1,"stats":{"Line":6}},{"line":393,"address":[4009255],"length":1,"stats":{"Line":2}},{"line":394,"address":[4009270],"length":1,"stats":{"Line":2}},{"line":395,"address":[3969550],"length":1,"stats":{"Line":2}},{"line":396,"address":[4009337],"length":1,"stats":{"Line":2}},{"line":397,"address":[4009421],"length":1,"stats":{"Line":2}},{"line":399,"address":[1755017],"length":1,"stats":{"Line":2}},{"line":407,"address":[1755107,1756134,1755759,1755049,1756254,1755261,1755510,1755885],"length":1,"stats":{"Line":14}},{"line":408,"address":[1965395,1965312],"length":1,"stats":{"Line":4}},{"line":409,"address":[1755361],"length":1,"stats":{"Line":2}},{"line":410,"address":[3970510],"length":1,"stats":{"Line":2}},{"line":411,"address":[1966103],"length":1,"stats":{"Line":2}},{"line":412,"address":[3970885],"length":1,"stats":{"Line":2}},{"line":413,"address":[1966491],"length":1,"stats":{"Line":2}},{"line":415,"address":[4011102,4012627,4012642,4011730,4011194],"length":1,"stats":{"Line":4}},{"line":416,"address":[1757492,1757235,1757055,1757936],"length":1,"stats":{"Line":4}},{"line":417,"address":[1967740,1967786],"length":1,"stats":{"Line":4}},{"line":418,"address":[3972729,3972450],"length":1,"stats":{"Line":2}},{"line":419,"address":[1968021],"length":1,"stats":{"Line":0}},{"line":421,"address":[1967813,1968080],"length":1,"stats":{"Line":2}},{"line":422,"address":[1968167],"length":1,"stats":{"Line":2}},{"line":425,"address":[1965157,1968300],"length":1,"stats":{"Line":0}}],"covered":114,"coverable":153},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","src","identity_server.rs"],"content":"// standard\nuse std::clone::Clone;\nuse std::convert::TryInto;\nuse std::net::TcpStream;\n\n// extern crates\nuse bson::doc;\nuse bson::spec::BinarySubtype;\nuse bson::{Binary, Bson};\nuse honk_rpc::honk_rpc::{\n    get_message_overhead, get_response_section_size, ApiSet, ErrorCode, RequestCookie, Session,\n};\nuse rand::rngs::OsRng;\nuse rand::RngCore;\nuse tor_interface::tor_crypto::*;\n\n// internal crates\nuse crate::ascii_string::*;\nuse crate::gosling::*;\n\n//\n// Identity Server\n//\n\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"HonkRPC method failed: {0}\")]\n    HonkRPCFailure(#[from] honk_rpc::honk_rpc::Error),\n\n    #[error(\"server is in invalid state: {0}\")]\n    InvalidState(String),\n\n    #[error(\"incorrect usage: {0}\")]\n    IncorrectUsage(String),\n\n    #[error(\"client sent invalid request\")]\n    BadClient,\n\n    #[error(\"provided endpoint challenge too large; encoded size would be {0} but session's maximum honk-rpc message size is {1}\")]\n    EndpointChallengeTooLarge(usize, usize),\n}\n\npub(crate) enum IdentityServerEvent {\n    EndpointRequestReceived {\n        client_service_id: V3OnionServiceId,\n        requested_endpoint: AsciiString,\n    },\n\n    ChallengeResponseReceived {\n        challenge_response: bson::document::Document,\n    },\n\n    HandshakeCompleted {\n        endpoint_private_key: Ed25519PrivateKey,\n        endpoint_name: AsciiString,\n        client_service_id: V3OnionServiceId,\n        client_auth_public_key: X25519PublicKey,\n    },\n\n    HandshakeRejected {\n        // Client not on the block-list\n        client_allowed: bool,\n        // The requested endpoint is valid\n        client_requested_endpoint_valid: bool,\n        // The client proof is valid and signed with client's public key\n        client_proof_signature_valid: bool,\n        // The client authorization signature is valid\n        client_auth_signature_valid: bool,\n        // The challenge response is valid\n        challenge_response_valid: bool,\n    },\n}\n\n#[derive(Debug, PartialEq)]\nenum IdentityServerState {\n    // valid/expected states\n    WaitingForBeginHandshake,\n    GettingChallenge,\n    ChallengeReady,\n    WaitingForSendResponse,\n    GettingChallengeVerification,\n    ChallengeVerificationReady,\n    ChallengeVerificationResponseSent,\n    HandshakeComplete,\n    // failure state\n    HandshakeFailed,\n}\n\npub(crate) struct IdentityServer {\n    // Session Data\n    rpc: Option\u003cSession\u003cTcpStream\u003e\u003e,\n    server_identity: V3OnionServiceId,\n\n    // State Machine Data\n    state: IdentityServerState,\n    begin_handshake_request_cookie: Option\u003cRequestCookie\u003e,\n    client_identity: Option\u003cV3OnionServiceId\u003e,\n    requested_endpoint: Option\u003cAsciiString\u003e,\n    server_cookie: Option\u003cServerCookie\u003e,\n    endpoint_challenge: Option\u003cbson::document::Document\u003e,\n    send_response_request_cookie: Option\u003cRequestCookie\u003e,\n    client_auth_key: Option\u003cX25519PublicKey\u003e,\n    challenge_response: Option\u003cbson::document::Document\u003e,\n    endpoint_private_key: Option\u003cEd25519PrivateKey\u003e,\n\n    // Verification flags\n\n    // Client not on the block-list\n    client_allowed: bool,\n    // The requested endpoint is valid\n    client_requested_endpoint_valid: bool,\n    // The client proof is valid and signed with client's public key\n    client_proof_signature_valid: bool,\n    // The client authorization signature is valid\n    client_auth_signature_valid: bool,\n    // The challenge response is valid\n    challenge_response_valid: bool,\n}\n\nimpl IdentityServer {\n    fn get_state(\u0026self) -\u003e String {\n        format!(\"{{ state: {:?}, begin_handshake_request_cookie: {:?}, client_identity: {:?}, requested_endpoint: {:?}, server_cookie: {:?}, endpoint_challenge: {:?}, send_response_request_cookie: {:?}, client_auth_key: {:?}, challenge_response: {:?}, endpoint_private_key: {:?} }}\", self.state, self.begin_handshake_request_cookie, self.client_identity, self.requested_endpoint, self.server_cookie, self.endpoint_challenge, self.send_response_request_cookie, self.client_auth_key, self.challenge_response, self.endpoint_private_key)\n    }\n\n    pub fn new(rpc: Session\u003cTcpStream\u003e, server_identity: V3OnionServiceId) -\u003e Self {\n        IdentityServer {\n            // Session Data\n            rpc: Some(rpc),\n            server_identity,\n\n            // State Machine Data\n            state: IdentityServerState::WaitingForBeginHandshake,\n            begin_handshake_request_cookie: None,\n            client_identity: None,\n            requested_endpoint: None,\n            server_cookie: None,\n            endpoint_challenge: None,\n            send_response_request_cookie: None,\n            client_auth_key: None,\n            challenge_response: None,\n            endpoint_private_key: None,\n\n            // Verification Flags\n            client_allowed: false,\n            client_requested_endpoint_valid: false,\n            client_proof_signature_valid: false,\n            client_auth_signature_valid: false,\n            challenge_response_valid: false,\n        }\n    }\n\n    pub fn update(\u0026mut self) -\u003e Result\u003cOption\u003cIdentityServerEvent\u003e, Error\u003e {\n        // need to remove ownership of the HonkRPC session from Self\n        // before being able to pass self into the session update method\n        if let Some(mut rpc) = std::mem::take(\u0026mut self.rpc) {\n            match rpc.update(Some(\u0026mut [self])) {\n                Ok(()) =\u003e {\n                    self.rpc = Some(rpc);\n                }\n                Err(err) =\u003e {\n                    self.rpc = Some(rpc);\n                    return Err(err.into());\n                }\n            }\n        }\n\n        match(\u0026self.state,\n              self.begin_handshake_request_cookie,\n              self.client_identity.as_ref(),\n              self.requested_endpoint.as_ref(),\n              self.server_cookie.as_ref(),\n              self.endpoint_challenge.as_ref(),\n              self.send_response_request_cookie,\n              self.client_auth_key.as_ref(),\n              self.challenge_response.as_mut(),\n              self.endpoint_private_key.as_ref()) {\n            (\u0026IdentityServerState::WaitingForBeginHandshake,\n             None, // begin_handshake_request_cookie\n             None, // client_identity\n             None, // requested_endpoint\n             None, // server_cookie\n             None, // endpoint_challenge\n             None, // send_response_request_cookie\n             None, // client_auth_key\n             None, // challenge_response\n             None) // endpoint_private_key\n            =\u003e {\n                // no-op, waiting for client to connect and begin handshake\n            },\n            (\u0026IdentityServerState::WaitingForBeginHandshake,\n             Some(_begin_handshake_request_cookie),\n             Some(client_identity),\n             Some(requested_endpoint),\n             None, // server_cookie\n             None, // endpoint_challenge\n             None, // send_response_request_cookie\n             None, // client_auth_key\n             None, // challenge_response\n             None) // endpoint_private_key\n            =\u003e {\n                self.state = IdentityServerState::GettingChallenge;\n                return Ok(Some(IdentityServerEvent::EndpointRequestReceived{client_service_id: client_identity.clone(), requested_endpoint: requested_endpoint.clone()}));\n            },\n            (\u0026IdentityServerState::WaitingForSendResponse,\n             Some(_begin_handshake_request_cookie),\n             Some(_client_identity),\n             Some(_requested_endpoint),\n             Some(_server_cookie),\n             Some(_endpoint_challenge),\n             None, // send_response_request_cookie\n             None, // client_auth_key\n             None, // challenge_response\n             None) // endpoint_private_key\n            =\u003e {\n                // no-op, waiting for client to send challenge response\n            },\n            (\u0026IdentityServerState::WaitingForSendResponse,\n             Some(_begin_handshake_request_cookie),\n             Some(_client_identity),\n             Some(_requested_endpoint),\n             Some(_server_cookie),\n             Some(_endpoint_challenge),\n             Some(_send_response_request_cookie),\n             Some(_client_auth_key),\n             Some(challenge_response),\n             None) // endpoint_private_key\n            =\u003e {\n                self.state = IdentityServerState::GettingChallengeVerification;\n                return Ok(Some(IdentityServerEvent::ChallengeResponseReceived{\n                    challenge_response: std::mem::take(challenge_response),\n                }));\n            },\n            (\u0026IdentityServerState::ChallengeVerificationResponseSent,\n             Some(_begin_handshake_request_cookie),\n             Some(client_identity),\n             Some(requested_endpoint),\n             Some(_server_cookie),\n             Some(_endpoint_challenge),\n             Some(_send_response_request_cookie),\n             Some(client_auth_key),\n             Some(_challenge_response),\n             Some(endpoint_private_key))\n            =\u003e {\n                self.state = IdentityServerState::HandshakeComplete;\n                return Ok(Some(IdentityServerEvent::HandshakeCompleted{\n                    endpoint_private_key: endpoint_private_key.clone(),\n                    endpoint_name: requested_endpoint.clone(),\n                    client_service_id: client_identity.clone(),\n                    client_auth_public_key: client_auth_key.clone(),\n                }));\n            },\n            (\u0026IdentityServerState::ChallengeVerificationResponseSent,\n             Some(_begin_handshake_request_cookie),\n             Some(_client_identity),\n             Some(_requested_endpoint),\n             Some(_server_cookie),\n             Some(_endpoint_challenge),\n             Some(_send_response_request_cookie),\n             Some(_client_auth_key),\n             Some(_challenge_response),\n             None) // endpoint_private_key\n            =\u003e {\n                self.state = IdentityServerState::HandshakeComplete;\n                return Ok(Some(IdentityServerEvent::HandshakeRejected{\n                    client_allowed: self.client_allowed,\n                    client_requested_endpoint_valid: self.client_requested_endpoint_valid,\n                    client_proof_signature_valid: self.client_proof_signature_valid,\n                    client_auth_signature_valid: self.client_auth_signature_valid,\n                    challenge_response_valid: self.challenge_response_valid,\n                }));\n            },\n             _ =\u003e {\n                if self.state == IdentityServerState::HandshakeFailed {\n                    return Err(Error::BadClient);\n                } else {\n                    return Err(Error::InvalidState(self.get_state()));\n                }\n            }\n        }\n\n        Ok(None)\n    }\n\n    pub fn handle_endpoint_request_received(\n        \u0026mut self,\n        client_allowed: bool,\n        endpoint_valid: bool,\n        endpoint_challenge: bson::document::Document,\n    ) -\u003e Result\u003c(), Error\u003e {\n        match (\n            \u0026self.state,\n            self.rpc.as_ref(),\n            self.begin_handshake_request_cookie,\n            self.client_identity.as_ref(),\n            self.requested_endpoint.as_ref(),\n            self.server_cookie.as_ref(),\n            self.endpoint_challenge.as_ref(),\n            self.client_auth_key.as_ref(),\n            self.challenge_response.as_ref(),\n            self.endpoint_private_key.as_ref(),\n        ) {\n            (\n                \u0026IdentityServerState::GettingChallenge,\n                Some(rpc),\n                Some(_begin_handshake_request_cookie),\n                Some(_client_identity),\n                Some(_endpoint_name),\n                None, // server_cookie\n                None, // endpoint_challenge\n                None, // client_auth_key\n                None, // challenge_response\n                None, // endpoint_private_key\n            ) =\u003e {\n                let mut server_cookie: ServerCookie = Default::default();\n                OsRng.fill_bytes(\u0026mut server_cookie);\n\n                // calculate required size of response message and ensure if fits our\n                // specified message size budget\n                let result = doc!{\n                    \"server_cookie\" : Bson::Binary(Binary{subtype: BinarySubtype::Generic, bytes: server_cookie.to_vec()}),\n                    \"endpoint_challenge\" : endpoint_challenge.clone(),\n                };\n                let response_section_size = get_response_section_size(Some(Bson::Document(result)))?;\n                let message_size = get_message_overhead()? + response_section_size;\n                let max_message_size = rpc.get_max_message_size();\n                if message_size \u003e max_message_size {\n                    Err(Error::EndpointChallengeTooLarge(message_size, max_message_size))\n                } else {\n                    self.server_cookie = Some(server_cookie);\n                    self.endpoint_challenge = Some(endpoint_challenge);\n                    self.client_allowed = client_allowed;\n                    self.client_requested_endpoint_valid = endpoint_valid;\n                    self.state = IdentityServerState::ChallengeReady;\n                    Ok(())\n                }\n            }\n            _ =\u003e {\n                Err(Error::IncorrectUsage(\"handle_endpoint_request_received() may only be called after EndpointRequestReceived has been returned from update(), and it may only be called once\".to_string()))\n            }\n        }\n    }\n\n    pub fn handle_challenge_response_received(\n        \u0026mut self,\n        challenge_response_valid: bool,\n    ) -\u003e Result\u003c(), Error\u003e {\n        match (\n            \u0026self.state,\n            self.begin_handshake_request_cookie,\n            self.client_identity.as_ref(),\n            self.requested_endpoint.as_ref(),\n            self.server_cookie.as_ref(),\n            self.endpoint_challenge.as_ref(),\n            self.client_auth_key.as_ref(),\n            self.challenge_response.as_ref(),\n            self.endpoint_private_key.as_ref(),\n        ) {\n            (\n                \u0026IdentityServerState::GettingChallengeVerification,\n                Some(_begin_handshake_request_cookie),\n                Some(_client_identity),\n                Some(_requested_endpoint),\n                Some(_server_cookie),\n                Some(_endpoint_challenge),\n                Some(_client_auth_key),\n                Some(_challenge_response),\n                None,\n            ) =\u003e\n            // endpoint_private_key\n            {\n                self.challenge_response_valid = challenge_response_valid;\n                self.state = IdentityServerState::ChallengeVerificationReady;\n                Ok(())\n            }\n            _ =\u003e {\n                Err(Error::IncorrectUsage(\"handle_challenge_response_received() may only be called after ChallengeResponseReceived event has been returned from update(), and it may only be called once\".to_string()))\n            }\n        }\n    }\n}\n\nimpl ApiSet for IdentityServer {\n    fn namespace(\u0026self) -\u003e \u0026str {\n        \"gosling_identity\"\n    }\n\n    fn exec_function(\n        \u0026mut self,\n        name: \u0026str,\n        version: i32,\n        mut args: bson::document::Document,\n        request_cookie: Option\u003cRequestCookie\u003e,\n    ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n        let request_cookie = match request_cookie {\n            Some(request_cookie) =\u003e request_cookie,\n            None =\u003e {\n                return Some(Err(ErrorCode::Runtime(\n                    RpcError::RequestCookieRequired as i32,\n                )))\n            }\n        };\n\n        match (\n            name,\n            version,\n            \u0026self.state,\n            self.begin_handshake_request_cookie,\n            self.client_identity.as_ref(),\n            self.requested_endpoint.as_ref(),\n            self.server_cookie.as_ref(),\n            self.endpoint_challenge.as_ref(),\n            self.client_auth_key.as_ref(),\n            self.challenge_response.as_ref(),\n            self.endpoint_private_key.as_ref(),\n        ) {\n            // handle begin_handshake call\n            (\n                \"begin_handshake\",\n                0,\n                \u0026IdentityServerState::WaitingForBeginHandshake,\n                None, // begin_handshake_request_cookie\n                None, // client_identity\n                None, // requested_endpoint\n                None, // server_cookie\n                None, // endpoint_challenge\n                None, // client_auth_key\n                None, // challenge_response\n                None, // endpoint_private_key\n            ) =\u003e {\n                let valid_version = match args.remove(\"version\") {\n                    Some(Bson::String(value)) =\u003e value == GOSLING_PROTOCOL_VERSION,\n                    _ =\u003e false,\n                };\n                if !valid_version {\n                    self.state = IdentityServerState::HandshakeFailed;\n                    return Some(Err(ErrorCode::Runtime(RpcError::BadVersion as i32)));\n                }\n\n                if let (Some(Bson::String(client_identity)), Some(Bson::String(endpoint_name))) =\n                    (args.remove(\"client_identity\"), args.remove(\"endpoint\"))\n                {\n                    // client_identiity\n                    let client_identity = match V3OnionServiceId::from_string(\u0026client_identity) {\n                        Ok(client_identity) =\u003e client_identity,\n                        Err(_) =\u003e {\n                            self.state = IdentityServerState::HandshakeFailed;\n                            return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                        }\n                    };\n\n                    // endpoint name\n                    let endpoint_name = match AsciiString::new(endpoint_name) {\n                        Ok(endpoint_name) =\u003e endpoint_name,\n                        Err(_) =\u003e {\n                            self.state = IdentityServerState::HandshakeFailed;\n                            return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                        }\n                    };\n\n                    // save cookie\n                    self.begin_handshake_request_cookie = Some(request_cookie);\n\n                    // save results\n                    self.client_identity = Some(client_identity);\n                    self.requested_endpoint = Some(endpoint_name);\n                    None\n                } else {\n                    self.state = IdentityServerState::HandshakeFailed;\n                    Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)))\n                }\n            }\n            // handle send_response call\n            (\n                \"send_response\",\n                0,\n                \u0026IdentityServerState::WaitingForSendResponse,\n                Some(_begin_handshake_request_cookie),\n                Some(client_identity),\n                Some(requested_endpoint),\n                Some(server_cookie),\n                Some(_endpoint_challenge),\n                None, // client_auth_key\n                None, // challenge_response\n                None, // endpoint_private_key\n            ) =\u003e {\n                // arg validation\n                if let (\n                    Some(Bson::Binary(Binary {\n                        subtype: BinarySubtype::Generic,\n                        bytes: client_cookie,\n                    })),\n                    Some(Bson::Binary(Binary {\n                        subtype: BinarySubtype::Generic,\n                        bytes: client_identity_proof_signature,\n                    })),\n                    Some(Bson::Binary(Binary {\n                        subtype: BinarySubtype::Generic,\n                        bytes: client_authorization_key,\n                    })),\n                    Some(Bson::Boolean(client_authorization_key_signbit)),\n                    Some(Bson::Binary(Binary {\n                        subtype: BinarySubtype::Generic,\n                        bytes: client_authorization_signature,\n                    })),\n                    Some(Bson::Document(challenge_response)),\n                ) = (\n                    args.remove(\"client_cookie\"),\n                    args.remove(\"client_identity_proof_signature\"),\n                    args.remove(\"client_authorization_key\"),\n                    args.remove(\"client_authorization_key_signbit\"),\n                    args.remove(\"client_authorization_signature\"),\n                    args.remove(\"challenge_response\"),\n                ) {\n                    // client_cookie\n                    let client_cookie: ClientCookie = match client_cookie.try_into() {\n                        Ok(client_cookie) =\u003e client_cookie,\n                        Err(_) =\u003e {\n                            self.state = IdentityServerState::HandshakeFailed;\n                            return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                        }\n                    };\n\n                    // client_identity_proof_signature\n                    let client_identity_proof_signature: [u8; ED25519_SIGNATURE_SIZE] =\n                        match client_identity_proof_signature.try_into() {\n                            Ok(client_identity_proof_signature) =\u003e client_identity_proof_signature,\n                            Err(_) =\u003e {\n                                self.state = IdentityServerState::HandshakeFailed;\n                                return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                            }\n                        };\n                    let client_identity_proof_signature =\n                        match Ed25519Signature::from_raw(\u0026client_identity_proof_signature) {\n                            Ok(client_identity_proof_signature) =\u003e client_identity_proof_signature,\n                            Err(_) =\u003e {\n                                self.state = IdentityServerState::HandshakeFailed;\n                                return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                            }\n                        };\n\n                    // client_authorization_key\n                    let client_authorization_key: [u8; X25519_PUBLIC_KEY_SIZE] =\n                        match client_authorization_key.try_into() {\n                            Ok(client_authorization_key) =\u003e client_authorization_key,\n                            Err(_) =\u003e {\n                                self.state = IdentityServerState::HandshakeFailed;\n                                return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                            }\n                        };\n                    let client_authorization_key =\n                        X25519PublicKey::from_raw(\u0026client_authorization_key);\n\n                    // client_authorization_key_signbit\n                    let client_authorization_key_signbit: SignBit =\n                        client_authorization_key_signbit.into();\n\n                    // client_authorization_signature\n                    let client_authorization_signature: [u8; ED25519_SIGNATURE_SIZE] =\n                        match client_authorization_signature.try_into() {\n                            Ok(client_authorization_signature) =\u003e client_authorization_signature,\n                            Err(_) =\u003e {\n                                self.state = IdentityServerState::HandshakeFailed;\n                                return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                            }\n                        };\n                    let client_authorization_signature =\n                        match Ed25519Signature::from_raw(\u0026client_authorization_signature) {\n                            Ok(client_authorization_signature) =\u003e client_authorization_signature,\n                            Err(_) =\u003e {\n                                self.state = IdentityServerState::HandshakeFailed;\n                                return Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)));\n                            }\n                        };\n\n                    // save  cookie\n                    self.send_response_request_cookie = Some(request_cookie);\n\n                    // convert client_identity to client's public ed25519 key\n                    if let Ok(client_identity_key) =\n                        Ed25519PublicKey::from_service_id(client_identity)\n                    {\n                        // construct + verify client proof\n                        let client_proof = build_client_proof(\n                            DomainSeparator::GoslingIdentity,\n                            requested_endpoint,\n                            client_identity,\n                            \u0026self.server_identity,\n                            \u0026client_cookie,\n                            server_cookie,\n                        );\n                        self.client_proof_signature_valid = client_identity_proof_signature\n                            .verify(\u0026client_proof, \u0026client_identity_key);\n                    }\n\n                    // evaluate the client authorization signature\n                    self.client_auth_signature_valid = client_authorization_signature\n                        .verify_x25519(\n                            client_identity.as_bytes(),\n                            \u0026client_authorization_key,\n                            client_authorization_key_signbit,\n                        );\n\n                    // save off client auth key for future endpoint generation\n                    self.client_auth_key = Some(client_authorization_key);\n\n                    // safe off challenge response for verification\n                    self.challenge_response = Some(challenge_response);\n\n                    None\n                } else {\n                    self.state = IdentityServerState::HandshakeFailed;\n                    Some(Err(ErrorCode::Runtime(RpcError::InvalidArg as i32)))\n                }\n            }\n            _ =\u003e {\n                self.state = IdentityServerState::HandshakeFailed;\n                Some(Err(ErrorCode::Runtime(RpcError::Failure as i32)))\n            }\n        }\n    }\n\n    fn next_result(\u0026mut self) -\u003e Option\u003c(RequestCookie, Result\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e)\u003e {\n        match (\n            \u0026self.state,\n            self.begin_handshake_request_cookie,\n            self.client_identity.as_ref(),\n            self.requested_endpoint.as_ref(),\n            self.server_cookie.as_ref(),\n            self.endpoint_challenge.as_mut(),\n            self.send_response_request_cookie,\n            self.client_auth_key.as_ref(),\n            self.challenge_response.as_ref(),\n        ) {\n            // return challenge from begin_handshake\n            (\n                \u0026IdentityServerState::ChallengeReady,\n                Some(begin_handshake_request_cookie),\n                Some(_client_identity),\n                Some(_requested_endpoint),\n                Some(server_cookie),\n                Some(endpoint_challenge),\n                None, // send_response_request_cookie\n                None, // client_auth_key\n                None,\n            ) =\u003e\n            // challenge_response\n            {\n                self.state = IdentityServerState::WaitingForSendResponse;\n                Some((\n                    begin_handshake_request_cookie,\n                    Ok(Some(Bson::Document(doc! {\n                        \"server_cookie\" : Bson::Binary(Binary{subtype: BinarySubtype::Generic, bytes: server_cookie.to_vec()}),\n                        \"endpoint_challenge\" : std::mem::take(endpoint_challenge),\n                    }))),\n                ))\n            }\n            (\u0026IdentityServerState::ChallengeReady, _, _, _, _, _, _, _, _) =\u003e unreachable!(),\n            (\n                \u0026IdentityServerState::ChallengeVerificationReady,\n                Some(_begin_handshake_request_cookie),\n                Some(_client_identity),\n                Some(_requested_endpoint),\n                Some(_server_cookie),\n                Some(_endpoint_challenge),\n                Some(send_response_request_cookie),\n                Some(_client_auth_key),\n                Some(_challenge_response),\n            ) =\u003e {\n                let mut success = true;\n                success \u0026= self.client_allowed;\n                success \u0026= self.client_requested_endpoint_valid;\n                success \u0026= self.client_proof_signature_valid;\n                success \u0026= self.client_auth_signature_valid;\n                success \u0026= self.challenge_response_valid;\n\n                self.state = IdentityServerState::ChallengeVerificationResponseSent;\n                if success {\n                    let endpoint_private_key = Ed25519PrivateKey::generate();\n                    let endpoint_service_id =\n                        V3OnionServiceId::from_private_key(\u0026endpoint_private_key);\n                    self.endpoint_private_key = Some(endpoint_private_key);\n                    Some((\n                        send_response_request_cookie,\n                        Ok(Some(Bson::String(endpoint_service_id.to_string()))),\n                    ))\n                } else {\n                    Some((\n                        send_response_request_cookie,\n                        Err(ErrorCode::Runtime(RpcError::Failure as i32)),\n                    ))\n                }\n            }\n            _ =\u003e None,\n        }\n    }\n}\n","traces":[{"line":121,"address":[4522480],"length":1,"stats":{"Line":0}},{"line":122,"address":[2091337,2092271,2091708,2091991,2091518,2092181,2091898,2091613,2092086,2091803],"length":1,"stats":{"Line":0}},{"line":125,"address":[4523840],"length":1,"stats":{"Line":2}},{"line":128,"address":[4484118],"length":1,"stats":{"Line":2}},{"line":152,"address":[2146208,2147470],"length":1,"stats":{"Line":2}},{"line":155,"address":[2093291],"length":1,"stats":{"Line":2}},{"line":156,"address":[2146419,2146577],"length":1,"stats":{"Line":4}},{"line":158,"address":[2146970,2146612],"length":1,"stats":{"Line":2}},{"line":160,"address":[2093766],"length":1,"stats":{"Line":0}},{"line":161,"address":[4485537,4485310],"length":1,"stats":{"Line":0}},{"line":162,"address":[2147165,2147360],"length":1,"stats":{"Line":0}},{"line":167,"address":[2147537,2148352,2148831,2147974,2149197,2149539,2147771],"length":1,"stats":{"Line":14}},{"line":168,"address":[4486016],"length":1,"stats":{"Line":2}},{"line":169,"address":[4525767],"length":1,"stats":{"Line":2}},{"line":170,"address":[4486052],"length":1,"stats":{"Line":2}},{"line":171,"address":[4525825],"length":1,"stats":{"Line":2}},{"line":172,"address":[4525854],"length":1,"stats":{"Line":2}},{"line":173,"address":[2094715],"length":1,"stats":{"Line":2}},{"line":174,"address":[2094733],"length":1,"stats":{"Line":2}},{"line":175,"address":[4486186],"length":1,"stats":{"Line":2}},{"line":176,"address":[2094791],"length":1,"stats":{"Line":2}},{"line":190,"address":[2095647],"length":1,"stats":{"Line":2}},{"line":201,"address":[2095700],"length":1,"stats":{"Line":2}},{"line":202,"address":[2095721],"length":1,"stats":{"Line":2}},{"line":204,"address":[4527370],"length":1,"stats":{"Line":2}},{"line":217,"address":[2096345],"length":1,"stats":{"Line":2}},{"line":228,"address":[4527641],"length":1,"stats":{"Line":2}},{"line":229,"address":[2149434],"length":1,"stats":{"Line":2}},{"line":230,"address":[2096494],"length":1,"stats":{"Line":2}},{"line":233,"address":[2097242],"length":1,"stats":{"Line":2}},{"line":244,"address":[2097343],"length":1,"stats":{"Line":2}},{"line":245,"address":[4528694],"length":1,"stats":{"Line":2}},{"line":246,"address":[2150290],"length":1,"stats":{"Line":2}},{"line":247,"address":[2097394],"length":1,"stats":{"Line":2}},{"line":248,"address":[4488882],"length":1,"stats":{"Line":2}},{"line":249,"address":[2097519],"length":1,"stats":{"Line":2}},{"line":252,"address":[2096931],"length":1,"stats":{"Line":1}},{"line":263,"address":[2149921],"length":1,"stats":{"Line":1}},{"line":264,"address":[2097048],"length":1,"stats":{"Line":1}},{"line":265,"address":[2097016],"length":1,"stats":{"Line":1}},{"line":266,"address":[2149949],"length":1,"stats":{"Line":1}},{"line":267,"address":[2149956],"length":1,"stats":{"Line":1}},{"line":268,"address":[2097036],"length":1,"stats":{"Line":1}},{"line":269,"address":[2097042],"length":1,"stats":{"Line":1}},{"line":273,"address":[4486440],"length":1,"stats":{"Line":0}},{"line":274,"address":[4489333],"length":1,"stats":{"Line":0}},{"line":276,"address":[2097766],"length":1,"stats":{"Line":0}},{"line":281,"address":[2095385],"length":1,"stats":{"Line":2}},{"line":284,"address":[4489408,4492353,4492472],"length":1,"stats":{"Line":2}},{"line":290,"address":[4489494,4489866,4490030],"length":1,"stats":{"Line":6}},{"line":291,"address":[4489510],"length":1,"stats":{"Line":2}},{"line":292,"address":[4529272],"length":1,"stats":{"Line":2}},{"line":293,"address":[2098176],"length":1,"stats":{"Line":2}},{"line":294,"address":[2098193],"length":1,"stats":{"Line":2}},{"line":295,"address":[2098221],"length":1,"stats":{"Line":2}},{"line":296,"address":[4529417],"length":1,"stats":{"Line":2}},{"line":297,"address":[4529445],"length":1,"stats":{"Line":2}},{"line":298,"address":[4529473],"length":1,"stats":{"Line":2}},{"line":299,"address":[2098333],"length":1,"stats":{"Line":2}},{"line":300,"address":[2098361],"length":1,"stats":{"Line":2}},{"line":302,"address":[2151732],"length":1,"stats":{"Line":2}},{"line":314,"address":[2151801],"length":1,"stats":{"Line":2}},{"line":315,"address":[2098924],"length":1,"stats":{"Line":2}},{"line":319,"address":[4530183,4530457,4530124,4530337],"length":1,"stats":{"Line":6}},{"line":320,"address":[4530143,4530227],"length":1,"stats":{"Line":4}},{"line":321,"address":[4530450],"length":1,"stats":{"Line":2}},{"line":323,"address":[2152381,2152740,2153780],"length":1,"stats":{"Line":2}},{"line":324,"address":[2099989,2099821,2100893,2100273],"length":1,"stats":{"Line":4}},{"line":325,"address":[2100258,2100302],"length":1,"stats":{"Line":4}},{"line":326,"address":[4492130,4491734],"length":1,"stats":{"Line":2}},{"line":327,"address":[2100654],"length":1,"stats":{"Line":0}},{"line":329,"address":[4491753],"length":1,"stats":{"Line":2}},{"line":330,"address":[2100716,2100444],"length":1,"stats":{"Line":2}},{"line":331,"address":[4492247],"length":1,"stats":{"Line":2}},{"line":332,"address":[2153706],"length":1,"stats":{"Line":2}},{"line":333,"address":[4532011],"length":1,"stats":{"Line":2}},{"line":334,"address":[2153736],"length":1,"stats":{"Line":2}},{"line":338,"address":[2100943,2098576],"length":1,"stats":{"Line":0}},{"line":343,"address":[2153952],"length":1,"stats":{"Line":2}},{"line":347,"address":[2154214,2154426],"length":1,"stats":{"Line":4}},{"line":348,"address":[4492566],"length":1,"stats":{"Line":2}},{"line":349,"address":[2101152],"length":1,"stats":{"Line":2}},{"line":350,"address":[2154033],"length":1,"stats":{"Line":2}},{"line":351,"address":[4532360],"length":1,"stats":{"Line":2}},{"line":352,"address":[4492639],"length":1,"stats":{"Line":2}},{"line":353,"address":[2101238],"length":1,"stats":{"Line":2}},{"line":354,"address":[2154121],"length":1,"stats":{"Line":2}},{"line":355,"address":[2154143],"length":1,"stats":{"Line":2}},{"line":356,"address":[2154165],"length":1,"stats":{"Line":2}},{"line":358,"address":[4533027],"length":1,"stats":{"Line":2}},{"line":371,"address":[4493347],"length":1,"stats":{"Line":2}},{"line":372,"address":[4533100],"length":1,"stats":{"Line":2}},{"line":373,"address":[4493377],"length":1,"stats":{"Line":2}},{"line":376,"address":[2101450],"length":1,"stats":{"Line":0}},{"line":383,"address":[4493408],"length":1,"stats":{"Line":2}},{"line":387,"address":[2116079,2108089,2102016],"length":1,"stats":{"Line":2}},{"line":394,"address":[4493588],"length":1,"stats":{"Line":2}},{"line":395,"address":[4533559],"length":1,"stats":{"Line":2}},{"line":397,"address":[2155159],"length":1,"stats":{"Line":0}},{"line":403,"address":[2155666,2155857,2156015,2164890],"length":1,"stats":{"Line":8}},{"line":406,"address":[4493839],"length":1,"stats":{"Line":2}},{"line":407,"address":[4493856],"length":1,"stats":{"Line":2}},{"line":408,"address":[4493879],"length":1,"stats":{"Line":2}},{"line":409,"address":[4533720],"length":1,"stats":{"Line":2}},{"line":410,"address":[2155442],"length":1,"stats":{"Line":2}},{"line":411,"address":[2155472],"length":1,"stats":{"Line":2}},{"line":412,"address":[2102654],"length":1,"stats":{"Line":2}},{"line":413,"address":[2155529],"length":1,"stats":{"Line":2}},{"line":414,"address":[2102716],"length":1,"stats":{"Line":2}},{"line":417,"address":[4494357],"length":1,"stats":{"Line":2}},{"line":430,"address":[2165165],"length":1,"stats":{"Line":2}},{"line":431,"address":[4503928],"length":1,"stats":{"Line":2}},{"line":432,"address":[4543659],"length":1,"stats":{"Line":0}},{"line":434,"address":[2112858],"length":1,"stats":{"Line":2}},{"line":435,"address":[4504364],"length":1,"stats":{"Line":0}},{"line":436,"address":[2165745],"length":1,"stats":{"Line":0}},{"line":439,"address":[2165844,2166057,2166268,2166224],"length":1,"stats":{"Line":8}},{"line":443,"address":[2166408,2166476],"length":1,"stats":{"Line":4}},{"line":444,"address":[4505161],"length":1,"stats":{"Line":2}},{"line":446,"address":[2166615],"length":1,"stats":{"Line":0}},{"line":447,"address":[4505284],"length":1,"stats":{"Line":0}},{"line":452,"address":[2166749],"length":1,"stats":{"Line":2}},{"line":453,"address":[4505471],"length":1,"stats":{"Line":2}},{"line":455,"address":[2166963],"length":1,"stats":{"Line":0}},{"line":456,"address":[2166984],"length":1,"stats":{"Line":0}},{"line":461,"address":[4545498],"length":1,"stats":{"Line":2}},{"line":464,"address":[2167149],"length":1,"stats":{"Line":2}},{"line":465,"address":[4505929,4506093],"length":1,"stats":{"Line":2}},{"line":466,"address":[4506218],"length":1,"stats":{"Line":2}},{"line":468,"address":[2113336],"length":1,"stats":{"Line":0}},{"line":469,"address":[4544525],"length":1,"stats":{"Line":0}},{"line":473,"address":[2103505],"length":1,"stats":{"Line":2}},{"line":487,"address":[4535917,4535457,4535873,4535590,4536077,4536041,4535785,4535702,4535422,4535829,4536059,4535624,4536005,4535741,4535961,4536023,4535663],"length":1,"stats":{"Line":32}},{"line":490,"address":[2157731],"length":1,"stats":{"Line":2}},{"line":494,"address":[2104959],"length":1,"stats":{"Line":2}},{"line":498,"address":[2105007],"length":1,"stats":{"Line":2}},{"line":500,"address":[2157867],"length":1,"stats":{"Line":2}},{"line":503,"address":[2105075],"length":1,"stats":{"Line":2}},{"line":505,"address":[2157935],"length":1,"stats":{"Line":2}},{"line":507,"address":[4534731],"length":1,"stats":{"Line":2}},{"line":508,"address":[2103602],"length":1,"stats":{"Line":2}},{"line":509,"address":[2156513],"length":1,"stats":{"Line":2}},{"line":510,"address":[2103765],"length":1,"stats":{"Line":2}},{"line":511,"address":[4535013],"length":1,"stats":{"Line":2}},{"line":512,"address":[2103925],"length":1,"stats":{"Line":2}},{"line":515,"address":[2105235,2105303],"length":1,"stats":{"Line":4}},{"line":516,"address":[2158133],"length":1,"stats":{"Line":2}},{"line":518,"address":[4496847],"length":1,"stats":{"Line":0}},{"line":519,"address":[4536612],"length":1,"stats":{"Line":0}},{"line":524,"address":[2105617],"length":1,"stats":{"Line":2}},{"line":526,"address":[2105706],"length":1,"stats":{"Line":2}},{"line":528,"address":[4497296],"length":1,"stats":{"Line":0}},{"line":529,"address":[4537061],"length":1,"stats":{"Line":0}},{"line":532,"address":[2106066],"length":1,"stats":{"Line":2}},{"line":534,"address":[4497539],"length":1,"stats":{"Line":2}},{"line":536,"address":[2159089],"length":1,"stats":{"Line":0}},{"line":537,"address":[2159110],"length":1,"stats":{"Line":0}},{"line":542,"address":[4497839],"length":1,"stats":{"Line":2}},{"line":544,"address":[4497924],"length":1,"stats":{"Line":2}},{"line":546,"address":[2159410],"length":1,"stats":{"Line":0}},{"line":547,"address":[4498047],"length":1,"stats":{"Line":0}},{"line":550,"address":[4498220],"length":1,"stats":{"Line":2}},{"line":554,"address":[4498251],"length":1,"stats":{"Line":2}},{"line":558,"address":[4538036],"length":1,"stats":{"Line":2}},{"line":560,"address":[2106957],"length":1,"stats":{"Line":2}},{"line":562,"address":[2159927],"length":1,"stats":{"Line":0}},{"line":563,"address":[2107144],"length":1,"stats":{"Line":0}},{"line":566,"address":[4498741],"length":1,"stats":{"Line":2}},{"line":568,"address":[4538534],"length":1,"stats":{"Line":2}},{"line":570,"address":[4498956],"length":1,"stats":{"Line":0}},{"line":571,"address":[4538721],"length":1,"stats":{"Line":0}},{"line":576,"address":[4499111],"length":1,"stats":{"Line":2}},{"line":579,"address":[2160531],"length":1,"stats":{"Line":2}},{"line":584,"address":[4499238],"length":1,"stats":{"Line":2}},{"line":587,"address":[4538990],"length":1,"stats":{"Line":2}},{"line":591,"address":[4499439],"length":1,"stats":{"Line":2}},{"line":592,"address":[4499359],"length":1,"stats":{"Line":2}},{"line":596,"address":[4539296],"length":1,"stats":{"Line":2}},{"line":598,"address":[4499527],"length":1,"stats":{"Line":2}},{"line":604,"address":[2108192],"length":1,"stats":{"Line":2}},{"line":607,"address":[2161075],"length":1,"stats":{"Line":2}},{"line":609,"address":[2108594],"length":1,"stats":{"Line":2}},{"line":611,"address":[4495739],"length":1,"stats":{"Line":0}},{"line":612,"address":[2157148],"length":1,"stats":{"Line":0}},{"line":616,"address":[2155903],"length":1,"stats":{"Line":0}},{"line":617,"address":[2155924],"length":1,"stats":{"Line":0}},{"line":622,"address":[4507520,4508986],"length":1,"stats":{"Line":2}},{"line":623,"address":[4507974,4508061,4509008,4507819,4507561],"length":1,"stats":{"Line":10}},{"line":624,"address":[2168913],"length":1,"stats":{"Line":2}},{"line":625,"address":[2116155],"length":1,"stats":{"Line":2}},{"line":626,"address":[2116167],"length":1,"stats":{"Line":2}},{"line":627,"address":[4507617],"length":1,"stats":{"Line":2}},{"line":628,"address":[4507643],"length":1,"stats":{"Line":2}},{"line":629,"address":[2169001],"length":1,"stats":{"Line":2}},{"line":630,"address":[4507698],"length":1,"stats":{"Line":2}},{"line":631,"address":[2169050],"length":1,"stats":{"Line":2}},{"line":632,"address":[4547495],"length":1,"stats":{"Line":2}},{"line":635,"address":[4548027],"length":1,"stats":{"Line":2}},{"line":648,"address":[2116901],"length":1,"stats":{"Line":2}},{"line":649,"address":[4548653],"length":1,"stats":{"Line":2}},{"line":651,"address":[4508346,4508400,4508678,4508554],"length":1,"stats":{"Line":6}},{"line":652,"address":[4508368,4508444],"length":1,"stats":{"Line":4}},{"line":653,"address":[2169979],"length":1,"stats":{"Line":2}},{"line":658,"address":[4549002],"length":1,"stats":{"Line":2}},{"line":669,"address":[4549103],"length":1,"stats":{"Line":2}},{"line":670,"address":[2170687],"length":1,"stats":{"Line":2}},{"line":671,"address":[4509392],"length":1,"stats":{"Line":2}},{"line":672,"address":[4509417],"length":1,"stats":{"Line":2}},{"line":673,"address":[2170762],"length":1,"stats":{"Line":2}},{"line":674,"address":[4509467],"length":1,"stats":{"Line":2}},{"line":676,"address":[4549236],"length":1,"stats":{"Line":2}},{"line":677,"address":[2170981,2170833,2171495],"length":1,"stats":{"Line":5}},{"line":678,"address":[2170986],"length":1,"stats":{"Line":2}},{"line":679,"address":[4509701],"length":1,"stats":{"Line":2}},{"line":681,"address":[4549505],"length":1,"stats":{"Line":2}},{"line":682,"address":[2171426],"length":1,"stats":{"Line":2}},{"line":684,"address":[2171276],"length":1,"stats":{"Line":2}},{"line":687,"address":[2170920],"length":1,"stats":{"Line":1}},{"line":689,"address":[2118108],"length":1,"stats":{"Line":1}},{"line":693,"address":[2116531],"length":1,"stats":{"Line":2}}],"covered":183,"coverable":220},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","src","lib.rs"],"content":"#![doc = include_str!(\"../README.md\")]\n\n// some internal functions take a lot of args but thats ok\n#![allow(clippy::too_many_arguments)]\n\nmod ascii_string;\n/// Implementation of the Gosling protocol\npub mod context;\n#[cfg(fuzzing)]\npub mod endpoint_client;\n#[cfg(not(fuzzing))]\nmod endpoint_client;\n#[cfg(fuzzing)]\npub mod endpoint_server;\n#[cfg(not(fuzzing))]\nmod endpoint_server;\npub(crate) mod gosling;\n#[cfg(fuzzing)]\npub mod identity_client;\n#[cfg(not(fuzzing))]\nmod identity_client;\n#[cfg(fuzzing)]\npub mod identity_server;\n#[cfg(not(fuzzing))]\nmod identity_server;\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","gosling","tests","context.rs"],"content":"// standard\nuse std::io::{BufRead, BufReader, Write};\nuse std::net::TcpStream;\n\n// extern crates\nuse anyhow::bail;\nuse bson::doc;\nuse serial_test::serial;\n#[cfg(feature = \"tor-interface/legacy-tor-provider\")]\nuse tor_interface::legacy_tor_client::*;\n#[cfg(feature = \"tor-interface/mock-tor-provider\")]\nuse tor_interface::mock_tor_client::*;\nuse tor_interface::tor_crypto::*;\nuse tor_interface::tor_provider::*;\n\n// internal crates\nuse gosling::context::*;\n\nconst INVALID_HANDSHAKE_HANDLE: HandshakeHandle = !0usize;\n\n#[test]\n#[cfg(feature = \"tor-interface/mock-tor-provider\")]\nfn test_mock_client_gosling_context() -\u003e anyhow::Result\u003c()\u003e {\n    let alice_tor_client = Box::new(MockTorClient::new());\n    let pat_tor_client = Box::new(MockTorClient::new());\n    gosling_context_test(alice_tor_client, pat_tor_client)\n}\n\n#[test]\n#[serial]\n#[cfg(feature = \"tor-interface/legacy-tor-provider\")]\nfn test_legacy_client_gosling_context() -\u003e anyhow::Result\u003c()\u003e {\n    let tor_path = which::which(\"tor\")?;\n\n    let mut alice_path = std::env::temp_dir();\n    alice_path.push(\"test_legacy_client_gosling_context_alice\");\n    let tor_config = LegacyTorClientConfig::BundledTor {\n        tor_bin_path: tor_path.clone(),\n        data_directory: alice_path,\n        proxy_settings: None,\n        allowed_ports: None,\n        pluggable_transports: None,\n        bridge_lines: None,\n    };\n    let alice_tor_client = Box::new(LegacyTorClient::new(tor_config)?);\n\n    let mut pat_path = std::env::temp_dir();\n    pat_path.push(\"test_legacy_client_gosling_context_pat\");\n    let tor_config = LegacyTorClientConfig::BundledTor {\n        tor_bin_path: tor_path,\n        data_directory: pat_path,\n        proxy_settings: None,\n        allowed_ports: None,\n        pluggable_transports: None,\n        bridge_lines: None,\n    };\n    let pat_tor_client = Box::new(LegacyTorClient::new(tor_config)?);\n\n    gosling_context_test(alice_tor_client, pat_tor_client)\n}\n\n#[cfg(test)]\nfn gosling_context_test(\n    alice_tor_client: Box\u003cdyn TorProvider\u003e,\n    pat_tor_client: Box\u003cdyn TorProvider\u003e,\n) -\u003e anyhow::Result\u003c()\u003e {\n    // Bootstrap Alice\n    let alice_private_key = Ed25519PrivateKey::generate();\n    let alice_service_id = V3OnionServiceId::from_private_key(\u0026alice_private_key);\n\n    println!(\n        \"Starting Alice gosling context ({})\",\n        alice_service_id.to_string()\n    );\n\n    let mut alice = Context::new(\n        alice_tor_client,\n        420,\n        420,\n        std::time::Duration::from_secs(60),\n        4096,\n        None,\n        alice_private_key,\n    )?;\n    alice.bootstrap()?;\n\n    let mut bootstrap_complete = false;\n    while !bootstrap_complete {\n        for event in alice.update()?.drain(..) {\n            match event {\n                ContextEvent::TorBootstrapStatusReceived {\n                    progress,\n                    tag,\n                    summary,\n                } =\u003e println!(\n                    \"Alice BootstrapStatus: {{ progress: {}, tag: {}, summary: '{}' }}\",\n                    progress, tag, summary\n                ),\n                ContextEvent::TorBootstrapCompleted =\u003e {\n                    println!(\"Alice Bootstrap Complete!\");\n                    bootstrap_complete = true;\n                }\n                ContextEvent::TorLogReceived { line } =\u003e {\n                    println!(\"--- ALICE --- {}\", line);\n                }\n                _ =\u003e {}\n            }\n        }\n    }\n\n    // Bootstrap Pat\n    let pat_private_key = Ed25519PrivateKey::generate();\n    let pat_service_id = V3OnionServiceId::from_private_key(\u0026pat_private_key);\n\n    println!(\n        \"Starting Pat gosling context ({})\",\n        pat_service_id.to_string()\n    );\n    let mut pat = Context::new(\n        pat_tor_client,\n        420,\n        420,\n        std::time::Duration::from_secs(60),\n        4096,\n        None,\n        pat_private_key,\n    )?;\n    pat.bootstrap()?;\n\n    let mut bootstrap_complete = false;\n    while !bootstrap_complete {\n        for event in pat.update()?.drain(..) {\n            match event {\n                ContextEvent::TorBootstrapStatusReceived {\n                    progress,\n                    tag,\n                    summary,\n                } =\u003e println!(\n                    \"Pat BootstrapStatus: {{ progress: {}, tag: {}, summary: '{}' }}\",\n                    progress, tag, summary\n                ),\n                ContextEvent::TorBootstrapCompleted =\u003e {\n                    println!(\"Pat Bootstrap Complete!\");\n                    bootstrap_complete = true;\n                }\n                ContextEvent::TorLogReceived { line } =\u003e {\n                    println!(\"--- PAT --- {}\", line);\n                }\n                _ =\u003e {}\n            }\n        }\n    }\n\n    // Start the Alice identity server\n    println!(\"Alice identity server starting\");\n    alice.identity_server_start()?;\n    let mut alice_identity_published: bool = false;\n\n    while !alice_identity_published {\n        for event in alice.update()?.drain(..) {\n            match event {\n                ContextEvent::IdentityServerPublished =\u003e {\n                    alice_identity_published = true;\n                    println!(\"Alice identity server published\");\n                }\n                ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                evt =\u003e bail!(\"alice.update() returned unexpected event: {:?}\", evt),\n            }\n        }\n    }\n\n    // Pat begins client handshake\n    println!(\"Pat identity client handshake begin\");\n    let mut pat_identity_handshake_handle: HandshakeHandle = INVALID_HANDSHAKE_HANDLE;\n    {\n        let mut pat_identity_handshake_tries_remaining = 3;\n        while pat_identity_handshake_tries_remaining \u003e 0\n            \u0026\u0026 pat_identity_handshake_handle == INVALID_HANDSHAKE_HANDLE\n        {\n            match pat.identity_client_begin_handshake(\n                alice_service_id.clone(),\n                \"test_endpoint\".to_string(),\n            ) {\n                Ok(handle) =\u003e {\n                    pat_identity_handshake_handle = handle;\n                }\n                Err(err) =\u003e {\n                    println!(\n                        \"Pat connecting to Alice's identity server failed with: {:?}\",\n                        err\n                    );\n                    pat_identity_handshake_tries_remaining -= 1;\n                }\n            }\n        }\n\n        if pat_identity_handshake_tries_remaining == 0 {\n            bail!(\"pat.identity_client_handshake() failed no more retries remain\");\n        }\n    }\n\n    // Alice waits for handshake start\n    let mut alice_identity_handshake_handle: HandshakeHandle = INVALID_HANDSHAKE_HANDLE;\n    println!(\"Alice waits for identity handshake start\");\n    {\n        let mut alice_identity_server_endpoint_request_received: bool = false;\n        while !alice_identity_server_endpoint_request_received {\n            for event in alice.update()?.drain(..) {\n                match event {\n                    ContextEvent::IdentityServerHandshakeStarted { handle } =\u003e {\n                        alice_identity_handshake_handle = handle;\n                        println!(\"Pat has connected to Alice identity server\");\n                    }\n                    ContextEvent::IdentityServerEndpointRequestReceived {\n                        handle,\n                        client_service_id,\n                        requested_endpoint,\n                    } =\u003e {\n                        assert_eq!(alice_identity_handshake_handle, handle);\n                        assert_eq!(pat_service_id, client_service_id);\n                        assert_eq!(requested_endpoint, \"test_endpoint\");\n                        alice_identity_server_endpoint_request_received = true;\n                        println!(\"Alice receives initial identity handshake request\");\n                    }\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"alice.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n            for event in pat.update()?.drain(..) {\n                match event {\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"pat.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n        }\n    }\n\n    // Alice sends challenge\n    println!(\"Alice sends identity server challenge\");\n    alice.identity_server_handle_endpoint_request_received(\n        alice_identity_handshake_handle,\n        true,\n        true,\n        doc! {},\n    )?;\n\n    // Pat responds to challenge\n    println!(\"Pat waits for server challenge\");\n    {\n        let mut pat_identity_client_challenge: Option\u003cbson::document::Document\u003e = None;\n        while pat_identity_client_challenge.is_none() {\n            for event in pat.update()?.drain(..) {\n                match event {\n                    ContextEvent::IdentityClientChallengeReceived {\n                        handle,\n                        endpoint_challenge,\n                    } =\u003e {\n                        assert_eq!(handle, pat_identity_handshake_handle);\n                        pat_identity_client_challenge = Some(endpoint_challenge);\n                    }\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"pat.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n            for event in alice.update()?.drain(..) {\n                match event {\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"alice.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n        }\n\n        println!(\"Pat responds to challenge\");\n        if let Some(challenge) = pat_identity_client_challenge {\n            assert_eq!(challenge, doc! {});\n            // send empty doc in response\n            pat.identity_client_handle_challenge_received(pat_identity_handshake_handle, doc! {})?;\n        } else {\n            bail!(\"missing pat_identity_client_challenge\");\n        }\n    }\n\n    // Alice evaluate challenge response\n    println!(\"Alice awaits challenge response\");\n    {\n        let mut alice_identity_server_challenge_response: Option\u003cbson::document::Document\u003e = None;\n        while alice_identity_server_challenge_response.is_none() {\n            for event in alice.update()?.drain(..) {\n                match event {\n                    ContextEvent::IdentityServerChallengeResponseReceived {\n                        handle,\n                        challenge_response,\n                    } =\u003e {\n                        assert_eq!(handle, alice_identity_handshake_handle);\n                        alice_identity_server_challenge_response = Some(challenge_response);\n                    }\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"alice.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n            for event in pat.update()?.drain(..) {\n                match event {\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"pat.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n        }\n        println!(\"Alice evaluates challenge response\");\n        if let Some(challenge_response) = alice_identity_server_challenge_response {\n            assert_eq!(challenge_response, doc! {});\n            println!(\"Alice accepts challenge response\");\n            alice.identity_server_handle_challenge_response_received(\n                alice_identity_handshake_handle,\n                true,\n            )?;\n        } else {\n            bail!(\"missing challenge response\");\n        }\n    }\n\n    // Alice and Pat awaits handshake results\n    println!(\"Identity handshake completing\");\n    let (\n        alice_endpoint_private_key,\n        alice_endpoint_service_id,\n        pat_auth_private_key,\n        pat_auth_public_key,\n    ) = {\n        let mut alice_endpoint_private_key: Option\u003cEd25519PrivateKey\u003e = None;\n        let mut alice_endpoint_service_id: Option\u003cV3OnionServiceId\u003e = None;\n        let mut pat_auth_private_key: Option\u003cX25519PrivateKey\u003e = None;\n        let mut pat_auth_public_key: Option\u003cX25519PublicKey\u003e = None;\n\n        let mut pat_identity_client_handshake_completed: bool = false;\n        let mut alice_identity_server_hanshake_completed: bool = false;\n        while !pat_identity_client_handshake_completed || !alice_identity_server_hanshake_completed\n        {\n            for event in alice.update()?.drain(..) {\n                match event {\n                    ContextEvent::IdentityServerHandshakeCompleted {\n                        handle,\n                        endpoint_private_key,\n                        endpoint_name,\n                        client_service_id,\n                        client_auth_public_key,\n                    } =\u003e {\n                        assert_eq!(handle, alice_identity_handshake_handle);\n                        alice_endpoint_private_key = Some(endpoint_private_key);\n                        assert_eq!(endpoint_name, \"test_endpoint\");\n                        assert_eq!(client_service_id, pat_service_id);\n                        pat_auth_public_key = Some(client_auth_public_key);\n                        alice_identity_server_hanshake_completed = true;\n                    }\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"alice.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n            for event in pat.update()?.drain(..) {\n                match event {\n                    ContextEvent::IdentityClientHandshakeCompleted {\n                        handle,\n                        identity_service_id,\n                        endpoint_service_id,\n                        endpoint_name,\n                        client_auth_private_key,\n                    } =\u003e {\n                        assert_eq!(handle, pat_identity_handshake_handle);\n                        assert_eq!(identity_service_id, alice_service_id);\n                        assert_eq!(endpoint_name, \"test_endpoint\");\n                        alice_endpoint_service_id = Some(endpoint_service_id);\n                        pat_auth_private_key = Some(client_auth_private_key);\n                        pat_identity_client_handshake_completed = true;\n                    }\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"pat.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n        }\n\n        // verify the private key returned by alice matches service id returned by pat\n        assert_eq!(\n            V3OnionServiceId::from_private_key(alice_endpoint_private_key.as_ref().unwrap()),\n            *alice_endpoint_service_id.as_ref().unwrap()\n        );\n\n        (\n            alice_endpoint_private_key.unwrap(),\n            alice_endpoint_service_id.unwrap(),\n            pat_auth_private_key.unwrap(),\n            pat_auth_public_key.unwrap(),\n        )\n    };\n\n    // Alice starts endpoint server\n    println!(\"Alice endpoint server starting\");\n    alice.endpoint_server_start(\n        alice_endpoint_private_key,\n        \"test_endpoint\".to_string(),\n        pat_service_id.clone(),\n        pat_auth_public_key.clone(),\n    )?;\n    {\n        let mut alice_endpoint_server_published: bool = false;\n        while !alice_endpoint_server_published {\n            for event in alice.update()?.drain(..) {\n                match event {\n                    ContextEvent::EndpointServerPublished {\n                        endpoint_service_id,\n                        endpoint_name,\n                    } =\u003e {\n                        assert_eq!(endpoint_service_id, alice_endpoint_service_id);\n                        assert_eq!(endpoint_name, \"test_endpoint\");\n                        println!(\"Alice endpoint server published\");\n                        alice_endpoint_server_published = true;\n                    }\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"alice.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n        }\n    }\n\n    // Pat begins client handshake\n    println!(\"Pat endpoint client handshake begin\");\n    let mut pat_endpoint_handshake_handle: HandshakeHandle = INVALID_HANDSHAKE_HANDLE;\n    {\n        let mut pat_endpoint_handshake_tries_remaining = 3;\n        while pat_endpoint_handshake_tries_remaining \u003e 0\n            \u0026\u0026 pat_endpoint_handshake_handle == INVALID_HANDSHAKE_HANDLE\n        {\n            match pat.endpoint_client_begin_handshake(\n                alice_endpoint_service_id.clone(),\n                pat_auth_private_key.clone(),\n                \"test_channel\".to_string(),\n            ) {\n                Ok(handle) =\u003e {\n                    pat_endpoint_handshake_handle = handle;\n                }\n                Err(err) =\u003e {\n                    println!(\n                        \"Pat connecting to Alice's identity server failed with:\\n{:?}\",\n                        err\n                    );\n                    pat_endpoint_handshake_tries_remaining -= 1;\n                }\n            }\n        }\n\n        if pat_endpoint_handshake_tries_remaining == 0 {\n            bail!(\"pat.endpoint_client_begin_handshake() failed no more retries remain\");\n        }\n    }\n\n    // Alice waits for handshake start\n    let mut alice_endpoint_server_handshake_handle: HandshakeHandle = INVALID_HANDSHAKE_HANDLE;\n    println!(\"Alice waits for endpoint handshake to start\");\n    {\n        let mut alice_endpoint_server_request_recieved: bool = false;\n        while !alice_endpoint_server_request_recieved {\n            for event in alice.update()?.drain(..) {\n                match event {\n                    ContextEvent::EndpointServerHandshakeStarted { handle } =\u003e {\n                        alice_endpoint_server_handshake_handle = handle;\n                        println!(\"Pat has connected to Alice endpoint server\")\n                    }\n                    ContextEvent::EndpointServerChannelRequestReceived {\n                        handle,\n                        client_service_id,\n                        requested_channel,\n                    } =\u003e {\n                        assert_eq!(handle, alice_endpoint_server_handshake_handle);\n                        assert_eq!(client_service_id, pat_service_id);\n                        assert_eq!(requested_channel, \"test_channel\");\n                        alice_endpoint_server_request_recieved = true;\n                        println!(\"Pat requesting '{0}' endpoint channel\", requested_channel);\n                    }\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"alice.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n            for event in pat.update()?.drain(..) {\n                match event {\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    evt =\u003e bail!(\"pat.update() returned unexpected event: {:?}\", evt),\n                }\n            }\n        }\n\n        // Alice sends handshake response\n        println!(\"Alice sends endpoint handshake response\");\n        alice.endpoint_server_handle_channel_request_received(\n            alice_endpoint_server_handshake_handle,\n            true,\n        )?;\n    }\n\n    // Alice and Pat await hndshake result\n    println!(\"Endpoint handshake completing\");\n    let (alice_server_stream, mut pat_client_stream) = {\n        let mut alice_server_stream: Option\u003cTcpStream\u003e = None;\n        let mut pat_client_stream: Option\u003cTcpStream\u003e = None;\n\n        let mut pat_endpoint_client_handshake_completed: bool = false;\n        let mut alice_endpoint_server_handshake_completed: bool = false;\n\n        while !pat_endpoint_client_handshake_completed || !alice_endpoint_server_handshake_completed\n        {\n            for event in alice.update()?.drain(..) {\n                match event {\n                    ContextEvent::EndpointServerHandshakeCompleted {\n                        handle,\n                        endpoint_service_id,\n                        client_service_id,\n                        channel_name,\n                        stream,\n                    } =\u003e {\n                        assert_eq!(handle, alice_endpoint_server_handshake_handle);\n                        assert_eq!(endpoint_service_id, alice_endpoint_service_id);\n                        assert_eq!(client_service_id, pat_service_id);\n                        assert_eq!(channel_name, \"test_channel\");\n                        alice_server_stream = Some(stream);\n                        alice_endpoint_server_handshake_completed = true;\n                    }\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    event =\u003e bail!(\"alice.update() returned unexepcted event: {:?}\", event),\n                }\n            }\n            for event in pat.update()?.drain(..) {\n                match event {\n                    ContextEvent::EndpointClientHandshakeCompleted {\n                        handle,\n                        endpoint_service_id,\n                        channel_name,\n                        stream,\n                    } =\u003e {\n                        assert_eq!(handle, pat_endpoint_handshake_handle);\n                        assert_eq!(endpoint_service_id, alice_endpoint_service_id);\n                        assert_eq!(channel_name, \"test_channel\");\n                        pat_client_stream = Some(stream);\n                        pat_endpoint_client_handshake_completed = true;\n                    }\n                    ContextEvent::TorLogReceived { line: _ } =\u003e (),\n                    event =\u003e bail!(\"pat.update() returned unexepcted event: {:?}\", event),\n                }\n            }\n        }\n        (alice_server_stream.unwrap(), pat_client_stream.unwrap())\n    };\n\n    println!(\"Endpoint handshake complete, TcpStreams returned\");\n\n    pat_client_stream.write(b\"Hello World!\\n\")?;\n    pat_client_stream.flush()?;\n\n    alice_server_stream.set_nonblocking(false)?;\n    let mut alice_reader = BufReader::new(alice_server_stream);\n\n    let mut response: String = Default::default();\n    alice_reader.read_line(\u0026mut response)?;\n\n    assert_eq!(response, \"Hello World!\\n\");\n\n    println!(\"TcpStream communication succesful\");\n\n    Ok(())\n}\n","traces":[{"line":63,"address":[1568192,1571677,1609144],"length":1,"stats":{"Line":0}},{"line":68,"address":[1568261],"length":1,"stats":{"Line":0}},{"line":69,"address":[1568649],"length":1,"stats":{"Line":0}},{"line":71,"address":[1568861],"length":1,"stats":{"Line":0}},{"line":77,"address":[1568993],"length":1,"stats":{"Line":0}},{"line":80,"address":[1569046],"length":1,"stats":{"Line":0}},{"line":82,"address":[1569109],"length":1,"stats":{"Line":0}},{"line":83,"address":[1569120],"length":1,"stats":{"Line":0}},{"line":85,"address":[1569687,1569444,1569733,1608971],"length":1,"stats":{"Line":0}},{"line":87,"address":[1569720],"length":1,"stats":{"Line":0}},{"line":88,"address":[1569728,1569894],"length":1,"stats":{"Line":0}},{"line":89,"address":[1569969,1572014,1570313,1570462,1572087,1570409,1569904],"length":1,"stats":{"Line":0}},{"line":90,"address":[1570516],"length":1,"stats":{"Line":0}},{"line":91,"address":[1571418],"length":1,"stats":{"Line":0}},{"line":99,"address":[1571713],"length":1,"stats":{"Line":0}},{"line":100,"address":[1570954,1571686],"length":1,"stats":{"Line":0}},{"line":101,"address":[1571705],"length":1,"stats":{"Line":0}},{"line":103,"address":[1570983],"length":1,"stats":{"Line":0}},{"line":104,"address":[1571762],"length":1,"stats":{"Line":0}},{"line":112,"address":[1569931],"length":1,"stats":{"Line":0}},{"line":113,"address":[1572117],"length":1,"stats":{"Line":0}},{"line":115,"address":[1572193],"length":1,"stats":{"Line":0}},{"line":120,"address":[1572464],"length":1,"stats":{"Line":0}},{"line":123,"address":[1572517],"length":1,"stats":{"Line":0}},{"line":125,"address":[1572580],"length":1,"stats":{"Line":0}},{"line":126,"address":[1572591],"length":1,"stats":{"Line":0}},{"line":128,"address":[1573204,1572915,1608875,1573158],"length":1,"stats":{"Line":0}},{"line":130,"address":[1573191],"length":1,"stats":{"Line":0}},{"line":131,"address":[1573199,1573365],"length":1,"stats":{"Line":0}},{"line":132,"address":[1573447,1573887,1573791,1573940,1575480,1573375,1575553],"length":1,"stats":{"Line":0}},{"line":133,"address":[1573994],"length":1,"stats":{"Line":0}},{"line":134,"address":[1574261],"length":1,"stats":{"Line":0}},{"line":142,"address":[1575182],"length":1,"stats":{"Line":0}},{"line":143,"address":[1574432,1575155],"length":1,"stats":{"Line":0}},{"line":144,"address":[1575174],"length":1,"stats":{"Line":0}},{"line":146,"address":[1574461],"length":1,"stats":{"Line":0}},{"line":147,"address":[1575228],"length":1,"stats":{"Line":0}},{"line":155,"address":[1573402,1575583],"length":1,"stats":{"Line":0}},{"line":156,"address":[1575602,1575691,1608854],"length":1,"stats":{"Line":0}},{"line":157,"address":[1575678],"length":1,"stats":{"Line":0}},{"line":159,"address":[1575686,1575852],"length":1,"stats":{"Line":0}},{"line":160,"address":[1576374,1576833,1576424,1575934,1577137,1576278,1575862],"length":1,"stats":{"Line":0}},{"line":161,"address":[1576462],"length":1,"stats":{"Line":0}},{"line":163,"address":[1576729],"length":1,"stats":{"Line":0}},{"line":164,"address":[1576737,1576804],"length":1,"stats":{"Line":0}},{"line":167,"address":[1576561,1576838,1577000],"length":1,"stats":{"Line":0}},{"line":173,"address":[1575889,1577150],"length":1,"stats":{"Line":0}},{"line":174,"address":[1577169],"length":1,"stats":{"Line":0}},{"line":176,"address":[1577181],"length":1,"stats":{"Line":0}},{"line":177,"address":[1577192],"length":1,"stats":{"Line":0}},{"line":178,"address":[1577214],"length":1,"stats":{"Line":0}},{"line":180,"address":[1608425],"length":1,"stats":{"Line":0}},{"line":181,"address":[1577241],"length":1,"stats":{"Line":0}},{"line":182,"address":[1608398],"length":1,"stats":{"Line":0}},{"line":184,"address":[1608494],"length":1,"stats":{"Line":0}},{"line":185,"address":[1608510],"length":1,"stats":{"Line":0}},{"line":187,"address":[1608523],"length":1,"stats":{"Line":0}},{"line":188,"address":[1608705],"length":1,"stats":{"Line":0}},{"line":192,"address":[1608774,1608825],"length":1,"stats":{"Line":0}},{"line":197,"address":[1577202],"length":1,"stats":{"Line":0}},{"line":198,"address":[1577251,1577323],"length":1,"stats":{"Line":0}},{"line":203,"address":[1577277],"length":1,"stats":{"Line":0}},{"line":204,"address":[1577367,1577289],"length":1,"stats":{"Line":0}},{"line":206,"address":[1577386],"length":1,"stats":{"Line":0}},{"line":207,"address":[1577394],"length":1,"stats":{"Line":0}},{"line":208,"address":[1577476,1577916,1577969,1580118,1580488,1577820,1577404],"length":1,"stats":{"Line":0}},{"line":209,"address":[1578007],"length":1,"stats":{"Line":0}},{"line":210,"address":[1579392],"length":1,"stats":{"Line":0}},{"line":211,"address":[1579408],"length":1,"stats":{"Line":0}},{"line":212,"address":[1579416,1579636],"length":1,"stats":{"Line":0}},{"line":214,"address":[1579445],"length":1,"stats":{"Line":0}},{"line":219,"address":[1579660,1579539],"length":1,"stats":{"Line":0}},{"line":220,"address":[1579738,1579829],"length":1,"stats":{"Line":0}},{"line":221,"address":[1579909],"length":1,"stats":{"Line":0}},{"line":222,"address":[1580027],"length":1,"stats":{"Line":0}},{"line":223,"address":[1580035],"length":1,"stats":{"Line":0}},{"line":226,"address":[1579194,1580307,1580142],"length":1,"stats":{"Line":0}},{"line":229,"address":[1578126,1579181,1578659,1578513,1578609],"length":1,"stats":{"Line":0}},{"line":230,"address":[1578685],"length":1,"stats":{"Line":0}},{"line":232,"address":[1578771,1578909,1579074],"length":1,"stats":{"Line":0}},{"line":239,"address":[1580501,1577431],"length":1,"stats":{"Line":0}},{"line":240,"address":[1608385,1580563,1580813],"length":1,"stats":{"Line":0}},{"line":241,"address":[1580520],"length":1,"stats":{"Line":0}},{"line":244,"address":[1580536],"length":1,"stats":{"Line":0}},{"line":248,"address":[1580656,1580846],"length":1,"stats":{"Line":0}},{"line":250,"address":[1580865],"length":1,"stats":{"Line":0}},{"line":251,"address":[1580899,1580986],"length":1,"stats":{"Line":0}},{"line":252,"address":[1581018,1605435,1605922,1605776,1605872,1607865,1608286],"length":1,"stats":{"Line":0}},{"line":253,"address":[1605960],"length":1,"stats":{"Line":0}},{"line":254,"address":[1607323],"length":1,"stats":{"Line":0}},{"line":258,"address":[1607361],"length":1,"stats":{"Line":0}},{"line":259,"address":[1607484,1607744],"length":1,"stats":{"Line":0}},{"line":262,"address":[1608089,1607109,1607927],"length":1,"stats":{"Line":0}},{"line":265,"address":[1606437,1606583,1606533,1607096,1606053],"length":1,"stats":{"Line":0}},{"line":266,"address":[1606609],"length":1,"stats":{"Line":0}},{"line":268,"address":[1606695,1606998,1606833],"length":1,"stats":{"Line":0}},{"line":273,"address":[1581048,1580992],"length":1,"stats":{"Line":0}},{"line":274,"address":[1581067],"length":1,"stats":{"Line":0}},{"line":275,"address":[1581206,1581306],"length":1,"stats":{"Line":0}},{"line":277,"address":[1581486,1605305,1581635],"length":1,"stats":{"Line":0}},{"line":279,"address":[1605384,1581225],"length":1,"stats":{"Line":0}},{"line":284,"address":[1581804],"length":1,"stats":{"Line":0}},{"line":286,"address":[1581849],"length":1,"stats":{"Line":0}},{"line":287,"address":[1581970,1581883],"length":1,"stats":{"Line":0}},{"line":288,"address":[1605206,1602839,1604782,1602693,1582002,1602349,1602789],"length":1,"stats":{"Line":0}},{"line":289,"address":[1602877],"length":1,"stats":{"Line":0}},{"line":290,"address":[1604224],"length":1,"stats":{"Line":0}},{"line":294,"address":[1604278],"length":1,"stats":{"Line":0}},{"line":295,"address":[1604401,1604661],"length":1,"stats":{"Line":0}},{"line":298,"address":[1605006,1604844,1604026],"length":1,"stats":{"Line":0}},{"line":301,"address":[1603354,1604013,1603450,1602970,1603500],"length":1,"stats":{"Line":0}},{"line":302,"address":[1603526],"length":1,"stats":{"Line":0}},{"line":304,"address":[1603750,1603612,1603915],"length":1,"stats":{"Line":0}},{"line":308,"address":[1581976,1582032],"length":1,"stats":{"Line":0}},{"line":309,"address":[1582051],"length":1,"stats":{"Line":0}},{"line":310,"address":[1582290,1582190],"length":1,"stats":{"Line":0}},{"line":311,"address":[1582470],"length":1,"stats":{"Line":0}},{"line":312,"address":[1602213,1582523,1582754],"length":1,"stats":{"Line":0}},{"line":313,"address":[1582515],"length":1,"stats":{"Line":0}},{"line":317,"address":[1582209,1602292],"length":1,"stats":{"Line":0}},{"line":322,"address":[1582795],"length":1,"stats":{"Line":0}},{"line":324,"address":[1588877],"length":1,"stats":{"Line":0}},{"line":325,"address":[1588895],"length":1,"stats":{"Line":0}},{"line":326,"address":[1588959],"length":1,"stats":{"Line":0}},{"line":327,"address":[1588991],"length":1,"stats":{"Line":0}},{"line":329,"address":[1582840],"length":1,"stats":{"Line":0}},{"line":330,"address":[1582860],"length":1,"stats":{"Line":0}},{"line":331,"address":[1582868],"length":1,"stats":{"Line":0}},{"line":332,"address":[1582884],"length":1,"stats":{"Line":0}},{"line":334,"address":[1582892],"length":1,"stats":{"Line":0}},{"line":335,"address":[1582900],"length":1,"stats":{"Line":0}},{"line":336,"address":[1582908,1582945],"length":1,"stats":{"Line":0}},{"line":338,"address":[1582918,1583386,1587672,1587242,1583482,1583042,1583532],"length":1,"stats":{"Line":0}},{"line":339,"address":[1583570],"length":1,"stats":{"Line":0}},{"line":340,"address":[1586223],"length":1,"stats":{"Line":0}},{"line":347,"address":[1586422],"length":1,"stats":{"Line":0}},{"line":348,"address":[1586716,1586545],"length":1,"stats":{"Line":0}},{"line":349,"address":[1586820],"length":1,"stats":{"Line":0}},{"line":350,"address":[1586946],"length":1,"stats":{"Line":0}},{"line":351,"address":[1587066],"length":1,"stats":{"Line":0}},{"line":352,"address":[1587152],"length":1,"stats":{"Line":0}},{"line":355,"address":[1587304,1587466,1586025],"length":1,"stats":{"Line":0}},{"line":358,"address":[1584202,1584056,1585592,1586015,1583669,1584152],"length":1,"stats":{"Line":0}},{"line":359,"address":[1584240],"length":1,"stats":{"Line":0}},{"line":360,"address":[1584583],"length":1,"stats":{"Line":0}},{"line":367,"address":[1584733],"length":1,"stats":{"Line":0}},{"line":368,"address":[1584950,1584864],"length":1,"stats":{"Line":0}},{"line":369,"address":[1585033],"length":1,"stats":{"Line":0}},{"line":370,"address":[1585151],"length":1,"stats":{"Line":0}},{"line":371,"address":[1585287],"length":1,"stats":{"Line":0}},{"line":372,"address":[1585497],"length":1,"stats":{"Line":0}},{"line":375,"address":[1585819,1584339,1585654],"length":1,"stats":{"Line":0}},{"line":381,"address":[1587855,1582955],"length":1,"stats":{"Line":0}},{"line":387,"address":[1588110],"length":1,"stats":{"Line":0}},{"line":388,"address":[1588205],"length":1,"stats":{"Line":0}},{"line":389,"address":[1588345],"length":1,"stats":{"Line":0}},{"line":390,"address":[1588481],"length":1,"stats":{"Line":0}},{"line":395,"address":[1589023,1589093],"length":1,"stats":{"Line":0}},{"line":396,"address":[1589599,1589318,1602073,1589425],"length":1,"stats":{"Line":0}},{"line":397,"address":[1589112],"length":1,"stats":{"Line":0}},{"line":398,"address":[1589158,1589226],"length":1,"stats":{"Line":0}},{"line":399,"address":[1589250],"length":1,"stats":{"Line":0}},{"line":400,"address":[1589311],"length":1,"stats":{"Line":0}},{"line":403,"address":[1589458],"length":1,"stats":{"Line":0}},{"line":404,"address":[1589632,1589466],"length":1,"stats":{"Line":0}},{"line":405,"address":[1591065,1589642,1590058,1591451,1590154,1590204,1589714],"length":1,"stats":{"Line":0}},{"line":406,"address":[1590242],"length":1,"stats":{"Line":0}},{"line":407,"address":[1590603],"length":1,"stats":{"Line":0}},{"line":411,"address":[1590643,1590732],"length":1,"stats":{"Line":0}},{"line":412,"address":[1590815],"length":1,"stats":{"Line":0}},{"line":413,"address":[1590933],"length":1,"stats":{"Line":0}},{"line":414,"address":[1590978],"length":1,"stats":{"Line":0}},{"line":417,"address":[1591089,1591251,1590341],"length":1,"stats":{"Line":0}},{"line":424,"address":[1589669,1591461],"length":1,"stats":{"Line":0}},{"line":425,"address":[1591480],"length":1,"stats":{"Line":0}},{"line":427,"address":[1591492],"length":1,"stats":{"Line":0}},{"line":428,"address":[1591503],"length":1,"stats":{"Line":0}},{"line":429,"address":[1591525],"length":1,"stats":{"Line":0}},{"line":431,"address":[1601659,1601592],"length":1,"stats":{"Line":0}},{"line":432,"address":[1591552],"length":1,"stats":{"Line":0}},{"line":433,"address":[1601509],"length":1,"stats":{"Line":0}},{"line":434,"address":[1601524],"length":1,"stats":{"Line":0}},{"line":436,"address":[1601685],"length":1,"stats":{"Line":0}},{"line":437,"address":[1601701],"length":1,"stats":{"Line":0}},{"line":439,"address":[1601714],"length":1,"stats":{"Line":0}},{"line":440,"address":[1601896],"length":1,"stats":{"Line":0}},{"line":444,"address":[1601965,1602022],"length":1,"stats":{"Line":0}},{"line":449,"address":[1591513],"length":1,"stats":{"Line":0}},{"line":450,"address":[1591562,1591634],"length":1,"stats":{"Line":0}},{"line":455,"address":[1591588],"length":1,"stats":{"Line":0}},{"line":456,"address":[1591600,1591678],"length":1,"stats":{"Line":0}},{"line":458,"address":[1591697],"length":1,"stats":{"Line":0}},{"line":459,"address":[1591705],"length":1,"stats":{"Line":0}},{"line":460,"address":[1594567,1594937,1592280,1592131,1591715,1591787,1592227],"length":1,"stats":{"Line":0}},{"line":461,"address":[1592318],"length":1,"stats":{"Line":0}},{"line":462,"address":[1593703],"length":1,"stats":{"Line":0}},{"line":463,"address":[1593719],"length":1,"stats":{"Line":0}},{"line":464,"address":[1593727,1593947],"length":1,"stats":{"Line":0}},{"line":466,"address":[1593756],"length":1,"stats":{"Line":0}},{"line":471,"address":[1593971,1593850],"length":1,"stats":{"Line":0}},{"line":472,"address":[1594052,1594141],"length":1,"stats":{"Line":0}},{"line":473,"address":[1594224],"length":1,"stats":{"Line":0}},{"line":474,"address":[1594342],"length":1,"stats":{"Line":0}},{"line":475,"address":[1594460],"length":1,"stats":{"Line":0}},{"line":478,"address":[1593505,1594591,1594756],"length":1,"stats":{"Line":0}},{"line":481,"address":[1592970,1592437,1592824,1593492,1592920],"length":1,"stats":{"Line":0}},{"line":482,"address":[1592996],"length":1,"stats":{"Line":0}},{"line":484,"address":[1593220,1593082,1593385],"length":1,"stats":{"Line":0}},{"line":490,"address":[1594950,1591742],"length":1,"stats":{"Line":0}},{"line":491,"address":[1601480,1595215,1594977],"length":1,"stats":{"Line":0}},{"line":492,"address":[1594969],"length":1,"stats":{"Line":0}},{"line":498,"address":[1595058,1595248],"length":1,"stats":{"Line":0}},{"line":499,"address":[1599939],"length":1,"stats":{"Line":0}},{"line":500,"address":[1595267],"length":1,"stats":{"Line":0}},{"line":501,"address":[1595286],"length":1,"stats":{"Line":0}},{"line":503,"address":[1595305],"length":1,"stats":{"Line":0}},{"line":504,"address":[1595313],"length":1,"stats":{"Line":0}},{"line":506,"address":[1595321,1595361],"length":1,"stats":{"Line":0}},{"line":508,"address":[1596003,1595331,1595513,1595857,1599271,1599679,1595953],"length":1,"stats":{"Line":0}},{"line":509,"address":[1596041],"length":1,"stats":{"Line":0}},{"line":510,"address":[1598500],"length":1,"stats":{"Line":0}},{"line":517,"address":[1598522],"length":1,"stats":{"Line":0}},{"line":518,"address":[1598653,1598739],"length":1,"stats":{"Line":0}},{"line":519,"address":[1598822],"length":1,"stats":{"Line":0}},{"line":520,"address":[1598950],"length":1,"stats":{"Line":0}},{"line":521,"address":[1599068],"length":1,"stats":{"Line":0}},{"line":522,"address":[1599176],"length":1,"stats":{"Line":0}},{"line":525,"address":[1598178,1599333,1599498],"length":1,"stats":{"Line":0}},{"line":528,"address":[1596673,1596527,1598168,1596140,1597745,1596623],"length":1,"stats":{"Line":0}},{"line":529,"address":[1596711],"length":1,"stats":{"Line":0}},{"line":530,"address":[1597102],"length":1,"stats":{"Line":0}},{"line":536,"address":[1597124],"length":1,"stats":{"Line":0}},{"line":537,"address":[1597255,1597341],"length":1,"stats":{"Line":0}},{"line":538,"address":[1597424],"length":1,"stats":{"Line":0}},{"line":539,"address":[1597542],"length":1,"stats":{"Line":0}},{"line":540,"address":[1597650],"length":1,"stats":{"Line":0}},{"line":543,"address":[1596810,1597972,1597807],"length":1,"stats":{"Line":0}},{"line":547,"address":[1599776,1599865,1595371],"length":1,"stats":{"Line":0}},{"line":550,"address":[1600031,1599961],"length":1,"stats":{"Line":0}},{"line":552,"address":[1600222,1601362,1600050],"length":1,"stats":{"Line":0}},{"line":553,"address":[1600364,1601344,1600271,1600207],"length":1,"stats":{"Line":0}},{"line":555,"address":[1600335,1600413,1568229,1600507,1601326],"length":1,"stats":{"Line":0}},{"line":556,"address":[1600477],"length":1,"stats":{"Line":0}},{"line":558,"address":[1600556],"length":1,"stats":{"Line":0}},{"line":559,"address":[1601257,1600830,1600619,1600699],"length":1,"stats":{"Line":0}},{"line":561,"address":[1600793,1600878],"length":1,"stats":{"Line":0}},{"line":563,"address":[1600952],"length":1,"stats":{"Line":0}},{"line":565,"address":[1600997],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":248},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","honk-rpc","fuzz","fuzz_targets","fuzz_session.rs"],"content":"#![no_main]\n\n// std\nuse std::collections::{BTreeSet, VecDeque};\nuse std::net::{SocketAddr, TcpListener, TcpStream};\n\n// honk_rpc\nuse honk_rpc::honk_rpc::{ApiSet, Error, ErrorCode, RequestCookie, Response, Session};\n\n// extern\nuse bson::Bson;\n\n// fuzzing\nuse libfuzzer_sys::fuzz_target;\nuse libfuzzer_sys::arbitrary;\nuse libfuzzer_sys::arbitrary::Arbitrary;\n\n#[derive(Arbitrary, Debug)]\nenum SessionMethod {\n    Update,\n    ClientCallSync,\n    ClientCallAsync {\n        // the number of update calls the ApiSet should wait before returning\n        wait_count: u8,\n    },\n    ClientCallInvalid{\n        namespace: Option\u003cString\u003e,\n        function: Option\u003cString\u003e,\n        version: Option\u003ci32\u003e,\n        // arguments: Option\u003cbson::document::Document\u003e,\n    },\n    ClientDrainResponses,\n}\n\n\n#[derive(Default)]\nstruct TestApiSet {\n    pending_async_calls: Vec\u003c(u8, RequestCookie)\u003e,\n    complete_async_calls: VecDeque\u003cRequestCookie\u003e,\n}\n\n// impl ApiSet\nimpl ApiSet for TestApiSet {\n    fn namespace(\u0026self) -\u003e \u0026str {\n        \"fuzzing\"\n    }\n\n    fn exec_function(\n        \u0026mut self,\n        name: \u0026str,\n        version: i32,\n        mut args: bson::document::Document,\n        request_cookie: Option\u003cRequestCookie\u003e) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n        match (name, version) {\n            (\"sync_call\", 0) =\u003e Some(Ok(Some(bson::Bson::Null))),\n            (\"sync_call\", _) =\u003e Some(Err(ErrorCode::RequestVersionInvalid)),\n            (\"async_call\", 0) =\u003e {\n                if let Some(request_cookie) = request_cookie {\n                    if let Some(bson::Bson::Int32(val)) = args.get_mut(\"wait_count\") {\n                        let \u0026mut val = val;\n                        let wait_count = val.clamp(0, 255) as u8;\n                        self.pending_async_calls.push((wait_count, request_cookie));\n                    }\n                }\n                None\n            },\n            (\"async_call\", _) =\u003e Some(Err(ErrorCode::RequestVersionInvalid)),\n            _ =\u003e Some(Err(ErrorCode::RequestFunctionInvalid)),\n        }\n    }\n\n    fn update(\u0026mut self) -\u003e () {\n        self.pending_async_calls.retain_mut(|record| -\u003e bool {\n            if record.0 == 0 {\n                self.complete_async_calls.push_back(record.1);\n                false\n            } else {\n                record.0 -= 1;\n                true\n            }\n        });\n    }\n\n    fn next_result(\u0026mut self) -\u003e Option\u003c(RequestCookie, Result\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e)\u003e {\n        match self.complete_async_calls.pop_front() {\n            Some(cookie) =\u003e Some((cookie, Ok(Some(bson::Bson::Null)))),\n            None =\u003e None\n        }\n    }\n}\n\n\nstruct Context {\n    session: Session\u003cTcpStream\u003e,\n    apiset: TestApiSet,\n    pending_successes: BTreeSet\u003cRequestCookie\u003e,\n    pending_failures: BTreeSet\u003cRequestCookie\u003e,\n}\n\nimpl Context {\n    fn new(session: Session\u003cTcpStream\u003e) -\u003e Context {\n        Context{session, apiset: Default::default(), pending_successes: Default::default(), pending_failures: Default::default()}\n    }\n}\n\nfuzz_target!(|methods: Vec\u003cSessionMethod\u003e| {\n    let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n    let listener = TcpListener::bind(socket_addr).unwrap();\n    let socket_addr = listener.local_addr().unwrap();\n\n    let alice_stream = TcpStream::connect(socket_addr).unwrap();\n    alice_stream.set_nonblocking(true).unwrap();\n\n    let (pat_stream, _socket_addr) = listener.accept().unwrap();\n    pat_stream.set_nonblocking(true).unwrap();\n\n    let alice = Session::new(alice_stream);\n    let pat = Session::new(pat_stream);\n\n    let mut current = \u0026mut Context::new(alice);\n    let mut next = \u0026mut Context::new(pat);\n\n    // run the methods on our pair of HonkRpc Sessions\n    for method in methods {\n        match method {\n            SessionMethod::Update =\u003e match current.session.update(Some(\u0026mut [\u0026mut current.apiset])) {\n                Ok(()) =\u003e {},\n                Err(Error::MessageConversionFailed(ErrorCode::RequestFunctionInvalid)) =\u003e {},\n                Err(error) =\u003e panic!(\"{:?}\", error),\n            },\n            SessionMethod::ClientCallSync =\u003e {\n                let cookie = current.session.client_call(\"fuzzing\", \"sync_call\", 0, bson::doc!{}).unwrap();\n                assert!(current.pending_successes.insert(cookie));\n            }\n            SessionMethod::ClientCallAsync{wait_count} =\u003e {\n                let cookie = current.session.client_call(\"fuzzing\", \"async_call\", 0, bson::doc!{\"wait_count\" : Bson::Int32(wait_count as i32)}).unwrap();\n                assert!(current.pending_successes.insert(cookie));\n            }\n            SessionMethod::ClientCallInvalid{namespace,function,version} =\u003e {\n                // ensure invalid namespace\n                let namespace = match namespace {\n                    Some(namespace) =\u003e namespace,\n                    None =\u003e \"invalid\".to_string(),\n                };\n                let namespace = match namespace.as_str() {\n                    \"fuzzing\" =\u003e \"invalid\",\n                    namespace =\u003e namespace,\n                };\n\n                // ensure invalid function name\n                let function = match function {\n                    Some(function) =\u003e function,\n                    None =\u003e \"invalid\".to_string(),\n                };\n                let function = match function.as_str() {\n                    \"sync_call\" =\u003e \"invalid\",\n                    \"async_call\" =\u003e \"invalid\",\n                    function =\u003e function,\n                };\n\n                // ensure invalid function version\n                let version = match version {\n                    Some(0) =\u003e 1,\n                    Some(version) =\u003e version,\n                    None =\u003e 1,\n                };\n\n                let cookie = current.session.client_call(namespace, function, version, bson::doc!{}).unwrap();\n                assert!(current.pending_failures.insert(cookie));\n            }\n            SessionMethod::ClientDrainResponses =\u003e {\n                for response in current.session.client_drain_responses() {\n                    match response {\n                        Response::Pending{cookie} =\u003e assert!(current.pending_successes.contains(\u0026cookie) || current.pending_failures.contains(\u0026cookie)),\n                        Response::Success{cookie, result: _} =\u003e assert!(current.pending_successes.remove(\u0026cookie)),\n                        Response::Error{cookie, error_code} =\u003e {\n                            assert!(current.pending_failures.remove(\u0026cookie));\n                            assert!(error_code == ErrorCode::RequestNamespaceInvalid ||\n                                    error_code == ErrorCode::RequestFunctionInvalid ||\n                                    error_code == ErrorCode::RequestVersionInvalid);\n                        }\n                    }\n                }\n            },\n        }\n        std::mem::swap(\u0026mut current, \u0026mut next);\n    }\n});\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","honk-rpc","src","byte_counter.rs"],"content":"use std::io::Write;\n\n#[derive(Default)]\npub(crate) struct ByteCounter {\n    bytes: usize,\n}\n\nimpl ByteCounter {\n    pub fn bytes(\u0026self) -\u003e usize {\n        self.bytes\n    }\n}\n\nimpl Write for ByteCounter {\n    fn write(\u0026mut self, buf: \u0026[u8]) -\u003e Result\u003cusize, std::io::Error\u003e {\n        self.bytes += buf.len();\n        Ok(buf.len())\n    }\n\n    fn flush(\u0026mut self) -\u003e Result\u003c(), std::io::Error\u003e {\n        Ok(())\n    }\n}\n","traces":[{"line":9,"address":[1702144],"length":1,"stats":{"Line":4}},{"line":10,"address":[14396581],"length":1,"stats":{"Line":4}},{"line":15,"address":[1340240],"length":1,"stats":{"Line":4}},{"line":16,"address":[14396681,14396621],"length":1,"stats":{"Line":4}},{"line":17,"address":[16447756],"length":1,"stats":{"Line":4}},{"line":20,"address":[3173840],"length":1,"stats":{"Line":0}},{"line":21,"address":[3173845],"length":1,"stats":{"Line":0}}],"covered":5,"coverable":7},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","honk-rpc","src","honk_rpc.rs"],"content":"// standard\nuse std::collections::VecDeque;\nuse std::fmt::Debug;\nuse std::io::{Cursor, ErrorKind};\n#[cfg(test)]\nuse std::net::{SocketAddr, TcpListener, TcpStream};\nuse std::option::Option;\n\n// extern crates\nuse bson::doc;\nuse bson::document::ValueAccessError;\n\nuse crate::byte_counter::ByteCounter;\n\n/// Represents various error codes that can be present in a Honk-RPC `error_section`\n#[derive(Debug, Eq, PartialEq)]\npub enum ErrorCode {\n    /// Failure to parse a received BSON document.\n    BsonParseFailed,\n    /// Received message document was too big; the default maximum message size\n    /// is 4096 bytes, but can be adjusted.\n    MessageTooBig,\n    /// Received message document missing required fields.\n    MessageParseFailed,\n    /// Received message contained version the receiver cannot handle.\n    MessageVersionIncompatible,\n    /// Section in received message contains unknown id.\n    SectionIdUnknown,\n    /// Section in received message missing required field, or provided\n    /// field is wrong datatype.\n    SectionParseFailed,\n    /// Provided request cookie is already in use.\n    RequestCookieInvalid,\n    /// Provided request namespace does not exist.\n    RequestNamespaceInvalid,\n    /// Provided request function does not exist within the provided namespace.\n    RequestFunctionInvalid,\n    /// Provided request version does not exist.\n    RequestVersionInvalid,\n    /// Provided response cookie is not recognized.\n    ResponseCookieInvalid,\n    /// Provided response state is not valid.\n    ResponseStateInvalid,\n    /// Represents an application-specific runtime error with a specific error code.\n    Runtime(i32),\n    /// Represents an unknown error with a specific error code.\n    Unknown(i32),\n}\n\n/// The error type for the `Session` type.\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    /// Failed to read data from read stream due to `std::io::Error`\n    #[error(\"failed to read data from read stream\")]\n    ReaderReadFailed(#[source] std::io::Error),\n\n    /// Bson documents need to be at least 4 bytes long\n    #[error(\"received invalid bson document size header value of {0}, must be at least 4\")]\n    BsonDocumentSizeTooSmall(i32),\n\n    /// Received Bson document header is larger than Session supports\n    #[error(\"received invalid bson document size header value of {0}, must be less than {1}\")]\n    BsonDocumentSizeTooLarge(i32, i32),\n\n    /// Too much time has elapsed without receiving a message\n    #[error(\"waited longer than {} seconds for read\", .0.as_secs_f32())]\n    MessageReadTimedOut(std::time::Duration),\n\n    /// Failed to parse bson message\n    #[error(\"failed to parse bson Message document\")]\n    BsonDocumentParseFailed(#[source] bson::de::Error),\n\n    /// Failed to convert bson document to Honk-RPC message\n    #[error(\"failed to convert bson document to Message\")]\n    MessageConversionFailed(#[source] crate::honk_rpc::ErrorCode),\n\n    /// Failed to serialise bson document\n    #[error(\"failed to serialize bson document\")]\n    BsonWriteFailed(#[source] bson::ser::Error),\n\n    /// Failed to write data to write stream due to `std::io::Error`\n    #[error(\"failed to write data to write stream\")]\n    WriterWriteFailed(#[source] std::io::Error),\n\n    /// Failed to flush data to write stream due to `std::io::Error`\n    #[error(\"failed to flush message to write stream\")]\n    WriterFlushFailed(#[source] std::io::Error),\n\n    /// Received a Honk-RPC `error_section` without an associated request cookie\n    #[error(\"recieved error section without cookie\")]\n    UnknownErrorSectionReceived(#[source] crate::honk_rpc::ErrorCode),\n\n    /// Attempted to define invalid maximum message size\n    #[error(\n        \"tried to set invalid max message size; must be \u003e=5 bytes and \u003c= i32::MAX (2147483647)\"\n    )]\n    InvalidMaxMesageSize(),\n\n    /// Attempted to send a Honk-RPC `section` that is too large to fit in a message\n    #[error(\"queued message section is too large to write; calculated size is {0} but must be less than {1}\")]\n    SectionTooLarge(usize, usize),\n}\n\nimpl From\u003ci32\u003e for ErrorCode {\n    fn from(value: i32) -\u003e ErrorCode {\n        match value {\n            -1i32 =\u003e ErrorCode::BsonParseFailed,\n            -2i32 =\u003e ErrorCode::MessageTooBig,\n            -3i32 =\u003e ErrorCode::MessageParseFailed,\n            -4i32 =\u003e ErrorCode::MessageVersionIncompatible,\n            -5i32 =\u003e ErrorCode::SectionIdUnknown,\n            -6i32 =\u003e ErrorCode::SectionParseFailed,\n            -7i32 =\u003e ErrorCode::RequestCookieInvalid,\n            -8i32 =\u003e ErrorCode::RequestNamespaceInvalid,\n            -9i32 =\u003e ErrorCode::RequestFunctionInvalid,\n            -10i32 =\u003e ErrorCode::RequestVersionInvalid,\n            -11i32 =\u003e ErrorCode::ResponseCookieInvalid,\n            -12i32 =\u003e ErrorCode::ResponseStateInvalid,\n            value =\u003e {\n                if value \u003e 0 {\n                    ErrorCode::Runtime(value)\n                } else {\n                    ErrorCode::Unknown(value)\n                }\n            }\n        }\n    }\n}\n\nimpl From\u003cErrorCode\u003e for i32 {\n    fn from(err: ErrorCode) -\u003e Self {\n        match err {\n            ErrorCode::BsonParseFailed =\u003e -1i32,\n            ErrorCode::MessageTooBig =\u003e -2i32,\n            ErrorCode::MessageParseFailed =\u003e -3i32,\n            ErrorCode::MessageVersionIncompatible =\u003e -4i32,\n            ErrorCode::SectionIdUnknown =\u003e -5i32,\n            ErrorCode::SectionParseFailed =\u003e -6i32,\n            ErrorCode::RequestCookieInvalid =\u003e -7i32,\n            ErrorCode::RequestNamespaceInvalid =\u003e -8i32,\n            ErrorCode::RequestFunctionInvalid =\u003e -9i32,\n            ErrorCode::RequestVersionInvalid =\u003e -10i32,\n            ErrorCode::ResponseCookieInvalid =\u003e -11i32,\n            ErrorCode::ResponseStateInvalid =\u003e -12i32,\n            ErrorCode::Runtime(val) =\u003e val,\n            ErrorCode::Unknown(val) =\u003e val,\n        }\n    }\n}\n\nimpl std::fmt::Display for ErrorCode {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter) -\u003e std::fmt::Result {\n        match self {\n            ErrorCode::BsonParseFailed =\u003e write!(f, \"ProtocolError: failed to parse BSON object\"),\n            ErrorCode::MessageTooBig =\u003e write!(f, \"ProtocolError: received document too large\"),\n            ErrorCode::MessageParseFailed =\u003e {\n                write!(f, \"ProtocolError: received message has invalid schema\")\n            }\n            ErrorCode::MessageVersionIncompatible =\u003e write!(\n                f,\n                \"ProtocolError: received message has incompatible version\"\n            ),\n            ErrorCode::SectionIdUnknown =\u003e write!(\n                f,\n                \"ProtocolError: received message contains section of unknown type\"\n            ),\n            ErrorCode::SectionParseFailed =\u003e write!(\n                f,\n                \"ProtocolError: received message contains section with invalid schema\"\n            ),\n            ErrorCode::RequestCookieInvalid =\u003e {\n                write!(f, \"ProtocolError: request cookie already in use\")\n            }\n            ErrorCode::RequestNamespaceInvalid =\u003e write!(\n                f,\n                \"ProtocolError: request function does not exist in requested namespace\"\n            ),\n            ErrorCode::RequestFunctionInvalid =\u003e {\n                write!(f, \"ProtocolError: request function does not exist\")\n            }\n            ErrorCode::RequestVersionInvalid =\u003e {\n                write!(f, \"ProtocolError: request function version does not exist\")\n            }\n            ErrorCode::ResponseCookieInvalid =\u003e {\n                write!(f, \"ProtocolError: response cookie is not recognized\")\n            }\n            ErrorCode::ResponseStateInvalid =\u003e write!(f, \"ProtocolError: response state not valid\"),\n            ErrorCode::Runtime(code) =\u003e write!(f, \"RuntimeError: runtime error {}\", code),\n            ErrorCode::Unknown(code) =\u003e write!(f, \"UnknownError: unknown error code {}\", code),\n        }\n    }\n}\n\nimpl std::error::Error for ErrorCode {}\n\n// Honk-RPC semver is packed into an i32\nconst fn semver_to_i32(major: u8, minor: u8, patch: u8) -\u003e i32 {\n    let major = major as i32;\n    let minor = minor as i32;\n    let patch = patch as i32;\n    (major \u003c\u003c 16) | (minor \u003c\u003c 8) | patch\n}\n\nconst fn i32_to_semver(ver: i32) -\u003e Option\u003c(u8, u8, u8)\u003e {\n    if ver \u003e= 0 \u0026\u0026 ver \u003c= 0xffffff {\n        let major = (ver \u0026 0xff0000) \u003e\u003e 16;\n        let minor = (ver \u0026 0xff00) \u003e\u003e 8;\n        let patch = ver \u0026 0xff;\n        Some((major as u8, minor as u8, patch as u8))\n    } else {\n        None\n    }\n}\n\n// Honk-RPC version 0.1.0\nconst HONK_RPC_VERSION: i32 = semver_to_i32(0, 1, 0);\n\nstruct Message {\n    honk_rpc: i32,\n    sections: Vec\u003cSection\u003e,\n}\n\nimpl TryFrom\u003cbson::document::Document\u003e for Message {\n    type Error = ErrorCode;\n\n    fn try_from(value: bson::document::Document) -\u003e Result\u003cSelf, Self::Error\u003e {\n        let mut value = value;\n\n        // verify version\n        let honk_rpc = match value.get_i32(\"honk_rpc\") {\n            Ok(HONK_RPC_VERSION) =\u003e HONK_RPC_VERSION,\n            Ok(honk_rpc) =\u003e {\n                return if let Some(_version) = i32_to_semver(honk_rpc) {\n                    // some other semver we cannot handle\n                    Err(ErrorCode::MessageVersionIncompatible)\n                } else {\n                    // an invalid semver\n                    Err(ErrorCode::MessageParseFailed)\n                };\n            }\n            Err(_err) =\u003e return Err(ErrorCode::MessageParseFailed),\n        };\n\n        if let Ok(sections) = value.get_array_mut(\"sections\") {\n            // messages must have at least one section\n            if sections.is_empty() {\n                return Err(ErrorCode::MessageParseFailed);\n            }\n\n            let mut message = Message {\n                honk_rpc,\n                sections: Default::default(),\n            };\n\n            for section in sections.iter_mut() {\n                if let bson::Bson::Document(section) = std::mem::take(section) {\n                    message.sections.push(Section::try_from(section)?);\n                } else {\n                    return Err(ErrorCode::SectionParseFailed);\n                }\n            }\n            Ok(message)\n        } else {\n            Err(ErrorCode::MessageParseFailed)\n        }\n    }\n}\n\nimpl From\u003cMessage\u003e for bson::document::Document {\n    fn from(value: Message) -\u003e bson::document::Document {\n        let mut value = value;\n        let mut message = bson::document::Document::new();\n        message.insert(\"honk_rpc\", value.honk_rpc);\n\n        let mut sections = bson::Array::new();\n        for section in value.sections.drain(0..) {\n            sections.push(bson::Bson::Document(bson::document::Document::from(\n                section,\n            )));\n        }\n        message.insert(\"sections\", sections);\n\n        message\n    }\n}\n\n/// A type alias for the cookie used to track client requests.\npub type RequestCookie = i64;\n\nconst ERROR_SECTION_ID: i32 = 0i32;\nconst REQUEST_SECTION_ID: i32 = 1i32;\nconst RESPONSE_SECTION_ID: i32 = 2i32;\n\nenum Section {\n    Error(ErrorSection),\n    Request(RequestSection),\n    Response(ResponseSection),\n}\n\nstruct ErrorSection {\n    cookie: Option\u003cRequestCookie\u003e,\n    code: ErrorCode,\n    message: Option\u003cString\u003e,\n    data: Option\u003cbson::Bson\u003e,\n}\n\nstruct RequestSection {\n    cookie: Option\u003cRequestCookie\u003e,\n    namespace: String,\n    function: String,\n    version: i32,\n    arguments: bson::document::Document,\n}\n\n#[repr(i32)]\n#[derive(Debug, PartialEq)]\nenum RequestState {\n    Pending = 0i32,\n    Complete = 1i32,\n}\n\nstruct ResponseSection {\n    cookie: RequestCookie,\n    state: RequestState,\n    result: Option\u003cbson::Bson\u003e,\n}\n\nimpl TryFrom\u003cbson::document::Document\u003e for Section {\n    type Error = ErrorCode;\n\n    fn try_from(\n        value: bson::document::Document,\n    ) -\u003e Result\u003cSelf, \u003cSelf as TryFrom\u003cbson::document::Document\u003e\u003e::Error\u003e {\n        match value.get_i32(\"id\") {\n            Ok(ERROR_SECTION_ID) =\u003e Ok(Section::Error(ErrorSection::try_from(value)?)),\n            Ok(REQUEST_SECTION_ID) =\u003e Ok(Section::Request(RequestSection::try_from(value)?)),\n            Ok(RESPONSE_SECTION_ID) =\u003e Ok(Section::Response(ResponseSection::try_from(value)?)),\n            Ok(_) =\u003e Err(ErrorCode::SectionIdUnknown),\n            Err(_) =\u003e Err(ErrorCode::SectionParseFailed),\n        }\n    }\n}\n\nimpl From\u003cSection\u003e for bson::document::Document {\n    fn from(value: Section) -\u003e bson::document::Document {\n        match value {\n            Section::Error(section) =\u003e bson::document::Document::from(section),\n            Section::Request(section) =\u003e bson::document::Document::from(section),\n            Section::Response(section) =\u003e bson::document::Document::from(section),\n        }\n    }\n}\n\nimpl TryFrom\u003cbson::document::Document\u003e for ErrorSection {\n    type Error = ErrorCode;\n\n    fn try_from(value: bson::document::Document) -\u003e Result\u003cSelf, Self::Error\u003e {\n        let mut value = value;\n\n        let cookie = match value.get_i64(\"cookie\") {\n            Ok(cookie) =\u003e Some(cookie),\n            Err(ValueAccessError::NotPresent) =\u003e None,\n            Err(_) =\u003e return Err(ErrorCode::SectionParseFailed),\n        };\n\n        let code = match value.get_i32(\"code\") {\n            Ok(code) =\u003e ErrorCode::from(code),\n            Err(_) =\u003e return Err(ErrorCode::SectionParseFailed),\n        };\n\n        let message = match value.get_str(\"message\") {\n            Ok(message) =\u003e Some(message.to_string()),\n            Err(ValueAccessError::NotPresent) =\u003e None,\n            Err(_) =\u003e return Err(ErrorCode::SectionParseFailed),\n        };\n\n        let data = value.get_mut(\"data\").map(std::mem::take);\n\n        Ok(ErrorSection {\n            cookie,\n            code,\n            message,\n            data,\n        })\n    }\n}\n\nimpl From\u003cErrorSection\u003e for bson::document::Document {\n    fn from(value: ErrorSection) -\u003e bson::document::Document {\n        let mut error_section = bson::document::Document::new();\n        error_section.insert(\"id\", ERROR_SECTION_ID);\n\n        if let Some(cookie) = value.cookie {\n            error_section.insert(\"cookie\", cookie);\n        }\n\n        error_section.insert(\"code\", Into::\u003ci32\u003e::into(value.code));\n\n        if let Some(message) = value.message {\n            error_section.insert(\"message\", message);\n        }\n\n        if let Some(data) = value.data {\n            error_section.insert(\"data\", data);\n        }\n\n        error_section\n    }\n}\n\nimpl TryFrom\u003cbson::document::Document\u003e for RequestSection {\n    type Error = ErrorCode;\n\n    fn try_from(value: bson::document::Document) -\u003e Result\u003cSelf, Self::Error\u003e {\n        let mut value = value;\n\n        let cookie = match value.get_i64(\"cookie\") {\n            Ok(cookie) =\u003e Some(cookie),\n            Err(ValueAccessError::NotPresent) =\u003e None,\n            Err(_) =\u003e return Err(ErrorCode::SectionParseFailed),\n        };\n\n        let namespace = match value.get_str(\"namespace\") {\n            Ok(namespace) =\u003e namespace.to_string(),\n            Err(ValueAccessError::NotPresent) =\u003e String::default(),\n            Err(_) =\u003e return Err(ErrorCode::SectionParseFailed),\n        };\n\n        let function = match value.get_str(\"function\") {\n            Ok(function) =\u003e {\n                if function.is_empty() {\n                    return Err(ErrorCode::RequestFunctionInvalid);\n                } else {\n                    function.to_string()\n                }\n            }\n            Err(_) =\u003e return Err(ErrorCode::SectionParseFailed),\n        };\n\n        let version = match value.get_i32(\"version\") {\n            Ok(version) =\u003e version,\n            Err(ValueAccessError::NotPresent) =\u003e 0i32,\n            Err(_) =\u003e return Err(ErrorCode::SectionParseFailed),\n        };\n\n        let arguments = match value.get_document_mut(\"arguments\") {\n            Ok(arguments) =\u003e std::mem::take(arguments),\n            Err(ValueAccessError::NotPresent) =\u003e bson::document::Document::new(),\n            Err(_) =\u003e return Err(ErrorCode::SectionParseFailed),\n        };\n\n        Ok(RequestSection {\n            cookie,\n            namespace,\n            function,\n            version,\n            arguments,\n        })\n    }\n}\n\nimpl From\u003cRequestSection\u003e for bson::document::Document {\n    fn from(value: RequestSection) -\u003e bson::document::Document {\n        let mut request_section = bson::document::Document::new();\n        request_section.insert(\"id\", REQUEST_SECTION_ID);\n\n        if let Some(cookie) = value.cookie {\n            request_section.insert(\"cookie\", cookie);\n        }\n\n        if !value.namespace.is_empty() {\n            request_section.insert(\"namespace\", value.namespace);\n        }\n\n        request_section.insert(\"function\", value.function);\n\n        if value.version != 0i32 {\n            request_section.insert(\"version\", value.version);\n        }\n\n        request_section.insert(\"arguments\", value.arguments);\n\n        request_section\n    }\n}\n\nimpl TryFrom\u003cbson::document::Document\u003e for ResponseSection {\n    type Error = ErrorCode;\n\n    fn try_from(value: bson::document::Document) -\u003e Result\u003cSelf, Self::Error\u003e {\n        let mut value = value;\n        let cookie = match value.get_i64(\"cookie\") {\n            Ok(cookie) =\u003e cookie,\n            Err(_) =\u003e return Err(ErrorCode::SectionParseFailed),\n        };\n\n        let state = match value.get_i32(\"state\") {\n            Ok(0i32) =\u003e RequestState::Pending,\n            Ok(1i32) =\u003e RequestState::Complete,\n            Ok(_) =\u003e return Err(ErrorCode::ResponseStateInvalid),\n            Err(_) =\u003e return Err(ErrorCode::SectionParseFailed),\n        };\n\n        let result = value.get_mut(\"result\").map(std::mem::take);\n\n        // if pending there should be no result\n        if state == RequestState::Pending \u0026\u0026 result.is_some() {\n            return Err(ErrorCode::SectionParseFailed);\n        }\n\n        Ok(ResponseSection {\n            cookie,\n            state,\n            result,\n        })\n    }\n}\n\nimpl From\u003cResponseSection\u003e for bson::document::Document {\n    fn from(value: ResponseSection) -\u003e bson::document::Document {\n        let mut response_section = bson::document::Document::new();\n        response_section.insert(\"id\", RESPONSE_SECTION_ID);\n\n        response_section.insert(\"cookie\", value.cookie);\n        response_section.insert(\"state\", value.state as i32);\n\n        if let Some(result) = value.result {\n            response_section.insert(\"result\", result);\n        }\n\n        response_section\n    }\n}\n\n/// The `ApiSet` trait represents a set of APIs that can be remotely invoked by a connecting Honk-RPC client.\n/// # Example\n/// This exampe `ApiSet` implements two methods, `example::println()` and `example::async_println()`. The\n/// `println()` method immediatley prints, whereas `async_println()` queues request and\n/// prints the messagge at a later date via `update()`\n///\n/// ```rust\n/// # use honk_rpc::honk_rpc::*;\n/// # use std::collections::VecDeque;\n///\n/// const RUNTIME_ERROR_INVALID_ARG: ErrorCode = ErrorCode::Runtime(1i32);\n///\n/// struct PrintlnApiSet {\n///     // queued print reuests\n///     async_println_work: Vec\u003c(Option\u003cRequestCookie\u003e, String)\u003e,\n///     // successful async requests\n///     async_println_cookies: VecDeque\u003cRequestCookie\u003e,\n/// }\n///\n/// impl PrintlnApiSet {\n///   // prints message immediately\n///   fn println_0(\n///       \u0026mut self,\n///       mut args: bson::document::Document,\n///   ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n///     if let Some(bson::Bson::String(val)) = args.get_mut(\"val\") {\n///         println!(\"example::echo_0(val): '{}'\", val);\n///         Some(Ok(Some(bson::Bson::String(std::mem::take(val)))))\n///     } else {\n///         Some(Err(RUNTIME_ERROR_INVALID_ARG))\n///     }\n///   }\n///\n///   // queues message up for printing later\n///   fn async_println_0(\n///       \u0026mut self,\n///       request_cookie: Option\u003cRequestCookie\u003e,\n///       mut args: bson::document::Document,\n///   ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e{\n///     if let Some(bson::Bson::String(val)) = args.get_mut(\"val\") {\n///         self.async_println_work.push((request_cookie, std::mem::take(val)));\n///         None\n///     } else {\n///         Some(Err(RUNTIME_ERROR_INVALID_ARG))\n///     }\n///   }\n/// }\n///\n/// impl ApiSet for PrintlnApiSet {\n///     fn namespace(\u0026self) -\u003e \u0026str {\n///         \"example\"\n///     }\n///\n///     // handles and routes requests for `println` and `async_println`\n///     fn exec_function(\n///         \u0026mut self,\n///         name: \u0026str,\n///         version: i32,\n///         args: bson::document::Document,\n///         request_cookie: Option\u003cRequestCookie\u003e,\n///     ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n///         match (name, version) {\n///             (\"println\", 0) =\u003e self.println_0(args),\n///             (\"async_println\", 0) =\u003e self.async_println_0(request_cookie, args),\n///             (name, version) =\u003e {\n///                 println!(\"received {{ name: '{}', version: {} }}\", name, version);\n///                 Some(Err(ErrorCode::RequestFunctionInvalid))\n///             }\n///         }\n///     }\n///\n///     // handles queued `async_println` requests\n///     fn update(\u0026mut self) {\n///         for ((cookie, val)) in self.async_println_work.drain(..) {\n///             println!(\"{}\", val);\n///             if let Some(cookie) = cookie {\n///                 self.async_println_cookies.push_back(cookie);\n///             }\n///         }\n///     }\n///\n///     // finally return queued async results\n///     fn next_result(\u0026mut self) -\u003e Option\u003c(RequestCookie, Result\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e)\u003e {\n///         if let Some(cookie) = self.async_println_cookies.pop_front() {\n///             Some((cookie, Ok(None)))\n///         } else {\n///             None\n///         }\n///     }\n/// }\n///```\n\npub trait ApiSet {\n    /// Returns the namespace of this `ApiSet`.\n    fn namespace(\u0026self) -\u003e \u0026str;\n\n    /// Schedules the execution of the requested remote procedure call. Calls to this\n    /// function map directly to a received Honk-RPC request. Each request has the\n    /// following parameters:\n    /// - `name`: The name of the function to execute.\n    /// - `version`: The version of the function to execute.\n    /// - `args`: The arguments to pass to the function.\n    /// - `request_cookie`: An optional cookie to track the request.\n    ///\n    /// This function handles both synchronous and asynchronous requests. The possible\n    /// return values for each are:\n    /// - Synchronous requests may execute and signal success by returning `Some(Ok(..))`.\n    /// - Synchronous requests may execute and signal failure by returning `Some(Err(..))`.\n    /// - Asynchronous requests must defer execution by returning `None`.\n    fn exec_function(\n        \u0026mut self,\n        name: \u0026str,\n        version: i32,\n        args: bson::document::Document,\n        request_cookie: Option\u003cRequestCookie\u003e,\n    ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e;\n\n    /// Updates any internal state required to make forward progress on any requested\n    /// remote procedure calls. Implementation of this method is optional and not needed\n    /// if the implementor does not have any async functions. If left unimplemented, this\n    /// function is a no-op.\n    fn update(\u0026mut self) {}\n\n    /// Returns the result of any in-flight asynchronous requests.\n    /// - Asynchronous requests may signal success by returning `Some((cookie, Ok(..)))`\n    /// - Asynchronous requests may signal failure by returning `Some((cookie, Err(..)))`\n    /// - returns None if no asynchronous results are available\n    ///\n    /// This method is optional and not needed if the implementor does not have any async\n    /// functions, in which case the default implementation will return `None`.\n    fn next_result(\u0026mut self) -\u003e Option\u003c(RequestCookie, Result\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e)\u003e {\n        None\n    }\n}\n\n/// Represents the response to a client request.\npub enum Response {\n    /// A pending response, indicating that the request is still being processed.\n    Pending {\n        /// The cookie associated with the request.\n        cookie: RequestCookie,\n    },\n    /// A successful response, containing the result of the request.\n    Success {\n        /// The cookie associated with the request.\n        cookie: RequestCookie,\n        /// The result of the request.\n        result: Option\u003cbson::Bson\u003e,\n    },\n    /// An error response, containing the error code.\n    Error {\n        /// The cookie associated with the request.\n        cookie: RequestCookie,\n        /// The error code indicating the type of error that occurred.\n        error_code: ErrorCode,\n    },\n}\n\n// 4 kilobytes per specification\n/// The default maximum allowed Honk-RPC message (4096 bytes)\npub const DEFAULT_MAX_MESSAGE_SIZE: usize = 4 * 1024;\n/// The default maximum allowed duration between Honk-RPC (60 seconds)\npub const DEFAULT_MAX_WAIT_TIME: std::time::Duration = std::time::Duration::from_secs(60);\n\n// Base Message Bson Format\n// document size             4 (sizeof i32 )\nconst HEADER_SIZE: usize = 4usize;\n// \"honk_rpc\" : i32          1 (0x10) + 8 (strlen \"honk_rpc\") + 1 (null) + 4 (sizeof i32)\nconst HONK_RPC_SIZE: usize = 14usize;\n// \"sections\" : {\"0\": Null}  1 (0x04) + 8 (strlen \"sections\") + 1 (null) + 4 (sizeof i32) + 1 (0x0a) + 1 (strlen \"0\") + 1 (null) + 1 (0x00)\nconst SECTIONS_SIZE: usize = 18usize;\n// footer                    1 (0x00)\nconst FOOTER_SIZE: usize = 1usize;\n\n// The honk-rpc message overhead before the content of a single section is added\nconst MIN_MESSAGE_SIZE: usize = HEADER_SIZE + HONK_RPC_SIZE + SECTIONS_SIZE + FOOTER_SIZE;\n\n/// Computes the overhead of the Honk-RPC message type. This method in conjunction with\n/// the other `get_*_section_size(..)` functions can be used to compute the size of a\n/// Honk-RPC message with exactly one section.\npub fn get_message_overhead() -\u003e Result\u003cusize, Error\u003e {\n    // construct an example empty message; the size of a real message with\n    // one section can be calculated as the sizeof(message) + sizeof(section)\n    let message = doc! {\n        \"honk_rpc\" : HONK_RPC_VERSION,\n        \"sections\" : [\n            bson::Bson::Null\n        ]\n    };\n\n    let mut counter: ByteCounter = Default::default();\n    message\n        .to_writer(\u0026mut counter)\n        .map_err(Error::BsonWriteFailed)?;\n\n    Ok(counter.bytes())\n}\n\n/// Computes the required size of a Honk-RPC error section in bytes.\n///\n/// Returns the size of the BSON-encoded error section. If BSON encoding fails,\n/// an `Error::BsonWriteFailed` is returned.\npub fn get_error_section_size(\n    cookie: Option\u003cRequestCookie\u003e,\n    message: Option\u003cString\u003e,\n    data: Option\u003cbson::Bson\u003e,\n) -\u003e Result\u003cusize, Error\u003e {\n    let mut error_section = doc! {\n        \"id\": ERROR_SECTION_ID,\n        \"code\": Into::\u003ci32\u003e::into(ErrorCode::Unknown(0)),\n    };\n\n    if let Some(cookie) = cookie {\n        error_section.insert(\"cookie\", bson::Bson::Int64(cookie));\n    }\n\n    if let Some(message) = message {\n        error_section.insert(\"message\", bson::Bson::String(message));\n    }\n\n    if let Some(data) = data {\n        error_section.insert(\"data\", data);\n    }\n\n    let mut counter: ByteCounter = Default::default();\n    error_section\n        .to_writer(\u0026mut counter)\n        .map_err(Error::BsonWriteFailed)?;\n\n    Ok(counter.bytes())\n}\n\n/// Computes the required size of a Honk-RPC requests section in bytes.\n///\n/// Returns the size of the BSON-encoded request section. If BSON encoding fails,\n/// an `Error::BsonWriteFailed` is returned.\npub fn get_request_section_size(\n    cookie: Option\u003cRequestCookie\u003e,\n    namespace: Option\u003cString\u003e,\n    function: String,\n    version: Option\u003ci32\u003e,\n    arguments: Option\u003cbson::Document\u003e,\n) -\u003e Result\u003cusize, Error\u003e {\n    let mut request_section = doc! {\n        \"id\": REQUEST_SECTION_ID,\n        \"function\": bson::Bson::String(function),\n    };\n\n    if let Some(cookie) = cookie {\n        request_section.insert(\"cookie\", bson::Bson::Int64(cookie));\n    }\n\n    if let Some(namespace) = namespace {\n        request_section.insert(\"namespace\", bson::Bson::String(namespace));\n    }\n\n    if let Some(version) = version {\n        request_section.insert(\"version\", bson::Bson::Int32(version));\n    }\n\n    if let Some(arguments) = arguments {\n        request_section.insert(\"arguments\", arguments);\n    }\n\n    let mut counter: ByteCounter = Default::default();\n    request_section\n        .to_writer(\u0026mut counter)\n        .map_err(Error::BsonWriteFailed)?;\n\n    Ok(counter.bytes())\n}\n\n/// Computes the required size of a Honk-RPC response section in bytes.\n///\n/// Returns the size of the BSON-encoded response section. If BSON encoding fails,\n/// an `Error::BsonWriteFailed` is returned.\npub fn get_response_section_size(result: Option\u003cbson::Bson\u003e) -\u003e Result\u003cusize, Error\u003e {\n    let mut response_section = doc! {\n        \"id\": RESPONSE_SECTION_ID,\n        \"cookie\": bson::Bson::Int64(0),\n        \"state\": bson::Bson::Int32(0),\n    };\n\n    if let Some(result) = result {\n        response_section.insert(\"result\", result);\n    }\n\n    let mut counter: ByteCounter = Default::default();\n    response_section\n        .to_writer(\u0026mut counter)\n        .map_err(Error::BsonWriteFailed)?;\n\n    Ok(counter.bytes())\n}\n\n/// The object that handles the communication between two endpoints  using the\n/// Honk-RPC protocol. Provides methods for setting and getting configuration\n/// parameters, reading and processing message documents, and handling API\n/// requests and responses.\npub struct Session\u003cRW\u003e {\n    // read-write stream\n    stream: RW,\n    // we write outgoing data to an intermediate buffer to handle writer blocking\n    message_write_buffer: VecDeque\u003cu8\u003e,\n\n    // message read data\n\n    // remaining number of bytes to read for current message\n    // if None, no message read is in progress\n    remaining_byte_count: Option\u003cusize\u003e,\n    // data we've read but not yet a full Message object\n    message_read_buffer: Vec\u003cu8\u003e,\n    // received sections to be handled\n    pending_sections: VecDeque\u003cSection\u003e,\n    // remote client's inbound remote procedure calls to local server\n    inbound_requests: Vec\u003cRequestSection\u003e,\n    // remote server's responses to local client's remote procedure calls\n    inbound_responses: VecDeque\u003cResponse\u003e,\n\n    // message write data\n\n    // we serialize outgoing messages to this buffer first to verify size limitations\n    message_serialization_buffer: VecDeque\u003cu8\u003e,\n    // the next request cookie to use when making a remote prodedure call\n    next_cookie: RequestCookie,\n    // sections to be sent to the remote server\n    outbound_sections: Vec\u003cbson::Document\u003e,\n\n    // the maximum size of a message we've agreed to allow in the session\n    max_message_size: usize,\n    // the maximum amount of time the session is willing to wait to receive a message\n    // before terminating the session\n    max_wait_time: std::time::Duration,\n    // last time a new message read began\n    read_timestamp: std::time::Instant,\n}\n\n#[allow(dead_code)]\nimpl\u003cRW\u003e Session\u003cRW\u003e\nwhere\n    RW: std::io::Read + std::io::Write + Send,\n{\n    /// Sets the maximum message size this `Session` is willing to read from from the underlying `RW`. Attempted reads  will abort if the next bson document's `i32` size field is greater than the `max_message_size` defined in this function.\n    pub fn set_max_message_size(\u0026mut self, max_message_size: i32) -\u003e Result\u003c(), Error\u003e {\n        if max_message_size \u003c MIN_MESSAGE_SIZE as i32 {\n            // base size of a honk-rpc mssage\n            Err(Error::InvalidMaxMesageSize())\n        } else {\n            self.max_message_size = max_message_size as usize;\n            Ok(())\n        }\n    }\n\n    /// Gets the maximum allowed message size this `Session` is willing to read from the underlying `RW`. The default value is 4096 bytes.\n    pub fn get_max_message_size(\u0026self) -\u003e usize {\n        self.max_message_size\n    }\n\n    /// Sets the maximum amount of time this `Session` is willing to wait for a new Honk-RPC message on the underlying `RW`. `Session` updates will fil after `max_wait_time` has elapsed without receiving any new Honk-RPC message documents.\n    pub fn set_max_wait_time(\u0026mut self, max_wait_time: std::time::Duration) {\n        self.max_wait_time = max_wait_time;\n    }\n\n    /// Gets the maximum amount this `Session` is willing to wait for a new Honk-RPC message. The default value is 60 seconds.\n    pub fn get_max_wait_time(\u0026self) -\u003e std::time::Duration {\n        self.max_wait_time\n    }\n\n    /// Creates a new `Session` using the given `stream`.\n    pub fn new(stream: RW) -\u003e Self {\n        let mut message_write_buffer: VecDeque\u003cu8\u003e = Default::default();\n        message_write_buffer.reserve(DEFAULT_MAX_MESSAGE_SIZE);\n\n        let mut message_serialization_buffer: VecDeque\u003cu8\u003e = Default::default();\n        message_serialization_buffer.reserve(DEFAULT_MAX_MESSAGE_SIZE);\n\n        Session {\n            stream,\n            message_write_buffer,\n            remaining_byte_count: None,\n            message_read_buffer: Default::default(),\n            pending_sections: Default::default(),\n            inbound_requests: Default::default(),\n            inbound_responses: Default::default(),\n            message_serialization_buffer,\n            next_cookie: Default::default(),\n            outbound_sections: Default::default(),\n            max_message_size: DEFAULT_MAX_MESSAGE_SIZE,\n            max_wait_time: DEFAULT_MAX_WAIT_TIME,\n            read_timestamp: std::time::Instant::now(),\n        }\n    }\n\n    /// Consumes the `Session` and returns the underlying stream.\n    pub fn into_stream(self) -\u003e RW {\n        self.stream\n    }\n\n    // read a block of bytes from the undelrying stream\n    fn stream_read(\u0026mut self, buffer: \u0026mut [u8]) -\u003e Result\u003cusize, Error\u003e {\n        match self.stream.read(buffer) {\n            Err(err) =\u003e {\n                if err.kind() == ErrorKind::WouldBlock || err.kind() == ErrorKind::TimedOut {\n                    // abort if we've gone too long without a new message\n                    if std::time::Instant::now().duration_since(self.read_timestamp)\n                        \u003e self.max_wait_time\n                    {\n                        Err(Error::MessageReadTimedOut(self.max_wait_time))\n                    } else {\n                        Ok(0)\n                    }\n                } else {\n                    Err(Error::ReaderReadFailed(err))\n                }\n            }\n            Ok(0) =\u003e Err(Error::ReaderReadFailed(std::io::Error::from(\n                ErrorKind::UnexpectedEof,\n            ))),\n            Ok(count) =\u003e {\n                // update read_timestamp\n                self.read_timestamp = std::time::Instant::now();\n                Ok(count)\n            }\n        }\n    }\n\n    // read the next block of bytes as a bson document size header\n    fn read_message_size(\u0026mut self) -\u003e Result\u003c(), Error\u003e {\n        match self.remaining_byte_count {\n            // we've already read the size header\n            Some(_remaining) =\u003e Ok(()),\n            // still need to read the size header\n            None =\u003e {\n                // may have been partially read already so ensure it's the right size\n                assert!(self.message_read_buffer.len() \u003c std::mem::size_of::\u003ci32\u003e());\n                let bytes_needed = std::mem::size_of::\u003ci32\u003e() - self.message_read_buffer.len();\n                // ensure we have enough space for an entire int32\n                let mut buffer = [0u8; std::mem::size_of::\u003ci32\u003e()];\n                // but shrink view down to number of bytes remaining\n                let buffer = \u0026mut buffer[0..bytes_needed];\n                match self.stream_read(buffer) {\n                    Err(err) =\u003e Err(err),\n                    Ok(0) =\u003e Ok(()),\n                    Ok(count) =\u003e {\n                        #[cfg(test)]\n                        println!(\"\u003c\u003c\u003c read {} bytes for message header\", count);\n                        self.message_read_buffer\n                            .extend_from_slice(\u0026buffer[0..count]);\n\n                        // all bytes required for i32 message size have been read\n                        if self.message_read_buffer.len() == std::mem::size_of::\u003ci32\u003e() {\n                            let size = \u0026self.message_read_buffer.as_slice();\n                            let size: i32 = (size[0] as i32)\n                                | (size[1] as i32) \u003c\u003c 8\n                                | (size[2] as i32) \u003c\u003c 16\n                                | (size[3] as i32) \u003c\u003c 24;\n                            // size should be at least larger than the bytes required for size header\n                            if size \u003c= std::mem::size_of::\u003ci32\u003e() as i32 {\n                                return Err(Error::BsonDocumentSizeTooSmall(size));\n                            }\n                            // convert to usize type now that we know it's not negative\n                            if size as usize \u003e self.max_message_size {\n                                return Err(Error::BsonDocumentSizeTooLarge(\n                                    size,\n                                    self.max_message_size as i32,\n                                ));\n                            }\n\n                            // deduct size of i32 header and save\n                            let size = size as usize - std::mem::size_of::\u003ci32\u003e();\n\n                            self.remaining_byte_count = Some(size);\n                        }\n                        Ok(())\n                    }\n                }\n            }\n        }\n    }\n\n    // read the remainder of a bson message\n    fn read_message(\u0026mut self) -\u003e Result\u003cOption\u003cMessage\u003e, Error\u003e {\n        // update remaining bytes to read for message\n        self.read_message_size()?;\n        // read the message bytes\n        if let Some(remaining) = self.remaining_byte_count {\n            #[cfg(test)]\n            println!(\"--- message requires {} more bytes\", remaining);\n\n            let mut buffer = vec![0u8; remaining];\n            match self.stream_read(\u0026mut buffer) {\n                Err(err) =\u003e Err(err),\n                Ok(0) =\u003e Ok(None),\n                Ok(count) =\u003e {\n                    #[cfg(test)]\n                    println!(\"\u003c\u003c\u003c read {} bytes\", count);\n                    // append read bytes\n                    self.message_read_buffer\n                        .extend_from_slice(\u0026buffer[0..count]);\n                    if remaining == count {\n                        self.remaining_byte_count = None;\n\n                        let mut cursor = Cursor::new(std::mem::take(\u0026mut self.message_read_buffer));\n                        let bson = bson::document::Document::from_reader(\u0026mut cursor)\n                            .map_err(Error::BsonDocumentParseFailed)?;\n\n                        // take back our allocated vec and clear it\n                        self.message_read_buffer = cursor.into_inner();\n                        self.message_read_buffer.clear();\n\n                        #[cfg(test)]\n                        println!(\"\u003c\u003c\u003c read message: {}\", bson);\n\n                        Ok(Some(\n                            Message::try_from(bson).map_err(Error::MessageConversionFailed)?,\n                        ))\n                    } else {\n                        // update the remaining byte count\n                        self.remaining_byte_count = Some(remaining - count);\n                        Ok(None)\n                    }\n                }\n            }\n        } else {\n            Ok(None)\n        }\n    }\n\n    // read and save of available sections\n    fn read_sections(\u0026mut self) -\u003e Result\u003c(), Error\u003e {\n        loop {\n            match self.read_message() {\n                Ok(Some(mut message)) =\u003e {\n                    self.pending_sections.extend(message.sections.drain(..));\n                }\n                Ok(None) =\u003e return Ok(()),\n                Err(err) =\u003e {\n                    match err {\n                        // in the event of timeouts and IO errors we finish any remaining work\n                        Error::MessageReadTimedOut(_) | Error::ReaderReadFailed(_) =\u003e {\n                            // ensure no pending items to handle\n                            if self.pending_sections.is_empty() \u0026\u0026 self.inbound_responses.is_empty()\n                            {\n                                return Err(err);\n                            }\n                            return Ok(());\n                        }\n                        // all other errors we terminate\n                        _ =\u003e return Err(err),\n                    }\n                }\n            }\n        }\n    }\n\n    // route read sections to client and server buffers\n    fn process_sections(\u0026mut self) -\u003e Result\u003c(), Error\u003e {\n        while let Some(section) = self.pending_sections.pop_front() {\n            match section {\n                Section::Error(error) =\u003e {\n                    if let Some(cookie) = error.cookie {\n                        // error in response to a request\n                        self.inbound_responses.push_back(Response::Error {\n                            cookie,\n                            error_code: error.code,\n                        });\n                    } else {\n                        return Err(Error::UnknownErrorSectionReceived(error.code));\n                    }\n                }\n                Section::Request(request) =\u003e {\n                    // request to route to our apisets\n                    self.inbound_requests.push(request);\n                }\n                Section::Response(response) =\u003e {\n                    // response to our client\n\n                    match (response.cookie, response.state, response.result) {\n                        (cookie, RequestState::Complete, result) =\u003e {\n                            self.inbound_responses\n                                .push_back(Response::Success { cookie, result });\n                        }\n                        (cookie, RequestState::Pending, _) =\u003e {\n                            self.inbound_responses\n                                .push_back(Response::Pending { cookie });\n                        }\n                    }\n                }\n            }\n        }\n\n        Ok(())\n    }\n\n    // queue outbound section for packaging into a Honk-RPC message\n    fn push_outbound_section(\u0026mut self, section: Section) -\u003e Result\u003c(), Error\u003e {\n        let max_section_size = self.max_message_size - MIN_MESSAGE_SIZE;\n\n        let mut counter: ByteCounter = Default::default();\n        let section: bson::Document = section.into();\n        section\n            .to_writer(\u0026mut counter)\n            .map_err(Error::BsonWriteFailed)?;\n        let section_size = counter.bytes();\n\n        if section_size \u003c= max_section_size {\n            self.outbound_sections.push(section);\n            Ok(())\n        } else {\n            Err(Error::SectionTooLarge(section_size, max_section_size))\n        }\n    }\n\n    // package outbound sections into a message, and serialize message to the message_write_buffer\n    fn serialize_messages(\u0026mut self) -\u003e Result\u003c(), Error\u003e {\n        // if no pending sections there is nothing to do\n        if self.outbound_sections.is_empty() {\n            return Ok(());\n        }\n\n        // build message and convert to bson to send\n        let message = Message {\n            honk_rpc: HONK_RPC_VERSION,\n            sections: Default::default(),\n        };\n        let mut message = bson::document::Document::from(message);\n        message.insert(\"sections\", std::mem::take(\u0026mut self.outbound_sections));\n        self.serialize_messages_impl(message)\n    }\n\n    // pack sections into messages and serialise them to buffer\n    fn serialize_messages_impl(\n        \u0026mut self,\n        mut message: bson::document::Document,\n    ) -\u003e Result\u003c(), Error\u003e {\n        self.message_serialization_buffer.clear();\n        message\n            .to_writer(\u0026mut self.message_serialization_buffer)\n            .map_err(Error::BsonWriteFailed)?;\n\n        if self.message_serialization_buffer.len() \u003e self.max_message_size {\n            // if we can't split a message anymore then we have a problem\n            let sections = message.get_array_mut(\"sections\").unwrap();\n            assert!(sections.len() \u003e 1);\n\n            let right = doc! {\n                \"honk_rpc\" : HONK_RPC_VERSION,\n                \"sections\" : sections.split_off(sections.len() / 2),\n            };\n            let left = message;\n\n            self.serialize_messages_impl(left)?;\n            self.serialize_messages_impl(right)?;\n        } else {\n            #[cfg(test)]\n            println!(\"\u003e\u003e\u003e write message: {:?}\", message);\n            // copy the serialized message into the pending write buffer\n            self.message_write_buffer\n                .append(\u0026mut self.message_serialization_buffer);\n        }\n\n        Ok(())\n    }\n\n    // write data to stream and remove from write buffer\n    fn write_pending_data(\u0026mut self) -\u003e Result\u003c(), Error\u003e {\n        let bytes_written = self.write_pending_data_impl()?;\n        self.stream.flush().map_err(Error::WriterWriteFailed)?;\n        // removes the written bytes\n        self.message_write_buffer.drain(0..bytes_written);\n        // and shuffles the data so it is contiguous\n        self.message_write_buffer.make_contiguous();\n\n        Ok(())\n    }\n\n    fn write_pending_data_impl(\u0026mut self) -\u003e Result\u003cusize, Error\u003e {\n        // write pending data\n        let (mut pending_data, empty): (\u0026[u8], \u0026[u8]) = self.message_write_buffer.as_slices();\n        assert!(empty.is_empty());\n        let pending_bytes: usize = pending_data.len();\n        let mut bytes_written: usize = 0usize;\n\n        while bytes_written != pending_bytes {\n            match self.stream.write(pending_data) {\n                Err(err) =\u003e {\n                    let kind = err.kind();\n                    if kind == ErrorKind::WouldBlock || kind == ErrorKind::TimedOut {\n                        // no *additional* bytes written so return bytes written so far\n                        return Ok(bytes_written);\n                    } else {\n                        return Err(Error::WriterWriteFailed(err));\n                    }\n                }\n                Ok(count) =\u003e {\n                    bytes_written += count;\n                    #[cfg(test)]\n                    println!(\"\u003e\u003e\u003e sent {} of {} bytes\", bytes_written, pending_bytes);\n                    pending_data = \u0026pending_data[count..];\n                }\n            }\n        }\n\n        Ok(bytes_written)\n    }\n\n    /// Read and process Honk-RPC message documents from connected peer, handle any new incoming Honk-RPC requests, update any in-progress async requests and write pending reponses, errors and requests to peer. This function must be called regularly for the `Session` to make forward progress.\n    pub fn update(\u0026mut self, apisets: Option\u003c\u0026mut [\u0026mut dyn ApiSet]\u003e) -\u003e Result\u003c(), Error\u003e {\n        // read sections from remote\n        self.read_sections()?;\n        // route sections to buffers\n        self.process_sections()?;\n\n        // handle incoming api calls\n        let apisets = apisets.unwrap_or(\u0026mut []);\n        self.handle_requests(apisets)?;\n\n        // serialize pending responses\n        self.serialize_messages()?;\n\n        // write pendng data to writer\n        self.write_pending_data()?;\n\n        Ok(())\n    }\n\n    // apisets : a slice of mutable ApiSet references sorted by their namespaces\n    fn handle_requests(\u0026mut self, apisets: \u0026mut [\u0026mut dyn ApiSet]) -\u003e Result\u003c(), Error\u003e {\n        // first handle all of our inbound requests\n        let mut inbound_requests = std::mem::take(\u0026mut self.inbound_requests);\n        for mut request in inbound_requests.drain(..) {\n            if let Ok(idx) =\n                apisets.binary_search_by(|probe| probe.namespace().cmp(\u0026request.namespace))\n            {\n                let apiset = match apisets.get_mut(idx) {\n                    Some(apiset) =\u003e apiset,\n                    None =\u003e unreachable!(),\n                };\n                match apiset.exec_function(\n                    \u0026request.function,\n                    request.version,\n                    std::mem::take(\u0026mut request.arguments),\n                    request.cookie,\n                ) {\n                    // func found, invoked and succeeded\n                    Some(Ok(result)) =\u003e {\n                        if let Some(cookie) = request.cookie {\n                            self.push_outbound_section(Section::Response(ResponseSection {\n                                cookie,\n                                state: RequestState::Complete,\n                                result,\n                            }))?;\n                        }\n                    }\n                    // func found, invoked and failed\n                    Some(Err(error_code)) =\u003e {\n                        self.push_outbound_section(Section::Error(ErrorSection {\n                            cookie: request.cookie,\n                            code: error_code,\n                            message: None,\n                            data: None,\n                        }))?;\n                    }\n                    // func found, called, and result is pending\n                    None =\u003e {\n                        if let Some(cookie) = request.cookie {\n                            self.push_outbound_section(Section::Response(ResponseSection {\n                                cookie,\n                                state: RequestState::Pending,\n                                result: None,\n                            }))?;\n                        }\n                    }\n                }\n            } else {\n                // invalid namespace\n                self.push_outbound_section(Section::Error(ErrorSection {\n                    cookie: request.cookie,\n                    code: ErrorCode::RequestNamespaceInvalid,\n                    message: None,\n                    data: None,\n                }))?;\n            }\n        }\n\n        // next send out async responses from apisets\n        for apiset in apisets.iter_mut() {\n            // allow apiset to do any required repetitive work\n            apiset.update();\n            // put pending results in our message\n            while let Some((cookie, result)) = apiset.next_result() {\n                match (cookie, result) {\n                    // function completed successfully\n                    (cookie, Ok(result)) =\u003e {\n                        self.push_outbound_section(Section::Response(ResponseSection {\n                            cookie,\n                            state: RequestState::Complete,\n                            result,\n                        }))?;\n                    }\n                    // function completed with failure\n                    (cookie, Err(error_code)) =\u003e {\n                        self.push_outbound_section(Section::Error(ErrorSection {\n                            cookie: Some(cookie),\n                            code: error_code,\n                            message: None,\n                            data: None,\n                        }))?;\n                    }\n                }\n            }\n        }\n        Ok(())\n    }\n\n    /// Performs a client call to a remote function. Returns a `RequestCookie` to associate this client call with a future `Response`.\n    pub fn client_call(\n        \u0026mut self,\n        namespace: \u0026str,\n        function: \u0026str,\n        version: i32,\n        arguments: bson::document::Document,\n    ) -\u003e Result\u003cRequestCookie, Error\u003e {\n        // always make sure we have a new cookie\n        let cookie = self.next_cookie;\n        self.next_cookie += 1;\n\n        // add request to outgoing buffer\n        self.push_outbound_section(Section::Request(RequestSection {\n            cookie: Some(cookie),\n            namespace: namespace.to_string(),\n            function: function.to_string(),\n            version,\n            arguments,\n        }))?;\n\n        Ok(cookie)\n    }\n\n    /// Drains all `Response` objects resulting from prevoius invocations of `Session::client_call()`\n    pub fn client_drain_responses(\u0026mut self) -\u003e std::collections::vec_deque::Drain\u003cResponse\u003e {\n        self.inbound_responses.drain(..)\n    }\n\n    /// Retrieves the next `Response` object from previous invocations of `Session::client_call()`\n    pub fn client_next_response(\u0026mut self) -\u003e Option\u003cResponse\u003e {\n        self.inbound_responses.pop_front()\n    }\n}\n\n#[test]\nfn test_honk_client_read_write() -\u003e anyhow::Result\u003c()\u003e {\n    let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n    let listener = TcpListener::bind(socket_addr)?;\n    let socket_addr = listener.local_addr()?;\n\n    let stream1 = TcpStream::connect(socket_addr)?;\n    stream1.set_nonblocking(true)?;\n    let (stream2, _socket_addr) = listener.accept()?;\n    stream2.set_nonblocking(true)?;\n\n    let mut alice = Session::new(stream1);\n    let mut pat = Session::new(stream2);\n\n    println!(\"--- pat reads message, but none has been sent\");\n\n    // no message sent yet\n    assert!(pat.read_message()?.is_none());\n\n    println!(\"--- alice sends no message, but no pending sections so no message sent\");\n\n    // send an empty message\n    alice.serialize_messages()?;\n    alice.write_pending_data()?;\n\n    println!(\"--- pat reads message, but none has been sent\");\n\n    // ensure no mesage as actually sent\n    match pat.read_message() {\n        Ok(Some(msg)) =\u003e panic!(\n            \"message should not have been sent: {}\",\n            bson::document::Document::from(msg)\n        ),\n        Ok(None) =\u003e {}\n        Err(err) =\u003e panic!(\"{:?}\", err),\n    }\n\n    println!(\"--- pat sends an error message\");\n\n    const CUSTOM_ERROR: \u0026str = \"Custom Error!\";\n\n    pat.push_outbound_section(Section::Error(ErrorSection {\n        cookie: Some(42069),\n        code: ErrorCode::Runtime(1),\n        message: Some(CUSTOM_ERROR.to_string()),\n        data: None,\n    }))?;\n\n    pat.serialize_messages()?;\n    pat.write_pending_data()?;\n\n    println!(\"--- alice reads and verifies message\");\n\n    // wait for alice to receive message\n    let mut alice_read_message: bool = false;\n    while !alice_read_message {\n        // println!(\"reading...\");\n        if let Some(mut msg) = alice.read_message()? {\n            assert_eq!(msg.sections.len(), 1);\n            match msg.sections.pop() {\n                Some(Section::Error(section)) =\u003e {\n                    match (section.cookie, section.code, section.message) {\n                        (Some(42069), ErrorCode::Runtime(1), Some(message)) =\u003e {\n                            assert_eq!(message, CUSTOM_ERROR);\n                            alice_read_message = true;\n                        }\n                        (cookie, code, message) =\u003e panic!(\n                            \"unexpected error section: cookie: {:?}, code: {:?}, message: {:?}\",\n                            cookie, code, message\n                        ),\n                    };\n                }\n                Some(_) =\u003e panic!(\"was expecting an Error section\"),\n                None =\u003e panic!(\"we should have a message\"),\n            }\n        }\n    }\n\n    println!(\"--- alice sends multi-section message\");\n\n    alice.push_outbound_section(Section::Error(ErrorSection {\n        cookie: Some(42069),\n        code: ErrorCode::Runtime(2),\n        message: Some(CUSTOM_ERROR.to_string()),\n        data: None,\n    }))?;\n    alice.push_outbound_section(Section::Request(RequestSection {\n        cookie: None,\n        namespace: \"std\".to_string(),\n        function: \"print\".to_string(),\n        version: 0,\n        arguments: doc! {\"message\": \"hello!\"},\n    }))?;\n    alice.push_outbound_section(Section::Response(ResponseSection {\n        cookie: 123456,\n        state: RequestState::Pending,\n        result: None,\n    }))?;\n\n    // send a multi-section mesage\n    alice.serialize_messages()?;\n    alice.write_pending_data()?;\n\n    println!(\"--- pat reads and verifies multi-section message\");\n\n    // read sections sent to pat\n    let mut pat_read_message: bool = false;\n    while !pat_read_message {\n        if let Some(msg) = pat.read_message()? {\n            assert_eq!(msg.sections.len(), 3);\n            for section in msg.sections.iter() {\n                match section {\n                    Section::Error(section) =\u003e {\n                        assert_eq!(section.cookie, Some(42069));\n                        assert_eq!(section.code, ErrorCode::Runtime(2));\n                        assert_eq!(section.message, Some(CUSTOM_ERROR.to_string()));\n                        assert_eq!(section.data, None);\n                    }\n                    Section::Request(section) =\u003e {\n                        assert_eq!(section.cookie, None);\n                        assert_eq!(section.namespace, \"std\");\n                        assert_eq!(section.function, \"print\");\n                        assert_eq!(section.version, 0i32);\n                    }\n                    Section::Response(section) =\u003e {\n                        assert_eq!(section.cookie, 123456);\n                        assert_eq!(section.state, RequestState::Pending);\n                        assert_eq!(section.result, None);\n                    }\n                }\n            }\n            pat_read_message = true;\n        }\n    }\n\n    Ok(())\n}\n\n#[cfg(test)]\nstruct TestApiSet {\n    call_count: usize,\n}\n\n#[cfg(test)]\nimpl ApiSet for TestApiSet {\n    fn namespace(\u0026self) -\u003e \u0026str {\n        \"namespace\"\n    }\n\n    fn exec_function(\n        \u0026mut self,\n        name: \u0026str,\n        version: i32,\n        _args: bson::document::Document,\n        _request_section: Option\u003cRequestCookie\u003e,\n    ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n        match (name, version) {\n            (\"function\", 0) =\u003e {\n                println!(\"--- namespace::function_0() called\");\n                self.call_count += 1;\n            }\n            _ =\u003e (),\n        }\n        Some(Ok(None))\n    }\n}\n\n#[test]\nfn test_honk_timeout() -\u003e anyhow::Result\u003c()\u003e {\n    let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n    let listener = TcpListener::bind(socket_addr)?;\n    let socket_addr = listener.local_addr()?;\n\n    let alice_stream = TcpStream::connect(socket_addr)?;\n    alice_stream.set_nonblocking(true)?;\n    alice_stream.set_nodelay(true)?;\n    println!(\"--- alice peer_addr: {}\", alice_stream.peer_addr()?);\n    let (pat_stream, _socket_addr) = listener.accept()?;\n    pat_stream.set_nonblocking(true)?;\n    pat_stream.set_nodelay(true)?;\n\n    let mut alice = Session::new(alice_stream);\n    let mut alice_apiset = TestApiSet { call_count: 0usize };\n    let mut pat = Session::new(pat_stream);\n\n    let start = std::time::Instant::now();\n\n    println!(\n        \"--- {:?} alice set max_wait_time to 3 seconds\",\n        std::time::Instant::now().duration_since(start)\n    );\n    alice.update(None)?;\n    alice.set_max_wait_time(std::time::Duration::from_secs(3));\n    alice.update(None)?;\n\n    // a read will happen so time should reset\n    println!(\n        \"--- {:?} sleep 2 seconds\",\n        std::time::Instant::now().duration_since(start)\n    );\n    std::thread::sleep(std::time::Duration::from_secs(2));\n\n    println!(\n        \"--- {:?} pat calls namespace::function_0()\",\n        std::time::Instant::now().duration_since(start)\n    );\n    pat.client_call(\"namespace\", \"function\", 0, doc! {})?;\n    while alice_apiset.call_count != 1 {\n        pat.update(None)?;\n        alice.update(Some(\u0026mut [\u0026mut alice_apiset]))?;\n    }\n\n    // a read will happen so time should reset\n    println!(\n        \"--- {:?} sleep 2 seconds\",\n        std::time::Instant::now().duration_since(start)\n    );\n    std::thread::sleep(std::time::Duration::from_secs(2));\n    pat.update(None)?;\n    alice.update(None)?;\n\n    println!(\n        \"--- {:?} pat calls namespace::function_0()\",\n        std::time::Instant::now().duration_since(start)\n    );\n    pat.client_call(\"namespace\", \"function\", 0, doc! {})?;\n    while alice_apiset.call_count != 2 {\n        pat.update(None)?;\n        alice.update(Some(\u0026mut [\u0026mut alice_apiset]))?;\n    }\n\n    // on reads occur so alice should timeout\n    println!(\n        \"--- {:?} sleep 4 seconds\",\n        std::time::Instant::now().duration_since(start)\n    );\n    std::thread::sleep(std::time::Duration::from_secs(4));\n\n    println!(\n        \"--- {:?} pat+alice update\",\n        std::time::Instant::now().duration_since(start)\n    );\n    pat.update(None)?;\n    match alice.update(None) {\n        Ok(()) =\u003e panic!(\"should have timed out\"),\n        Err(Error::MessageReadTimedOut(duration)) =\u003e {\n            println!(\"--- expected time out after {:?}\", duration)\n        }\n        Err(err) =\u003e panic!(\"unexpected error: {:?}\", err),\n    }\n    Ok(())\n}\n","traces":[{"line":105,"address":[16488528],"length":1,"stats":{"Line":3}},{"line":106,"address":[3178842],"length":1,"stats":{"Line":3}},{"line":107,"address":[16488589],"length":1,"stats":{"Line":0}},{"line":108,"address":[3178903],"length":1,"stats":{"Line":0}},{"line":109,"address":[16452881],"length":1,"stats":{"Line":0}},{"line":110,"address":[14401787],"length":1,"stats":{"Line":0}},{"line":111,"address":[14401797],"length":1,"stats":{"Line":0}},{"line":112,"address":[478223],"length":1,"stats":{"Line":0}},{"line":113,"address":[1707385],"length":1,"stats":{"Line":0}},{"line":114,"address":[1707395],"length":1,"stats":{"Line":0}},{"line":115,"address":[14401837],"length":1,"stats":{"Line":0}},{"line":116,"address":[14401847],"length":1,"stats":{"Line":0}},{"line":117,"address":[16488689],"length":1,"stats":{"Line":0}},{"line":118,"address":[478283],"length":1,"stats":{"Line":0}},{"line":120,"address":[1707314,1707468,1707486],"length":1,"stats":{"Line":6}},{"line":121,"address":[16488738],"length":1,"stats":{"Line":3}},{"line":123,"address":[1707456],"length":1,"stats":{"Line":0}},{"line":131,"address":[16488752],"length":1,"stats":{"Line":3}},{"line":132,"address":[16488760],"length":1,"stats":{"Line":3}},{"line":133,"address":[16488792],"length":1,"stats":{"Line":0}},{"line":134,"address":[3179109],"length":1,"stats":{"Line":0}},{"line":135,"address":[1707551],"length":1,"stats":{"Line":0}},{"line":136,"address":[1707561],"length":1,"stats":{"Line":0}},{"line":137,"address":[3179139],"length":1,"stats":{"Line":0}},{"line":138,"address":[14402013],"length":1,"stats":{"Line":0}},{"line":139,"address":[1707591],"length":1,"stats":{"Line":0}},{"line":140,"address":[478449],"length":1,"stats":{"Line":0}},{"line":141,"address":[14402043],"length":1,"stats":{"Line":0}},{"line":142,"address":[14402053],"length":1,"stats":{"Line":0}},{"line":143,"address":[16488895],"length":1,"stats":{"Line":0}},{"line":144,"address":[3179209],"length":1,"stats":{"Line":0}},{"line":145,"address":[16488915],"length":1,"stats":{"Line":3}},{"line":146,"address":[14402097],"length":1,"stats":{"Line":0}},{"line":152,"address":[14402128],"length":1,"stats":{"Line":1}},{"line":153,"address":[3179297],"length":1,"stats":{"Line":1}},{"line":154,"address":[14402191],"length":1,"stats":{"Line":0}},{"line":155,"address":[14402235],"length":1,"stats":{"Line":0}},{"line":157,"address":[16453383],"length":1,"stats":{"Line":0}},{"line":159,"address":[478745],"length":1,"stats":{"Line":0}},{"line":163,"address":[16489211],"length":1,"stats":{"Line":0}},{"line":167,"address":[16453533],"length":1,"stats":{"Line":0}},{"line":172,"address":[1708047],"length":1,"stats":{"Line":0}},{"line":174,"address":[1708097],"length":1,"stats":{"Line":0}},{"line":179,"address":[3179715],"length":1,"stats":{"Line":0}},{"line":182,"address":[479045],"length":1,"stats":{"Line":0}},{"line":185,"address":[479095],"length":1,"stats":{"Line":0}},{"line":187,"address":[16453833],"length":1,"stats":{"Line":0}},{"line":188,"address":[3180042,3179920],"length":1,"stats":{"Line":2}},{"line":189,"address":[479539,479417],"length":1,"stats":{"Line":0}},{"line":197,"address":[14403232],"length":1,"stats":{"Line":0}},{"line":198,"address":[16454356],"length":1,"stats":{"Line":0}},{"line":199,"address":[16454363],"length":1,"stats":{"Line":0}},{"line":200,"address":[16454370],"length":1,"stats":{"Line":0}},{"line":201,"address":[14403273],"length":1,"stats":{"Line":0}},{"line":204,"address":[1708864],"length":1,"stats":{"Line":0}},{"line":205,"address":[16490136,16490146],"length":1,"stats":{"Line":0}},{"line":206,"address":[16490163],"length":1,"stats":{"Line":0}},{"line":207,"address":[16454450],"length":1,"stats":{"Line":0}},{"line":208,"address":[1708929],"length":1,"stats":{"Line":0}},{"line":209,"address":[14403370],"length":1,"stats":{"Line":0}},{"line":211,"address":[1708877],"length":1,"stats":{"Line":0}},{"line":226,"address":[16490256,16491862,16492161],"length":1,"stats":{"Line":4}},{"line":227,"address":[1709017],"length":1,"stats":{"Line":4}},{"line":230,"address":[1709009,1709172,1709093],"length":1,"stats":{"Line":12}},{"line":232,"address":[1709336],"length":1,"stats":{"Line":0}},{"line":233,"address":[16490614,16491976,16492094],"length":1,"stats":{"Line":0}},{"line":235,"address":[1710786],"length":1,"stats":{"Line":0}},{"line":238,"address":[3182405],"length":1,"stats":{"Line":0}},{"line":241,"address":[1709234],"length":1,"stats":{"Line":0}},{"line":244,"address":[14403732,14404370,14403796,14403899],"length":1,"stats":{"Line":12}},{"line":246,"address":[1709403,1709476],"length":1,"stats":{"Line":8}},{"line":247,"address":[3181074],"length":1,"stats":{"Line":0}},{"line":252,"address":[16455018],"length":1,"stats":{"Line":4}},{"line":255,"address":[480756,480439,480506,481300],"length":1,"stats":{"Line":16}},{"line":256,"address":[480803,480780],"length":1,"stats":{"Line":8}},{"line":257,"address":[14404731,14404964,14404579],"length":1,"stats":{"Line":8}},{"line":259,"address":[1710179],"length":1,"stats":{"Line":0}},{"line":262,"address":[14404259],"length":1,"stats":{"Line":4}},{"line":264,"address":[3180991],"length":1,"stats":{"Line":0}},{"line":270,"address":[14429670,14429701,14428848],"length":1,"stats":{"Line":4}},{"line":271,"address":[1734433],"length":1,"stats":{"Line":4}},{"line":272,"address":[16479994],"length":1,"stats":{"Line":4}},{"line":273,"address":[16515779,16515858],"length":1,"stats":{"Line":8}},{"line":275,"address":[16480149],"length":1,"stats":{"Line":4}},{"line":276,"address":[16515970,16515896,16516172,16516094],"length":1,"stats":{"Line":12}},{"line":277,"address":[14429347,14429524],"length":1,"stats":{"Line":0}},{"line":281,"address":[3206505],"length":1,"stats":{"Line":4}},{"line":283,"address":[16516309],"length":1,"stats":{"Line":4}},{"line":331,"address":[16456448,16457744,16457773],"length":1,"stats":{"Line":4}},{"line":334,"address":[16456568,16456478],"length":1,"stats":{"Line":8}},{"line":335,"address":[482358,482017,482538],"length":1,"stats":{"Line":6}},{"line":336,"address":[14406205,14405763],"length":1,"stats":{"Line":8}},{"line":337,"address":[16493242,16492709],"length":1,"stats":{"Line":8}},{"line":338,"address":[16456705],"length":1,"stats":{"Line":0}},{"line":339,"address":[481921],"length":1,"stats":{"Line":0}},{"line":345,"address":[16480832],"length":1,"stats":{"Line":4}},{"line":346,"address":[1735318],"length":1,"stats":{"Line":4}},{"line":347,"address":[14429787],"length":1,"stats":{"Line":3}},{"line":348,"address":[3206965],"length":1,"stats":{"Line":4}},{"line":349,"address":[14429877],"length":1,"stats":{"Line":4}},{"line":357,"address":[16458849,16457792,16458871],"length":1,"stats":{"Line":3}},{"line":358,"address":[16457809],"length":1,"stats":{"Line":3}},{"line":360,"address":[14406894,14406838,14406761],"length":1,"stats":{"Line":6}},{"line":361,"address":[16493688],"length":1,"stats":{"Line":3}},{"line":362,"address":[3184083],"length":1,"stats":{"Line":0}},{"line":363,"address":[16458070],"length":1,"stats":{"Line":0}},{"line":366,"address":[16493846,16493746],"length":1,"stats":{"Line":6}},{"line":367,"address":[16458249,16458160],"length":1,"stats":{"Line":6}},{"line":368,"address":[16458198],"length":1,"stats":{"Line":0}},{"line":371,"address":[16494003,16494115],"length":1,"stats":{"Line":5}},{"line":372,"address":[16458340,16458407],"length":1,"stats":{"Line":2}},{"line":373,"address":[1712951],"length":1,"stats":{"Line":2}},{"line":374,"address":[16458512],"length":1,"stats":{"Line":0}},{"line":377,"address":[1712919,1713067],"length":1,"stats":{"Line":6}},{"line":379,"address":[14407590],"length":1,"stats":{"Line":3}},{"line":380,"address":[14407526],"length":1,"stats":{"Line":3}},{"line":382,"address":[16494374],"length":1,"stats":{"Line":3}},{"line":389,"address":[14430894,14430927,14429936],"length":1,"stats":{"Line":3}},{"line":390,"address":[1121990],"length":1,"stats":{"Line":3}},{"line":391,"address":[1122105,1122178],"length":1,"stats":{"Line":6}},{"line":393,"address":[16517006],"length":1,"stats":{"Line":3}},{"line":394,"address":[1122225,1122292],"length":1,"stats":{"Line":6}},{"line":397,"address":[16517070,16517128],"length":1,"stats":{"Line":6}},{"line":399,"address":[16481460],"length":1,"stats":{"Line":3}},{"line":400,"address":[16481528,16481613],"length":1,"stats":{"Line":2}},{"line":403,"address":[3207609,3207669],"length":1,"stats":{"Line":3}},{"line":404,"address":[16481732,16481834],"length":1,"stats":{"Line":0}},{"line":407,"address":[1736245],"length":1,"stats":{"Line":3}},{"line":414,"address":[484112,485736,485714],"length":1,"stats":{"Line":4}},{"line":415,"address":[14407809],"length":1,"stats":{"Line":4}},{"line":417,"address":[3185084,3185007,3185140],"length":1,"stats":{"Line":9}},{"line":418,"address":[1713534],"length":1,"stats":{"Line":4}},{"line":419,"address":[3185196],"length":1,"stats":{"Line":1}},{"line":420,"address":[484399],"length":1,"stats":{"Line":0}},{"line":423,"address":[1713592,1713690,1713766],"length":1,"stats":{"Line":8}},{"line":424,"address":[16494983,16495050],"length":1,"stats":{"Line":8}},{"line":425,"address":[3185455,3185400],"length":1,"stats":{"Line":0}},{"line":426,"address":[3185412],"length":1,"stats":{"Line":0}},{"line":429,"address":[1713788,1713933],"length":1,"stats":{"Line":8}},{"line":430,"address":[3185530],"length":1,"stats":{"Line":4}},{"line":431,"address":[16459603,16459540],"length":1,"stats":{"Line":8}},{"line":432,"address":[1714103],"length":1,"stats":{"Line":0}},{"line":434,"address":[3185659],"length":1,"stats":{"Line":4}},{"line":437,"address":[484772],"length":1,"stats":{"Line":0}},{"line":440,"address":[16459764,16459829,16459682],"length":1,"stats":{"Line":12}},{"line":441,"address":[485022],"length":1,"stats":{"Line":1}},{"line":442,"address":[16495613],"length":1,"stats":{"Line":4}},{"line":443,"address":[16495631],"length":1,"stats":{"Line":0}},{"line":446,"address":[485065,485158,485207],"length":1,"stats":{"Line":8}},{"line":447,"address":[16495754,16495692],"length":1,"stats":{"Line":8}},{"line":448,"address":[16460450,16460386],"length":1,"stats":{"Line":0}},{"line":449,"address":[16460410],"length":1,"stats":{"Line":0}},{"line":452,"address":[16495929],"length":1,"stats":{"Line":4}},{"line":453,"address":[16495756],"length":1,"stats":{"Line":4}},{"line":454,"address":[14408950],"length":1,"stats":{"Line":4}},{"line":455,"address":[1714566],"length":1,"stats":{"Line":4}},{"line":456,"address":[3186182],"length":1,"stats":{"Line":4}},{"line":457,"address":[485369],"length":1,"stats":{"Line":4}},{"line":463,"address":[3209138,3208224,3209065],"length":1,"stats":{"Line":4}},{"line":464,"address":[16517942],"length":1,"stats":{"Line":4}},{"line":465,"address":[1736783,1736863],"length":1,"stats":{"Line":8}},{"line":467,"address":[16482423],"length":1,"stats":{"Line":4}},{"line":468,"address":[16518230,16518174],"length":1,"stats":{"Line":8}},{"line":471,"address":[1736951,1736989],"length":1,"stats":{"Line":8}},{"line":472,"address":[14431589,14431432],"length":1,"stats":{"Line":8}},{"line":475,"address":[3208649,3208744],"length":1,"stats":{"Line":8}},{"line":477,"address":[14431632],"length":1,"stats":{"Line":4}},{"line":478,"address":[3208921],"length":1,"stats":{"Line":1}},{"line":481,"address":[16482954,16482754],"length":1,"stats":{"Line":8}},{"line":483,"address":[14431874],"length":1,"stats":{"Line":4}},{"line":490,"address":[16460544,16461420],"length":1,"stats":{"Line":4}},{"line":491,"address":[16460561],"length":1,"stats":{"Line":4}},{"line":492,"address":[14409593,14409516],"length":1,"stats":{"Line":8}},{"line":493,"address":[3186747],"length":1,"stats":{"Line":4}},{"line":494,"address":[3186806],"length":1,"stats":{"Line":0}},{"line":497,"address":[16496556,16496464],"length":1,"stats":{"Line":8}},{"line":498,"address":[1715470],"length":1,"stats":{"Line":4}},{"line":499,"address":[16496747],"length":1,"stats":{"Line":4}},{"line":500,"address":[14409853],"length":1,"stats":{"Line":0}},{"line":501,"address":[486119],"length":1,"stats":{"Line":0}},{"line":504,"address":[486246],"length":1,"stats":{"Line":4}},{"line":507,"address":[16497018,16496815,16496889],"length":1,"stats":{"Line":12}},{"line":508,"address":[16461331],"length":1,"stats":{"Line":0}},{"line":511,"address":[16461213],"length":1,"stats":{"Line":4}},{"line":513,"address":[16496895],"length":1,"stats":{"Line":4}},{"line":514,"address":[16461178],"length":1,"stats":{"Line":4}},{"line":520,"address":[16518880,16519526,16519545],"length":1,"stats":{"Line":4}},{"line":521,"address":[16518902],"length":1,"stats":{"Line":4}},{"line":522,"address":[16519000,16519077],"length":1,"stats":{"Line":8}},{"line":524,"address":[3209402],"length":1,"stats":{"Line":4}},{"line":525,"address":[3209466],"length":1,"stats":{"Line":5}},{"line":527,"address":[1124380],"length":1,"stats":{"Line":4}},{"line":528,"address":[3209775,3209674],"length":1,"stats":{"Line":6}},{"line":531,"address":[16483691],"length":1,"stats":{"Line":4}},{"line":656,"address":[3977024,3977029],"length":1,"stats":{"Line":12}},{"line":665,"address":[1126576],"length":1,"stats":{"Line":1}},{"line":666,"address":[],"length":0,"stats":{"Line":1}},{"line":715,"address":[487724,486656],"length":1,"stats":{"Line":2}},{"line":718,"address":[3187505,3187716,3188606],"length":1,"stats":{"Line":4}},{"line":721,"address":[486876],"length":1,"stats":{"Line":2}},{"line":725,"address":[1716653,1716595],"length":1,"stats":{"Line":4}},{"line":726,"address":[14411093,14411358],"length":1,"stats":{"Line":2}},{"line":728,"address":[1716814],"length":1,"stats":{"Line":0}},{"line":730,"address":[16462498,16462318],"length":1,"stats":{"Line":4}},{"line":737,"address":[16464303,16464355,16462592],"length":1,"stats":{"Line":0}},{"line":742,"address":[16462629,16462943,16462746],"length":1,"stats":{"Line":0}},{"line":744,"address":[3188913],"length":1,"stats":{"Line":0}},{"line":747,"address":[14411954],"length":1,"stats":{"Line":0}},{"line":748,"address":[488243,488394],"length":1,"stats":{"Line":0}},{"line":751,"address":[3189186,3189286],"length":1,"stats":{"Line":0}},{"line":752,"address":[488449,488583],"length":1,"stats":{"Line":0}},{"line":755,"address":[14412280,14412339],"length":1,"stats":{"Line":0}},{"line":756,"address":[14412430,14412486],"length":1,"stats":{"Line":0}},{"line":759,"address":[3189610,3189646],"length":1,"stats":{"Line":0}},{"line":760,"address":[3188651,3189654,3189919],"length":1,"stats":{"Line":0}},{"line":762,"address":[3189807],"length":1,"stats":{"Line":0}},{"line":764,"address":[3189775,3189958],"length":1,"stats":{"Line":0}},{"line":771,"address":[1718848,1720713,1720818],"length":1,"stats":{"Line":2}},{"line":778,"address":[16464450,16464583,16464807],"length":1,"stats":{"Line":6}},{"line":780,"address":[16464726],"length":1,"stats":{"Line":2}},{"line":783,"address":[490082],"length":1,"stats":{"Line":2}},{"line":784,"address":[3190983,3191134],"length":1,"stats":{"Line":4}},{"line":787,"address":[1719590,1719490],"length":1,"stats":{"Line":4}},{"line":788,"address":[3191295,3191189],"length":1,"stats":{"Line":4}},{"line":791,"address":[16465251,16465282],"length":1,"stats":{"Line":4}},{"line":792,"address":[1719757,1719866],"length":1,"stats":{"Line":4}},{"line":795,"address":[3191399,3191458],"length":1,"stats":{"Line":4}},{"line":796,"address":[1719969,1720025],"length":1,"stats":{"Line":4}},{"line":799,"address":[16501277,16501313],"length":1,"stats":{"Line":4}},{"line":800,"address":[3190463,3191890,3191625],"length":1,"stats":{"Line":4}},{"line":802,"address":[16465746],"length":1,"stats":{"Line":0}},{"line":804,"address":[1720361,1720178],"length":1,"stats":{"Line":4}},{"line":811,"address":[16467687,16466384,16467668],"length":1,"stats":{"Line":2}},{"line":812,"address":[16502235,16502403,16502532,16502134],"length":1,"stats":{"Line":8}},{"line":814,"address":[491781],"length":1,"stats":{"Line":2}},{"line":815,"address":[3192807],"length":1,"stats":{"Line":2}},{"line":818,"address":[492068],"length":1,"stats":{"Line":2}},{"line":819,"address":[3193191,3193094],"length":1,"stats":{"Line":4}},{"line":822,"address":[492242,492319],"length":1,"stats":{"Line":4}},{"line":823,"address":[492575,492348],"length":1,"stats":{"Line":2}},{"line":825,"address":[492463],"length":1,"stats":{"Line":0}},{"line":827,"address":[1721954,1721776],"length":1,"stats":{"Line":4}},{"line":878,"address":[4476080],"length":1,"stats":{"Line":1}},{"line":879,"address":[2045849,2045891],"length":1,"stats":{"Line":2}},{"line":881,"address":[1731866],"length":1,"stats":{"Line":0}},{"line":883,"address":[4436396],"length":1,"stats":{"Line":1}},{"line":884,"address":[],"length":0,"stats":{"Line":1}},{"line":889,"address":[4476064],"length":1,"stats":{"Line":2}},{"line":890,"address":[4476069],"length":1,"stats":{"Line":2}},{"line":894,"address":[4475088],"length":1,"stats":{"Line":2}},{"line":895,"address":[],"length":0,"stats":{"Line":2}},{"line":899,"address":[],"length":0,"stats":{"Line":0}},{"line":900,"address":[],"length":0,"stats":{"Line":0}},{"line":904,"address":[2051020,2050932,2049728],"length":1,"stats":{"Line":5}},{"line":905,"address":[1126661],"length":1,"stats":{"Line":5}},{"line":906,"address":[1126746],"length":1,"stats":{"Line":5}},{"line":908,"address":[4440433],"length":1,"stats":{"Line":5}},{"line":909,"address":[2049921],"length":1,"stats":{"Line":5}},{"line":915,"address":[990431],"length":1,"stats":{"Line":5}},{"line":916,"address":[4480379],"length":1,"stats":{"Line":5}},{"line":917,"address":[1736071],"length":1,"stats":{"Line":5}},{"line":918,"address":[1736123],"length":1,"stats":{"Line":5}},{"line":920,"address":[],"length":0,"stats":{"Line":0}},{"line":921,"address":[4480665],"length":1,"stats":{"Line":5}},{"line":924,"address":[990764],"length":1,"stats":{"Line":5}},{"line":929,"address":[4462690,4462304],"length":1,"stats":{"Line":2}},{"line":930,"address":[1718265],"length":1,"stats":{"Line":2}},{"line":934,"address":[4463560,4462720],"length":1,"stats":{"Line":5}},{"line":935,"address":[4423056],"length":1,"stats":{"Line":5}},{"line":936,"address":[973377],"length":1,"stats":{"Line":5}},{"line":937,"address":[1128056,1128351,1128274],"length":1,"stats":{"Line":10}},{"line":939,"address":[1719295,1719433,1719203,1719047,1719354],"length":1,"stats":{"Line":21}},{"line":940,"address":[2033112],"length":1,"stats":{"Line":5}},{"line":942,"address":[1719369],"length":1,"stats":{"Line":1}},{"line":944,"address":[4463429],"length":1,"stats":{"Line":5}},{"line":947,"address":[4423465],"length":1,"stats":{"Line":0}},{"line":950,"address":[1718798],"length":1,"stats":{"Line":2}},{"line":951,"address":[973414],"length":1,"stats":{"Line":2}},{"line":953,"address":[973486],"length":1,"stats":{"Line":4}},{"line":955,"address":[1128160],"length":1,"stats":{"Line":4}},{"line":956,"address":[2032743],"length":1,"stats":{"Line":4}},{"line":962,"address":[],"length":0,"stats":{"Line":4}},{"line":963,"address":[1729444],"length":1,"stats":{"Line":4}},{"line":965,"address":[984110],"length":1,"stats":{"Line":0}},{"line":967,"address":[],"length":0,"stats":{"Line":0}},{"line":969,"address":[4434060,4433999],"length":1,"stats":{"Line":4}},{"line":970,"address":[],"length":0,"stats":{"Line":4}},{"line":972,"address":[2043618],"length":1,"stats":{"Line":5}},{"line":974,"address":[984251],"length":1,"stats":{"Line":5}},{"line":975,"address":[984380,984314],"length":1,"stats":{"Line":10}},{"line":976,"address":[984393],"length":1,"stats":{"Line":3}},{"line":977,"address":[4434380],"length":1,"stats":{"Line":5}},{"line":978,"address":[2043885],"length":1,"stats":{"Line":4}},{"line":981,"address":[4434638,4434434],"length":1,"stats":{"Line":8}},{"line":982,"address":[1129425],"length":1,"stats":{"Line":1}},{"line":985,"address":[4434649,4435311],"length":1,"stats":{"Line":8}},{"line":986,"address":[4434711],"length":1,"stats":{"Line":4}},{"line":987,"address":[984831,984935,984896,985011,985087],"length":1,"stats":{"Line":16}},{"line":988,"address":[4474532,4474637,4474586],"length":1,"stats":{"Line":8}},{"line":989,"address":[2044441,2044390,2044335],"length":1,"stats":{"Line":8}},{"line":990,"address":[4474683,4474738,4474782],"length":1,"stats":{"Line":8}},{"line":992,"address":[985100],"length":1,"stats":{"Line":4}},{"line":993,"address":[1730547],"length":1,"stats":{"Line":0}},{"line":996,"address":[985146],"length":1,"stats":{"Line":4}},{"line":997,"address":[4435195],"length":1,"stats":{"Line":0}},{"line":998,"address":[],"length":0,"stats":{"Line":0}},{"line":999,"address":[1730642],"length":1,"stats":{"Line":0}},{"line":1004,"address":[4435145,4435260,4435316],"length":1,"stats":{"Line":8}},{"line":1006,"address":[1130252],"length":1,"stats":{"Line":4}},{"line":1008,"address":[1730145],"length":1,"stats":{"Line":4}},{"line":1016,"address":[976609,974112,976536],"length":1,"stats":{"Line":4}},{"line":1018,"address":[1719510,1719614],"length":1,"stats":{"Line":7}},{"line":1020,"address":[1719603,1719826,1719672],"length":1,"stats":{"Line":16}},{"line":1024,"address":[2033515],"length":1,"stats":{"Line":4}},{"line":1025,"address":[1719898,1719718],"length":1,"stats":{"Line":8}},{"line":1026,"address":[4424314],"length":1,"stats":{"Line":0}},{"line":1027,"address":[4424373],"length":1,"stats":{"Line":0}},{"line":1028,"address":[],"length":0,"stats":{"Line":4}},{"line":1032,"address":[4464224,4464349],"length":1,"stats":{"Line":8}},{"line":1033,"address":[],"length":0,"stats":{"Line":4}},{"line":1034,"address":[4464370,4465854,4464610],"length":1,"stats":{"Line":9}},{"line":1035,"address":[4424668],"length":1,"stats":{"Line":4}},{"line":1037,"address":[975167,974967],"length":1,"stats":{"Line":8}},{"line":1038,"address":[4424994,4424926,4425474],"length":1,"stats":{"Line":8}},{"line":1039,"address":[4465106],"length":1,"stats":{"Line":0}},{"line":1042,"address":[],"length":0,"stats":{"Line":8}},{"line":1043,"address":[4465409],"length":1,"stats":{"Line":4}},{"line":1048,"address":[2035441],"length":1,"stats":{"Line":5}},{"line":1049,"address":[976348,975912],"length":1,"stats":{"Line":4}},{"line":1053,"address":[975004,974905,975131],"length":1,"stats":{"Line":0}},{"line":1054,"address":[1720425],"length":1,"stats":{"Line":0}},{"line":1059,"address":[],"length":0,"stats":{"Line":6}},{"line":1064,"address":[4466160,4466711],"length":1,"stats":{"Line":4}},{"line":1065,"address":[4426446,4426962],"length":1,"stats":{"Line":8}},{"line":1066,"address":[4466203],"length":1,"stats":{"Line":4}},{"line":1067,"address":[1722329],"length":1,"stats":{"Line":5}},{"line":1068,"address":[4466639,4466516],"length":1,"stats":{"Line":10}},{"line":1070,"address":[],"length":0,"stats":{"Line":5}},{"line":1071,"address":[4426543],"length":1,"stats":{"Line":3}},{"line":1072,"address":[1722231],"length":1,"stats":{"Line":3}},{"line":1074,"address":[],"length":0,"stats":{"Line":0}},{"line":1076,"address":[4427056,4427120,4427151],"length":1,"stats":{"Line":7}},{"line":1078,"address":[4466924],"length":1,"stats":{"Line":1}},{"line":1080,"address":[2036603],"length":1,"stats":{"Line":2}},{"line":1083,"address":[2036461],"length":1,"stats":{"Line":0}},{"line":1091,"address":[],"length":0,"stats":{"Line":4}},{"line":1092,"address":[4472526],"length":1,"stats":{"Line":4}},{"line":1093,"address":[],"length":0,"stats":{"Line":4}},{"line":1094,"address":[4472678],"length":1,"stats":{"Line":2}},{"line":1095,"address":[1134402,1134645],"length":1,"stats":{"Line":4}},{"line":1097,"address":[2042696,2042714],"length":1,"stats":{"Line":4}},{"line":1098,"address":[],"length":0,"stats":{"Line":0}},{"line":1099,"address":[1134665],"length":1,"stats":{"Line":2}},{"line":1102,"address":[2042778],"length":1,"stats":{"Line":0}},{"line":1105,"address":[4472728],"length":1,"stats":{"Line":4}},{"line":1107,"address":[2042491],"length":1,"stats":{"Line":4}},{"line":1109,"address":[1728511],"length":1,"stats":{"Line":4}},{"line":1112,"address":[1728541],"length":1,"stats":{"Line":4}},{"line":1113,"address":[],"length":0,"stats":{"Line":4}},{"line":1114,"address":[4473563,4473633,4473439],"length":1,"stats":{"Line":12}},{"line":1115,"address":[1135122],"length":1,"stats":{"Line":4}},{"line":1117,"address":[983575],"length":1,"stats":{"Line":3}},{"line":1118,"address":[4433875,4433502,4433532],"length":1,"stats":{"Line":9}},{"line":1119,"address":[2042978],"length":1,"stats":{"Line":3}},{"line":1126,"address":[],"length":0,"stats":{"Line":4}},{"line":1130,"address":[986352,987256],"length":1,"stats":{"Line":4}},{"line":1131,"address":[986461,986387],"length":1,"stats":{"Line":4}},{"line":1133,"address":[4436660,4436577],"length":1,"stats":{"Line":8}},{"line":1134,"address":[],"length":0,"stats":{"Line":4}},{"line":1135,"address":[4476779,4476550,4476251,4476480],"length":1,"stats":{"Line":12}},{"line":1136,"address":[],"length":0,"stats":{"Line":0}},{"line":1137,"address":[4476667],"length":1,"stats":{"Line":0}},{"line":1138,"address":[2046545,2046367],"length":1,"stats":{"Line":8}},{"line":1140,"address":[987170,986945,987016],"length":1,"stats":{"Line":8}},{"line":1141,"address":[2046631],"length":1,"stats":{"Line":4}},{"line":1142,"address":[4437297],"length":1,"stats":{"Line":4}},{"line":1144,"address":[2046572],"length":1,"stats":{"Line":0}},{"line":1149,"address":[4435814,4435376,4435843],"length":1,"stats":{"Line":4}},{"line":1151,"address":[1136342],"length":1,"stats":{"Line":4}},{"line":1152,"address":[2045016],"length":1,"stats":{"Line":4}},{"line":1158,"address":[4435439],"length":1,"stats":{"Line":4}},{"line":1160,"address":[4475225],"length":1,"stats":{"Line":4}},{"line":1161,"address":[4435513,4435603],"length":1,"stats":{"Line":8}},{"line":1162,"address":[],"length":0,"stats":{"Line":4}},{"line":1166,"address":[1734857,1734884,1732864],"length":1,"stats":{"Line":4}},{"line":1170,"address":[],"length":0,"stats":{"Line":4}},{"line":1171,"address":[2047075,2047319,2048954],"length":1,"stats":{"Line":4}},{"line":1172,"address":[2047068],"length":1,"stats":{"Line":4}},{"line":1173,"address":[987633],"length":1,"stats":{"Line":0}},{"line":1175,"address":[987774,987606,989088],"length":1,"stats":{"Line":9}},{"line":1177,"address":[4438156,4437930],"length":1,"stats":{"Line":2}},{"line":1178,"address":[4477908],"length":1,"stats":{"Line":1}},{"line":1180,"address":[4438221,4438438],"length":1,"stats":{"Line":2}},{"line":1181,"address":[],"length":0,"stats":{"Line":0}},{"line":1182,"address":[4478132],"length":1,"stats":{"Line":1}},{"line":1184,"address":[1138109],"length":1,"stats":{"Line":1}},{"line":1186,"address":[],"length":0,"stats":{"Line":2}},{"line":1187,"address":[1734266,1734778,1734618,1732899,1734538],"length":1,"stats":{"Line":6}},{"line":1192,"address":[4437961,4437914,4437900],"length":1,"stats":{"Line":11}},{"line":1193,"address":[987795],"length":1,"stats":{"Line":4}},{"line":1196,"address":[],"length":0,"stats":{"Line":4}},{"line":1200,"address":[],"length":0,"stats":{"Line":4}},{"line":1201,"address":[4475630,4475809],"length":1,"stats":{"Line":4}},{"line":1202,"address":[4475718,4475622,4475944],"length":1,"stats":{"Line":8}},{"line":1204,"address":[1731565],"length":1,"stats":{"Line":4}},{"line":1206,"address":[986196],"length":1,"stats":{"Line":5}},{"line":1208,"address":[1731618],"length":1,"stats":{"Line":4}},{"line":1211,"address":[4479280,4479977],"length":1,"stats":{"Line":4}},{"line":1213,"address":[989438],"length":1,"stats":{"Line":4}},{"line":1214,"address":[4479379],"length":1,"stats":{"Line":4}},{"line":1215,"address":[4479417],"length":1,"stats":{"Line":4}},{"line":1216,"address":[989562],"length":1,"stats":{"Line":4}},{"line":1218,"address":[1139531,1140105],"length":1,"stats":{"Line":8}},{"line":1219,"address":[4479490],"length":1,"stats":{"Line":4}},{"line":1220,"address":[2049309],"length":1,"stats":{"Line":0}},{"line":1221,"address":[4439866,4440021],"length":1,"stats":{"Line":0}},{"line":1222,"address":[4479867,4479772],"length":1,"stats":{"Line":0}},{"line":1224,"address":[4479839],"length":1,"stats":{"Line":0}},{"line":1226,"address":[2049606],"length":1,"stats":{"Line":0}},{"line":1229,"address":[4439802],"length":1,"stats":{"Line":4}},{"line":1230,"address":[],"length":0,"stats":{"Line":8}},{"line":1233,"address":[1140048,1140095],"length":1,"stats":{"Line":8}},{"line":1238,"address":[989588],"length":1,"stats":{"Line":4}},{"line":1242,"address":[1736912],"length":1,"stats":{"Line":4}},{"line":1244,"address":[1737112,1736968],"length":1,"stats":{"Line":5}},{"line":1246,"address":[4441975,4441710],"length":1,"stats":{"Line":5}},{"line":1249,"address":[4481594],"length":1,"stats":{"Line":4}},{"line":1250,"address":[2051371,2051585],"length":1,"stats":{"Line":4}},{"line":1253,"address":[1141066,1140860],"length":1,"stats":{"Line":4}},{"line":1256,"address":[4482066,4481919,4481360],"length":1,"stats":{"Line":8}},{"line":1258,"address":[992105],"length":1,"stats":{"Line":4}},{"line":1262,"address":[982715,977488],"length":1,"stats":{"Line":4}},{"line":1264,"address":[],"length":0,"stats":{"Line":4}},{"line":1265,"address":[2037086,2036899,2036962,2037159],"length":1,"stats":{"Line":16}},{"line":1266,"address":[1725075,1727809],"length":1,"stats":{"Line":10}},{"line":1267,"address":[],"length":0,"stats":{"Line":0}},{"line":1269,"address":[4469363,4469718],"length":1,"stats":{"Line":8}},{"line":1270,"address":[1143872],"length":1,"stats":{"Line":4}},{"line":1273,"address":[4470029,4469801,4469944],"length":1,"stats":{"Line":13}},{"line":1274,"address":[4469818],"length":1,"stats":{"Line":5}},{"line":1275,"address":[1725612],"length":1,"stats":{"Line":5}},{"line":1276,"address":[1143963],"length":1,"stats":{"Line":5}},{"line":1277,"address":[],"length":0,"stats":{"Line":5}},{"line":1280,"address":[2040484],"length":1,"stats":{"Line":4}},{"line":1281,"address":[],"length":0,"stats":{"Line":8}},{"line":1282,"address":[1145366,1145698,1145860],"length":1,"stats":{"Line":8}},{"line":1283,"address":[],"length":0,"stats":{"Line":0}},{"line":1284,"address":[4431424],"length":1,"stats":{"Line":4}},{"line":1285,"address":[1145246],"length":1,"stats":{"Line":4}},{"line":1290,"address":[4470810],"length":1,"stats":{"Line":2}},{"line":1291,"address":[1727599,1727833,1726629,1727785],"length":1,"stats":{"Line":4}},{"line":1292,"address":[],"length":0,"stats":{"Line":2}},{"line":1293,"address":[],"length":0,"stats":{"Line":0}},{"line":1294,"address":[4431120],"length":1,"stats":{"Line":2}},{"line":1295,"address":[],"length":0,"stats":{"Line":2}},{"line":1299,"address":[],"length":0,"stats":{"Line":0}},{"line":1300,"address":[4430269,4430337],"length":1,"stats":{"Line":6}},{"line":1301,"address":[4470126,4470684,4470498],"length":1,"stats":{"Line":6}},{"line":1302,"address":[],"length":0,"stats":{"Line":0}},{"line":1303,"address":[980468],"length":1,"stats":{"Line":3}},{"line":1304,"address":[4430374],"length":1,"stats":{"Line":3}},{"line":1311,"address":[4472141,4469445,4472323],"length":1,"stats":{"Line":0}},{"line":1312,"address":[4469382],"length":1,"stats":{"Line":0}},{"line":1313,"address":[],"length":0,"stats":{"Line":0}},{"line":1314,"address":[979794],"length":1,"stats":{"Line":0}},{"line":1315,"address":[2039165],"length":1,"stats":{"Line":0}},{"line":1321,"address":[978096,977916],"length":1,"stats":{"Line":9}},{"line":1323,"address":[],"length":0,"stats":{"Line":8}},{"line":1325,"address":[2037483],"length":1,"stats":{"Line":4}},{"line":1326,"address":[978273],"length":1,"stats":{"Line":3}},{"line":1328,"address":[4428237],"length":1,"stats":{"Line":3}},{"line":1329,"address":[4429050,4428376,4429236],"length":1,"stats":{"Line":6}},{"line":1330,"address":[],"length":0,"stats":{"Line":0}},{"line":1331,"address":[1142233],"length":1,"stats":{"Line":3}},{"line":1332,"address":[],"length":0,"stats":{"Line":0}},{"line":1336,"address":[],"length":0,"stats":{"Line":1}},{"line":1337,"address":[4428780,4429469,4427358,4429283],"length":1,"stats":{"Line":6}},{"line":1338,"address":[4468468],"length":1,"stats":{"Line":1}},{"line":1339,"address":[],"length":0,"stats":{"Line":0}},{"line":1340,"address":[978890],"length":1,"stats":{"Line":1}},{"line":1341,"address":[4468516],"length":1,"stats":{"Line":1}},{"line":1347,"address":[4467667],"length":1,"stats":{"Line":4}},{"line":1351,"address":[4461296,4462253],"length":1,"stats":{"Line":4}},{"line":1359,"address":[4461402],"length":1,"stats":{"Line":4}},{"line":1360,"address":[2031166,2031253],"length":1,"stats":{"Line":4}},{"line":1363,"address":[2031979,2031940,2031090,2031468],"length":1,"stats":{"Line":8}},{"line":1364,"address":[],"length":0,"stats":{"Line":4}},{"line":1365,"address":[1717486],"length":1,"stats":{"Line":4}},{"line":1366,"address":[1146836],"length":1,"stats":{"Line":4}},{"line":1367,"address":[],"length":0,"stats":{"Line":0}},{"line":1368,"address":[1146893],"length":1,"stats":{"Line":4}},{"line":1371,"address":[4462079],"length":1,"stats":{"Line":4}},{"line":1375,"address":[987296],"length":1,"stats":{"Line":1}},{"line":1376,"address":[987313],"length":1,"stats":{"Line":1}},{"line":1380,"address":[],"length":0,"stats":{"Line":3}},{"line":1381,"address":[],"length":0,"stats":{"Line":3}}],"covered":357,"coverable":496},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","honk-rpc","src","lib.rs"],"content":"#![doc = include_str!(\"../README.md\")]\n\nmod byte_counter;\npub mod honk_rpc;\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","honk-rpc","tests","honk_rpc.rs"],"content":"// standard\nuse std::collections::VecDeque;\nuse std::net::{SocketAddr, TcpListener, TcpStream};\n\n// extern crates\nuse bson::doc;\nuse data_encoding::HEXLOWER;\nuse sha3::{Digest, Sha3_256};\n\n// internal crates\nuse honk_rpc::honk_rpc::*;\n\n#[derive(Default)]\nstruct TestApiSet {\n    delay_echo_results: VecDeque\u003c(RequestCookie, Result\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e)\u003e,\n}\n\nconst RUNTIME_ERROR_INVALID_ARG: ErrorCode = ErrorCode::Runtime(1i32);\nconst RUNTIME_ERROR_NOT_IMPLEMENTED: ErrorCode = ErrorCode::Runtime(2i32);\n\nimpl TestApiSet {\n    // returns the same string arg sent\n    fn echo_0(\n        \u0026mut self,\n        mut args: bson::document::Document,\n    ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n        if let Some(bson::Bson::String(val)) = args.get_mut(\"val\") {\n            println!(\"TestApiSet::echo_0(val): val = '{}'\", val);\n            // Some((Some(bson::Bson::String(std::mem::take(val))), None))\n            Some(Ok(Some(bson::Bson::String(std::mem::take(val)))))\n        } else {\n            Some(Err(RUNTIME_ERROR_INVALID_ARG))\n        }\n    }\n\n    // second version of echo that isn't implemented\n    fn echo_1(\n        \u0026mut self,\n        _args: bson::document::Document,\n    ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n        Some(Err(RUNTIME_ERROR_NOT_IMPLEMENTED))\n    }\n\n    // same as echo but takes awhile and appends ' - Delayed!' to source string before returning\n    fn delay_echo_0(\n        \u0026mut self,\n        request_cookie: Option\u003cRequestCookie\u003e,\n        mut args: bson::document::Document,\n    ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n        if let Some(bson::Bson::String(val)) = args.get_mut(\"val\") {\n            println!(\"TestApiSet::delay_echo_0(val): val = '{}'\", val);\n            // only enqueue response if a request cookie is provided\n            if let Some(request_cookie) = request_cookie {\n                val.push_str(\" - Delayed!\");\n                self.delay_echo_results.push_back((\n                    request_cookie,\n                    Ok(Some(bson::Bson::String(std::mem::take(val)))),\n                ));\n            }\n            // async func so don't return result immediately\n            None\n        } else {\n            Some(Err(RUNTIME_ERROR_INVALID_ARG))\n        }\n    }\n\n    fn sha256_0(\n        \u0026mut self,\n        mut args: bson::document::Document,\n    ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n        if let Some(bson::Bson::Binary(val)) = args.get_mut(\"data\") {\n            let mut sha256 = Sha3_256::new();\n            sha256.update(\u0026val.bytes);\n\n            let hash = sha256.finalize();\n\n            Some(Ok(Some(bson::Bson::String(HEXLOWER.encode(\u0026hash)))))\n        } else {\n            Some(Err(RUNTIME_ERROR_INVALID_ARG))\n        }\n    }\n}\n\nimpl ApiSet for TestApiSet {\n    fn namespace(\u0026self) -\u003e \u0026str {\n        \"test\"\n    }\n\n    fn exec_function(\n        \u0026mut self,\n        name: \u0026str,\n        version: i32,\n        args: bson::document::Document,\n        request_cookie: Option\u003cRequestCookie\u003e,\n    ) -\u003e Option\u003cResult\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e\u003e {\n        match (name, version) {\n            (\"echo\", 0) =\u003e self.echo_0(args),\n            (\"echo\", 1) =\u003e self.echo_1(args),\n            (\"delay_echo\", 0) =\u003e self.delay_echo_0(request_cookie, args),\n            (\"sha256\", 0) =\u003e self.sha256_0(args),\n            (name, version) =\u003e {\n                println!(\"received {{ name: '{}', version: {} }}\", name, version);\n                Some(Err(ErrorCode::RequestFunctionInvalid))\n            }\n        }\n    }\n\n    fn next_result(\u0026mut self) -\u003e Option\u003c(RequestCookie, Result\u003cOption\u003cbson::Bson\u003e, ErrorCode\u003e)\u003e {\n        self.delay_echo_results.pop_front()\n    }\n}\n\n#[test]\nfn test_honk_client_apiset() -\u003e anyhow::Result\u003c()\u003e {\n    let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n    let listener = TcpListener::bind(socket_addr)?;\n    let socket_addr = listener.local_addr()?;\n\n    let stream1 = TcpStream::connect(socket_addr)?;\n    stream1.set_nonblocking(true)?;\n    let (stream2, _socket_addr) = listener.accept()?;\n    stream2.set_nonblocking(true)?;\n\n    let mut alice = Session::new(stream1);\n    let mut pat = Session::new(stream2);\n\n    let mut test_api_set: TestApiSet = Default::default();\n    let alice_apisets: \u0026mut [\u0026mut dyn ApiSet] = \u0026mut [\u0026mut test_api_set];\n\n    //\n    // Pat calls remote test::echo_0 call\n    //\n\n    println!(\"--- pat calling test::echo(val: \\\"Hello Alice!\\\")\");\n    let sent_cookie = pat.client_call(\"test\", \"echo\", 0, doc! {\"val\" : \"Hello Alice!\"})?;\n\n    println!(\"--- pat wits for response from alice\");\n    let mut pat_sync_call_handled: bool = false;\n    while !pat_sync_call_handled {\n        alice.update(Some(alice_apisets))?;\n        pat.update(None)?;\n        if let Some(response) = pat.client_next_response() {\n            match response {\n                Response::Pending { cookie } =\u003e {\n                    panic!(\"received unexpected pending, cookie: {}\", cookie);\n                }\n                Response::Success { cookie, result } =\u003e {\n                    assert_eq!(sent_cookie, cookie);\n                    if let Some(bson::Bson::String(result)) = result {\n                        assert_eq!(result, \"Hello Alice!\");\n                        pat_sync_call_handled = true;\n                    }\n                }\n                Response::Error { cookie, error_code } =\u003e {\n                    panic!(\n                        \"received unexpected error: {}, cookie: {}\",\n                        error_code, cookie\n                    );\n                }\n            }\n        }\n    }\n\n    //\n    // Pat calls remote test::echo_0 call (with wrong arg)\n    //\n    println!(\"--- pat calling test::echo(string: \\\"Hello Alice!\\\"), should fail because bad arg\");\n    let sent_cookie = pat.client_call(\"test\", \"echo\", 0, doc! {\"string\" : \"Hello Alice!\"})?;\n\n    println!(\"--- pat waits for response from alice\");\n    let mut pat_bad_call_handled: bool = false;\n    while !pat_bad_call_handled {\n        alice.update(Some(alice_apisets))?;\n        pat.update(None)?;\n        if let Some(response) = pat.client_next_response() {\n            match response {\n                Response::Pending { cookie } =\u003e {\n                    panic!(\"received unexpected pending, cookie: {}\", cookie);\n                }\n                Response::Success { cookie, result } =\u003e {\n                    panic!(\n                        \"received unexpected result: {:?}, cookie: {}\",\n                        result, cookie\n                    );\n                }\n                Response::Error { cookie, error_code } =\u003e {\n                    assert_eq!(sent_cookie, cookie);\n                    assert_eq!(error_code, RUNTIME_ERROR_INVALID_ARG);\n                    println!(\"--- pat received invlaid arg response\");\n                    pat_bad_call_handled = true;\n                }\n            }\n        }\n    }\n\n    //\n    // Pat calls v2 remote test::echo_1 call (which is not implemented)\n    //\n    println!(\n        \"--- pat calling test::echo_1(val: \\\"Hello Again!\\\"), should fail because not implemented\"\n    );\n    let sent_cookie = pat.client_call(\"test\", \"echo\", 1, doc! {\"val\" : \"Hello Again!\"})?;\n\n    println!(\"--- pat waits for response from alice\");\n    let mut pat_bad_call_handled: bool = false;\n    while !pat_bad_call_handled {\n        alice.update(Some(alice_apisets))?;\n        pat.update(None)?;\n        if let Some(response) = pat.client_next_response() {\n            match response {\n                Response::Pending { cookie } =\u003e {\n                    panic!(\"received unexpected pending, cookie: {}\", cookie);\n                }\n                Response::Success { cookie, result } =\u003e {\n                    panic!(\n                        \"received unexpected result: {:?}, cookie: {}\",\n                        result, cookie\n                    );\n                }\n                Response::Error { cookie, error_code } =\u003e {\n                    assert_eq!(sent_cookie, cookie);\n                    assert_eq!(error_code, RUNTIME_ERROR_NOT_IMPLEMENTED);\n                    println!(\"--- pat received not implemented response\");\n                    pat_bad_call_handled = true;\n                }\n            }\n        }\n    }\n\n    //\n    // Pat calls test::delay_echo_0 which goes through the async machinery\n    //\n    println!(\"--- pat calling test::delay_echo(val: \\\"Hello Delayed?\\\"), should succeed\");\n    let sent_cookie = pat.client_call(\"test\", \"delay_echo\", 0, doc! {\"val\" : \"Hello Delayed?\"})?;\n\n    println!(\"--- pat waits for ack from alice\");\n    let mut pat_async_call_acked: bool = false;\n    while !pat_async_call_acked {\n        alice.update(Some(alice_apisets))?;\n        pat.update(None)?;\n        if let Some(response) = pat.client_next_response() {\n            match response {\n                Response::Pending { cookie } =\u003e {\n                    assert_eq!(sent_cookie, cookie);\n                    println!(\"--- pat received pending response\");\n                    pat_async_call_acked = true;\n                }\n                Response::Error { cookie, error_code } =\u003e {\n                    panic!(\n                        \"received unexpected error: {}, cookie: {}\",\n                        error_code, cookie\n                    );\n                }\n                Response::Success { cookie, result } =\u003e {\n                    panic!(\n                        \"received unexpected sucess: {:?}, cookie: {}\",\n                        result, cookie\n                    );\n                }\n            }\n        }\n    }\n\n    println!(\"--- pat waits for alice response\");\n    let mut pat_async_call_handled: bool = false;\n    while !pat_async_call_handled {\n        alice.update(Some(alice_apisets))?;\n        pat.update(None)?;\n        if let Some(response) = pat.client_next_response() {\n            match response {\n                Response::Pending { cookie } =\u003e {\n                    panic!(\"received unexpected pending, cookie: {}\", cookie);\n                }\n                Response::Error { cookie, error_code } =\u003e {\n                    panic!(\n                        \"received unexpected error: {}, cookie: {}\",\n                        error_code, cookie\n                    );\n                }\n                Response::Success { cookie, result } =\u003e {\n                    assert_eq!(sent_cookie, cookie);\n                    if let Some(bson::Bson::String(result)) = result {\n                        assert_eq!(result, \"Hello Delayed? - Delayed!\");\n                        println!(\"--- pat received success response\");\n                        pat_async_call_handled = true;\n                    }\n                }\n            }\n        }\n    }\n\n    println!(\"--- pat calling test::sha256(data: [0x00..])\");\n    let mut args: bson::document::Document = Default::default();\n    let data = vec![0u8; DEFAULT_MAX_MESSAGE_SIZE / 2];\n    args.insert(\n        \"data\",\n        bson::Bson::Binary(bson::Binary {\n            subtype: bson::spec::BinarySubtype::Generic,\n            bytes: data,\n        }),\n    );\n\n    let cookie1 = pat.client_call(\"test\", \"sha256\", 0, args)?;\n\n    println!(\"--- pat calling test::sha256(data: [0xff..])\");\n    let mut args: bson::document::Document = Default::default();\n    let data = vec![0xFFu8; DEFAULT_MAX_MESSAGE_SIZE / 2];\n    args.insert(\n        \"data\",\n        bson::Bson::Binary(bson::Binary {\n            subtype: bson::spec::BinarySubtype::Generic,\n            bytes: data,\n        }),\n    );\n\n    let cookie2 = pat.client_call(\"test\", \"sha256\", 0, args)?;\n\n    println!(\"--- pat waits for alice responses\");\n    let mut pat_0x00_buffer_hashed: bool = false;\n    let mut pat_0xff_buffer_hashed: bool = false;\n\n    while !pat_0x00_buffer_hashed || !pat_0xff_buffer_hashed {\n        alice.update(Some(alice_apisets))?;\n        pat.update(None)?;\n        for response in pat.client_drain_responses() {\n            match response {\n                Response::Pending { cookie } =\u003e {\n                    panic!(\"received unexpected pending, cookie: {}\", cookie);\n                }\n                Response::Error { cookie, error_code } =\u003e {\n                    panic!(\n                        \"received unexpected error: {}, cookie: {}\",\n                        error_code, cookie\n                    );\n                }\n                Response::Success { cookie, result } =\u003e {\n                    println!(\"cookie: {}, result: {:?}\", cookie, result);\n                    if let Some(bson::Bson::String(result)) = result {\n                        if cookie == cookie1 {\n                            pat_0x00_buffer_hashed = true;\n                            assert_eq!(\n                                result,\n                                \"463c61ad03873aa9e82581205205acc3d3c8346c7037c43e4e241ee529f2dc27\"\n                            );\n                            println!(\"--- pat received 0x00 buffer hash\");\n                        } else if cookie == cookie2 {\n                            assert_eq!(\n                                result,\n                                \"9bd2dc706dd5251ae8fad858931585c71a1b4587aa7ecb30e15880e1b9dcda16\"\n                            );\n                            pat_0xff_buffer_hashed = true;\n                            println!(\"--- pat received 0xff buffer hash\");\n                        }\n                    }\n                }\n            }\n        }\n    }\n\n    Ok(())\n}\n","traces":[{"line":23,"address":[853703,853104],"length":1,"stats":{"Line":1}},{"line":27,"address":[853140,853213,853351],"length":1,"stats":{"Line":3}},{"line":28,"address":[853465],"length":1,"stats":{"Line":1}},{"line":30,"address":[853519],"length":1,"stats":{"Line":1}},{"line":32,"address":[853289],"length":1,"stats":{"Line":1}},{"line":37,"address":[853728],"length":1,"stats":{"Line":1}},{"line":41,"address":[853755],"length":1,"stats":{"Line":1}},{"line":45,"address":[853840,854827],"length":1,"stats":{"Line":1}},{"line":50,"address":[853893,853967,854355,854105],"length":1,"stats":{"Line":3}},{"line":51,"address":[854225],"length":1,"stats":{"Line":1}},{"line":53,"address":[854288],"length":1,"stats":{"Line":1}},{"line":54,"address":[854313],"length":1,"stats":{"Line":1}},{"line":55,"address":[854663],"length":1,"stats":{"Line":1}},{"line":57,"address":[854360],"length":1,"stats":{"Line":1}},{"line":61,"address":[854342],"length":1,"stats":{"Line":1}},{"line":63,"address":[854043],"length":1,"stats":{"Line":0}},{"line":67,"address":[855782,854864],"length":1,"stats":{"Line":1}},{"line":71,"address":[855114,854902,854976],"length":1,"stats":{"Line":2}},{"line":72,"address":[855146],"length":1,"stats":{"Line":1}},{"line":73,"address":[855163],"length":1,"stats":{"Line":1}},{"line":75,"address":[855200],"length":1,"stats":{"Line":1}},{"line":77,"address":[855222,855350],"length":1,"stats":{"Line":2}},{"line":79,"address":[855052],"length":1,"stats":{"Line":0}},{"line":85,"address":[855808],"length":1,"stats":{"Line":1}},{"line":89,"address":[855840,857171,857142],"length":1,"stats":{"Line":1}},{"line":96,"address":[855949,856352,856097,856173],"length":1,"stats":{"Line":4}},{"line":97,"address":[855980,856058,856632,856826],"length":1,"stats":{"Line":4}},{"line":98,"address":[856831,856732],"length":1,"stats":{"Line":2}},{"line":99,"address":[856518,856064,856134],"length":1,"stats":{"Line":3}},{"line":100,"address":[856378,856140,856190],"length":1,"stats":{"Line":3}},{"line":101,"address":[856200],"length":1,"stats":{"Line":0}},{"line":102,"address":[856946],"length":1,"stats":{"Line":0}},{"line":103,"address":[857036],"length":1,"stats":{"Line":0}},{"line":108,"address":[857184],"length":1,"stats":{"Line":1}},{"line":109,"address":[857201],"length":1,"stats":{"Line":1}}],"covered":30,"coverable":35},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","fuzz","fuzz_targets","fuzz_crypto.rs"],"content":"#![no_main]\n\n// tor_interface\nuse tor_interface::tor_crypto::*;\n\n// fuzzing\nuse libfuzzer_sys::fuzz_target;\nuse libfuzzer_sys::arbitrary;\nuse libfuzzer_sys::arbitrary::Arbitrary;\n\n#[derive(Arbitrary, Debug)]\nstruct CryptoData\u003c'a\u003e {\n    ed25519_public_raw: [u8; 32],\n    onion_service_id: \u0026'a str,\n    x25519_public_raw: [u8; 32],\n    message_1: \u0026'a [u8],\n    message_2: \u0026'a [u8],\n    ed25519_private_raw_1: [u8; 64],\n    ed25519_private_raw_2: [u8; 64],\n    x25519_private_raw_1: [u8; 32],\n    x25519_private_raw_2: [u8; 32],\n}\n\nfuzz_target!(|data: CryptoData| {\n\n    //\n    // ed25519 tests\n    //\n\n    // ensure random bytes don't break ed25519public from_raw\n    let _ = Ed25519PublicKey::from_raw(\u0026data.ed25519_public_raw);\n\n    // ensure random string doesn't break v3onionserviceid from_string\n    let _ = V3OnionServiceId::from_string(data.onion_service_id);\n\n    // ensure random bytes don't break x25519public from_raw\n    let _ = X25519PublicKey::from_raw(\u0026data.x25519_public_raw);\n\n    // try to build key from raw binary blob, return early if invalid\n    if let Ok(ed25519_private_1) = Ed25519PrivateKey::from_raw(\u0026data.ed25519_private_raw_1) {\n        // ensure key round-trips through keyblob representation\n        assert_eq!(Ed25519PrivateKey::from_key_blob(ed25519_private_1.to_key_blob().as_ref()).unwrap(), ed25519_private_1);\n\n        // ensure key round-trips through raw bytes representation\n        match Ed25519PrivateKey::from_raw(\u0026ed25519_private_1.to_bytes()) {\n            Ok(ed25519_private) =\u003e assert_eq!(ed25519_private, ed25519_private_1),\n            Err(err) =\u003e panic!(\"{:?}\", err),\n        }\n\n        // derive private keys public key\n        let ed25519_public_1 = Ed25519PublicKey::from_private_key(\u0026ed25519_private_1);\n\n        // compare onion service id derivation from public vs privat ekey\n        assert_eq!(V3OnionServiceId::from_private_key(\u0026ed25519_private_1), V3OnionServiceId::from_public_key(\u0026ed25519_public_1));\n        let onion_service_id_1 = V3OnionServiceId::from_public_key(\u0026ed25519_public_1);\n        // ensure service id round-trips through string representation\n        assert_eq!(V3OnionServiceId::from_string(\u0026onion_service_id_1.to_string()).unwrap(), onion_service_id_1);\n\n        // ensure public key round-trips through service id\n        assert_eq!(ed25519_public_1, Ed25519PublicKey::from_service_id(\u0026V3OnionServiceId::from_public_key(\u0026ed25519_public_1)).unwrap());\n\n        // ensure key round-trips through raw bytes representation\n        assert_eq!(ed25519_public_1, Ed25519PublicKey::from_raw(ed25519_public_1.as_bytes()).unwrap());\n\n        // sign and verify a message\n        let ed25519_signature_1 = ed25519_private_1.sign_message(data.message_1);\n        assert!(ed25519_signature_1.verify(data.message_1, \u0026ed25519_public_1));\n        // verify signature does not work for unrelated message\n        if data.message_1 != data.message_2 {\n            assert!(!ed25519_signature_1.verify(data.message_2, \u0026ed25519_public_1));\n        }\n\n        // ensure we can't verfify another key's signature\n        if data.ed25519_private_raw_1 != data.ed25519_private_raw_2 {\n            // try to build key from raw binary blob, return early if invalid\n            if let Ok(ed25519_private_2) = Ed25519PrivateKey::from_raw(\u0026data.ed25519_private_raw_2) {\n\n                // ensure key round-trips through keyblob representation\n                assert_eq!(Ed25519PrivateKey::from_key_blob(ed25519_private_2.to_key_blob().as_ref()).unwrap(), ed25519_private_2);\n\n                // ensure key round-trips through raw bytes representation\n                match Ed25519PrivateKey::from_raw(\u0026ed25519_private_2.to_bytes()) {\n                    Ok(ed25519_private) =\u003e assert_eq!(ed25519_private, ed25519_private_2),\n                    Err(err) =\u003e panic!(\"{:?}\", err),\n                }\n\n                // derive private key's public key\n                let ed25519_public_2 = Ed25519PublicKey::from_private_key(\u0026ed25519_private_2);\n\n                // compare onion service id derivation from public vs privat ekey\n                assert_eq!(V3OnionServiceId::from_private_key(\u0026ed25519_private_2), V3OnionServiceId::from_public_key(\u0026ed25519_public_2));\n                let onion_service_id_2 = V3OnionServiceId::from_public_key(\u0026ed25519_public_2);\n                // ensure service id round-trips through string representation\n                assert_eq!(V3OnionServiceId::from_string(\u0026onion_service_id_2.to_string()).unwrap(), onion_service_id_2);\n\n                // ensure public key round-trips through service id\n                assert_eq!(ed25519_public_2, Ed25519PublicKey::from_service_id(\u0026V3OnionServiceId::from_public_key(\u0026ed25519_public_2)).unwrap());\n\n                // ensure key round-trips through raw bytes representation\n                assert_eq!(ed25519_public_2, Ed25519PublicKey::from_raw(ed25519_public_2.as_bytes()).unwrap());\n\n\n                // sign and verify a message\n                let ed25519_signature_2 = ed25519_private_2.sign_message(data.message_2);\n                assert!(ed25519_signature_2.verify(data.message_2, \u0026ed25519_public_2));\n\n                // verify signature does not work for unrelated message\n                if data.message_1 != data.message_2 {\n                    assert!(!ed25519_signature_2.verify(data.message_1, \u0026ed25519_public_2));\n                }\n\n                // verify we cannot verify signatures using the wrong public keys\n                if ed25519_public_1 != ed25519_public_2 {\n                    assert!(!ed25519_signature_1.verify(data.message_1, \u0026ed25519_public_2));\n                    assert!(!ed25519_signature_2.verify(data.message_2, \u0026ed25519_public_1));\n                }\n            }\n        }\n    }\n\n    //\n    // x25519 tests\n    //\n\n    if let Ok(x25519_private_1) = X25519PrivateKey::from_raw(\u0026data.x25519_private_raw_1) {\n        // ensure round-trips through byte representation\n        assert_eq!(x25519_private_1, X25519PrivateKey::from_raw(\u0026x25519_private_1.to_bytes()).unwrap());\n        assert_eq!(data.x25519_private_raw_1, x25519_private_1.to_bytes());\n        // ensure round-trips through base64 representation\n        assert_eq!(x25519_private_1, X25519PrivateKey::from_base64(\u0026x25519_private_1.to_base64()).unwrap());\n\n        // ensure converts to e25519 without issue\n        let _ = Ed25519PrivateKey::from_private_x25519(\u0026x25519_private_1).unwrap();\n\n        let x25519_public_1 = X25519PublicKey::from_private_key(\u0026x25519_private_1);\n        // ensure round-trips through byte representation\n        assert_eq!(x25519_public_1, X25519PublicKey::from_raw(x25519_public_1.as_bytes()));\n        // ensure round-trips through base32 representation\n        assert_eq!(x25519_public_1, X25519PublicKey::from_base32(\u0026x25519_public_1.to_base32()).unwrap());\n\n        if let Ok(x25519_private_2) = X25519PrivateKey::from_raw(\u0026data.x25519_private_raw_2) {\n            // ensure round-trips through byte representation\n            assert_eq!(x25519_private_2, X25519PrivateKey::from_raw(\u0026x25519_private_2.to_bytes()).unwrap());\n            assert_eq!(data.x25519_private_raw_2, x25519_private_2.to_bytes());\n            // ensure round-trips through base64 representation\n            assert_eq!(x25519_private_2, X25519PrivateKey::from_base64(\u0026x25519_private_2.to_base64()).unwrap());\n\n            // ensure converts to e25519 without issue\n            let _ = Ed25519PrivateKey::from_private_x25519(\u0026x25519_private_2).unwrap();\n\n            let x25519_public_2 = X25519PublicKey::from_private_key(\u0026x25519_private_2);\n            // ensure round-trips through byte representation\n            assert_eq!(x25519_public_2, X25519PublicKey::from_raw(x25519_public_2.as_bytes()));\n            // ensure round-trips through base32 representation\n            assert_eq!(x25519_public_2, X25519PublicKey::from_base32(\u0026x25519_public_2.to_base32()).unwrap());\n        }\n    }\n\n\n});\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","arti_client_tor_client.rs"],"content":"// standard\nuse std::net::SocketAddr;\nuse std::ops::DerefMut;\nuse std::path::{Path, PathBuf};\nuse std::sync::atomic::{AtomicBool, Ordering};\nuse std::sync::{Arc, Mutex};\n\n//extern\nuse arti_client::config::{CfgPath, TorClientConfigBuilder};\nuse arti_client::{BootstrapBehavior, DangerouslyIntoTorAddr, IntoTorAddr, TorClient};\nuse fs_mistrust::Mistrust;\nuse tokio::io::{AsyncReadExt, AsyncWriteExt};\nuse tokio::net::{TcpListener, TcpStream};\nuse tokio::runtime;\nuse tokio_stream::StreamExt;\nuse tor_cell::relaycell::msg::Connected;\nuse tor_hscrypto::pk::HsIdKeypair;\nuse tor_hsservice::config::OnionServiceConfigBuilder;\nuse tor_hsservice::{HsIdKeypairSpecifier, HsNickname, OnionServiceBuilder, RunningOnionService};\nuse tor_keymgr::{ArtiEphemeralKeystore, KeyMgrBuilder, KeystoreSelector};\nuse tor_llcrypto::pk::ed25519::ExpandedKeypair;\nuse tor_persist::state_dir::StateDirectory;\nuse tor_proto::stream::IncomingStreamRequest;\nuse tor_rtcompat::PreferredRuntime;\n\n// internal crates\nuse crate::tor_crypto::*;\nuse crate::tor_provider;\nuse crate::tor_provider::*;\n\n/// [`ArtiClientTorClient`]-specific error type\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"not implemented\")]\n    NotImplemented(),\n\n    #[error(\"unable to bind TCP listener\")]\n    TcpListenerBindFailed(#[source] std::io::Error),\n\n    #[error(\"unable to get TCP listener's local address\")]\n    TcpListenerLocalAddrFailed(#[source] std::io::Error),\n\n    #[error(\"unable to accept connection on TCP Listener\")]\n    TcpListenerAcceptFailed(#[source] std::io::Error),\n\n    #[error(\"unable to connect to TCP listener\")]\n    TcpStreamConnectFailed(#[source] std::io::Error),\n\n    #[error(\"unable to convert tokio::TcpStream to std::net::TcpStream\")]\n    TcpStreamIntoFailed(#[source] std::io::Error),\n\n    #[error(\"arti-client config-builder error: {0}\")]\n    ArtiClientConfigBuilderError(#[source] arti_client::config::ConfigBuildError),\n\n    #[error(\"arti-client error: {0}\")]\n    ArtiClientError(#[source] arti_client::Error),\n\n    #[error(\"arti-client tor-addr error: {0}\")]\n    ArtiClientTorAddrError(#[source] arti_client::TorAddrError),\n\n    #[error(\"tor-keymgr error: {0}\")]\n    TorKeyMgrError(#[source] tor_keymgr::Error),\n\n    // TODO: the 'real' error (tor_keymgr::mgr::KeyMgrBuilderError) isn't\n    // actually defined anywhere from what I can tell\n    #[error(\"failed to build KeyMgr\")]\n    TorKeyMgrBuilderError(),\n\n    #[error(\"unexpected key found when inserting HsIdKeypair\")]\n    KeyMgrInsertionFailure(),\n\n    #[error(\"onion-service config-builder error: {0}\")]\n    OnionServiceConfigBuilderError(#[source] tor_config::ConfigBuildError),\n\n    #[error(\"tor-persist error: {0}\")]\n    TorPersistError(#[source] tor_persist::Error),\n\n    #[error(\"tor-hsservice startup error: {0}\")]\n    TorHsServiceStartupError(#[source] tor_hsservice::StartupError),\n}\n\nimpl From\u003cError\u003e for crate::tor_provider::Error {\n    fn from(error: Error) -\u003e Self {\n        crate::tor_provider::Error::Generic(error.to_string())\n    }\n}\n\n/// The `ArtiClientTorClient` is an in-process [`arti-client`](https://crates.io/crates/arti-client)-based [`TorProvider`].\n///\n///\npub struct ArtiClientTorClient {\n    tokio_runtime: Arc\u003cruntime::Runtime\u003e,\n    arti_client: TorClient\u003cPreferredRuntime\u003e,\n    state_dir: PathBuf,\n    fs_mistrust: Mistrust,\n    pending_events: Arc\u003cMutex\u003cVec\u003cTorEvent\u003e\u003e\u003e,\n}\n\n// used to forward traffic to/from arti to local tcp streams\nasync fn forward_stream\u003cR, W\u003e(alive: Arc\u003cAtomicBool\u003e, mut reader: R, mut writer: W) -\u003e ()\nwhere\n    R: AsyncReadExt + Unpin,\n    W: AsyncWriteExt + Unpin,\n{\n    // allow 100ms timeout on reads to verify writer is still good\n    let read_timeout = std::time::Duration::from_millis(100);\n    // allow additional retries in the event the other half of the pump\n    // dies; keep pumping data until our read times out 3 times\n    let mut remaining_retries = 3;\n    let mut buf = [0u8; 1024];\n\n    loop {\n        if !alive.load(Ordering::Relaxed) \u0026\u0026 remaining_retries == 0 {\n            break;\n        }\n\n        tokio::select! {\n            count = reader.read(\u0026mut buf) =\u003e match count {\n                // end of stream\n                Ok(0) =\u003e break,\n                // read N bytes\n                Ok(count) =\u003e {\n                    // forward traffic\n                    match writer.write_all(\u0026buf[0..count]).await {\n                        Ok(()) =\u003e (),\n                        Err(_err) =\u003e break,\n                    }\n                    match writer.flush().await {\n                        Ok(()) =\u003e (),\n                        Err(_err) =\u003e break,\n                    }\n                },\n                // read failed\n                Err(_err) =\u003e break,\n            },\n            _ = tokio::time::sleep(read_timeout.clone()) =\u003e match writer.flush().await {\n                Ok(()) =\u003e {\n                    // so long as our writer and reader are good, we should\n                    // allow a few additional data pump attempts\n                    if !alive.load(Ordering::Relaxed) {\n                        remaining_retries -= 1;\n                    }\n                },\n                Err(_err) =\u003e break,\n            }\n        }\n    }\n    // signal pump death\n    alive.store(false, Ordering::Relaxed);\n}\n\nimpl ArtiClientTorClient {\n    /// Construct a new `ArtiClientTorClient` which uses a [Tokio](https://crates.io/crates/tokio) runtime internally for all async operations.\n    pub fn new(\n        tokio_runtime: Arc\u003cruntime::Runtime\u003e,\n        root_data_directory: \u0026Path,\n    ) -\u003e Result\u003cSelf, Error\u003e {\n        // set custom config options\n        let mut config_builder: TorClientConfigBuilder = Default::default();\n\n        // manually set arti cache and data directories so we can have\n        // multiple concurrent instances and control where it writes\n        let mut cache_dir = PathBuf::from(root_data_directory);\n        cache_dir.push(\"cache\");\n        config_builder\n            .storage()\n            .cache_dir(CfgPath::new_literal(cache_dir));\n\n        let mut state_dir = PathBuf::from(root_data_directory);\n        state_dir.push(\"state\");\n        config_builder\n            .storage()\n            .state_dir(CfgPath::new_literal(state_dir.clone()));\n\n        // disable access to clearnet addresses and enable access to onion services\n        config_builder\n            .address_filter()\n            .allow_local_addrs(false)\n            .allow_onion_addrs(true);\n\n        let config = match config_builder.build() {\n            Ok(config) =\u003e config,\n            Err(err) =\u003e return Err(err).map_err(Error::ArtiClientConfigBuilderError),\n        };\n\n        let fs_mistrust = config.fs_mistrust().clone();\n\n        let arti_client = tokio_runtime.block_on(async {\n            TorClient::builder()\n                .config(config)\n                .bootstrap_behavior(BootstrapBehavior::Manual)\n                .create_unbootstrapped()\n                .map_err(Error::ArtiClientError)\n\n            // TODO: implement TorEvent::LogReceived events once upstream issue is resolved:\n            // https://gitlab.torproject.org/tpo/core/arti/-/issues/1356\n        })?;\n\n        let pending_events = std::vec![TorEvent::LogReceived {\n            line: \"Starting arti-client TorProvider\".to_string()\n        }];\n        let pending_events = Arc::new(Mutex::new(pending_events));\n\n        Ok(Self {\n            tokio_runtime,\n            arti_client,\n            state_dir,\n            fs_mistrust,\n            pending_events,\n        })\n    }\n}\n\nimpl TorProvider for ArtiClientTorClient {\n    fn update(\u0026mut self) -\u003e Result\u003cVec\u003cTorEvent\u003e, tor_provider::Error\u003e {\n        std::thread::sleep(std::time::Duration::from_millis(16));\n        match self.pending_events.lock() {\n            Ok(mut pending_events) =\u003e Ok(std::mem::take(pending_events.deref_mut())),\n            Err(_) =\u003e {\n                unreachable!(\"another thread panicked while holding this pending_events mutex\")\n            }\n        }\n    }\n\n    fn bootstrap(\u0026mut self) -\u003e Result\u003c(), tor_provider::Error\u003e {\n        // save progress events\n        let mut bootstrap_events = self.arti_client.bootstrap_events();\n        let pending_events = self.pending_events.clone();\n        self.tokio_runtime.spawn(async move {\n            while let Some(evt) = bootstrap_events.next().await {\n                match pending_events.lock() {\n                    Ok(mut pending_events) =\u003e {\n                        pending_events.push(TorEvent::BootstrapStatus {\n                            progress: (evt.as_frac().clamp(0.0f32, 1.0f32) * 100f32) as u32,\n                            tag: \"no-tag\".to_string(),\n                            summary: \"no summary\".to_string(),\n                        });\n                        // TODO: properly handle evt.blocked() with a new TorEvent::Error or something\n                    }\n                    Err(_) =\u003e unreachable!(\n                        \"another thread panicked while holding this pending_events mutex\"\n                    ),\n                }\n            }\n        });\n\n        // initiate bootstrap\n        let arti_client = self.arti_client.clone();\n        let pending_events = self.pending_events.clone();\n        self.tokio_runtime.spawn(async move {\n            match arti_client.bootstrap().await {\n                Ok(()) =\u003e match pending_events.lock() {\n                    Ok(mut pending_events) =\u003e {\n                        pending_events.push(TorEvent::BootstrapComplete);\n                        return;\n                    }\n                    Err(_) =\u003e unreachable!(\n                        \"another thread panicked while holding this pending_events mutex\"\n                    ),\n                },\n                Err(_err) =\u003e {\n                    // TODO: add an error event to TorEvent\n                }\n            }\n        });\n\n        Ok(())\n    }\n\n    fn add_client_auth(\n        \u0026mut self,\n        _service_id: \u0026V3OnionServiceId,\n        _client_auth: \u0026X25519PrivateKey,\n    ) -\u003e Result\u003c(), tor_provider::Error\u003e {\n        Err(Error::NotImplemented().into())\n    }\n\n    fn remove_client_auth(\n        \u0026mut self,\n        _service_id: \u0026V3OnionServiceId,\n    ) -\u003e Result\u003c(), tor_provider::Error\u003e {\n        Err(Error::NotImplemented().into())\n    }\n\n    fn connect(\n        \u0026mut self,\n        target: TargetAddr,\n        circuit: Option\u003cCircuitToken\u003e,\n    ) -\u003e Result\u003cOnionStream, tor_provider::Error\u003e {\n        // stream isolation not implemented yet\n        if circuit.is_some() {\n            return Err(Error::NotImplemented().into());\n        }\n\n        // connect to onion service\n        let arti_target = match target.clone() {\n            TargetAddr::Socket(socket_addr) =\u003e socket_addr.into_tor_addr_dangerously(),\n            TargetAddr::Domain(domain_addr) =\u003e {\n                (domain_addr.domain(), domain_addr.port()).into_tor_addr()\n            }\n            TargetAddr::OnionService(OnionAddr::V3(OnionAddrV3 {\n                service_id,\n                virt_port,\n            })) =\u003e (format!(\"{}.onion\", service_id), virt_port).into_tor_addr(),\n        }\n        .map_err(Error::ArtiClientTorAddrError)?;\n\n        let arti_client = self.arti_client.clone();\n        let data_stream = self\n            .tokio_runtime\n            .block_on(async move { arti_client.connect(arti_target).await })\n            .map_err(Error::ArtiClientError)?;\n\n        // start a task to forward traffic from returned data stream\n        // and tcp socket\n        let client_stream = self.tokio_runtime.block_on(async move {\n            let (data_reader, data_writer) = data_stream.split();\n\n            // try to bind to a local address, let OS pick our port\n            let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n            let server_listener = TcpListener::bind(socket_addr)\n                .await\n                .map_err(Error::TcpListenerBindFailed)?;\n            // await future after a client connects\n            let server_accept_future = server_listener.accept();\n            let socket_addr = server_listener\n                .local_addr()\n                .map_err(Error::TcpListenerLocalAddrFailed)?;\n\n            // client stream will ultimatley be returned from connect()\n            let client_stream = TcpStream::connect(socket_addr)\n                .await\n                .map_err(Error::TcpStreamConnectFailed)?;\n            // client has connected so now get the server's tcp stream\n            let (server_stream, _socket_addr) = server_accept_future\n                .await\n                .map_err(Error::TcpListenerAcceptFailed)?;\n            let (tcp_reader, tcp_writer) = server_stream.into_split();\n\n            // now spawn new tasks to forward traffic to/from local listener\n            let pump_alive = Arc::new(AtomicBool::new(true));\n            tokio::task::spawn({\n                let pump_alive = pump_alive.clone();\n                async move {\n                    forward_stream(pump_alive, tcp_reader, data_writer).await;\n                }\n            });\n            tokio::task::spawn(async move {\n                forward_stream(pump_alive, data_reader, tcp_writer).await;\n            });\n            Ok::\u003cTcpStream, tor_provider::Error\u003e(client_stream)\n        })?;\n\n        let stream = client_stream\n            .into_std()\n            .map_err(Error::TcpStreamIntoFailed)?;\n        Ok(OnionStream {\n            stream,\n            local_addr: None,\n            peer_addr: Some(target),\n        })\n    }\n\n    fn listener(\n        \u0026mut self,\n        private_key: \u0026Ed25519PrivateKey,\n        virt_port: u16,\n        authorized_clients: Option\u003c\u0026[X25519PublicKey]\u003e,\n    ) -\u003e Result\u003cOnionListener, tor_provider::Error\u003e {\n        // client auth is not implemented yet\n        if authorized_clients.is_some() {\n            return Err(Error::NotImplemented().into());\n        }\n\n        // try to bind to a local address, let OS pick our port\n        let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n        // TODO: make this one async too\n        let listener =\n            std::net::TcpListener::bind(socket_addr).map_err(Error::TcpListenerBindFailed)?;\n        let socket_addr = listener\n            .local_addr()\n            .map_err(Error::TcpListenerLocalAddrFailed)?;\n\n        // create a new ephemeral store for storing our onion service keys\n        let ephemeral_store: ArtiEphemeralKeystore =\n            ArtiEphemeralKeystore::new(\"ephemeral\".to_string());\n        let keymgr = match KeyMgrBuilder::default()\n            .default_store(Box::new(ephemeral_store))\n            .build()\n        {\n            Ok(keymgr) =\u003e keymgr,\n            Err(_) =\u003e return Err(Error::TorKeyMgrBuilderError().into()),\n        };\n\n        // generate a nickname to identify this onion service\n        let service_id = V3OnionServiceId::from_private_key(private_key);\n        let hs_nickname = match HsNickname::new(service_id.to_string()) {\n            Ok(nickname) =\u003e nickname,\n            Err(_) =\u003e {\n                panic!(\"v3 onion service id string representation should be a valid HsNickname\")\n            }\n        };\n\n        let hs_id_spec = HsIdKeypairSpecifier::new(hs_nickname.clone());\n        // generate a new HsIdKeypair (from an Ed25519PrivateKey)\n        // clone() isn't implemented for ExpandedKeypair \u003e:[\n        let secret_key_bytes = private_key.inner().to_secret_key_bytes();\n        let expanded_keypair = ExpandedKeypair::from_secret_key_bytes(secret_key_bytes)\n            .unwrap()\n            .into();\n\n        // write the HsIdKeypair to keymgr\n        // TODO: for now this should return Ok(None) unless we persist the ephemeral store longer-term (ie for client auth keys in the future)\n        match keymgr.insert::\u003cHsIdKeypair\u003e(expanded_keypair, \u0026hs_id_spec, KeystoreSelector::Default)\n        {\n            Ok(None) =\u003e (), // expected\n            Ok(Some(_)) =\u003e return Err(Error::KeyMgrInsertionFailure().into()),\n            Err(err) =\u003e Err(err).map_err(Error::TorKeyMgrError)?,\n        }\n\n        // create an OnionServiceConfig with the ephemeral nickname\n        let onion_service_config = match OnionServiceConfigBuilder::default()\n            .nickname(hs_nickname)\n            .build()\n        {\n            Ok(onion_service_config) =\u003e onion_service_config,\n            Err(err) =\u003e Err(err).map_err(Error::OnionServiceConfigBuilderError)?,\n        };\n\n        // create OnionService\n        let state_dir = match StateDirectory::new(self.state_dir.as_path(), \u0026self.fs_mistrust) {\n            Ok(state_dir) =\u003e state_dir,\n            Err(err) =\u003e Err(err).map_err(Error::TorPersistError)?,\n        };\n\n        let onion_service = match OnionServiceBuilder::default()\n            .config(onion_service_config)\n            .keymgr(Arc::new(keymgr))\n            .state_dir(state_dir)\n            .build()\n        {\n            Ok(onion_service) =\u003e onion_service,\n            Err(err) =\u003e Err(err).map_err(Error::TorHsServiceStartupError)?,\n        };\n\n        let onion_addr = OnionAddr::V3(OnionAddrV3::new(service_id.clone(), virt_port));\n\n        // launch the OnionService and get a Stream of RendRequest\n        let runtime = self.arti_client.runtime().clone();\n        let dirmgr = self.arti_client.dirmgr().clone().upcast_arc();\n        let hs_circ_pool = self.arti_client.hs_circ_pool().clone();\n\n        let (onion_service, mut rend_requests) = onion_service\n            .launch(runtime, dirmgr, hs_circ_pool)\n            .map_err(Error::TorHsServiceStartupError)?;\n\n        // start a task to signal onion service published\n        let pending_events = self.pending_events.clone();\n        let mut status_events = onion_service.status_events();\n        self.tokio_runtime.spawn(async move {\n            while let Some(evt) = status_events.next().await {\n                match evt.state() {\n                    tor_hsservice::status::State::Running =\u003e match pending_events.lock() {\n                        Ok(mut pending_events) =\u003e {\n                            pending_events.push(TorEvent::OnionServicePublished { service_id });\n                            return;\n                        }\n                        Err(_) =\u003e unreachable!(\n                            \"another thread panicked while holding this pending_events mutex\"\n                        ),\n                    },\n                    _ =\u003e (),\n                }\n            }\n        });\n\n        // start a task which accepts every RendRequest to get a StreamRequest\n        self.tokio_runtime.spawn(async move {\n            while let Some(request) = rend_requests.next().await {\n                let mut stream_requests = match request.accept().await {\n                    Ok(stream_requests) =\u003e stream_requests,\n                    // TODO: probably not our problem?\n                    _ =\u003e return,\n                };\n                // spawn a new task to consume the stream requsts\n                tokio::task::spawn(async move {\n                    while let Some(stream_request) = stream_requests.next().await {\n                        let should_accept =\n                            if let IncomingStreamRequest::Begin(begin) = stream_request.request() {\n                                // we only accept connections on the virt port\n                                begin.port() == virt_port\n                            } else {\n                                false\n                            };\n\n                        if should_accept {\n                            let data_stream =\n                                match stream_request.accept(Connected::new_empty()).await {\n                                    Ok(data_stream) =\u003e data_stream,\n                                    // TODO: probably not our problem\n                                    _ =\u003e continue,\n                                };\n                            let (data_reader, data_writer) = data_stream.split();\n\n                            let (tcp_reader, tcp_writer) =\n                                match TcpStream::connect(socket_addr).await {\n                                    Ok(tcp_stream) =\u003e tcp_stream.into_split(),\n                                    // TODO: possibly our problem?\n                                    _ =\u003e continue,\n                                };\n                            // now spawn new tasks to forward traffic to/from the onion listener\n\n                            let pump_alive = Arc::new(AtomicBool::new(true));\n                            // read from connected client and write to local socket\n                            tokio::task::spawn({\n                                let pump_alive = pump_alive.clone();\n                                async move {\n                                    forward_stream(pump_alive, data_reader, tcp_writer).await;\n                                }\n                            });\n                            // read from local socket and write to connected client\n                            tokio::task::spawn(async move {\n                                forward_stream(pump_alive, tcp_reader, data_writer).await;\n                            });\n                        } else {\n                            // either requesting the wrong port or the wrong type of stream request\n                            let _ = stream_request.shutdown_circuit();\n                        }\n                    }\n                });\n            }\n        });\n\n        // onion-service is torn down when `onion_service` is dropped\n        Ok(OnionListener::new::\u003cArc\u003cRunningOnionService\u003e\u003e(listener, onion_addr, onion_service, |_|{}))\n    }\n\n    fn generate_token(\u0026mut self) -\u003e CircuitToken {\n        0usize\n    }\n\n    fn release_token(\u0026mut self, _token: CircuitToken) {}\n}\n","traces":[{"line":106,"address":[],"length":0,"stats":{"Line":0}},{"line":109,"address":[],"length":0,"stats":{"Line":0}},{"line":110,"address":[],"length":0,"stats":{"Line":0}},{"line":112,"address":[],"length":0,"stats":{"Line":0}},{"line":113,"address":[],"length":0,"stats":{"Line":0}},{"line":114,"address":[],"length":0,"stats":{"Line":0}},{"line":117,"address":[],"length":0,"stats":{"Line":0}},{"line":118,"address":[],"length":0,"stats":{"Line":0}},{"line":120,"address":[],"length":0,"stats":{"Line":0}},{"line":122,"address":[],"length":0,"stats":{"Line":0}},{"line":124,"address":[],"length":0,"stats":{"Line":0}},{"line":125,"address":[],"length":0,"stats":{"Line":0}},{"line":126,"address":[],"length":0,"stats":{"Line":0}},{"line":128,"address":[],"length":0,"stats":{"Line":0}},{"line":129,"address":[],"length":0,"stats":{"Line":0}},{"line":130,"address":[],"length":0,"stats":{"Line":0}},{"line":134,"address":[],"length":0,"stats":{"Line":0}},{"line":136,"address":[],"length":0,"stats":{"Line":0}},{"line":137,"address":[],"length":0,"stats":{"Line":0}},{"line":140,"address":[],"length":0,"stats":{"Line":0}},{"line":141,"address":[],"length":0,"stats":{"Line":0}},{"line":144,"address":[],"length":0,"stats":{"Line":0}},{"line":149,"address":[],"length":0,"stats":{"Line":0}}],"covered":0,"coverable":23},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","censorship_circumvention.rs"],"content":"// standard\nuse std::net::SocketAddr;\nuse std::path::PathBuf;\nuse std::str::FromStr;\nuse std::sync::OnceLock;\n\n// extern crates\nuse regex::Regex;\n\n#[derive(Clone, Debug)]\n/// Configuration for a pluggable-transport\npub struct PluggableTransportConfig {\n    transports: Vec\u003cString\u003e,\n    path_to_binary: PathBuf,\n    options: Vec\u003cString\u003e,\n}\n\n#[derive(thiserror::Error, Debug)]\n/// Error returned on failure to construct a [`PluggableTransportConfig`]\npub enum PluggableTransportConfigError {\n    #[error(\"pluggable transport name '{0}' is invalid\")]\n    /// transport names must be a valid C identifier\n    TransportNameInvalid(String),\n    #[error(\"unable to use '{0}' as pluggable transport binary path, {1}\")]\n    /// configuration only allows aboslute paths to binaries\n    BinaryPathInvalid(String, String),\n}\n\n// per the PT spec: https://github.com/Pluggable-Transports/Pluggable-Transports-spec/blob/main/releases/PTSpecV1.0/pt-1_0.txt\nstatic TRANSPORT_PATTERN: OnceLock\u003cRegex\u003e = OnceLock::new();\nfn init_transport_pattern() -\u003e Regex {\n    Regex::new(r\"(?m)^[a-zA-Z_][a-zA-Z0-9_]*$\").unwrap()\n}\n\n/// Configuration struct for a pluggable-transport which conforms to the v1.0 pluggable-transport [specification](https://github.com/Pluggable-Transports/Pluggable-Transports-spec/blob/main/releases/PTSpecV1.0/pt-1_0.txt)\nimpl PluggableTransportConfig {\n    /// Construct a new `PluggableTransportConfig`. Each `transport` string must be a [valid C identifier](https://github.com/Pluggable-Transports/Pluggable-Transports-spec/blob/c92e59a9fa6ba11c181f4c5ec9d533eaa7d9d7f3/releases/PTSpecV1.0/pt-1_0.txt#L144) while `path_to_binary` must be an absolute path.\n    pub fn new(\n        transports: Vec\u003cString\u003e,\n        path_to_binary: PathBuf,\n    ) -\u003e Result\u003cSelf, PluggableTransportConfigError\u003e {\n        let transport_pattern = TRANSPORT_PATTERN.get_or_init(init_transport_pattern);\n        // validate each transport\n        for transport in \u0026transports {\n            if !transport_pattern.is_match(\u0026transport) {\n                return Err(PluggableTransportConfigError::TransportNameInvalid(\n                    transport.clone(),\n                ));\n            }\n        }\n\n        // pluggable transport path must be absolute so we can fix it up for individual\n        // TorProvider implementations\n        if !path_to_binary.is_absolute() {\n            return Err(PluggableTransportConfigError::BinaryPathInvalid(\n                format!(\"{:?}\", path_to_binary.display()),\n                \"must be an absolute path\".to_string(),\n            ));\n        }\n\n        Ok(Self {\n            transports,\n            path_to_binary,\n            options: Default::default(),\n        })\n    }\n\n    /// Get a reference to this `PluggableTransportConfig`'s list of transports.\n    pub fn transports(\u0026self) -\u003e \u0026Vec\u003cString\u003e {\n        \u0026self.transports\n    }\n\n    /// Get a reference to this `PluggableTransportConfig`'s `PathBuf` containing the absolute path to the pluggable-transport binary.\n    pub fn path_to_binary(\u0026self) -\u003e \u0026PathBuf {\n        \u0026self.path_to_binary\n    }\n\n    /// Get a reference to this `PluggableTransportConfig`'s list of command-line options\n    pub fn options(\u0026self) -\u003e \u0026Vec\u003cString\u003e {\n        \u0026self.options\n    }\n\n    /// Add a command-line option used to invoke this pluggable-transport.\n    pub fn add_option(\u0026mut self, arg: String) {\n        self.options.push(arg);\n    }\n}\n\n/// Configuration for a bridge line to be used with a pluggable-transport\n#[derive(Clone, Debug)]\npub struct BridgeLine {\n    transport: String,\n    address: SocketAddr,\n    fingerprint: String,\n    keyvalues: Vec\u003c(String, String)\u003e,\n}\n\n#[derive(thiserror::Error, Debug)]\n/// Error returned on failure to construct a [`BridgeLine`]\npub enum BridgeLineError {\n    #[error(\"bridge line '{0}' missing transport\")]\n    /// Provided bridge line missing transport\n    TransportMissing(String),\n\n    #[error(\"bridge line '{0}' missing address\")]\n    /// Provided bridge line missing address\n    AddressMissing(String),\n\n    #[error(\"bridge line '{0}' missing fingerprint\")]\n    /// Provided bridge line missing fingerprint\n    FingerprintMissing(String),\n\n    #[error(\"transport name '{0}' is invalid\")]\n    /// Invalid transport name (must be a valid C identifier)\n    TransportNameInvalid(String),\n\n    #[error(\"address '{0}' cannot be parsed as IP:PORT\")]\n    /// Provided bridge line's address not parseable\n    AddressParseFailed(String),\n\n    #[error(\"key=value '{0}' is invalid\")]\n    /// A key/value pair in invalid format\n    KeyValueInvalid(String),\n\n    #[error(\"bridge address port must not be 0\")]\n    /// Invalid bridge address port\n    AddressPortInvalid,\n\n    #[error(\"fingerprint '{0}' is invalid\")]\n    /// Fingerprint is not parseable (must be length 40 base16 string)\n    FingerprintInvalid(String),\n}\n\n/// A `BridgeLine` contains the information required to connect to a bridge through the means of a particular pluggable-transport (defined in a `PluggableTransportConfi`). For more information, see:\n/// - [https://tb-manual.torproject.org/bridges/](https://tb-manual.torproject.org/bridges/)\nimpl BridgeLine {\n    /// Construct a new `BridgeLine` from its constiuent parts. The `transport` argument must be a valid C identifier and must have an associated `transport` defined in an associated `PluggableTransportConfig`. The `address` must have a non-zero port. The `fingerprint` is a length 40 base16-encoded string. Finally, the keys in the `keyvalues` list must not contain space (` `) or equal (`=`) characters.\n    ///\n    /// In practice, bridge lines are distributed as entire strings so most consumers of these APIs are not likely to need this particular function.\n    pub fn new(\n        transport: String,\n        address: SocketAddr,\n        fingerprint: String,\n        keyvalues: Vec\u003c(String, String)\u003e,\n    ) -\u003e Result\u003cBridgeLine, BridgeLineError\u003e {\n        let transport_pattern = TRANSPORT_PATTERN.get_or_init(init_transport_pattern);\n\n        // transports have a particular pattern\n        if !transport_pattern.is_match(\u0026transport) {\n            return Err(BridgeLineError::TransportNameInvalid(transport));\n        }\n\n        // port can't be 0\n        if address.port() == 0 {\n            return Err(BridgeLineError::AddressPortInvalid);\n        }\n\n        static BRIDGE_FINGERPRINT_PATTERN: OnceLock\u003cRegex\u003e = OnceLock::new();\n        let bridge_fingerprint_pattern = BRIDGE_FINGERPRINT_PATTERN\n            .get_or_init(|| Regex::new(r\"(?m)^[0-9a-fA-F]{40}$\").unwrap());\n\n        // fingerprint should be a sha1 hash\n        if !bridge_fingerprint_pattern.is_match(\u0026fingerprint) {\n            return Err(BridgeLineError::FingerprintInvalid(fingerprint));\n        }\n\n        // validate key-values\n        for (key, value) in \u0026keyvalues {\n            if key.contains(' ') || key.contains('=') || key.len() == 0 {\n                return Err(BridgeLineError::KeyValueInvalid(format!(\"{key}={value}\")));\n            }\n        }\n\n        Ok(Self {\n            transport,\n            address,\n            fingerprint,\n            keyvalues,\n        })\n    }\n\n    /// Get a reference to this `BridgeLine`'s transport field.\n    pub fn transport(\u0026self) -\u003e \u0026String {\n        \u0026self.transport\n    }\n\n    /// Get a reference to this `BridgeLine`'s address field.\n    pub fn address(\u0026self) -\u003e \u0026SocketAddr {\n        \u0026self.address\n    }\n\n    /// Get a reference to this `BridgeLine`'s fingerprint field.\n    pub fn fingerprint(\u0026self) -\u003e \u0026String {\n        \u0026self.fingerprint\n    }\n\n    /// Get a reference to this `BridgeLine`'s key/values field.\n    pub fn keyvalues(\u0026self) -\u003e \u0026Vec\u003c(String, String)\u003e {\n        \u0026self.keyvalues\n    }\n\n    #[cfg(feature = \"legacy-tor-provider\")]\n    /// Serialise this `BridgeLine` to the value set via `SETCONF Bridge...` legacy c-tor control-port command.\n    pub fn as_legacy_tor_setconf_value(\u0026self) -\u003e String {\n        let transport = \u0026self.transport;\n        let address = self.address.to_string();\n        let fingerprint = self.fingerprint.to_string();\n        let keyvalues: Vec\u003cString\u003e = self\n            .keyvalues\n            .iter()\n            .map(|(key, value)| format!(\"{key}={value}\"))\n            .collect();\n        let keyvalues = keyvalues.join(\" \");\n\n        format!(\"{transport} {address} {fingerprint} {keyvalues}\")\n    }\n}\n\nimpl FromStr for BridgeLine {\n    type Err = BridgeLineError;\n    fn from_str(s: \u0026str) -\u003e Result\u003cSelf, Self::Err\u003e {\n        let mut tokens = s.split(' ');\n        // get transport name\n        let transport = if let Some(transport) = tokens.next() {\n            transport\n        } else {\n            return Err(BridgeLineError::TransportMissing(s.to_string()));\n        };\n        // get bridge address\n        let address = if let Some(address) = tokens.next() {\n            if let Ok(address) = SocketAddr::from_str(address) {\n                address\n            } else {\n                return Err(BridgeLineError::AddressParseFailed(address.to_string()));\n            }\n        } else {\n            return Err(BridgeLineError::AddressMissing(s.to_string()));\n        };\n        // get the bridge fingerprint\n        let fingerprint = if let Some(fingerprint) = tokens.next() {\n            fingerprint\n        } else {\n            return Err(BridgeLineError::FingerprintMissing(s.to_string()));\n        };\n\n        // get the bridge options\n        static BRIDGE_OPTION_PATTERN: OnceLock\u003cRegex\u003e = OnceLock::new();\n        let bridge_option_pattern = BRIDGE_OPTION_PATTERN\n            .get_or_init(|| Regex::new(r\"(?m)^(?\u003ckey\u003e[^=]+)=(?\u003cvalue\u003e.*)$\").unwrap());\n\n        let mut keyvalues: Vec\u003c(String, String)\u003e = Default::default();\n        while let Some(keyvalue) = tokens.next() {\n            if let Some(caps) = bridge_option_pattern.captures(\u0026keyvalue) {\n                let key = caps\n                    .name(\"key\")\n                    .expect(\"missing key group\")\n                    .as_str()\n                    .to_string();\n                let value = caps\n                    .name(\"value\")\n                    .expect(\"missing value group\")\n                    .as_str()\n                    .to_string();\n                keyvalues.push((key, value));\n            } else {\n                return Err(BridgeLineError::KeyValueInvalid(keyvalue.to_string()));\n            }\n        }\n\n        BridgeLine::new(\n            transport.to_string(),\n            address,\n            fingerprint.to_string(),\n            keyvalues,\n        )\n    }\n}","traces":[{"line":31,"address":[3410432],"length":1,"stats":{"Line":0}},{"line":32,"address":[2582797],"length":1,"stats":{"Line":0}},{"line":38,"address":[5559760,5560764,5561283],"length":1,"stats":{"Line":0}},{"line":42,"address":[1734097,1733985],"length":1,"stats":{"Line":0}},{"line":44,"address":[3410809,3410944],"length":1,"stats":{"Line":0}},{"line":45,"address":[5520320,5521299],"length":1,"stats":{"Line":0}},{"line":46,"address":[5521359],"length":1,"stats":{"Line":0}},{"line":47,"address":[5561068],"length":1,"stats":{"Line":0}},{"line":54,"address":[1551895,1551966],"length":1,"stats":{"Line":0}},{"line":55,"address":[1734798],"length":1,"stats":{"Line":0}},{"line":56,"address":[2583501,2583654,2583380],"length":1,"stats":{"Line":0}},{"line":57,"address":[1552387],"length":1,"stats":{"Line":0}},{"line":61,"address":[5521081],"length":1,"stats":{"Line":0}},{"line":62,"address":[3411055],"length":1,"stats":{"Line":0}},{"line":63,"address":[3411086],"length":1,"stats":{"Line":0}},{"line":64,"address":[5520477],"length":1,"stats":{"Line":0}},{"line":69,"address":[5521568],"length":1,"stats":{"Line":0}},{"line":74,"address":[5521584],"length":1,"stats":{"Line":0}},{"line":75,"address":[1553208],"length":1,"stats":{"Line":0}},{"line":79,"address":[5521600],"length":1,"stats":{"Line":0}},{"line":80,"address":[5561352],"length":1,"stats":{"Line":0}},{"line":84,"address":[3412256],"length":1,"stats":{"Line":0}},{"line":85,"address":[3412261],"length":1,"stats":{"Line":0}},{"line":140,"address":[5521648,5523856,5523884],"length":1,"stats":{"Line":0}},{"line":146,"address":[3412461,3412343],"length":1,"stats":{"Line":0}},{"line":149,"address":[2584821],"length":1,"stats":{"Line":0}},{"line":150,"address":[3412557],"length":1,"stats":{"Line":0}},{"line":154,"address":[5522091,5522130],"length":1,"stats":{"Line":0}},{"line":155,"address":[1736080],"length":1,"stats":{"Line":0}},{"line":159,"address":[2585211],"length":1,"stats":{"Line":0}},{"line":160,"address":[5545837,5545616,5545630],"length":1,"stats":{"Line":0}},{"line":163,"address":[3535927],"length":1,"stats":{"Line":0}},{"line":164,"address":[3412976],"length":1,"stats":{"Line":0}},{"line":168,"address":[1736938,1736449],"length":1,"stats":{"Line":0}},{"line":169,"address":[3413678,3413729,3413906],"length":1,"stats":{"Line":0}},{"line":170,"address":[3414235,3414090],"length":1,"stats":{"Line":0}},{"line":174,"address":[3536455],"length":1,"stats":{"Line":0}},{"line":175,"address":[5522670],"length":1,"stats":{"Line":0}},{"line":177,"address":[5522713],"length":1,"stats":{"Line":0}},{"line":178,"address":[3413396],"length":1,"stats":{"Line":0}},{"line":183,"address":[3414560],"length":1,"stats":{"Line":0}},{"line":188,"address":[1555536],"length":1,"stats":{"Line":0}},{"line":189,"address":[3537608],"length":1,"stats":{"Line":0}},{"line":193,"address":[2586944],"length":1,"stats":{"Line":0}},{"line":194,"address":[3414600],"length":1,"stats":{"Line":0}},{"line":198,"address":[5563712],"length":1,"stats":{"Line":0}},{"line":199,"address":[3537640],"length":1,"stats":{"Line":0}},{"line":204,"address":[1555584,1556669],"length":1,"stats":{"Line":0}},{"line":205,"address":[5563758],"length":1,"stats":{"Line":0}},{"line":206,"address":[3537683],"length":1,"stats":{"Line":0}},{"line":207,"address":[3537706],"length":1,"stats":{"Line":0}},{"line":208,"address":[5563851,5563927],"length":1,"stats":{"Line":0}},{"line":211,"address":[3558976,3559352,3559224,3559008],"length":1,"stats":{"Line":0}},{"line":213,"address":[3414904,3414987],"length":1,"stats":{"Line":0}},{"line":215,"address":[2587839],"length":1,"stats":{"Line":0}},{"line":221,"address":[3538784,3541405,3540964],"length":1,"stats":{"Line":0}},{"line":222,"address":[1556750],"length":1,"stats":{"Line":0}},{"line":224,"address":[1739153],"length":1,"stats":{"Line":0}},{"line":227,"address":[5525396],"length":1,"stats":{"Line":0}},{"line":230,"address":[1556902,1557124],"length":1,"stats":{"Line":0}},{"line":231,"address":[5525582,5525785],"length":1,"stats":{"Line":0}},{"line":234,"address":[1557511],"length":1,"stats":{"Line":0}},{"line":237,"address":[1557225],"length":1,"stats":{"Line":0}},{"line":240,"address":[1739785,1740007],"length":1,"stats":{"Line":0}},{"line":243,"address":[5565920],"length":1,"stats":{"Line":0}},{"line":248,"address":[3416753],"length":1,"stats":{"Line":0}},{"line":249,"address":[2135838,2136045,2135824],"length":1,"stats":{"Line":0}},{"line":251,"address":[5565883],"length":1,"stats":{"Line":0}},{"line":252,"address":[1557982,1557902,1558843],"length":1,"stats":{"Line":0}},{"line":253,"address":[1740477,1740418],"length":1,"stats":{"Line":0}},{"line":254,"address":[1740599,1740712],"length":1,"stats":{"Line":0}},{"line":259,"address":[1740892,1740816],"length":1,"stats":{"Line":0}},{"line":264,"address":[5566794],"length":1,"stats":{"Line":0}},{"line":266,"address":[1741250,1740634],"length":1,"stats":{"Line":0}},{"line":271,"address":[2590498,2589523],"length":1,"stats":{"Line":0}},{"line":273,"address":[5527522],"length":1,"stats":{"Line":0}},{"line":274,"address":[2590567],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":77},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","legacy_tor_client.rs"],"content":"// standard\nuse std::collections::BTreeMap;\nuse std::convert::From;\nuse std::default::Default;\nuse std::net::{SocketAddr, TcpListener};\nuse std::option::Option;\nuse std::path::PathBuf;\nuse std::string::ToString;\nuse std::sync::{atomic, Arc};\nuse std::time::Duration;\n\n// extern crates\nuse socks::Socks5Stream;\n\n// internal crates\nuse crate::censorship_circumvention::*;\nuse crate::legacy_tor_control_stream::*;\nuse crate::legacy_tor_controller::*;\nuse crate::legacy_tor_process::*;\nuse crate::legacy_tor_version::*;\nuse crate::proxy::*;\nuse crate::tor_crypto::*;\nuse crate::tor_provider;\nuse crate::tor_provider::*;\n\n/// [`LegacyTorClient`]-specific error type\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"failed to create LegacyTorProcess object\")]\n    LegacyTorProcessCreationFailed(#[source] crate::legacy_tor_process::Error),\n\n    #[error(\"failed to create LegacyControlStream object\")]\n    LegacyControlStreamCreationFailed(#[source] crate::legacy_tor_control_stream::Error),\n\n    #[error(\"failed to create LegacyTorController object\")]\n    LegacyTorControllerCreationFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"failed to authenticate with the tor process\")]\n    LegacyTorProcessAuthenticationFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"failed to determine the tor process version\")]\n    GetInfoVersionFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"tor process version to old; found {0} but must be at least {1}\")]\n    LegacyTorProcessTooOld(String, String),\n\n    #[error(\"failed to register for STATUS_CLIENT and HS_DESC events\")]\n    SetEventsFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"failed to delete unused onion service\")]\n    DelOnionFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"failed waiting for async events: {0}\")]\n    WaitAsyncEventsFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"failed to begin bootstrap\")]\n    SetConfDisableNetwork0Failed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"failed to setconf\")]\n    SetConfFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"failed to add client auth for onion service\")]\n    OnionClientAuthAddFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"failed to remove client auth from onion service\")]\n    OnionClientAuthRemoveFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"failed to get socks listener\")]\n    GetInfoNetListenersSocksFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"no socks listeners available to connect through\")]\n    NoSocksListenersFound(),\n\n    #[error(\"invalid circuit token\")]\n    CircuitTokenInvalid(),\n\n    #[error(\"unable to connect to socks listener\")]\n    Socks5ConnectionFailed(#[source] std::io::Error),\n\n    #[error(\"unable to bind TCP listener\")]\n    TcpListenerBindFailed(#[source] std::io::Error),\n\n    #[error(\"unable to get TCP listener's local address\")]\n    TcpListenerLocalAddrFailed(#[source] std::io::Error),\n\n    #[error(\"failed to create onion service\")]\n    AddOnionFailed(#[source] crate::legacy_tor_controller::Error),\n\n    #[error(\"tor not bootstrapped\")]\n    LegacyTorNotBootstrapped(),\n\n    #[error(\"{0}\")]\n    PluggableTransportConfigDirectoryCreationFailed(#[source] std::io::Error),\n\n    #[error(\"unable to create pluggable-transport directory because file with same name already exists: {0:?}\")]\n    PluggableTransportDirectoryNameCollision(PathBuf),\n\n    #[error(\"{0}\")]\n    PluggableTransportSymlinkRemovalFailed(#[source] std::io::Error),\n\n    #[error(\"{0}\")]\n    PluggableTransportSymlinkCreationFailed(#[source] std::io::Error),\n\n    #[error(\"pluggable transport binary name not representable as utf8: {0:?}\")]\n    PluggableTransportBinaryNameNotUtf8Representnable(std::ffi::OsString),\n\n    #[error(\"{0}\")]\n    PluggableTransportConfigError(#[source] crate::censorship_circumvention::PluggableTransportConfigError),\n\n    #[error(\"pluggable transport multiply defines '{0}' bridge transport type\")]\n    BridgeTransportTypeMultiplyDefined(String),\n\n    #[error(\"bridge transport '{0}' not supported by pluggable transport configuration\")]\n    BridgeTransportNotSupported(String),\n\n    #[error(\"not implemented\")]\n    NotImplemented(),\n}\n\nimpl From\u003cError\u003e for crate::tor_provider::Error {\n    fn from(error: Error) -\u003e Self {\n        crate::tor_provider::Error::Generic(error.to_string())\n    }\n}\n\n//\n// CircuitToken Implementation\n//\nstruct LegacyCircuitToken {\n    username: String,\n    password: String,\n}\n\nimpl LegacyCircuitToken {\n    fn new() -\u003e LegacyCircuitToken {\n        const CIRCUIT_TOKEN_USERNAME_LENGTH: usize = 32usize;\n        const CIRCUIT_TOKEN_PASSWORD_LENGTH: usize = 32usize;\n        let username = generate_password(CIRCUIT_TOKEN_USERNAME_LENGTH);\n        let password = generate_password(CIRCUIT_TOKEN_PASSWORD_LENGTH);\n\n        LegacyCircuitToken { username, password }\n    }\n}\n\nimpl Default for LegacyCircuitToken {\n    fn default() -\u003e Self {\n        Self::new()\n    }\n}\n\n//\n// LegacyTorClientConfig\n//\n\n#[derive(Clone, Debug)]\npub enum LegacyTorClientConfig {\n    BundledTor {\n        tor_bin_path: PathBuf,\n        data_directory: PathBuf,\n        proxy_settings: Option\u003cProxyConfig\u003e,\n        allowed_ports: Option\u003cVec\u003cu16\u003e\u003e,\n        pluggable_transports: Option\u003cVec\u003cPluggableTransportConfig\u003e\u003e,\n        bridge_lines: Option\u003cVec\u003cBridgeLine\u003e\u003e,\n    },\n    SystemTor {\n        tor_socks_addr: SocketAddr,\n        tor_control_addr: SocketAddr,\n        tor_control_passwd: String,\n    },\n}\n\n//\n// LegacyTorClient\n//\n\n/// A `LegacyTorClient` implements the [`TorProvider`] trait using a legacy c-tor daemon backend.\n///\n/// The tor process can either be launched and owned by `LegacyTorClient`, or it can use an already running tor-daemon. When using an already runnng tor-daemon, the [`TorProvider::bootstrap()`] automatically succeeds, presuming the connected tor-daemon has successfully bootstrapped.\n///\n/// The minimum supported c-tor is version 0.4.6.1.\npub struct LegacyTorClient {\n    daemon: Option\u003cLegacyTorProcess\u003e,\n    version: LegacyTorVersion,\n    controller: LegacyTorController,\n    bootstrapped: bool,\n    socks_listener: Option\u003cSocketAddr\u003e,\n    // list of open onion services and their is_active flag\n    onion_services: Vec\u003c(V3OnionServiceId, Arc\u003catomic::AtomicBool\u003e)\u003e,\n    // our list of circuit tokens for the tor daemon\n    circuit_token_counter: usize,\n    circuit_tokens: BTreeMap\u003cCircuitToken, LegacyCircuitToken\u003e,\n}\n\nimpl LegacyTorClient {\n    /// Construct a new `LegacyTorClient` from a [`LegacyTorClientConfig`].\n    pub fn new(config: LegacyTorClientConfig) -\u003e Result\u003cLegacyTorClient, Error\u003e {\n        let (daemon, mut controller, password, socks_listener) = match \u0026config {\n            LegacyTorClientConfig::BundledTor {\n                tor_bin_path,\n                data_directory,\n                ..\n            } =\u003e {\n                // launch tor\n                let daemon =\n                    LegacyTorProcess::new(tor_bin_path.as_path(), data_directory.as_path())\n                        .map_err(Error::LegacyTorProcessCreationFailed)?;\n                // open a control stream\n                let control_stream =\n                    LegacyControlStream::new(daemon.get_control_addr(), Duration::from_millis(16))\n                        .map_err(Error::LegacyControlStreamCreationFailed)?;\n\n                // create a controler\n                let controller = LegacyTorController::new(control_stream)\n                    .map_err(Error::LegacyTorControllerCreationFailed)?;\n\n                let password = daemon.get_password().to_string();\n                (Some(daemon), controller, password, None)\n            }\n            LegacyTorClientConfig::SystemTor {\n                tor_socks_addr,\n                tor_control_addr,\n                tor_control_passwd,\n            } =\u003e {\n                // open a control stream\n                let control_stream =\n                    LegacyControlStream::new(\u0026tor_control_addr, Duration::from_millis(16))\n                        .map_err(Error::LegacyControlStreamCreationFailed)?;\n\n                // create a controler\n                let controller = LegacyTorController::new(control_stream)\n                    .map_err(Error::LegacyTorControllerCreationFailed)?;\n\n                (\n                    None,\n                    controller,\n                    tor_control_passwd.clone(),\n                    Some(tor_socks_addr.clone()),\n                )\n            }\n        };\n\n        // authenticate\n        controller\n            .authenticate(\u0026password)\n            .map_err(Error::LegacyTorProcessAuthenticationFailed)?;\n\n        // min required version for v3 client auth (see control-spec.txt)\n        let min_required_version = LegacyTorVersion {\n            major: 0u32,\n            minor: 4u32,\n            micro: 6u32,\n            patch_level: 1u32,\n            status_tag: None,\n        };\n\n        // verify version is recent enough\n        let version = controller\n            .getinfo_version()\n            .map_err(Error::GetInfoVersionFailed)?;\n\n        if version \u003c min_required_version {\n            return Err(Error::LegacyTorProcessTooOld(\n                version.to_string(),\n                min_required_version.to_string(),\n            ));\n        }\n\n        // configure tor client\n        if let LegacyTorClientConfig::BundledTor {\n            data_directory,\n            proxy_settings,\n            allowed_ports,\n            pluggable_transports,\n            bridge_lines,\n            ..\n        } = config\n        {\n            // configure proxy\n            match proxy_settings {\n                Some(ProxyConfig::Socks4(Socks4ProxyConfig { address })) =\u003e {\n                    controller\n                        .setconf(\u0026[(\"Socks4Proxy\", address.to_string())])\n                        .map_err(Error::SetConfFailed)?;\n                }\n                Some(ProxyConfig::Socks5(Socks5ProxyConfig {\n                    address,\n                    username,\n                    password,\n                })) =\u003e {\n                    controller\n                        .setconf(\u0026[(\"Socks5Proxy\", address.to_string())])\n                        .map_err(Error::SetConfFailed)?;\n                    let username = username.unwrap_or(\"\".to_string());\n                    if !username.is_empty() {\n                        controller\n                            .setconf(\u0026[(\"Socks5ProxyUsername\", username.to_string())])\n                            .map_err(Error::SetConfFailed)?;\n                    }\n                    let password = password.unwrap_or(\"\".to_string());\n                    if !password.is_empty() {\n                        controller\n                            .setconf(\u0026[(\"Socks5ProxyPassword\", password.to_string())])\n                            .map_err(Error::SetConfFailed)?;\n                    }\n                }\n                Some(ProxyConfig::Https(HttpsProxyConfig {\n                    address,\n                    username,\n                    password,\n                })) =\u003e {\n                    controller\n                        .setconf(\u0026[(\"HTTPSProxy\", address.to_string())])\n                        .map_err(Error::SetConfFailed)?;\n                    let username = username.unwrap_or(\"\".to_string());\n                    let password = password.unwrap_or(\"\".to_string());\n                    if !username.is_empty() || !password.is_empty() {\n                        let authenticator = format!(\"{}:{}\", username, password);\n                        controller\n                            .setconf(\u0026[(\"HTTPSProxyAuthenticator\", authenticator)])\n                            .map_err(Error::SetConfFailed)?;\n                    }\n                }\n                None =\u003e (),\n            }\n            // configure firewall\n            if let Some(allowed_ports) = allowed_ports {\n                let allowed_addresses: Vec\u003cString\u003e = allowed_ports\n                    .iter()\n                    .map(|port| format!(\"*{{}}:{port}\"))\n                    .collect();\n                let allowed_addresses = allowed_addresses.join(\", \");\n                controller\n                    .setconf(\u0026[(\"ReachableAddresses\", allowed_addresses)])\n                    .map_err(Error::SetConfFailed)?;\n            }\n            // configure pluggable transports\n            let mut supported_transports: std::collections::BTreeSet\u003cString\u003e = Default::default();\n            if let Some(pluggable_transports) = pluggable_transports {\n                // Legacy tor daemon cannot be configured to use pluggable-transports which\n                // exist in paths containing spaces. To work around this, we create a known, safe\n                // path in the tor daemon's working directory, and soft-link the provided\n                // binary path to this safe location. Finally, we configure tor to use the soft-linked\n                // binary in the ClientTransportPlugin setconf call.\n\n                // create pluggable-transport directory\n                let mut pt_directory = data_directory.clone();\n                pt_directory.push(\"pluggable-transports\");\n                if !std::path::Path::exists(\u0026pt_directory) {\n                    // path does not exist so create it\n                    std::fs::create_dir(\u0026pt_directory)\n                        .map_err(Error::PluggableTransportConfigDirectoryCreationFailed)?;\n                } else if !std::path::Path::is_dir(\u0026pt_directory) {\n                    // path exists but it is not a directory\n                    return Err(Error::PluggableTransportDirectoryNameCollision(\n                        pt_directory,\n                    ));\n                }\n\n                // symlink all our pts and configure tor\n                let mut conf: Vec\u003c(\u0026str, String)\u003e = Default::default();\n                for pt_settings in \u0026pluggable_transports {\n                    // symlink absolute path of pt binary to pt_directory in tor's working\n                    // directory\n                    let path_to_binary = pt_settings.path_to_binary();\n                    let binary_name = path_to_binary\n                        .file_name()\n                        .expect(\"file_name should be absolute path\");\n                    let mut pt_symlink = pt_directory.clone();\n                    pt_symlink.push(binary_name);\n                    let binary_name = if let Some(binary_name) = binary_name.to_str() {\n                        binary_name\n                    } else {\n                        return Err(Error::PluggableTransportBinaryNameNotUtf8Representnable(\n                            binary_name.to_os_string(),\n                        ));\n                    };\n\n                    // remove any file that may exist with the same name\n                    if std::path::Path::exists(\u0026pt_symlink) {\n                        std::fs::remove_file(\u0026pt_symlink)\n                            .map_err(Error::PluggableTransportSymlinkRemovalFailed)?;\n                    }\n\n                    // create new symlink\n                    #[cfg(windows)]\n                    std::os::windows::fs::symlink_file(path_to_binary, \u0026pt_symlink)\n                        .map_err(Error::PluggableTransportSymlinkCreationFailed)?;\n                    #[cfg(unix)]\n                    std::os::unix::fs::symlink(path_to_binary, \u0026pt_symlink)\n                        .map_err(Error::PluggableTransportSymlinkCreationFailed)?;\n\n                    // verify a bridge-type support has not been defined for multiple pluggable-transports\n                    for transport in pt_settings.transports() {\n                        if supported_transports.contains(transport) {\n                            return Err(Error::BridgeTransportTypeMultiplyDefined(\n                                transport.to_string(),\n                            ));\n                        }\n                        supported_transports.insert(transport.to_string());\n                    }\n\n                    // finally construct our setconf value\n                    let transports = pt_settings.transports().join(\",\");\n                    use std::path::MAIN_SEPARATOR;\n                    let path_to_binary =\n                        format!(\"pluggable-transports{MAIN_SEPARATOR}{binary_name}\");\n                    let options = pt_settings.options().join(\" \");\n\n                    let value = format!(\"{transports} exec {path_to_binary} {options}\");\n                    conf.push((\"ClientTransportPlugin\", value));\n                }\n                controller\n                    .setconf(conf.as_slice())\n                    .map_err(Error::SetConfFailed)?;\n            }\n            // configure bridge lines\n            if let Some(bridge_lines) = bridge_lines {\n                let mut conf: Vec\u003c(\u0026str, String)\u003e = Default::default();\n                for bridge_line in \u0026bridge_lines {\n                    if !supported_transports.contains(bridge_line.transport()) {\n                        return Err(Error::BridgeTransportNotSupported(\n                            bridge_line.transport().to_string(),\n                        ));\n                    }\n                    let value = bridge_line.as_legacy_tor_setconf_value();\n                    conf.push((\"Bridge\", value));\n                }\n                conf.push((\"UseBridges\", \"1\".to_string()));\n                controller\n                    .setconf(conf.as_slice())\n                    .map_err(Error::SetConfFailed)?;\n            }\n        }\n\n        // register for STATUS_CLIENT async events\n        controller\n            .setevents(\u0026[\"STATUS_CLIENT\", \"HS_DESC\"])\n            .map_err(Error::SetEventsFailed)?;\n\n        Ok(LegacyTorClient {\n            daemon,\n            version,\n            controller,\n            bootstrapped: false,\n            socks_listener,\n            onion_services: Default::default(),\n            circuit_token_counter: 0usize,\n            circuit_tokens: Default::default(),\n        })\n    }\n\n    /// Get the version of the connected c-tor daemon.\n    pub fn version(\u0026mut self) -\u003e LegacyTorVersion {\n        self.version.clone()\n    }\n}\n\nimpl TorProvider for LegacyTorClient {\n    fn update(\u0026mut self) -\u003e Result\u003cVec\u003cTorEvent\u003e, tor_provider::Error\u003e {\n        let mut i = 0;\n        while i \u003c self.onion_services.len() {\n            // remove onion services with no active listeners\n            if !self.onion_services[i].1.load(atomic::Ordering::Relaxed) {\n                let entry = self.onion_services.swap_remove(i);\n                let service_id = entry.0;\n\n                self.controller\n                    .del_onion(\u0026service_id)\n                    .map_err(Error::DelOnionFailed)?;\n            } else {\n                i += 1;\n            }\n        }\n\n        let mut events: Vec\u003cTorEvent\u003e = Default::default();\n        for async_event in self\n            .controller\n            .wait_async_events()\n            .map_err(Error::WaitAsyncEventsFailed)?\n            .iter()\n        {\n            match async_event {\n                AsyncEvent::StatusClient {\n                    severity,\n                    action,\n                    arguments,\n                } =\u003e {\n                    if severity == \"NOTICE\" \u0026\u0026 action == \"BOOTSTRAP\" {\n                        let mut progress: u32 = 0;\n                        let mut tag: String = Default::default();\n                        let mut summary: String = Default::default();\n                        for (key, val) in arguments.iter() {\n                            match key.as_str() {\n                                \"PROGRESS\" =\u003e progress = val.parse().unwrap_or(0u32),\n                                \"TAG\" =\u003e tag = val.to_string(),\n                                \"SUMMARY\" =\u003e summary = val.to_string(),\n                                _ =\u003e {} // ignore unexpected arguments\n                            }\n                        }\n                        events.push(TorEvent::BootstrapStatus {\n                            progress,\n                            tag,\n                            summary,\n                        });\n                        if progress == 100u32 {\n                            events.push(TorEvent::BootstrapComplete);\n                            self.bootstrapped = true;\n                        }\n                    }\n                }\n                AsyncEvent::HsDesc { action, hs_address } =\u003e {\n                    if action == \"UPLOADED\" {\n                        events.push(TorEvent::OnionServicePublished {\n                            service_id: hs_address.clone(),\n                        });\n                    }\n                }\n                AsyncEvent::Unknown { lines } =\u003e {\n                    println!(\"Received Unknown Event:\");\n                    for line in lines.iter() {\n                        println!(\" {}\", line);\n                    }\n                }\n            }\n        }\n\n        if let Some(daemon) = \u0026mut self.daemon {\n            // bundled tor gives us log-lines\n            for log_line in daemon.wait_log_lines().iter_mut() {\n                events.push(TorEvent::LogReceived {\n                    line: std::mem::take(log_line),\n                });\n            }\n        } else if !self.bootstrapped {\n            // system tor needs to send a bootstrap complete event *once*\n            events.push(TorEvent::BootstrapComplete);\n            self.bootstrapped = true;\n        }\n\n        Ok(events)\n    }\n\n    fn bootstrap(\u0026mut self) -\u003e Result\u003c(), tor_provider::Error\u003e {\n        if !self.bootstrapped {\n            self.controller\n                .setconf(\u0026[(\"DisableNetwork\", \"0\".to_string())])\n                .map_err(Error::SetConfDisableNetwork0Failed)?;\n        }\n        Ok(())\n    }\n\n    fn add_client_auth(\n        \u0026mut self,\n        service_id: \u0026V3OnionServiceId,\n        client_auth: \u0026X25519PrivateKey,\n    ) -\u003e Result\u003c(), tor_provider::Error\u003e {\n        Ok(self\n            .controller\n            .onion_client_auth_add(service_id, client_auth, None, \u0026Default::default())\n            .map_err(Error::OnionClientAuthAddFailed)?)\n    }\n\n    fn remove_client_auth(\n        \u0026mut self,\n        service_id: \u0026V3OnionServiceId,\n    ) -\u003e Result\u003c(), tor_provider::Error\u003e {\n        Ok(self\n            .controller\n            .onion_client_auth_remove(service_id)\n            .map_err(Error::OnionClientAuthRemoveFailed)?)\n    }\n\n    // connect to an onion service and returns OnionStream\n    fn connect(\n        \u0026mut self,\n        target: TargetAddr,\n        circuit: Option\u003cCircuitToken\u003e,\n    ) -\u003e Result\u003cOnionStream, tor_provider::Error\u003e {\n        if !self.bootstrapped {\n            return Err(Error::LegacyTorNotBootstrapped().into());\n        }\n\n        if self.socks_listener.is_none() {\n            let mut listeners = self\n                .controller\n                .getinfo_net_listeners_socks()\n                .map_err(Error::GetInfoNetListenersSocksFailed)?;\n            if listeners.is_empty() {\n                return Err(Error::NoSocksListenersFound())?;\n            }\n            self.socks_listener = Some(listeners.swap_remove(0));\n        }\n\n        let socks_listener = match self.socks_listener {\n            Some(socks_listener) =\u003e socks_listener,\n            None =\u003e unreachable!(),\n        };\n\n        // our target\n        let socks_target = match target.clone() {\n            TargetAddr::Socket(socket_addr) =\u003e socks::TargetAddr::Ip(socket_addr),\n            TargetAddr::Domain(domain_addr) =\u003e {\n                socks::TargetAddr::Domain(domain_addr.domain().to_string(), domain_addr.port())\n            }\n            TargetAddr::OnionService(OnionAddr::V3(OnionAddrV3 {\n                service_id,\n                virt_port,\n            })) =\u003e socks::TargetAddr::Domain(format!(\"{}.onion\", service_id), virt_port),\n        };\n\n        // readwrite stream\n        let stream = match \u0026circuit {\n            None =\u003e Socks5Stream::connect(socks_listener, socks_target),\n            Some(circuit) =\u003e {\n                if let Some(circuit) = self.circuit_tokens.get(circuit) {\n                    Socks5Stream::connect_with_password(\n                        socks_listener,\n                        socks_target,\n                        \u0026circuit.username,\n                        \u0026circuit.password,\n                    )\n                } else {\n                    return Err(Error::CircuitTokenInvalid())?;\n                }\n            }\n        }\n        .map_err(Error::Socks5ConnectionFailed)?;\n\n        Ok(OnionStream {\n            stream: stream.into_inner(),\n            local_addr: None,\n            peer_addr: Some(target),\n        })\n    }\n\n    // stand up an onion service and return an LegacyOnionListener\n    fn listener(\n        \u0026mut self,\n        private_key: \u0026Ed25519PrivateKey,\n        virt_port: u16,\n        authorized_clients: Option\u003c\u0026[X25519PublicKey]\u003e,\n    ) -\u003e Result\u003cOnionListener, tor_provider::Error\u003e {\n        if !self.bootstrapped {\n            return Err(Error::LegacyTorNotBootstrapped().into());\n        }\n\n        // try to bind to a local address, let OS pick our port\n        let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n        let listener = TcpListener::bind(socket_addr).map_err(Error::TcpListenerBindFailed)?;\n        let socket_addr = listener\n            .local_addr()\n            .map_err(Error::TcpListenerLocalAddrFailed)?;\n\n        let mut flags = AddOnionFlags {\n            discard_pk: true,\n            ..Default::default()\n        };\n        if authorized_clients.is_some() {\n            flags.v3_auth = true;\n        }\n\n        let onion_addr = OnionAddr::V3(OnionAddrV3::new(\n            V3OnionServiceId::from_private_key(private_key),\n            virt_port,\n        ));\n\n        // start onion service\n        let (_, service_id) = self\n            .controller\n            .add_onion(\n                Some(private_key),\n                \u0026flags,\n                None,\n                virt_port,\n                Some(socket_addr),\n                authorized_clients,\n            )\n            .map_err(Error::AddOnionFailed)?;\n\n        let is_active = Arc::new(atomic::AtomicBool::new(true));\n        self.onion_services\n            .push((service_id, Arc::clone(\u0026is_active)));\n\n        Ok(OnionListener::new(listener, onion_addr, is_active, |is_active| {\n            is_active.store(false, atomic::Ordering::Relaxed);\n        }))\n    }\n\n    fn generate_token(\u0026mut self) -\u003e CircuitToken {\n        let new_token = self.circuit_token_counter;\n        self.circuit_token_counter += 1;\n        self.circuit_tokens\n            .insert(new_token, LegacyCircuitToken::new());\n        new_token\n    }\n\n    fn release_token(\u0026mut self, circuit_token: CircuitToken) {\n        self.circuit_tokens.remove(\u0026circuit_token);\n    }\n}\n","traces":[{"line":121,"address":[2767712,2767845],"length":1,"stats":{"Line":1}},{"line":122,"address":[3596499,3596557],"length":1,"stats":{"Line":2}},{"line":135,"address":[2055040,2055221],"length":1,"stats":{"Line":0}},{"line":138,"address":[3817341],"length":1,"stats":{"Line":0}},{"line":139,"address":[5232572],"length":1,"stats":{"Line":0}},{"line":146,"address":[2055248],"length":1,"stats":{"Line":0}},{"line":147,"address":[2050504],"length":1,"stats":{"Line":0}},{"line":196,"address":[3712991,3696303,3693792],"length":1,"stats":{"Line":2}},{"line":197,"address":[5232859,5237898,5235039],"length":1,"stats":{"Line":4}},{"line":198,"address":[5233135],"length":1,"stats":{"Line":2}},{"line":204,"address":[3694872,3696403,3694419,3694181],"length":1,"stats":{"Line":4}},{"line":206,"address":[5194040],"length":1,"stats":{"Line":0}},{"line":208,"address":[5233926,5233758,5234331,5235339],"length":1,"stats":{"Line":4}},{"line":210,"address":[3819051],"length":1,"stats":{"Line":0}},{"line":213,"address":[2052149,2052400,2051943,2053004],"length":1,"stats":{"Line":4}},{"line":214,"address":[5234612],"length":1,"stats":{"Line":0}},{"line":216,"address":[2052481,2052310],"length":1,"stats":{"Line":4}},{"line":217,"address":[2057284],"length":1,"stats":{"Line":2}},{"line":219,"address":[3817975],"length":1,"stats":{"Line":1}},{"line":225,"address":[2051009,2053464,2069617,2053120],"length":1,"stats":{"Line":2}},{"line":227,"address":[5235700],"length":1,"stats":{"Line":0}},{"line":230,"address":[3820424,3820618,3820977],"length":1,"stats":{"Line":2}},{"line":231,"address":[3697153],"length":1,"stats":{"Line":0}},{"line":234,"address":[5196321],"length":1,"stats":{"Line":1}},{"line":235,"address":[5196329],"length":1,"stats":{"Line":1}},{"line":236,"address":[5196355],"length":1,"stats":{"Line":1}},{"line":237,"address":[5196538,5196586],"length":1,"stats":{"Line":2}},{"line":243,"address":[5197197,5196918,5212613],"length":1,"stats":{"Line":2}},{"line":244,"address":[3820037],"length":1,"stats":{"Line":2}},{"line":245,"address":[2494285],"length":1,"stats":{"Line":0}},{"line":257,"address":[2059371,2074848,2059823,2059526],"length":1,"stats":{"Line":4}},{"line":259,"address":[2054899],"length":1,"stats":{"Line":0}},{"line":261,"address":[2054874,2055036],"length":1,"stats":{"Line":4}},{"line":262,"address":[5212387],"length":1,"stats":{"Line":0}},{"line":263,"address":[2494836],"length":1,"stats":{"Line":0}},{"line":264,"address":[3836836],"length":1,"stats":{"Line":0}},{"line":269,"address":[3698426],"length":1,"stats":{"Line":2}},{"line":270,"address":[2494874],"length":1,"stats":{"Line":2}},{"line":271,"address":[3698543],"length":1,"stats":{"Line":2}},{"line":272,"address":[2055205],"length":1,"stats":{"Line":2}},{"line":273,"address":[2495030],"length":1,"stats":{"Line":2}},{"line":274,"address":[2055327],"length":1,"stats":{"Line":2}},{"line":279,"address":[2055388,2055498],"length":1,"stats":{"Line":2}},{"line":280,"address":[2055544],"length":1,"stats":{"Line":0}},{"line":281,"address":[2061034,2061256,2061085],"length":1,"stats":{"Line":0}},{"line":282,"address":[5238386,5237964],"length":1,"stats":{"Line":0}},{"line":283,"address":[3823437,3823313,3823642],"length":1,"stats":{"Line":0}},{"line":285,"address":[3699122],"length":1,"stats":{"Line":0}},{"line":290,"address":[3823901,3823952,3824123],"length":1,"stats":{"Line":0}},{"line":291,"address":[3822922,3823765],"length":1,"stats":{"Line":0}},{"line":292,"address":[5239124,5239248,5240898],"length":1,"stats":{"Line":0}},{"line":293,"address":[5240876,5239368],"length":1,"stats":{"Line":0}},{"line":294,"address":[2497013,2496948],"length":1,"stats":{"Line":0}},{"line":295,"address":[5200101,5200326,5200152],"length":1,"stats":{"Line":0}},{"line":296,"address":[3824493,3824411],"length":1,"stats":{"Line":0}},{"line":297,"address":[5240096,5239852,5239976],"length":1,"stats":{"Line":0}},{"line":299,"address":[2497042,2497545,2498262],"length":1,"stats":{"Line":0}},{"line":300,"address":[5240237,5240302],"length":1,"stats":{"Line":0}},{"line":301,"address":[3701513,3701564,3701738],"length":1,"stats":{"Line":0}},{"line":302,"address":[5200609,5200580],"length":1,"stats":{"Line":0}},{"line":303,"address":[2497904,2498028,2498148],"length":1,"stats":{"Line":0}},{"line":306,"address":[3823016],"length":1,"stats":{"Line":0}},{"line":311,"address":[5201786,5201615,5201564],"length":1,"stats":{"Line":0}},{"line":312,"address":[2063684,2060824],"length":1,"stats":{"Line":0}},{"line":313,"address":[2058824,2058936,2067006],"length":1,"stats":{"Line":0}},{"line":314,"address":[3710835,3702583],"length":1,"stats":{"Line":0}},{"line":315,"address":[3834573,3826507],"length":1,"stats":{"Line":0}},{"line":316,"address":[3702984,3703110,3702919],"length":1,"stats":{"Line":0}},{"line":317,"address":[5242248],"length":1,"stats":{"Line":0}},{"line":318,"address":[2060057,2060203,2059994],"length":1,"stats":{"Line":0}},{"line":319,"address":[2499793],"length":1,"stats":{"Line":0}},{"line":320,"address":[3703552,3703796,3703676],"length":1,"stats":{"Line":0}},{"line":326,"address":[3827733,3822594],"length":1,"stats":{"Line":2}},{"line":327,"address":[2500514,2500397],"length":1,"stats":{"Line":0}},{"line":329,"address":[3376305,3376080,3376208],"length":1,"stats":{"Line":0}},{"line":331,"address":[5243306,5243211],"length":1,"stats":{"Line":0}},{"line":332,"address":[5203730,5203781,5203952],"length":1,"stats":{"Line":0}},{"line":333,"address":[2060767],"length":1,"stats":{"Line":0}},{"line":334,"address":[3704787,3704629,3704505],"length":1,"stats":{"Line":0}},{"line":337,"address":[3827808],"length":1,"stats":{"Line":2}},{"line":338,"address":[3828607],"length":1,"stats":{"Line":2}},{"line":346,"address":[2061319,2061410],"length":1,"stats":{"Line":0}},{"line":347,"address":[2066529],"length":1,"stats":{"Line":0}},{"line":348,"address":[3705121],"length":1,"stats":{"Line":0}},{"line":350,"address":[2061568,2061633,2061779],"length":1,"stats":{"Line":0}},{"line":351,"address":[2501742],"length":1,"stats":{"Line":0}},{"line":352,"address":[5244461,5244198],"length":1,"stats":{"Line":0}},{"line":354,"address":[2067072],"length":1,"stats":{"Line":0}},{"line":355,"address":[3829288],"length":1,"stats":{"Line":0}},{"line":360,"address":[5204560],"length":1,"stats":{"Line":0}},{"line":361,"address":[2502171,2502076,2502294],"length":1,"stats":{"Line":0}},{"line":364,"address":[5245293,5244910],"length":1,"stats":{"Line":0}},{"line":365,"address":[5245301],"length":1,"stats":{"Line":0}},{"line":368,"address":[2062824],"length":1,"stats":{"Line":0}},{"line":369,"address":[2502930],"length":1,"stats":{"Line":0}},{"line":370,"address":[2068113],"length":1,"stats":{"Line":0}},{"line":371,"address":[2063038],"length":1,"stats":{"Line":0}},{"line":373,"address":[3709085],"length":1,"stats":{"Line":0}},{"line":374,"address":[5245788],"length":1,"stats":{"Line":0}},{"line":379,"address":[2063135,2063062],"length":1,"stats":{"Line":0}},{"line":380,"address":[3706903,3709075,3707086],"length":1,"stats":{"Line":0}},{"line":381,"address":[3707022],"length":1,"stats":{"Line":0}},{"line":389,"address":[2063178,2063559,2065310,2063408],"length":1,"stats":{"Line":0}},{"line":390,"address":[3830990],"length":1,"stats":{"Line":0}},{"line":393,"address":[3707331,3707489,3707203],"length":1,"stats":{"Line":0}},{"line":394,"address":[2063774,2065097],"length":1,"stats":{"Line":0}},{"line":395,"address":[3832708],"length":1,"stats":{"Line":0}},{"line":396,"address":[2065142],"length":1,"stats":{"Line":0}},{"line":399,"address":[3832638,3832668],"length":1,"stats":{"Line":0}},{"line":403,"address":[2503854,2503934],"length":1,"stats":{"Line":0}},{"line":405,"address":[3707882],"length":1,"stats":{"Line":0}},{"line":407,"address":[2064337,2064276],"length":1,"stats":{"Line":0}},{"line":409,"address":[3832291],"length":1,"stats":{"Line":0}},{"line":410,"address":[5207916],"length":1,"stats":{"Line":0}},{"line":412,"address":[3829748,3830045,3829926],"length":1,"stats":{"Line":0}},{"line":413,"address":[5244851],"length":1,"stats":{"Line":0}},{"line":414,"address":[2062423],"length":1,"stats":{"Line":0}},{"line":417,"address":[5243921,5248237],"length":1,"stats":{"Line":2}},{"line":418,"address":[5248277],"length":1,"stats":{"Line":0}},{"line":419,"address":[3709386,3709575,3709466],"length":1,"stats":{"Line":0}},{"line":420,"address":[3833356,3833771],"length":1,"stats":{"Line":0}},{"line":421,"address":[5209352],"length":1,"stats":{"Line":0}},{"line":422,"address":[3710105,3710049],"length":1,"stats":{"Line":0}},{"line":425,"address":[3710070],"length":1,"stats":{"Line":0}},{"line":426,"address":[5249226],"length":1,"stats":{"Line":0}},{"line":428,"address":[5248591,5248524],"length":1,"stats":{"Line":0}},{"line":429,"address":[2065949,2066115,2066155],"length":1,"stats":{"Line":0}},{"line":430,"address":[2065906],"length":1,"stats":{"Line":0}},{"line":431,"address":[3709870],"length":1,"stats":{"Line":0}},{"line":436,"address":[3835623,3835247,3822556,3836831],"length":1,"stats":{"Line":4}},{"line":438,"address":[3711799],"length":1,"stats":{"Line":0}},{"line":440,"address":[5211228],"length":1,"stats":{"Line":2}},{"line":441,"address":[5250547],"length":1,"stats":{"Line":2}},{"line":442,"address":[2508059],"length":1,"stats":{"Line":2}},{"line":443,"address":[5250707],"length":1,"stats":{"Line":2}},{"line":446,"address":[3711769],"length":1,"stats":{"Line":2}},{"line":448,"address":[2073424],"length":1,"stats":{"Line":2}},{"line":453,"address":[3838176],"length":1,"stats":{"Line":0}},{"line":454,"address":[5213665],"length":1,"stats":{"Line":0}},{"line":459,"address":[2075952,2079867,2077502],"length":1,"stats":{"Line":2}},{"line":460,"address":[2070455],"length":1,"stats":{"Line":2}},{"line":461,"address":[2510923],"length":1,"stats":{"Line":2}},{"line":463,"address":[2070579,2074634],"length":1,"stats":{"Line":4}},{"line":464,"address":[2514784],"length":1,"stats":{"Line":0}},{"line":465,"address":[3842200],"length":1,"stats":{"Line":0}},{"line":467,"address":[2075983,2080261,2077582,2080090,2080008],"length":1,"stats":{"Line":2}},{"line":469,"address":[2074517],"length":1,"stats":{"Line":0}},{"line":471,"address":[5257812,5257799,5257503],"length":1,"stats":{"Line":4}},{"line":475,"address":[5213816],"length":1,"stats":{"Line":2}},{"line":476,"address":[2076781,2076499,2076105,2076245,2076588],"length":1,"stats":{"Line":8}},{"line":479,"address":[3838707],"length":1,"stats":{"Line":0}},{"line":482,"address":[5254293],"length":1,"stats":{"Line":2}},{"line":483,"address":[2072050],"length":1,"stats":{"Line":2}},{"line":488,"address":[5215443,5216729,5216006],"length":1,"stats":{"Line":6}},{"line":489,"address":[2513216],"length":1,"stats":{"Line":2}},{"line":490,"address":[3840611],"length":1,"stats":{"Line":2}},{"line":491,"address":[2078346],"length":1,"stats":{"Line":2}},{"line":492,"address":[3840690,3840779,3841138],"length":1,"stats":{"Line":6}},{"line":493,"address":[2513913,2513803],"length":1,"stats":{"Line":4}},{"line":494,"address":[5256521,5257047,5256592],"length":1,"stats":{"Line":6}},{"line":495,"address":[3841348,3841400,3841452,3841658],"length":1,"stats":{"Line":8}},{"line":496,"address":[5216938,5216888],"length":1,"stats":{"Line":4}},{"line":500,"address":[3841032],"length":1,"stats":{"Line":2}},{"line":501,"address":[2513569],"length":1,"stats":{"Line":2}},{"line":502,"address":[5256168],"length":1,"stats":{"Line":2}},{"line":503,"address":[2513616],"length":1,"stats":{"Line":2}},{"line":505,"address":[5216668,5216749],"length":1,"stats":{"Line":4}},{"line":506,"address":[2078934],"length":1,"stats":{"Line":2}},{"line":507,"address":[3841270],"length":1,"stats":{"Line":2}},{"line":511,"address":[5255231],"length":1,"stats":{"Line":2}},{"line":512,"address":[5257200,5255259],"length":1,"stats":{"Line":4}},{"line":513,"address":[5257232],"length":1,"stats":{"Line":2}},{"line":514,"address":[2514633],"length":1,"stats":{"Line":2}},{"line":518,"address":[2071978],"length":1,"stats":{"Line":0}},{"line":519,"address":[2077807,2077612],"length":1,"stats":{"Line":0}},{"line":520,"address":[2077834],"length":1,"stats":{"Line":0}},{"line":521,"address":[3840453],"length":1,"stats":{"Line":0}},{"line":527,"address":[2511785],"length":1,"stats":{"Line":2}},{"line":529,"address":[2511860,2512181,2511893,2511988],"length":1,"stats":{"Line":8}},{"line":530,"address":[3715942],"length":1,"stats":{"Line":2}},{"line":531,"address":[3715813],"length":1,"stats":{"Line":2}},{"line":534,"address":[2077561,2076979],"length":1,"stats":{"Line":2}},{"line":536,"address":[3716023],"length":1,"stats":{"Line":1}},{"line":537,"address":[2512450],"length":1,"stats":{"Line":1}},{"line":540,"address":[5215072],"length":1,"stats":{"Line":2}},{"line":543,"address":[2080352,2080828],"length":1,"stats":{"Line":2}},{"line":544,"address":[2074686],"length":1,"stats":{"Line":2}},{"line":545,"address":[3719287,3718886,3719068,3719143],"length":1,"stats":{"Line":6}},{"line":546,"address":[2515291],"length":1,"stats":{"Line":2}},{"line":547,"address":[3719211,3719313,3719099],"length":1,"stats":{"Line":2}},{"line":549,"address":[2080568],"length":1,"stats":{"Line":2}},{"line":552,"address":[3843526,3843136,3843494],"length":1,"stats":{"Line":2}},{"line":557,"address":[2081081,2081034,2080896,2081188],"length":1,"stats":{"Line":6}},{"line":559,"address":[3719440,3719585,3719747],"length":1,"stats":{"Line":4}},{"line":560,"address":[3719672],"length":1,"stats":{"Line":0}},{"line":563,"address":[5219008],"length":1,"stats":{"Line":1}},{"line":567,"address":[2516310,2516176],"length":1,"stats":{"Line":1}},{"line":570,"address":[3719899],"length":1,"stats":{"Line":0}},{"line":574,"address":[5262637,5258944,5262130],"length":1,"stats":{"Line":2}},{"line":579,"address":[3843791],"length":1,"stats":{"Line":2}},{"line":580,"address":[5259040,5259171],"length":1,"stats":{"Line":0}},{"line":583,"address":[2081606,2081741],"length":1,"stats":{"Line":4}},{"line":584,"address":[5222888,5219549,5219801,5220261],"length":1,"stats":{"Line":2}},{"line":587,"address":[2076240],"length":1,"stats":{"Line":0}},{"line":588,"address":[2516852,2517033],"length":1,"stats":{"Line":4}},{"line":589,"address":[3723454,3723654,3720686],"length":1,"stats":{"Line":0}},{"line":591,"address":[2076402,2076529],"length":1,"stats":{"Line":4}},{"line":594,"address":[2076014],"length":1,"stats":{"Line":2}},{"line":595,"address":[2517324],"length":1,"stats":{"Line":2}},{"line":600,"address":[3844738],"length":1,"stats":{"Line":2}},{"line":601,"address":[5220263],"length":1,"stats":{"Line":0}},{"line":602,"address":[3721345],"length":1,"stats":{"Line":0}},{"line":603,"address":[5220928,5220609],"length":1,"stats":{"Line":0}},{"line":605,"address":[5220787,5220661],"length":1,"stats":{"Line":3}},{"line":612,"address":[5221792,5220641,5221298,5222107,5222395],"length":1,"stats":{"Line":8}},{"line":613,"address":[2083341,2083552],"length":1,"stats":{"Line":4}},{"line":614,"address":[3845744],"length":1,"stats":{"Line":0}},{"line":615,"address":[5221232,5221333],"length":1,"stats":{"Line":0}},{"line":618,"address":[2077846],"length":1,"stats":{"Line":0}},{"line":619,"address":[5221455],"length":1,"stats":{"Line":0}},{"line":620,"address":[2078108],"length":1,"stats":{"Line":0}},{"line":623,"address":[3846003,3846974],"length":1,"stats":{"Line":0}},{"line":627,"address":[5222043],"length":1,"stats":{"Line":1}},{"line":629,"address":[3846771],"length":1,"stats":{"Line":2}},{"line":630,"address":[3722721],"length":1,"stats":{"Line":2}},{"line":631,"address":[2519337],"length":1,"stats":{"Line":2}},{"line":632,"address":[3722963],"length":1,"stats":{"Line":2}},{"line":637,"address":[3723680,3725771,3725813],"length":1,"stats":{"Line":2}},{"line":643,"address":[5262743],"length":1,"stats":{"Line":2}},{"line":644,"address":[2079456],"length":1,"stats":{"Line":0}},{"line":648,"address":[3723883],"length":1,"stats":{"Line":2}},{"line":649,"address":[2520567,2520393,2520623],"length":1,"stats":{"Line":4}},{"line":650,"address":[2080011,2080183,2079868,2081396],"length":1,"stats":{"Line":4}},{"line":652,"address":[5263448],"length":1,"stats":{"Line":0}},{"line":658,"address":[5263731,5263666],"length":1,"stats":{"Line":4}},{"line":659,"address":[3724747],"length":1,"stats":{"Line":2}},{"line":662,"address":[5223997],"length":1,"stats":{"Line":2}},{"line":663,"address":[5223960],"length":1,"stats":{"Line":2}},{"line":668,"address":[3849540,3848690,3849094],"length":1,"stats":{"Line":2}},{"line":671,"address":[5263856],"length":1,"stats":{"Line":2}},{"line":673,"address":[3724888],"length":1,"stats":{"Line":2}},{"line":675,"address":[2086386],"length":1,"stats":{"Line":2}},{"line":678,"address":[3849011],"length":1,"stats":{"Line":2}},{"line":680,"address":[5224600],"length":1,"stats":{"Line":2}},{"line":681,"address":[2086959,2087117],"length":1,"stats":{"Line":4}},{"line":682,"address":[2081164,2081101],"length":1,"stats":{"Line":4}},{"line":684,"address":[3725648],"length":1,"stats":{"Line":4}},{"line":685,"address":[3376392,3376334],"length":1,"stats":{"Line":4}},{"line":689,"address":[3849616],"length":1,"stats":{"Line":0}},{"line":690,"address":[5225108],"length":1,"stats":{"Line":0}},{"line":691,"address":[3726005,3725896],"length":1,"stats":{"Line":0}},{"line":692,"address":[3849725,3849694],"length":1,"stats":{"Line":0}},{"line":693,"address":[2522329,2522365],"length":1,"stats":{"Line":0}},{"line":697,"address":[2081616],"length":1,"stats":{"Line":0}},{"line":698,"address":[2522436],"length":1,"stats":{"Line":0}}],"covered":124,"coverable":255},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","legacy_tor_control_stream.rs"],"content":"// standard\nuse std::collections::VecDeque;\nuse std::default::Default;\nuse std::io::{ErrorKind, Read, Write};\nuse std::net::{SocketAddr, TcpStream};\nuse std::option::Option;\nuse std::string::ToString;\nuse std::time::Duration;\n\n// extern crates\nuse regex::Regex;\n\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"control stream read timeout must not be zero\")]\n    ReadTimeoutZero(),\n\n    #[error(\"could not connect to control port\")]\n    CreationFailed(#[source] std::io::Error),\n\n    #[error(\"configure control port socket failed\")]\n    ConfigurationFailed(#[source] std::io::Error),\n\n    #[error(\"control port parsing regex creation failed\")]\n    ParsingRegexCreationFailed(#[source] regex::Error),\n\n    #[error(\"control port stream read failure\")]\n    ReadFailed(#[source] std::io::Error),\n\n    #[error(\"control port stream closed by remote\")]\n    ClosedByRemote(),\n\n    #[error(\"received control port response invalid utf8\")]\n    InvalidResponse(#[source] std::str::Utf8Error),\n\n    #[error(\"failed to parse control port reply: {0}\")]\n    ReplyParseFailed(String),\n\n    #[error(\"control port stream write failure\")]\n    WriteFailed(#[source] std::io::Error),\n}\n\npub(crate) struct LegacyControlStream {\n    stream: TcpStream,\n    closed_by_remote: bool,\n    pending_data: Vec\u003cu8\u003e,\n    pending_lines: VecDeque\u003cString\u003e,\n    pending_reply: Vec\u003cString\u003e,\n    reading_multiline_value: bool,\n    // regexes used to parse control port responses\n    single_line_data: Regex,\n    multi_line_data: Regex,\n    end_reply_line: Regex,\n}\n\ntype StatusCode = u32;\npub(crate) struct Reply {\n    pub status_code: StatusCode,\n    pub reply_lines: Vec\u003cString\u003e,\n}\n\nimpl LegacyControlStream {\n    pub fn new(addr: \u0026SocketAddr, read_timeout: Duration) -\u003e Result\u003cLegacyControlStream, Error\u003e {\n        if read_timeout.is_zero() {\n            return Err(Error::ReadTimeoutZero());\n        }\n\n        let stream = TcpStream::connect(addr).map_err(Error::CreationFailed)?;\n        stream\n            .set_read_timeout(Some(read_timeout))\n            .map_err(Error::ConfigurationFailed)?;\n\n        // pre-allocate a kilobyte for the read buffer\n        const READ_BUFFER_SIZE: usize = 1024;\n        let pending_data = Vec::with_capacity(READ_BUFFER_SIZE);\n\n        let single_line_data =\n            Regex::new(r\"^\\d\\d\\d-.*\").map_err(Error::ParsingRegexCreationFailed)?;\n        let multi_line_data =\n            Regex::new(r\"^\\d\\d\\d+.*\").map_err(Error::ParsingRegexCreationFailed)?;\n        let end_reply_line =\n            Regex::new(r\"^\\d\\d\\d .*\").map_err(Error::ParsingRegexCreationFailed)?;\n\n        Ok(LegacyControlStream {\n            stream,\n            closed_by_remote: false,\n            pending_data,\n            pending_lines: Default::default(),\n            pending_reply: Default::default(),\n            reading_multiline_value: false,\n            // regex\n            single_line_data,\n            multi_line_data,\n            end_reply_line,\n        })\n    }\n\n    #[cfg(test)]\n    pub(crate) fn closed_by_remote(\u0026mut self) -\u003e bool {\n        self.closed_by_remote\n    }\n\n    fn read_line(\u0026mut self) -\u003e Result\u003cOption\u003cString\u003e, Error\u003e {\n        // read pending bytes from stream until we have a line to return\n        while self.pending_lines.is_empty() {\n            let byte_count = self.pending_data.len();\n            match self.stream.read_to_end(\u0026mut self.pending_data) {\n                Err(err) =\u003e {\n                    if err.kind() == ErrorKind::WouldBlock || err.kind() == ErrorKind::TimedOut {\n                        if byte_count == self.pending_data.len() {\n                            return Ok(None);\n                        }\n                    } else {\n                        return Err(Error::ReadFailed(err));\n                    }\n                }\n                Ok(0usize) =\u003e {\n                    self.closed_by_remote = true;\n                    return Err(Error::ClosedByRemote());\n                }\n                Ok(_count) =\u003e (),\n            }\n\n            // split our read buffer into individual lines\n            let mut begin = 0;\n            for index in 1..self.pending_data.len() {\n                if self.pending_data[index - 1] == b'\\r' \u0026\u0026 self.pending_data[index] == b'\\n' {\n                    let end = index - 1;\n                    // view into byte vec of just the found line\n                    let line_view: \u0026[u8] = \u0026self.pending_data[begin..end];\n                    // convert to string\n                    let line_string =\n                        std::str::from_utf8(line_view).map_err(Error::InvalidResponse)?;\n\n                    // save in pending list\n                    self.pending_lines.push_back(line_string.to_string());\n                    // update begin (and skip over \\r\\n)\n                    begin = end + 2;\n                }\n            }\n            // leave any leftover bytes in the buffer for the next call\n            self.pending_data.drain(0..begin);\n        }\n\n        Ok(self.pending_lines.pop_front())\n    }\n\n    pub fn read_reply(\u0026mut self) -\u003e Result\u003cOption\u003cReply\u003e, Error\u003e {\n        loop {\n            let current_line = match self.read_line()? {\n                Some(line) =\u003e line,\n                None =\u003e return Ok(None),\n            };\n\n            // make sure the status code matches (if we are not in the\n            // middle of a multi-line read\n            if let Some(first_line) = self.pending_reply.first() {\n                if !self.reading_multiline_value {\n                    let first_status_code = \u0026first_line[0..3];\n                    let current_status_code = \u0026current_line[0..3];\n                    if first_status_code != current_status_code {\n                        return Err(Error::ReplyParseFailed(format!(\n                            \"mismatched status codes, {} != {}\",\n                            first_status_code, current_status_code\n                        )));\n                    }\n                }\n            }\n\n            // end of a response\n            if self.end_reply_line.is_match(\u0026current_line) {\n                if self.reading_multiline_value {\n                    return Err(Error::ReplyParseFailed(\n                        \"found multi-line end reply but not reading a multi-line reply\".to_string(),\n                    ));\n                }\n                self.pending_reply.push(current_line);\n                break;\n            // single line data from getinfo and friends\n            } else if self.single_line_data.is_match(\u0026current_line) {\n                if self.reading_multiline_value {\n                    return Err(Error::ReplyParseFailed(\n                        \"found single-line reply but still reading a multi-line reply\".to_string(),\n                    ));\n                }\n                self.pending_reply.push(current_line);\n            // begin of multiline data from getinfo and friends\n            } else if self.multi_line_data.is_match(\u0026current_line) {\n                if self.reading_multiline_value {\n                    return Err(Error::ReplyParseFailed(\n                        \"found multi-line start reply but still reading a multi-line reply\"\n                            .to_string(),\n                    ));\n                }\n                self.pending_reply.push(current_line);\n                self.reading_multiline_value = true;\n            // multiline data to be squashed to a single entry\n            } else {\n                if !self.reading_multiline_value {\n                    return Err(Error::ReplyParseFailed(\n                        \"found a multi-line intermediate reply but not reading a multi-line reply\"\n                            .to_string(),\n                    ));\n                }\n                // don't bother writing the end of multiline token\n                if current_line == \".\" {\n                    self.reading_multiline_value = false;\n                } else {\n                    let multiline = match self.pending_reply.last_mut() {\n                        Some(multiline) =\u003e multiline,\n                        // if our logic here is right, then\n                        // self.reading_multiline_value == !self.pending_reply.is_empty()\n                        // should always be true regardless of the data received\n                        // from the control port\n                        None =\u003e unreachable!(),\n                    };\n                    multiline.push('\\n');\n                    multiline.push_str(\u0026current_line);\n                }\n            }\n        }\n\n        // take ownership of the reply lines\n        let mut reply_lines: Vec\u003cString\u003e = Default::default();\n        std::mem::swap(\u0026mut self.pending_reply, \u0026mut reply_lines);\n\n        // parse out the response code for easier matching\n        let status_code_string = match reply_lines.first() {\n            Some(line) =\u003e line[0..3].to_string(),\n            // the lines have already been parsed+validated in the above loop\n            None =\u003e unreachable!(),\n        };\n        let status_code: u32 = match status_code_string.parse() {\n            Ok(status_code) =\u003e status_code,\n            Err(_) =\u003e {\n                return Err(Error::ReplyParseFailed(format!(\n                    \"unable to parse '{}' as status code\",\n                    status_code_string\n                )))\n            }\n        };\n\n        // strip the redundant status code from start of lines\n        for line in reply_lines.iter_mut() {\n            if line.starts_with(\u0026status_code_string) {\n                *line = line[4..].to_string();\n            }\n        }\n\n        Ok(Some(Reply {\n            status_code,\n            reply_lines,\n        }))\n    }\n\n    pub fn write(\u0026mut self, cmd: \u0026str) -\u003e Result\u003c(), Error\u003e {\n        if let Err(err) = write!(self.stream, \"{}\\r\\n\", cmd) {\n            self.closed_by_remote = true;\n            return Err(Error::WriteFailed(err));\n        }\n        Ok(())\n    }\n}\n","traces":[{"line":63,"address":[5663904,5666128,5666297],"length":1,"stats":{"Line":3}},{"line":64,"address":[1829527],"length":1,"stats":{"Line":3}},{"line":65,"address":[3637442],"length":1,"stats":{"Line":0}},{"line":68,"address":[3637354,3637505,3637592],"length":1,"stats":{"Line":6}},{"line":69,"address":[1829923,1831866,1829510,1830056,1829760],"length":1,"stats":{"Line":9}},{"line":70,"address":[5664152],"length":1,"stats":{"Line":3}},{"line":71,"address":[2685064],"length":1,"stats":{"Line":0}},{"line":75,"address":[1829995],"length":1,"stats":{"Line":3}},{"line":77,"address":[5624757],"length":1,"stats":{"Line":4}},{"line":79,"address":[2686840,2685475,2685640,2685334],"length":1,"stats":{"Line":6}},{"line":81,"address":[2685745,2685604,2685961],"length":1,"stats":{"Line":6}},{"line":84,"address":[3639075],"length":1,"stats":{"Line":3}},{"line":85,"address":[2685878],"length":1,"stats":{"Line":3}},{"line":87,"address":[2685897],"length":1,"stats":{"Line":3}},{"line":88,"address":[3638689],"length":1,"stats":{"Line":3}},{"line":89,"address":[5625698],"length":1,"stats":{"Line":3}},{"line":92,"address":[2686131],"length":1,"stats":{"Line":3}},{"line":93,"address":[5665571],"length":1,"stats":{"Line":3}},{"line":94,"address":[5665635],"length":1,"stats":{"Line":3}},{"line":99,"address":[1763120],"length":1,"stats":{"Line":1}},{"line":100,"address":[1763125],"length":1,"stats":{"Line":1}},{"line":103,"address":[2688405,2686960],"length":1,"stats":{"Line":3}},{"line":105,"address":[5626622],"length":1,"stats":{"Line":3}},{"line":106,"address":[3516823],"length":1,"stats":{"Line":3}},{"line":107,"address":[5666495,5666544],"length":1,"stats":{"Line":4}},{"line":108,"address":[3516906],"length":1,"stats":{"Line":3}},{"line":109,"address":[3516929,3517140,3517227],"length":1,"stats":{"Line":6}},{"line":110,"address":[2687476,2687656],"length":1,"stats":{"Line":6}},{"line":111,"address":[1763879],"length":1,"stats":{"Line":3}},{"line":114,"address":[5666923],"length":1,"stats":{"Line":0}},{"line":118,"address":[5626857],"length":1,"stats":{"Line":0}},{"line":119,"address":[2687232],"length":1,"stats":{"Line":0}},{"line":121,"address":[3517024],"length":1,"stats":{"Line":1}},{"line":125,"address":[1832274],"length":1,"stats":{"Line":3}},{"line":126,"address":[1832286,1832804,1832713],"length":1,"stats":{"Line":9}},{"line":127,"address":[3640617,3641110],"length":1,"stats":{"Line":6}},{"line":128,"address":[3517697,3517863],"length":1,"stats":{"Line":3}},{"line":130,"address":[2688009],"length":1,"stats":{"Line":3}},{"line":132,"address":[5667425,5667532,5667631],"length":1,"stats":{"Line":6}},{"line":136,"address":[5667564],"length":1,"stats":{"Line":3}},{"line":138,"address":[1764547,1764419,1764534],"length":1,"stats":{"Line":6}},{"line":142,"address":[3640551],"length":1,"stats":{"Line":3}},{"line":145,"address":[1763213],"length":1,"stats":{"Line":3}},{"line":148,"address":[3641184,3645622],"length":1,"stats":{"Line":3}},{"line":149,"address":[2688471,2691081],"length":1,"stats":{"Line":6}},{"line":150,"address":[2688495],"length":1,"stats":{"Line":3}},{"line":151,"address":[3641585],"length":1,"stats":{"Line":3}},{"line":152,"address":[1764940],"length":1,"stats":{"Line":3}},{"line":157,"address":[1765196,1765095],"length":1,"stats":{"Line":6}},{"line":158,"address":[1834062],"length":1,"stats":{"Line":3}},{"line":159,"address":[3641927],"length":1,"stats":{"Line":3}},{"line":160,"address":[5668626],"length":1,"stats":{"Line":3}},{"line":161,"address":[3642085],"length":1,"stats":{"Line":3}},{"line":162,"address":[5669124,5668979],"length":1,"stats":{"Line":0}},{"line":171,"address":[3518847,3519634],"length":1,"stats":{"Line":6}},{"line":172,"address":[1834952],"length":1,"stats":{"Line":3}},{"line":173,"address":[5632551],"length":1,"stats":{"Line":0}},{"line":174,"address":[3521029],"length":1,"stats":{"Line":0}},{"line":177,"address":[5630870],"length":1,"stats":{"Line":3}},{"line":180,"address":[1834901,1834994],"length":1,"stats":{"Line":6}},{"line":181,"address":[3519848],"length":1,"stats":{"Line":3}},{"line":182,"address":[1767276],"length":1,"stats":{"Line":0}},{"line":183,"address":[1836001],"length":1,"stats":{"Line":0}},{"line":186,"address":[5630700,5630610],"length":1,"stats":{"Line":6}},{"line":188,"address":[5669445,5669538,5670213],"length":1,"stats":{"Line":3}},{"line":189,"address":[3642968],"length":1,"stats":{"Line":1}},{"line":190,"address":[5630482],"length":1,"stats":{"Line":0}},{"line":191,"address":[5630427],"length":1,"stats":{"Line":0}},{"line":195,"address":[5670108],"length":1,"stats":{"Line":1}},{"line":196,"address":[3520558],"length":1,"stats":{"Line":1}},{"line":199,"address":[1835157],"length":1,"stats":{"Line":1}},{"line":200,"address":[3643053],"length":1,"stats":{"Line":0}},{"line":201,"address":[3642986],"length":1,"stats":{"Line":0}},{"line":206,"address":[1835388,1835448,1835221],"length":1,"stats":{"Line":3}},{"line":207,"address":[5669857],"length":1,"stats":{"Line":1}},{"line":209,"address":[2690509,2690442],"length":1,"stats":{"Line":2}},{"line":210,"address":[5669979],"length":1,"stats":{"Line":1}},{"line":217,"address":[1835592],"length":1,"stats":{"Line":1}},{"line":218,"address":[1766815],"length":1,"stats":{"Line":1}},{"line":224,"address":[2691339],"length":1,"stats":{"Line":3}},{"line":225,"address":[3521116],"length":1,"stats":{"Line":3}},{"line":228,"address":[5631076],"length":1,"stats":{"Line":3}},{"line":229,"address":[3644344],"length":1,"stats":{"Line":3}},{"line":233,"address":[3521495,3521418],"length":1,"stats":{"Line":6}},{"line":234,"address":[2691830],"length":1,"stats":{"Line":3}},{"line":236,"address":[5671996,5672125],"length":1,"stats":{"Line":0}},{"line":244,"address":[5671699,5671224,5671378],"length":1,"stats":{"Line":9}},{"line":245,"address":[2692344,2692395,2692615],"length":1,"stats":{"Line":9}},{"line":246,"address":[5632068],"length":1,"stats":{"Line":3}},{"line":250,"address":[3521930],"length":1,"stats":{"Line":3}},{"line":252,"address":[3644914],"length":1,"stats":{"Line":3}},{"line":256,"address":[1769184],"length":1,"stats":{"Line":3}},{"line":257,"address":[2693112,2693225],"length":1,"stats":{"Line":6}},{"line":258,"address":[1769455],"length":1,"stats":{"Line":1}},{"line":259,"address":[1838311],"length":1,"stats":{"Line":1}},{"line":261,"address":[2693436],"length":1,"stats":{"Line":3}}],"covered":81,"coverable":96},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","legacy_tor_controller.rs"],"content":"// standard\nuse std::default::Default;\nuse std::net::SocketAddr;\nuse std::option::Option;\n#[cfg(test)]\nuse std::path::Path;\nuse std::str::FromStr;\nuse std::string::ToString;\n#[cfg(test)]\nuse std::time::{Duration, Instant};\n\n// extern crates\nuse regex::Regex;\n#[cfg(test)]\nuse serial_test::serial;\n\n// internal crates\nuse crate::legacy_tor_control_stream::*;\n#[cfg(test)]\nuse crate::legacy_tor_process::*;\nuse crate::legacy_tor_version::*;\nuse crate::tor_crypto::*;\n\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"response regex creation failed\")]\n    ParsingRegexCreationFailed(#[source] regex::Error),\n\n    #[error(\"control stream read reply failed\")]\n    ReadReplyFailed(#[source] crate::legacy_tor_control_stream::Error),\n\n    #[error(\"unexpected synchronous reply recieved\")]\n    UnexpectedSynchonousReplyReceived(),\n\n    #[error(\"control stream write command failed\")]\n    WriteCommandFailed(#[source] crate::legacy_tor_control_stream::Error),\n\n    #[error(\"invalid command arguments: {0}\")]\n    InvalidCommandArguments(String),\n\n    #[error(\"command failed: {0} {}\", .1.join(\"\\n\"))]\n    CommandFailed(u32, Vec\u003cString\u003e),\n\n    #[error(\"failed to parse command reply: {0}\")]\n    CommandReplyParseFailed(String),\n\n    #[error(\"failed to parse received tor version\")]\n    TorVersionParseFailed(#[source] crate::legacy_tor_version::Error),\n}\n\n// Per-command data\n#[derive(Default)]\npub(crate) struct AddOnionFlags {\n    pub discard_pk: bool,\n    pub detach: bool,\n    pub v3_auth: bool,\n    pub non_anonymous: bool,\n    pub max_streams_close_circuit: bool,\n}\n\n#[derive(Default)]\npub(crate) struct OnionClientAuthAddFlags {\n    pub permanent: bool,\n}\n\npub(crate) enum AsyncEvent {\n    Unknown {\n        lines: Vec\u003cString\u003e,\n    },\n    StatusClient {\n        severity: String,\n        action: String,\n        arguments: Vec\u003c(String, String)\u003e,\n    },\n    HsDesc {\n        action: String,\n        hs_address: V3OnionServiceId,\n    },\n}\n\npub(crate) struct LegacyTorController {\n    // underlying control stream\n    control_stream: LegacyControlStream,\n    // list of async replies to be handled\n    async_replies: Vec\u003cReply\u003e,\n    // regex for parsing events\n    status_event_pattern: Regex,\n    status_event_argument_pattern: Regex,\n    hs_desc_pattern: Regex,\n}\n\nfn quoted_string(string: \u0026str) -\u003e String {\n    // replace \\ with \\\\ and \" with \\\"\n    // see: https://spec.torproject.org/control-spec/message-format.html?highlight=QuotedString#description-format\n    string.replace(\"\\\\\", \"\\\\\\\\\").replace(\"\\\"\", \"\\\\\\\"\")\n}\n\nimpl LegacyTorController {\n    pub fn new(control_stream: LegacyControlStream) -\u003e Result\u003cLegacyTorController, Error\u003e {\n        let status_event_pattern =\n            Regex::new(r#\"^STATUS_CLIENT (?P\u003cseverity\u003eNOTICE|WARN|ERR) (?P\u003caction\u003e[A-Za-z]+)\"#)\n                .map_err(Error::ParsingRegexCreationFailed)?;\n        let status_event_argument_pattern =\n            Regex::new(r#\"(?P\u003ckey\u003e[A-Z]+)=(?P\u003cvalue\u003e[A-Za-z0-9_]+|\"[^\"]+\")\"#)\n                .map_err(Error::ParsingRegexCreationFailed)?;\n        let hs_desc_pattern = Regex::new(\n            r#\"HS_DESC (?P\u003caction\u003eREQUESTED|UPLOAD|RECEIVED|UPLOADED|IGNORE|FAILED|CREATED) (?P\u003chsaddress\u003e[a-z2-7]{56})\"#\n        ).map_err(Error::ParsingRegexCreationFailed)?;\n\n        Ok(LegacyTorController {\n            control_stream,\n            async_replies: Default::default(),\n            // regex\n            status_event_pattern,\n            status_event_argument_pattern,\n            hs_desc_pattern,\n        })\n    }\n\n    // return curently available events, does not block waiting\n    // for an event\n    fn wait_async_replies(\u0026mut self) -\u003e Result\u003cVec\u003cReply\u003e, Error\u003e {\n        let mut replies: Vec\u003cReply\u003e = Default::default();\n        // take any previously received async replies\n        std::mem::swap(\u0026mut self.async_replies, \u0026mut replies);\n\n        // and keep consuming until none are available\n        loop {\n            if let Some(reply) = self\n                .control_stream\n                .read_reply()\n                .map_err(Error::ReadReplyFailed)?\n            {\n                replies.push(reply);\n            } else {\n                // no more replies immediately available so return\n                return Ok(replies);\n            }\n        }\n    }\n\n    fn reply_to_event(\u0026self, reply: \u0026mut Reply) -\u003e Result\u003cAsyncEvent, Error\u003e {\n        if reply.status_code != 650u32 {\n            return Err(Error::UnexpectedSynchonousReplyReceived());\n        }\n\n        // not sure this is what we want but yolo\n        let reply_text = reply.reply_lines.join(\" \");\n        if let Some(caps) = self.status_event_pattern.captures(\u0026reply_text) {\n            let severity = match caps.name(\"severity\") {\n                Some(severity) =\u003e severity.as_str(),\n                None =\u003e unreachable!(),\n            };\n            let action = match caps.name(\"action\") {\n                Some(action) =\u003e action.as_str(),\n                None =\u003e unreachable!(),\n            };\n\n            let mut arguments: Vec\u003c(String, String)\u003e = Default::default();\n            for caps in self\n                .status_event_argument_pattern\n                .captures_iter(\u0026reply_text)\n            {\n                let key = match caps.name(\"key\") {\n                    Some(key) =\u003e key.as_str(),\n                    None =\u003e unreachable!(),\n                };\n                let value = {\n                    let value = match caps.name(\"value\") {\n                        Some(value) =\u003e value.as_str(),\n                        None =\u003e unreachable!(),\n                    };\n                    if value.starts_with('\\\"') \u0026\u0026 value.ends_with('\\\"') {\n                        \u0026value[1..value.len() - 1]\n                    } else {\n                        value\n                    }\n                };\n                arguments.push((key.to_string(), value.to_string()));\n            }\n\n            return Ok(AsyncEvent::StatusClient {\n                severity: severity.to_string(),\n                action: action.to_string(),\n                arguments,\n            });\n        }\n\n        if let Some(caps) = self.hs_desc_pattern.captures(\u0026reply_text) {\n            let action = match caps.name(\"action\") {\n                Some(action) =\u003e action.as_str(),\n                None =\u003e unreachable!(),\n            };\n            let hs_address = match caps.name(\"hsaddress\") {\n                Some(hs_address) =\u003e hs_address.as_str(),\n                None =\u003e unreachable!(),\n            };\n\n            if let Ok(hs_address) = V3OnionServiceId::from_string(hs_address) {\n                return Ok(AsyncEvent::HsDesc {\n                    action: action.to_string(),\n                    hs_address,\n                });\n            }\n        }\n\n        // no luck parsing reply, just return full text\n        let mut reply_lines: Vec\u003cString\u003e = Default::default();\n        std::mem::swap(\u0026mut reply_lines, \u0026mut reply.reply_lines);\n\n        Ok(AsyncEvent::Unknown { lines: reply_lines })\n    }\n\n    pub fn wait_async_events(\u0026mut self) -\u003e Result\u003cVec\u003cAsyncEvent\u003e, Error\u003e {\n        let mut async_replies = self.wait_async_replies()?;\n        let mut async_events: Vec\u003cAsyncEvent\u003e = Default::default();\n\n        for reply in async_replies.iter_mut() {\n            async_events.push(self.reply_to_event(reply)?);\n        }\n\n        Ok(async_events)\n    }\n\n    // wait for a sync reply, save off async replies for later\n    fn wait_sync_reply(\u0026mut self) -\u003e Result\u003cReply, Error\u003e {\n        loop {\n            if let Some(reply) = self\n                .control_stream\n                .read_reply()\n                .map_err(Error::ReadReplyFailed)?\n            {\n                match reply.status_code {\n                    650u32 =\u003e self.async_replies.push(reply),\n                    _ =\u003e return Ok(reply),\n                }\n            }\n        }\n    }\n\n    fn write_command(\u0026mut self, text: \u0026str) -\u003e Result\u003cReply, Error\u003e {\n        self.control_stream\n            .write(text)\n            .map_err(Error::WriteCommandFailed)?;\n        self.wait_sync_reply()\n    }\n\n    //\n    // Tor Commands\n    //\n    // The section where we can find the specification in control-spec.txt\n    // for the underlying command is listed in parentheses\n    //\n    // Each of these command wrapper methods block until completion\n    //\n\n    // SETCONF (3.1)\n    fn setconf_cmd(\u0026mut self, key_values: \u0026[(\u0026str, String)]) -\u003e Result\u003cReply, Error\u003e {\n        if key_values.is_empty() {\n            return Err(Error::InvalidCommandArguments(\n                \"SETCONF key-value pairs list must not be empty\".to_string(),\n            ));\n        }\n        let mut command_buffer = vec![\"SETCONF\".to_string()];\n\n        for (key, value) in key_values.iter() {\n            command_buffer.push(format!(\"{}=\\\"{}\\\"\", key, quoted_string(value.trim())));\n        }\n        let command = command_buffer.join(\" \");\n\n        self.write_command(\u0026command)\n    }\n\n    // GETCONF (3.3)\n    #[cfg(test)]\n    fn getconf_cmd(\u0026mut self, keywords: \u0026[\u0026str]) -\u003e Result\u003cReply, Error\u003e {\n        if keywords.is_empty() {\n            return Err(Error::InvalidCommandArguments(\n                \"GETCONF keywords list must not be empty\".to_string(),\n            ));\n        }\n        let command = format!(\"GETCONF {}\", keywords.join(\" \"));\n\n        self.write_command(\u0026command)\n    }\n\n    // SETEVENTS (3.4)\n    fn setevents_cmd(\u0026mut self, event_codes: \u0026[\u0026str]) -\u003e Result\u003cReply, Error\u003e {\n        if event_codes.is_empty() {\n            return Err(Error::InvalidCommandArguments(\n                \"SETEVENTS event codes list mut not be empty\".to_string(),\n            ));\n        }\n        let command = format!(\"SETEVENTS {}\", event_codes.join(\" \"));\n\n        self.write_command(\u0026command)\n    }\n\n    // AUTHENTICATE (3.5)\n    fn authenticate_cmd(\u0026mut self, password: \u0026str) -\u003e Result\u003cReply, Error\u003e {\n        let command = format!(\"AUTHENTICATE \\\"{}\\\"\", quoted_string(password));\n\n        self.write_command(\u0026command)\n    }\n\n    // GETINFO (3.9)\n    fn getinfo_cmd(\u0026mut self, keywords: \u0026[\u0026str]) -\u003e Result\u003cReply, Error\u003e {\n        if keywords.is_empty() {\n            return Err(Error::InvalidCommandArguments(\n                \"GETINFO keywords list must not be empty\".to_string(),\n            ));\n        }\n        let command = format!(\"GETINFO {}\", keywords.join(\" \"));\n\n        self.write_command(\u0026command)\n    }\n\n    // ADD_ONION (3.27)\n    fn add_onion_cmd(\n        \u0026mut self,\n        key: Option\u003c\u0026Ed25519PrivateKey\u003e,\n        flags: \u0026AddOnionFlags,\n        max_streams: Option\u003cu16\u003e,\n        virt_port: u16,\n        target: Option\u003cSocketAddr\u003e,\n        client_auth: Option\u003c\u0026[X25519PublicKey]\u003e,\n    ) -\u003e Result\u003cReply, Error\u003e {\n        let mut command_buffer = vec![\"ADD_ONION\".to_string()];\n\n        // set our key or request a new one\n        if let Some(key) = key {\n            command_buffer.push(key.to_key_blob());\n        } else {\n            command_buffer.push(\"NEW:ED25519-V3\".to_string());\n        }\n\n        // set our flags\n        let mut flag_buffer: Vec\u003c\u0026str\u003e = Default::default();\n        if flags.discard_pk {\n            flag_buffer.push(\"DiscardPK\");\n        }\n        if flags.detach {\n            flag_buffer.push(\"Detach\");\n        }\n        if flags.v3_auth {\n            flag_buffer.push(\"V3Auth\");\n        }\n        if flags.non_anonymous {\n            flag_buffer.push(\"NonAnonymous\");\n        }\n        if flags.max_streams_close_circuit {\n            flag_buffer.push(\"MaxStreamsCloseCircuit\");\n        }\n\n        if !flag_buffer.is_empty() {\n            command_buffer.push(format!(\"Flags={}\", flag_buffer.join(\",\")));\n        }\n\n        // set max concurrent streams\n        if let Some(max_streams) = max_streams {\n            command_buffer.push(format!(\"MaxStreams={}\", max_streams));\n        }\n\n        // set our onion service target\n        if let Some(target) = target {\n            command_buffer.push(format!(\"Port={},{}\", virt_port, target));\n        } else {\n            command_buffer.push(format!(\"Port={}\", virt_port));\n        }\n        // setup client auth\n        if let Some(client_auth) = client_auth {\n            for key in client_auth.iter() {\n                command_buffer.push(format!(\"ClientAuthV3={}\", key.to_base32()));\n            }\n        }\n\n        // finally send the command\n        let command = command_buffer.join(\" \");\n\n        self.write_command(\u0026command)\n    }\n\n    // DEL_ONION (3.38)\n    fn del_onion_cmd(\u0026mut self, service_id: \u0026V3OnionServiceId) -\u003e Result\u003cReply, Error\u003e {\n        let command = format!(\"DEL_ONION {}\", service_id);\n\n        self.write_command(\u0026command)\n    }\n\n    // ONION_CLIENT_AUTH_ADD (3.30)\n    fn onion_client_auth_add_cmd(\n        \u0026mut self,\n        service_id: \u0026V3OnionServiceId,\n        private_key: \u0026X25519PrivateKey,\n        client_name: Option\u003cString\u003e,\n        flags: \u0026OnionClientAuthAddFlags,\n    ) -\u003e Result\u003cReply, Error\u003e {\n        let mut command_buffer = vec![\"ONION_CLIENT_AUTH_ADD\".to_string()];\n\n        // set the onion service id\n        command_buffer.push(service_id.to_string());\n\n        // set our client's private key\n        command_buffer.push(format!(\"x25519:{}\", private_key.to_base64()));\n\n        if let Some(client_name) = client_name {\n            command_buffer.push(format!(\"ClientName={}\", client_name));\n        }\n\n        if flags.permanent {\n            command_buffer.push(\"Flags=Permanent\".to_string());\n        }\n\n        // finally send command\n        let command = command_buffer.join(\" \");\n\n        self.write_command(\u0026command)\n    }\n\n    // ONION_CLIENT_AUTH_REMOVE (3.31)\n    fn onion_client_auth_remove_cmd(\n        \u0026mut self,\n        service_id: \u0026V3OnionServiceId,\n    ) -\u003e Result\u003cReply, Error\u003e {\n        let command = format!(\"ONION_CLIENT_AUTH_REMOVE {}\", service_id);\n\n        self.write_command(\u0026command)\n    }\n\n    //\n    // Public high-level typesafe command method wrappers\n    //\n\n    pub fn setconf(\u0026mut self, key_values: \u0026[(\u0026str, String)]) -\u003e Result\u003c(), Error\u003e {\n        let reply = self.setconf_cmd(key_values)?;\n\n        match reply.status_code {\n            250u32 =\u003e Ok(()),\n            code =\u003e Err(Error::CommandFailed(code, reply.reply_lines)),\n        }\n    }\n\n    #[cfg(test)]\n    pub fn getconf(\u0026mut self, keywords: \u0026[\u0026str]) -\u003e Result\u003cVec\u003c(String, String)\u003e, Error\u003e {\n        let reply = self.getconf_cmd(keywords)?;\n\n        match reply.status_code {\n            250u32 =\u003e {\n                let mut key_values: Vec\u003c(String, String)\u003e = Default::default();\n                for line in reply.reply_lines {\n                    match line.find('=') {\n                        Some(index) =\u003e key_values\n                            .push((line[0..index].to_string(), line[index + 1..].to_string())),\n                        None =\u003e key_values.push((line, String::new())),\n                    }\n                }\n                Ok(key_values)\n            }\n            code =\u003e Err(Error::CommandFailed(code, reply.reply_lines)),\n        }\n    }\n\n    pub fn setevents(\u0026mut self, events: \u0026[\u0026str]) -\u003e Result\u003c(), Error\u003e {\n        let reply = self.setevents_cmd(events)?;\n\n        match reply.status_code {\n            250u32 =\u003e Ok(()),\n            code =\u003e Err(Error::CommandFailed(code, reply.reply_lines)),\n        }\n    }\n\n    pub fn authenticate(\u0026mut self, password: \u0026str) -\u003e Result\u003c(), Error\u003e {\n        let reply = self.authenticate_cmd(password)?;\n\n        match reply.status_code {\n            250u32 =\u003e Ok(()),\n            code =\u003e Err(Error::CommandFailed(code, reply.reply_lines)),\n        }\n    }\n\n    pub fn getinfo(\u0026mut self, keywords: \u0026[\u0026str]) -\u003e Result\u003cVec\u003c(String, String)\u003e, Error\u003e {\n        let reply = self.getinfo_cmd(keywords)?;\n\n        match reply.status_code {\n            250u32 =\u003e {\n                let mut key_values: Vec\u003c(String, String)\u003e = Default::default();\n                for line in reply.reply_lines {\n                    match line.find('=') {\n                        Some(index) =\u003e key_values\n                            .push((line[0..index].to_string(), line[index + 1..].to_string())),\n                        None =\u003e {\n                            if line != \"OK\" {\n                                key_values.push((line, String::new()))\n                            }\n                        }\n                    }\n                }\n                Ok(key_values)\n            }\n            code =\u003e Err(Error::CommandFailed(code, reply.reply_lines)),\n        }\n    }\n\n    pub fn add_onion(\n        \u0026mut self,\n        key: Option\u003c\u0026Ed25519PrivateKey\u003e,\n        flags: \u0026AddOnionFlags,\n        max_streams: Option\u003cu16\u003e,\n        virt_port: u16,\n        target: Option\u003cSocketAddr\u003e,\n        client_auth: Option\u003c\u0026[X25519PublicKey]\u003e,\n    ) -\u003e Result\u003c(Option\u003cEd25519PrivateKey\u003e, V3OnionServiceId), Error\u003e {\n        let reply = self.add_onion_cmd(key, flags, max_streams, virt_port, target, client_auth)?;\n\n        let mut private_key: Option\u003cEd25519PrivateKey\u003e = None;\n        let mut service_id: Option\u003cV3OnionServiceId\u003e = None;\n\n        match reply.status_code {\n            250u32 =\u003e {\n                for line in reply.reply_lines {\n                    if let Some(mut index) = line.find(\"ServiceID=\") {\n                        if service_id.is_some() {\n                            return Err(Error::CommandReplyParseFailed(\n                                \"received duplicate ServiceID entries\".to_string(),\n                            ));\n                        }\n                        index += \"ServiceId=\".len();\n                        let service_id_string = \u0026line[index..];\n                        service_id = match V3OnionServiceId::from_string(service_id_string) {\n                            Ok(service_id) =\u003e Some(service_id),\n                            Err(_) =\u003e {\n                                return Err(Error::CommandReplyParseFailed(format!(\n                                    \"could not parse '{}' as V3OnionServiceId\",\n                                    service_id_string\n                                )))\n                            }\n                        }\n                    } else if let Some(mut index) = line.find(\"PrivateKey=\") {\n                        if private_key.is_some() {\n                            return Err(Error::CommandReplyParseFailed(\n                                \"received duplicate PrivateKey entries\".to_string(),\n                            ));\n                        }\n                        index += \"PrivateKey=\".len();\n                        let key_blob_string = \u0026line[index..];\n                        private_key = match Ed25519PrivateKey::from_key_blob_legacy(key_blob_string)\n                        {\n                            Ok(private_key) =\u003e Some(private_key),\n                            Err(_) =\u003e {\n                                return Err(Error::CommandReplyParseFailed(format!(\n                                    \"could not parse {} as Ed25519PrivateKey\",\n                                    key_blob_string\n                                )))\n                            }\n                        };\n                    } else if line.contains(\"ClientAuthV3=\") {\n                        if client_auth.unwrap_or_default().is_empty() {\n                            return Err(Error::CommandReplyParseFailed(\n                                \"recieved unexpected ClientAuthV3 keys\".to_string(),\n                            ));\n                        }\n                    } else if !line.contains(\"OK\") {\n                        return Err(Error::CommandReplyParseFailed(format!(\n                            \"received unexpected reply line '{}'\",\n                            line\n                        )));\n                    }\n                }\n            }\n            code =\u003e return Err(Error::CommandFailed(code, reply.reply_lines)),\n        }\n\n        if flags.discard_pk {\n            if private_key.is_some() {\n                return Err(Error::CommandReplyParseFailed(\n                    \"PrivateKey response should have been discard\".to_string(),\n                ));\n            }\n        } else if private_key.is_none() {\n            return Err(Error::CommandReplyParseFailed(\n                \"did not receive a PrivateKey\".to_string(),\n            ));\n        }\n\n        match service_id {\n            Some(service_id) =\u003e Ok((private_key, service_id)),\n            None =\u003e Err(Error::CommandReplyParseFailed(\n                \"did not receive a ServiceID\".to_string(),\n            )),\n        }\n    }\n\n    pub fn del_onion(\u0026mut self, service_id: \u0026V3OnionServiceId) -\u003e Result\u003c(), Error\u003e {\n        let reply = self.del_onion_cmd(service_id)?;\n\n        match reply.status_code {\n            250u32 =\u003e Ok(()),\n            code =\u003e Err(Error::CommandFailed(code, reply.reply_lines)),\n        }\n    }\n\n    // more specific encapulsation of specific command invocations\n\n    pub fn getinfo_net_listeners_socks(\u0026mut self) -\u003e Result\u003cVec\u003cSocketAddr\u003e, Error\u003e {\n        let response = self.getinfo(\u0026[\"net/listeners/socks\"])?;\n        for (key, value) in response.iter() {\n            if key.as_str() == \"net/listeners/socks\" {\n                if value.is_empty() {\n                    return Ok(Default::default());\n                }\n                // get our list of double-quoted strings\n                let listeners: Vec\u003c\u0026str\u003e = value.split(' ').collect();\n                let mut result: Vec\u003cSocketAddr\u003e = Default::default();\n                for socket_addr in listeners.iter() {\n                    if !socket_addr.starts_with('\\\"') || !socket_addr.ends_with('\\\"') {\n                        return Err(Error::CommandReplyParseFailed(format!(\n                            \"could not parse '{}' as socket address\",\n                            socket_addr\n                        )));\n                    }\n\n                    // remove leading/trailing double quote\n                    let stripped = \u0026socket_addr[1..socket_addr.len() - 1];\n                    result.push(match SocketAddr::from_str(stripped) {\n                        Ok(result) =\u003e result,\n                        Err(_) =\u003e {\n                            return Err(Error::CommandReplyParseFailed(format!(\n                                \"could not parse '{}' as socket address\",\n                                socket_addr\n                            )))\n                        }\n                    });\n                }\n                return Ok(result);\n            }\n        }\n        Err(Error::CommandReplyParseFailed(\n            \"reply did not find a 'net/listeners/socks' key/value\".to_string(),\n        ))\n    }\n\n    pub fn getinfo_version(\u0026mut self) -\u003e Result\u003cLegacyTorVersion, Error\u003e {\n        let response = self.getinfo(\u0026[\"version\"])?;\n        for (key, value) in response.iter() {\n            if key.as_str() == \"version\" {\n                return LegacyTorVersion::from_str(value).map_err(Error::TorVersionParseFailed);\n            }\n        }\n        Err(Error::CommandReplyParseFailed(\n            \"did not find a 'version' key/value\".to_string(),\n        ))\n    }\n\n    pub fn onion_client_auth_add(\n        \u0026mut self,\n        service_id: \u0026V3OnionServiceId,\n        private_key: \u0026X25519PrivateKey,\n        client_name: Option\u003cString\u003e,\n        flags: \u0026OnionClientAuthAddFlags,\n    ) -\u003e Result\u003c(), Error\u003e {\n        let reply = self.onion_client_auth_add_cmd(service_id, private_key, client_name, flags)?;\n\n        match reply.status_code {\n            250u32..=252u32 =\u003e Ok(()),\n            code =\u003e Err(Error::CommandFailed(code, reply.reply_lines)),\n        }\n    }\n\n    #[allow(dead_code)]\n    pub fn onion_client_auth_remove(\u0026mut self, service_id: \u0026V3OnionServiceId) -\u003e Result\u003c(), Error\u003e {\n        let reply = self.onion_client_auth_remove_cmd(service_id)?;\n\n        match reply.status_code {\n            250u32..=251u32 =\u003e Ok(()),\n            code =\u003e Err(Error::CommandFailed(code, reply.reply_lines)),\n        }\n    }\n}\n\n#[test]\n#[serial]\nfn test_tor_controller() -\u003e anyhow::Result\u003c()\u003e {\n    let tor_path = which::which(format!(\"tor{}\", std::env::consts::EXE_SUFFIX))?;\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_tor_controller\");\n    let tor_process = LegacyTorProcess::new(\u0026tor_path, \u0026data_path)?;\n\n    // create a scope to ensure tor_controller is dropped\n    {\n        let control_stream =\n            LegacyControlStream::new(tor_process.get_control_addr(), Duration::from_millis(16))?;\n\n        // create a tor controller and send authentication command\n        let mut tor_controller = LegacyTorController::new(control_stream)?;\n        tor_controller.authenticate_cmd(tor_process.get_password())?;\n        assert!(\n            tor_controller\n                .authenticate_cmd(\"invalid password\")?\n                .status_code\n                == 515u32\n        );\n\n        // tor controller should have shutdown the connection after failed authentication\n        assert!(\n            tor_controller\n                .authenticate_cmd(tor_process.get_password())\n                .is_err(),\n            \"expected failure due to closed connection\"\n        );\n        assert!(tor_controller.control_stream.closed_by_remote());\n    }\n    // now create a second controller\n    {\n        let control_stream =\n            LegacyControlStream::new(tor_process.get_control_addr(), Duration::from_millis(16))?;\n\n        // create a tor controller and send authentication command\n        // all async events are just printed to stdout\n        let mut tor_controller = LegacyTorController::new(control_stream)?;\n        tor_controller.authenticate(tor_process.get_password())?;\n\n        // ensure everything is matching our default_torrc settings\n        let vals = tor_controller.getconf(\u0026[\"SocksPort\", \"AvoidDiskWrites\", \"DisableNetwork\"])?;\n        for (key, value) in vals.iter() {\n            let expected = match key.as_str() {\n                \"SocksPort\" =\u003e \"auto\",\n                \"AvoidDiskWrites\" =\u003e \"1\",\n                \"DisableNetwork\" =\u003e \"1\",\n                _ =\u003e panic!(\"unexpected returned key: {}\", key),\n            };\n            assert!(value == expected);\n        }\n\n        let vals = tor_controller.getinfo(\u0026[\"version\", \"config-file\", \"config-text\"])?;\n        let mut expected_torrc_path = data_path.clone();\n        expected_torrc_path.push(\"torrc\");\n        let mut expected_control_port_path = data_path.clone();\n        expected_control_port_path.push(\"control_port\");\n        for (key, value) in vals.iter() {\n            match key.as_str() {\n                \"version\" =\u003e assert!(Regex::new(r\"\\d+\\.\\d+\\.\\d+\\.\\d+\")?.is_match(\u0026value)),\n                \"config-file\" =\u003e assert!(Path::new(\u0026value) == expected_torrc_path),\n                \"config-text\" =\u003e assert!(\n                    value.to_string()\n                        == format!(\n                            \"\\nControlPort auto\\nControlPortWriteToFile {}\\nDataDirectory {}\",\n                            expected_control_port_path.display(),\n                            data_path.display()\n                        )\n                ),\n                _ =\u003e panic!(\"unexpected returned key: {}\", key),\n            }\n        }\n\n        tor_controller.setevents(\u0026[\"STATUS_CLIENT\"])?;\n        // begin bootstrap\n        tor_controller.setconf(\u0026[(\"DisableNetwork\", \"0\".to_string())])?;\n\n        // add an onoin service\n        let (private_key, service_id) =\n            match tor_controller.add_onion(None, \u0026Default::default(), None, 22, None, None)? {\n                (Some(private_key), service_id) =\u003e (private_key, service_id),\n                _ =\u003e panic!(\"add_onion did not return expected values\"),\n            };\n        println!(\"private_key: {}\", private_key.to_key_blob());\n        println!(\"service_id: {}\", service_id.to_string());\n\n        assert!(\n            tor_controller\n                .del_onion(\u0026V3OnionServiceId::from_string(\n                    \"6l62fw7tqctlu5fesdqukvpoxezkaxbzllrafa2ve6ewuhzphxczsjyd\"\n                )?)\n                .is_err(),\n            \"deleting unknown onion should have failed\"\n        );\n\n        // delete our new onion\n        tor_controller.del_onion(\u0026service_id)?;\n\n        println!(\"listeners: \");\n        for sock_addr in tor_controller.getinfo_net_listeners_socks()?.iter() {\n            println!(\" {}\", sock_addr);\n        }\n\n        // print our event names available to tor\n        for (key, value) in tor_controller.getinfo(\u0026[\"events/names\"])?.iter() {\n            println!(\"{} : {}\", key, value);\n        }\n\n        let stop_time = Instant::now() + std::time::Duration::from_secs(5);\n        while stop_time \u003e Instant::now() {\n            for async_event in tor_controller.wait_async_events()?.iter() {\n                match async_event {\n                    AsyncEvent::Unknown { lines } =\u003e {\n                        println!(\"Unknown: {}\", lines.join(\"\\n\"));\n                    }\n                    AsyncEvent::StatusClient {\n                        severity,\n                        action,\n                        arguments,\n                    } =\u003e {\n                        println!(\"STATUS_CLIENT severity={}, action={}\", severity, action);\n                        for (key, value) in arguments.iter() {\n                            println!(\" {}='{}'\", key, value);\n                        }\n                    }\n                    AsyncEvent::HsDesc { action, hs_address } =\u003e {\n                        println!(\n                            \"HS_DESC action={}, hsaddress={}\",\n                            action,\n                            hs_address.to_string()\n                        );\n                    }\n                }\n            }\n        }\n    }\n    Ok(())\n}\n","traces":[{"line":92,"address":[5586224,5586428],"length":1,"stats":{"Line":3}},{"line":95,"address":[5586248,5586366],"length":1,"stats":{"Line":6}},{"line":99,"address":[5586448,5587927,5588010],"length":1,"stats":{"Line":3}},{"line":100,"address":[5546726],"length":1,"stats":{"Line":6}},{"line":102,"address":[5586713],"length":1,"stats":{"Line":0}},{"line":103,"address":[3560053,3560425,3561369,3560198],"length":1,"stats":{"Line":6}},{"line":105,"address":[5587001],"length":1,"stats":{"Line":0}},{"line":110,"address":[3437977],"length":1,"stats":{"Line":3}},{"line":111,"address":[5587270],"length":1,"stats":{"Line":3}},{"line":112,"address":[3560676],"length":1,"stats":{"Line":3}},{"line":114,"address":[2610693],"length":1,"stats":{"Line":3}},{"line":115,"address":[3437849],"length":1,"stats":{"Line":3}},{"line":116,"address":[5547817],"length":1,"stats":{"Line":3}},{"line":122,"address":[3562053,3561424,3562082],"length":1,"stats":{"Line":3}},{"line":123,"address":[3438429],"length":1,"stats":{"Line":3}},{"line":125,"address":[1776134,1776189],"length":1,"stats":{"Line":6}},{"line":129,"address":[5588196,5588461,5588641],"length":1,"stats":{"Line":3}},{"line":132,"address":[3561798],"length":1,"stats":{"Line":0}},{"line":134,"address":[5548772,5548880],"length":1,"stats":{"Line":6}},{"line":137,"address":[3438896],"length":1,"stats":{"Line":3}},{"line":142,"address":[1776704,1778419,1780695],"length":1,"stats":{"Line":3}},{"line":143,"address":[5588775],"length":1,"stats":{"Line":3}},{"line":144,"address":[3562287],"length":1,"stats":{"Line":0}},{"line":148,"address":[5549056],"length":1,"stats":{"Line":3}},{"line":149,"address":[2612114,2612294],"length":1,"stats":{"Line":6}},{"line":150,"address":[1757468,1757367],"length":1,"stats":{"Line":6}},{"line":151,"address":[5589319],"length":1,"stats":{"Line":3}},{"line":154,"address":[5549694],"length":1,"stats":{"Line":3}},{"line":155,"address":[3562911],"length":1,"stats":{"Line":3}},{"line":159,"address":[1777644],"length":1,"stats":{"Line":3}},{"line":160,"address":[2613220,2613175,2612927,2613048],"length":1,"stats":{"Line":12}},{"line":162,"address":[1757909],"length":1,"stats":{"Line":3}},{"line":164,"address":[5590500,5590052],"length":1,"stats":{"Line":6}},{"line":165,"address":[3563938],"length":1,"stats":{"Line":3}},{"line":169,"address":[2613927],"length":1,"stats":{"Line":3}},{"line":170,"address":[1778748],"length":1,"stats":{"Line":3}},{"line":173,"address":[3564331,3564266,3564553],"length":1,"stats":{"Line":9}},{"line":174,"address":[1759269,1759221],"length":1,"stats":{"Line":6}},{"line":176,"address":[5590939],"length":1,"stats":{"Line":3}},{"line":179,"address":[3564425,3564558],"length":1,"stats":{"Line":6}},{"line":182,"address":[5590236],"length":1,"stats":{"Line":3}},{"line":183,"address":[5550370],"length":1,"stats":{"Line":3}},{"line":184,"address":[1758353],"length":1,"stats":{"Line":3}},{"line":185,"address":[3563580],"length":1,"stats":{"Line":3}},{"line":189,"address":[1759586],"length":1,"stats":{"Line":2}},{"line":190,"address":[1779534,1779648],"length":1,"stats":{"Line":4}},{"line":191,"address":[5591742],"length":1,"stats":{"Line":2}},{"line":194,"address":[5591841],"length":1,"stats":{"Line":2}},{"line":195,"address":[3442290],"length":1,"stats":{"Line":2}},{"line":199,"address":[3565397],"length":1,"stats":{"Line":2}},{"line":200,"address":[5592221],"length":1,"stats":{"Line":2}},{"line":201,"address":[3565516],"length":1,"stats":{"Line":2}},{"line":208,"address":[5552739],"length":1,"stats":{"Line":0}},{"line":209,"address":[3565905],"length":1,"stats":{"Line":0}},{"line":211,"address":[3565976],"length":1,"stats":{"Line":0}},{"line":214,"address":[5553024,5553941],"length":1,"stats":{"Line":3}},{"line":215,"address":[5592926,5592798],"length":1,"stats":{"Line":3}},{"line":216,"address":[3443259],"length":1,"stats":{"Line":3}},{"line":218,"address":[5593353,5593098,5593021],"length":1,"stats":{"Line":9}},{"line":219,"address":[5553653,5553633],"length":1,"stats":{"Line":6}},{"line":222,"address":[3566621],"length":1,"stats":{"Line":3}},{"line":226,"address":[3567088],"length":1,"stats":{"Line":3}},{"line":227,"address":[1761949,1762472],"length":1,"stats":{"Line":6}},{"line":228,"address":[5554009,5554260],"length":1,"stats":{"Line":3}},{"line":231,"address":[5554232],"length":1,"stats":{"Line":0}},{"line":233,"address":[1762298],"length":1,"stats":{"Line":3}},{"line":234,"address":[3567519],"length":1,"stats":{"Line":2}},{"line":235,"address":[3567547],"length":1,"stats":{"Line":3}},{"line":241,"address":[5594288],"length":1,"stats":{"Line":3}},{"line":242,"address":[2617558,2617691],"length":1,"stats":{"Line":4}},{"line":244,"address":[1762623],"length":1,"stats":{"Line":1}},{"line":245,"address":[2617656],"length":1,"stats":{"Line":3}},{"line":258,"address":[3446347,3444832,3445830],"length":1,"stats":{"Line":3}},{"line":259,"address":[3444919],"length":1,"stats":{"Line":3}},{"line":260,"address":[5554919],"length":1,"stats":{"Line":0}},{"line":261,"address":[3444982],"length":1,"stats":{"Line":0}},{"line":264,"address":[1763117,1764216,1762953,1762795],"length":1,"stats":{"Line":3}},{"line":266,"address":[1763337,1763091,1763192],"length":1,"stats":{"Line":9}},{"line":267,"address":[5555748,5555927,5556219],"length":1,"stats":{"Line":6}},{"line":269,"address":[5555551,5555353],"length":1,"stats":{"Line":6}},{"line":271,"address":[5595335,5595422],"length":1,"stats":{"Line":6}},{"line":276,"address":[1783904,1784590],"length":1,"stats":{"Line":1}},{"line":277,"address":[1783976],"length":1,"stats":{"Line":1}},{"line":278,"address":[1784168],"length":1,"stats":{"Line":0}},{"line":279,"address":[1784141],"length":1,"stats":{"Line":0}},{"line":282,"address":[1784000,1784226],"length":1,"stats":{"Line":1}},{"line":284,"address":[1784556,1784478],"length":1,"stats":{"Line":2}},{"line":288,"address":[1785310,1784624],"length":1,"stats":{"Line":3}},{"line":289,"address":[3446440],"length":1,"stats":{"Line":3}},{"line":290,"address":[2619529],"length":1,"stats":{"Line":0}},{"line":291,"address":[3569630],"length":1,"stats":{"Line":0}},{"line":294,"address":[3569715,3569488],"length":1,"stats":{"Line":3}},{"line":296,"address":[5556847,5556925],"length":1,"stats":{"Line":6}},{"line":300,"address":[1765469,1764944],"length":1,"stats":{"Line":3}},{"line":301,"address":[5596933,5596808],"length":1,"stats":{"Line":3}},{"line":303,"address":[2620403,2620478],"length":1,"stats":{"Line":6}},{"line":307,"address":[1765504,1766191],"length":1,"stats":{"Line":3}},{"line":308,"address":[5557624],"length":1,"stats":{"Line":3}},{"line":309,"address":[2620809],"length":1,"stats":{"Line":0}},{"line":310,"address":[5557790],"length":1,"stats":{"Line":0}},{"line":313,"address":[3570995,3570768],"length":1,"stats":{"Line":3}},{"line":315,"address":[1786478,1786556],"length":1,"stats":{"Line":6}},{"line":319,"address":[1786624,1787966,1789897],"length":1,"stats":{"Line":3}},{"line":328,"address":[3571551,3571761,3574747],"length":1,"stats":{"Line":3}},{"line":331,"address":[3448701,3448758],"length":1,"stats":{"Line":5}},{"line":332,"address":[5598422,5598512],"length":1,"stats":{"Line":4}},{"line":334,"address":[1766768,1766649],"length":1,"stats":{"Line":2}},{"line":338,"address":[5558797],"length":1,"stats":{"Line":3}},{"line":339,"address":[1787189],"length":1,"stats":{"Line":3}},{"line":340,"address":[5558943,5558868],"length":1,"stats":{"Line":4}},{"line":342,"address":[5558860],"length":1,"stats":{"Line":3}},{"line":343,"address":[2621950],"length":1,"stats":{"Line":0}},{"line":345,"address":[1787281],"length":1,"stats":{"Line":3}},{"line":346,"address":[3449100],"length":1,"stats":{"Line":2}},{"line":348,"address":[3572116],"length":1,"stats":{"Line":3}},{"line":349,"address":[5559050],"length":1,"stats":{"Line":0}},{"line":351,"address":[2622034],"length":1,"stats":{"Line":3}},{"line":352,"address":[5598850],"length":1,"stats":{"Line":0}},{"line":355,"address":[5559083,5559143],"length":1,"stats":{"Line":6}},{"line":356,"address":[1767583,1767101,1767307,1767163],"length":1,"stats":{"Line":6}},{"line":360,"address":[2622664,2622170],"length":1,"stats":{"Line":3}},{"line":361,"address":[1767790,1767911],"length":1,"stats":{"Line":0}},{"line":365,"address":[3449904,3450095],"length":1,"stats":{"Line":5}},{"line":366,"address":[1788823,1788686],"length":1,"stats":{"Line":4}},{"line":368,"address":[3573828,3573707],"length":1,"stats":{"Line":2}},{"line":371,"address":[3573669,3573860],"length":1,"stats":{"Line":5}},{"line":372,"address":[2623764,2623827],"length":1,"stats":{"Line":4}},{"line":373,"address":[1769051,1768920,1769327],"length":1,"stats":{"Line":4}},{"line":378,"address":[1789704,1789092],"length":1,"stats":{"Line":6}},{"line":380,"address":[1789826,1789744],"length":1,"stats":{"Line":6}},{"line":384,"address":[5601376,5601675],"length":1,"stats":{"Line":1}},{"line":385,"address":[1769687],"length":1,"stats":{"Line":1}},{"line":387,"address":[2624892,2624817],"length":1,"stats":{"Line":2}},{"line":391,"address":[3453731,3452064,3453386],"length":1,"stats":{"Line":2}},{"line":398,"address":[3576740,3575271,3575162],"length":1,"stats":{"Line":4}},{"line":401,"address":[3575461,3575521],"length":1,"stats":{"Line":4}},{"line":404,"address":[2625553,2625422,2625829],"length":1,"stats":{"Line":4}},{"line":406,"address":[1770818],"length":1,"stats":{"Line":2}},{"line":407,"address":[1791395,1791516],"length":1,"stats":{"Line":0}},{"line":410,"address":[3453161],"length":1,"stats":{"Line":2}},{"line":411,"address":[3453421],"length":1,"stats":{"Line":0}},{"line":415,"address":[1771251,1771340],"length":1,"stats":{"Line":4}},{"line":417,"address":[2626420,2626499],"length":1,"stats":{"Line":4}},{"line":421,"address":[5563963,5563664],"length":1,"stats":{"Line":1}},{"line":425,"address":[5603511],"length":1,"stats":{"Line":1}},{"line":427,"address":[1771809,1771884],"length":1,"stats":{"Line":2}},{"line":434,"address":[1792272],"length":1,"stats":{"Line":3}},{"line":435,"address":[1771993,1772173],"length":1,"stats":{"Line":3}},{"line":437,"address":[5564209],"length":1,"stats":{"Line":3}},{"line":438,"address":[1772240],"length":1,"stats":{"Line":3}},{"line":439,"address":[5604048],"length":1,"stats":{"Line":0}},{"line":444,"address":[1794450,1794127,1792768],"length":1,"stats":{"Line":1}},{"line":445,"address":[1793024,1792809],"length":1,"stats":{"Line":1}},{"line":447,"address":[1793012],"length":1,"stats":{"Line":1}},{"line":449,"address":[1793096],"length":1,"stats":{"Line":1}},{"line":450,"address":[1793520,1793393,1793570,1793299,1794404],"length":1,"stats":{"Line":5}},{"line":451,"address":[1793797,1793618],"length":1,"stats":{"Line":2}},{"line":452,"address":[1793915,1794384],"length":1,"stats":{"Line":2}},{"line":453,"address":[1794154,1793936],"length":1,"stats":{"Line":2}},{"line":454,"address":[1793975,1793860],"length":1,"stats":{"Line":0}},{"line":457,"address":[1793643],"length":1,"stats":{"Line":1}},{"line":459,"address":[1793111],"length":1,"stats":{"Line":0}},{"line":463,"address":[2627488],"length":1,"stats":{"Line":3}},{"line":464,"address":[2627709,2627529],"length":1,"stats":{"Line":3}},{"line":466,"address":[3577825],"length":1,"stats":{"Line":3}},{"line":467,"address":[3577904],"length":1,"stats":{"Line":3}},{"line":468,"address":[1794798],"length":1,"stats":{"Line":0}},{"line":472,"address":[5604736],"length":1,"stats":{"Line":3}},{"line":473,"address":[3578153,3578333],"length":1,"stats":{"Line":3}},{"line":475,"address":[3455297],"length":1,"stats":{"Line":3}},{"line":476,"address":[5605024],"length":1,"stats":{"Line":3}},{"line":477,"address":[1795294],"length":1,"stats":{"Line":0}},{"line":481,"address":[1795488,1796904,1797229],"length":1,"stats":{"Line":3}},{"line":482,"address":[3455850,3455625],"length":1,"stats":{"Line":3}},{"line":484,"address":[1795738],"length":1,"stats":{"Line":3}},{"line":486,"address":[3455915],"length":1,"stats":{"Line":3}},{"line":487,"address":[1773992,1774286,1774097,1774232,1775175],"length":1,"stats":{"Line":15}},{"line":488,"address":[5566382,5566561],"length":1,"stats":{"Line":6}},{"line":489,"address":[3457279,3456746],"length":1,"stats":{"Line":6}},{"line":490,"address":[2629663,2629955],"length":1,"stats":{"Line":6}},{"line":492,"address":[2629616,2629708],"length":1,"stats":{"Line":6}},{"line":493,"address":[2629733],"length":1,"stats":{"Line":0}},{"line":498,"address":[2629399],"length":1,"stats":{"Line":3}},{"line":500,"address":[1795840],"length":1,"stats":{"Line":0}},{"line":504,"address":[1802453,1797280,1800384],"length":1,"stats":{"Line":3}},{"line":513,"address":[1775748,1775402],"length":1,"stats":{"Line":3}},{"line":515,"address":[5607494],"length":1,"stats":{"Line":3}},{"line":516,"address":[1797737],"length":1,"stats":{"Line":3}},{"line":518,"address":[5607522],"length":1,"stats":{"Line":3}},{"line":520,"address":[5568345,5567856,5568291,5568156],"length":1,"stats":{"Line":12}},{"line":521,"address":[5609021,5608129],"length":1,"stats":{"Line":6}},{"line":522,"address":[2632434,2632367],"length":1,"stats":{"Line":6}},{"line":523,"address":[3583618],"length":1,"stats":{"Line":0}},{"line":524,"address":[3582595],"length":1,"stats":{"Line":0}},{"line":527,"address":[5609192,5609257,5609344],"length":1,"stats":{"Line":6}},{"line":528,"address":[3459646,3459732],"length":1,"stats":{"Line":6}},{"line":529,"address":[5609428,5609653],"length":1,"stats":{"Line":6}},{"line":530,"address":[2632765],"length":1,"stats":{"Line":3}},{"line":532,"address":[3583424,3583295],"length":1,"stats":{"Line":0}},{"line":538,"address":[3583560,3583520,3583735,3582529,3583093,3583246],"length":1,"stats":{"Line":9}},{"line":539,"address":[1778732,1778665],"length":1,"stats":{"Line":2}},{"line":540,"address":[2634759],"length":1,"stats":{"Line":0}},{"line":541,"address":[3583933],"length":1,"stats":{"Line":0}},{"line":544,"address":[5570851,5570786,5570932],"length":1,"stats":{"Line":2}},{"line":545,"address":[5570963,5570888],"length":1,"stats":{"Line":2}},{"line":546,"address":[5571011,5571362,5571304,5571167],"length":1,"stats":{"Line":3}},{"line":548,"address":[3461181],"length":1,"stats":{"Line":1}},{"line":550,"address":[1801362,1801491],"length":1,"stats":{"Line":0}},{"line":556,"address":[5611628,5610491],"length":1,"stats":{"Line":6}},{"line":557,"address":[1801837,1802254],"length":1,"stats":{"Line":4}},{"line":558,"address":[1780402],"length":1,"stats":{"Line":0}},{"line":559,"address":[5612159],"length":1,"stats":{"Line":0}},{"line":562,"address":[5611740,5611673],"length":1,"stats":{"Line":6}},{"line":563,"address":[5612020,5611891],"length":1,"stats":{"Line":0}},{"line":570,"address":[5567934],"length":1,"stats":{"Line":0}},{"line":573,"address":[5568419],"length":1,"stats":{"Line":3}},{"line":574,"address":[3458546,3458775],"length":1,"stats":{"Line":4}},{"line":575,"address":[1799043],"length":1,"stats":{"Line":0}},{"line":576,"address":[1776640],"length":1,"stats":{"Line":0}},{"line":579,"address":[2631416,2631478],"length":1,"stats":{"Line":2}},{"line":580,"address":[1798489],"length":1,"stats":{"Line":0}},{"line":581,"address":[3458615],"length":1,"stats":{"Line":0}},{"line":585,"address":[3458588],"length":1,"stats":{"Line":3}},{"line":586,"address":[1776700],"length":1,"stats":{"Line":3}},{"line":587,"address":[2631899],"length":1,"stats":{"Line":0}},{"line":588,"address":[2631710],"length":1,"stats":{"Line":0}},{"line":593,"address":[1780592],"length":1,"stats":{"Line":1}},{"line":594,"address":[3462948,3462768],"length":1,"stats":{"Line":1}},{"line":596,"address":[2635832],"length":1,"stats":{"Line":1}},{"line":597,"address":[2635909],"length":1,"stats":{"Line":1}},{"line":598,"address":[5572932],"length":1,"stats":{"Line":1}},{"line":604,"address":[3588784,3586240,3588723],"length":1,"stats":{"Line":3}},{"line":605,"address":[5573330,5573151],"length":1,"stats":{"Line":3}},{"line":606,"address":[1781247,1781603,1781402],"length":1,"stats":{"Line":9}},{"line":607,"address":[2636841,2636687],"length":1,"stats":{"Line":6}},{"line":608,"address":[5573922],"length":1,"stats":{"Line":3}},{"line":609,"address":[3464073,3465716],"length":1,"stats":{"Line":0}},{"line":612,"address":[3587077,3587132],"length":1,"stats":{"Line":6}},{"line":613,"address":[1782015],"length":1,"stats":{"Line":3}},{"line":614,"address":[1782166,1782418,1782078],"length":1,"stats":{"Line":9}},{"line":615,"address":[5614284,5614226,5614402],"length":1,"stats":{"Line":9}},{"line":616,"address":[5614490,5614619],"length":1,"stats":{"Line":0}},{"line":623,"address":[5614450,5614706],"length":1,"stats":{"Line":6}},{"line":624,"address":[3465247,3465418,3465170],"length":1,"stats":{"Line":9}},{"line":625,"address":[1783071],"length":1,"stats":{"Line":3}},{"line":627,"address":[2638448,2638319],"length":1,"stats":{"Line":0}},{"line":634,"address":[5614110],"length":1,"stats":{"Line":3}},{"line":637,"address":[3463822],"length":1,"stats":{"Line":0}},{"line":638,"address":[1803458],"length":1,"stats":{"Line":0}},{"line":642,"address":[1784450,1783632],"length":1,"stats":{"Line":2}},{"line":643,"address":[1805497,1805657],"length":1,"stats":{"Line":2}},{"line":644,"address":[2638973,2639144,2638833],"length":1,"stats":{"Line":6}},{"line":645,"address":[5576345,5576193],"length":1,"stats":{"Line":4}},{"line":646,"address":[3466505],"length":1,"stats":{"Line":2}},{"line":649,"address":[1784167],"length":1,"stats":{"Line":0}},{"line":650,"address":[3466221],"length":1,"stats":{"Line":0}},{"line":654,"address":[2639520],"length":1,"stats":{"Line":2}},{"line":661,"address":[1806336,1806524],"length":1,"stats":{"Line":2}},{"line":664,"address":[3589868,3590094],"length":1,"stats":{"Line":4}},{"line":665,"address":[1806588],"length":1,"stats":{"Line":0}},{"line":670,"address":[5577056],"length":1,"stats":{"Line":1}},{"line":671,"address":[2640080,2640269],"length":1,"stats":{"Line":1}},{"line":674,"address":[3467356,3467582],"length":1,"stats":{"Line":2}},{"line":675,"address":[2640334],"length":1,"stats":{"Line":0}}],"covered":210,"coverable":264},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","legacy_tor_process.rs"],"content":"// standard\nuse std::default::Default;\nuse std::fs;\nuse std::fs::File;\nuse std::io::{BufRead, BufReader, Read, Write};\nuse std::net::SocketAddr;\nuse std::ops::Drop;\nuse std::path::Path;\nuse std::process;\nuse std::process::{Child, ChildStdout, Command, Stdio};\nuse std::str::FromStr;\nuse std::string::ToString;\nuse std::sync::{Arc, Mutex};\nuse std::time::{Duration, Instant};\n\n// extern crates\nuse data_encoding::HEXUPPER;\nuse rand::rngs::OsRng;\nuse rand::RngCore;\nuse sha1::{Digest, Sha1};\n\n// internal crates\nuse crate::tor_crypto::generate_password;\n\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"failed to read control port file\")]\n    ControlPortFileReadFailed(#[source] std::io::Error),\n\n    #[error(\"provided control port file '{0}' larger than expected ({1} bytes)\")]\n    ControlPortFileTooLarge(String, u64),\n\n    #[error(\"failed to parse '{0}' as control port file\")]\n    ControlPortFileContentsInvalid(String),\n\n    #[error(\"provided tor bin path '{0}' must be an absolute path\")]\n    TorBinPathNotAbsolute(String),\n\n    #[error(\"provided data directory '{0}' must be an absolute path\")]\n    TorDataDirectoryPathNotAbsolute(String),\n\n    #[error(\"failed to create data directory\")]\n    DataDirectoryCreationFailed(#[source] std::io::Error),\n\n    #[error(\"file exists in provided data directory path '{0}'\")]\n    DataDirectoryPathExistsAsFile(String),\n\n    #[error(\"failed to create default_torrc file\")]\n    DefaultTorrcFileCreationFailed(#[source] std::io::Error),\n\n    #[error(\"failed to write default_torrc file\")]\n    DefaultTorrcFileWriteFailed(#[source] std::io::Error),\n\n    #[error(\"failed to create torrc file\")]\n    TorrcFileCreationFailed(#[source] std::io::Error),\n\n    #[error(\"failed to remove control_port file\")]\n    ControlPortFileDeleteFailed(#[source] std::io::Error),\n\n    #[error(\"failed to start legacy tor process\")]\n    LegacyTorProcessStartFailed(#[source] std::io::Error),\n\n    #[error(\"failed to read control addr from control_file '{0}'\")]\n    ControlPortFileMissing(String),\n\n    #[error(\"unable to take legacy tor process stdout\")]\n    LegacyTorProcessStdoutTakeFailed(),\n\n    #[error(\"failed to spawn tor process stdout read thread\")]\n    StdoutReadThreadSpawnFailed(#[source] std::io::Error),\n}\n\nfn read_control_port_file(control_port_file: \u0026Path) -\u003e Result\u003cSocketAddr, Error\u003e {\n    // open file\n    let mut file = File::open(control_port_file).map_err(Error::ControlPortFileReadFailed)?;\n\n    // bail if the file is larger than expected\n    let metadata = file.metadata().map_err(Error::ControlPortFileReadFailed)?;\n    if metadata.len() \u003e= 1024 {\n        return Err(Error::ControlPortFileTooLarge(\n            format!(\"{}\", control_port_file.display()),\n            metadata.len(),\n        ));\n    }\n\n    // read contents to string\n    let mut contents = String::new();\n    file.read_to_string(\u0026mut contents)\n        .map_err(Error::ControlPortFileReadFailed)?;\n\n    if contents.starts_with(\"PORT=\") {\n        let addr_string = \u0026contents.trim_end()[\"PORT=\".len()..];\n        if let Ok(addr) = SocketAddr::from_str(addr_string) {\n            return Ok(addr);\n        }\n    }\n    Err(Error::ControlPortFileContentsInvalid(format!(\n        \"{}\",\n        control_port_file.display()\n    )))\n}\n\n// Encapsulates the tor daemon process\npub(crate) struct LegacyTorProcess {\n    control_addr: SocketAddr,\n    process: Child,\n    password: String,\n    // stdout data\n    stdout_lines: Arc\u003cMutex\u003cVec\u003cString\u003e\u003e\u003e,\n}\n\nimpl LegacyTorProcess {\n    const S2K_RFC2440_SPECIFIER_LEN: usize = 9;\n\n    fn hash_tor_password_with_salt(\n        salt: \u0026[u8; Self::S2K_RFC2440_SPECIFIER_LEN],\n        password: \u0026str,\n    ) -\u003e String {\n        assert_eq!(salt[Self::S2K_RFC2440_SPECIFIER_LEN - 1], 0x60);\n\n        // tor-specific rfc 2440 constants\n        const EXPBIAS: u8 = 6u8;\n        const C: u8 = 0x60; // salt[S2K_RFC2440_SPECIFIER_LEN - 1]\n        const COUNT: usize = (16usize + ((C \u0026 15u8) as usize)) \u003c\u003c ((C \u003e\u003e 4) + EXPBIAS);\n\n        // squash together our hash input\n        let mut input: Vec\u003cu8\u003e = Default::default();\n        // append salt (sans the 'C' constant')\n        input.extend_from_slice(\u0026salt[0..Self::S2K_RFC2440_SPECIFIER_LEN - 1]);\n        // append password bytes\n        input.extend_from_slice(password.as_bytes());\n\n        let input = input.as_slice();\n        let input_len = input.len();\n\n        let mut sha1 = Sha1::new();\n        let mut count = COUNT;\n        while count \u003e 0 {\n            if count \u003e input_len {\n                sha1.update(input);\n                count -= input_len;\n            } else {\n                sha1.update(\u0026input[0..count]);\n                break;\n            }\n        }\n\n        let key = sha1.finalize();\n\n        let mut hash = \"16:\".to_string();\n        HEXUPPER.encode_append(salt, \u0026mut hash);\n        HEXUPPER.encode_append(\u0026key, \u0026mut hash);\n\n        hash\n    }\n\n    fn hash_tor_password(password: \u0026str) -\u003e String {\n        let mut salt = [0x00u8; Self::S2K_RFC2440_SPECIFIER_LEN];\n        OsRng.fill_bytes(\u0026mut salt);\n        salt[Self::S2K_RFC2440_SPECIFIER_LEN - 1] = 0x60u8;\n\n        Self::hash_tor_password_with_salt(\u0026salt, password)\n    }\n\n    pub fn get_control_addr(\u0026self) -\u003e \u0026SocketAddr {\n        \u0026self.control_addr\n    }\n\n    pub fn get_password(\u0026self) -\u003e \u0026String {\n        \u0026self.password\n    }\n\n    pub fn new(tor_bin_path: \u0026Path, data_directory: \u0026Path) -\u003e Result\u003cLegacyTorProcess, Error\u003e {\n        if tor_bin_path.is_relative() {\n            return Err(Error::TorBinPathNotAbsolute(format!(\n                \"{}\",\n                tor_bin_path.display()\n            )));\n        }\n        if data_directory.is_relative() {\n            return Err(Error::TorDataDirectoryPathNotAbsolute(format!(\n                \"{}\",\n                data_directory.display()\n            )));\n        }\n\n        // create data directory if it doesn't exist\n        if !data_directory.exists() {\n            fs::create_dir_all(data_directory).map_err(Error::DataDirectoryCreationFailed)?;\n        } else if data_directory.is_file() {\n            return Err(Error::DataDirectoryPathExistsAsFile(format!(\n                \"{}\",\n                data_directory.display()\n            )));\n        }\n\n        // construct paths to torrc files\n        let default_torrc = data_directory.join(\"default_torrc\");\n        let torrc = data_directory.join(\"torrc\");\n        let control_port_file = data_directory.join(\"control_port\");\n\n        // TODO: should we nuke the existing torrc between runs? Do we want\n        // users setting custom nonsense in there?\n        // construct default torrc\n        //  - daemon determines socks port\n        //  - minimize writes to disk\n        //  - start with network disabled by default\n        if !default_torrc.exists() {\n            const DEFAULT_TORRC_CONTENT: \u0026str = \"SocksPort auto\\n\\\n            AvoidDiskWrites 1\\n\\\n            DisableNetwork 1\\n\";\n\n            let mut default_torrc_file =\n                File::create(\u0026default_torrc).map_err(Error::DefaultTorrcFileCreationFailed)?;\n            default_torrc_file\n                .write_all(DEFAULT_TORRC_CONTENT.as_bytes())\n                .map_err(Error::DefaultTorrcFileWriteFailed)?;\n        }\n\n        // create empty torrc for user\n        if !torrc.exists() {\n            let _ = File::create(\u0026torrc).map_err(Error::TorrcFileCreationFailed)?;\n        }\n\n        // remove any existing control_port_file\n        if control_port_file.exists() {\n            fs::remove_file(\u0026control_port_file).map_err(Error::ControlPortFileDeleteFailed)?;\n        }\n\n        const CONTROL_PORT_PASSWORD_LENGTH: usize = 32usize;\n        let password = generate_password(CONTROL_PORT_PASSWORD_LENGTH);\n        let password_hash = Self::hash_tor_password(\u0026password);\n\n        let mut process = Command::new(tor_bin_path.as_os_str())\n            .stdout(Stdio::piped())\n            .stdin(Stdio::null())\n            .stderr(Stdio::null())\n            // set working directory to data directory\n            .current_dir(data_directory)\n            // point to our above written torrc file\n            .arg(\"--defaults-torrc\")\n            .arg(default_torrc)\n            // location of torrc\n            .arg(\"--torrc-file\")\n            .arg(torrc)\n            // root data directory\n            .arg(\"DataDirectory\")\n            .arg(data_directory)\n            // daemon will assign us a port, and we will\n            // read it from the control port file\n            .arg(\"ControlPort\")\n            .arg(\"auto\")\n            // control port file destination\n            .arg(\"ControlPortWriteToFile\")\n            .arg(control_port_file.clone())\n            // use password authentication to prevent other apps\n            // from modifying our daemon's settings\n            .arg(\"HashedControlPassword\")\n            .arg(password_hash)\n            // tor process will shut down after this process shuts down\n            // to avoid orphaned tor daemon\n            .arg(\"__OwningControllerProcess\")\n            .arg(process::id().to_string())\n            .spawn()\n            .map_err(Error::LegacyTorProcessStartFailed)?;\n\n        let mut control_addr = None;\n        let start = Instant::now();\n\n        // try and read the control port from the control port file\n        // or abort after 5 seconds\n        // TODO: make this timeout configurable?\n        while control_addr.is_none() \u0026\u0026 start.elapsed() \u003c Duration::from_secs(5) {\n            if control_port_file.exists() {\n                control_addr = Some(read_control_port_file(control_port_file.as_path())?);\n                fs::remove_file(\u0026control_port_file).map_err(Error::ControlPortFileDeleteFailed)?;\n            }\n        }\n\n        let control_addr = match control_addr {\n            Some(control_addr) =\u003e control_addr,\n            None =\u003e {\n                return Err(Error::ControlPortFileMissing(format!(\n                    \"{}\",\n                    control_port_file.display()\n                )))\n            }\n        };\n\n        let stdout_lines: Arc\u003cMutex\u003cVec\u003cString\u003e\u003e\u003e = Default::default();\n\n        {\n            let stdout_lines = Arc::downgrade(\u0026stdout_lines);\n            let stdout = BufReader::new(match process.stdout.take() {\n                Some(stdout) =\u003e stdout,\n                None =\u003e return Err(Error::LegacyTorProcessStdoutTakeFailed()),\n            });\n\n            std::thread::Builder::new()\n                .name(\"tor_stdout_reader\".to_string())\n                .spawn(move || {\n                    LegacyTorProcess::read_stdout_task(\u0026stdout_lines, stdout);\n                })\n                .map_err(Error::StdoutReadThreadSpawnFailed)?;\n        }\n\n        Ok(LegacyTorProcess {\n            control_addr,\n            process,\n            password,\n            stdout_lines,\n        })\n    }\n\n    fn read_stdout_task(\n        stdout_lines: \u0026std::sync::Weak\u003cMutex\u003cVec\u003cString\u003e\u003e\u003e,\n        mut stdout: BufReader\u003cChildStdout\u003e,\n    ) {\n        while let Some(stdout_lines) = stdout_lines.upgrade() {\n            let mut line = String::default();\n            // read line\n            if stdout.read_line(\u0026mut line).is_ok() {\n                // remove trailing '\\n'\n                line.pop();\n                // then acquire the lock on the line buffer\n                let mut stdout_lines = match stdout_lines.lock() {\n                    Ok(stdout_lines) =\u003e stdout_lines,\n                    Err(_) =\u003e unreachable!(),\n                };\n                stdout_lines.push(line);\n            }\n        }\n    }\n\n    pub fn wait_log_lines(\u0026mut self) -\u003e Vec\u003cString\u003e {\n        let mut lines = match self.stdout_lines.lock() {\n            Ok(lines) =\u003e lines,\n            Err(_) =\u003e unreachable!(),\n        };\n        std::mem::take(\u0026mut lines)\n    }\n}\n\nimpl Drop for LegacyTorProcess {\n    fn drop(\u0026mut self) {\n        let _ = self.process.kill();\n    }\n}\n\n#[test]\nfn test_password_hash() -\u003e Result\u003c(), anyhow::Error\u003e {\n    let salt1: [u8; LegacyTorProcess::S2K_RFC2440_SPECIFIER_LEN] = [\n        0xbeu8, 0x2au8, 0x25u8, 0x1du8, 0xe6u8, 0x2cu8, 0xb2u8, 0x7au8, 0x60u8,\n    ];\n    let hash1 = LegacyTorProcess::hash_tor_password_with_salt(\u0026salt1, \"abcdefghijklmnopqrstuvwxyz\");\n    assert_eq!(\n        hash1,\n        \"16:BE2A251DE62CB27A60AC9178A937990E8ED0AB662FA82A5C7DE3EBB23A\"\n    );\n\n    let salt2: [u8; LegacyTorProcess::S2K_RFC2440_SPECIFIER_LEN] = [\n        0x36u8, 0x73u8, 0x0eu8, 0xefu8, 0xd1u8, 0x8cu8, 0x60u8, 0xd6u8, 0x60u8,\n    ];\n    let hash2 = LegacyTorProcess::hash_tor_password_with_salt(\u0026salt2, \"password\");\n    assert_eq!(\n        hash2,\n        \"16:36730EEFD18C60D66052E7EA535438761C0928D316EEA56A190C99B50A\"\n    );\n\n    // ensure same password is hashed to different things\n    assert_ne!(\n        LegacyTorProcess::hash_tor_password(\"password\"),\n        LegacyTorProcess::hash_tor_password(\"password\")\n    );\n\n    Ok(())\n}\n","traces":[{"line":73,"address":[2743068,2743537,2741232],"length":1,"stats":{"Line":3}},{"line":75,"address":[5721855,5721703],"length":1,"stats":{"Line":3}},{"line":78,"address":[2741780,2741401,2743532,2741573],"length":1,"stats":{"Line":6}},{"line":79,"address":[5722265,5722173],"length":1,"stats":{"Line":6}},{"line":80,"address":[1887705],"length":1,"stats":{"Line":0}},{"line":81,"address":[5722304,5723509,5723635],"length":1,"stats":{"Line":0}},{"line":82,"address":[2743348],"length":1,"stats":{"Line":0}},{"line":87,"address":[1629173],"length":1,"stats":{"Line":3}},{"line":88,"address":[3570970,3571073,3571235,3572103],"length":1,"stats":{"Line":6}},{"line":89,"address":[5722563],"length":1,"stats":{"Line":0}},{"line":91,"address":[5682794,5682890],"length":1,"stats":{"Line":6}},{"line":92,"address":[1886587],"length":1,"stats":{"Line":3}},{"line":93,"address":[1886744],"length":1,"stats":{"Line":3}},{"line":94,"address":[3694657],"length":1,"stats":{"Line":3}},{"line":97,"address":[5683590,5683461],"length":1,"stats":{"Line":0}},{"line":99,"address":[5722687,5723079],"length":1,"stats":{"Line":0}},{"line":115,"address":[3574026,3572608,3574100],"length":1,"stats":{"Line":3}},{"line":119,"address":[2743620],"length":1,"stats":{"Line":3}},{"line":127,"address":[2743736],"length":1,"stats":{"Line":3}},{"line":129,"address":[1631053,1631144],"length":1,"stats":{"Line":6}},{"line":131,"address":[1631212],"length":1,"stats":{"Line":3}},{"line":133,"address":[5684608],"length":1,"stats":{"Line":3}},{"line":134,"address":[1888295],"length":1,"stats":{"Line":3}},{"line":136,"address":[2744015],"length":1,"stats":{"Line":3}},{"line":137,"address":[2744034],"length":1,"stats":{"Line":3}},{"line":138,"address":[5725435,5724462],"length":1,"stats":{"Line":6}},{"line":139,"address":[3573264],"length":1,"stats":{"Line":3}},{"line":140,"address":[1631765],"length":1,"stats":{"Line":3}},{"line":141,"address":[1889312,1889272],"length":1,"stats":{"Line":3}},{"line":143,"address":[1888520,1888786],"length":1,"stats":{"Line":6}},{"line":148,"address":[5684733],"length":1,"stats":{"Line":3}},{"line":150,"address":[2744522],"length":1,"stats":{"Line":3}},{"line":151,"address":[3573613],"length":1,"stats":{"Line":3}},{"line":152,"address":[5685395,5685469],"length":1,"stats":{"Line":3}},{"line":154,"address":[3696985],"length":1,"stats":{"Line":3}},{"line":157,"address":[3574128],"length":1,"stats":{"Line":3}},{"line":158,"address":[5725522],"length":1,"stats":{"Line":3}},{"line":159,"address":[1632403],"length":1,"stats":{"Line":3}},{"line":160,"address":[2745159],"length":1,"stats":{"Line":3}},{"line":162,"address":[1889452],"length":1,"stats":{"Line":3}},{"line":165,"address":[1632464],"length":1,"stats":{"Line":3}},{"line":166,"address":[2745192],"length":1,"stats":{"Line":3}},{"line":169,"address":[3697280],"length":1,"stats":{"Line":3}},{"line":173,"address":[3699955,3704867,3697296],"length":1,"stats":{"Line":3}},{"line":174,"address":[1889613],"length":1,"stats":{"Line":3}},{"line":175,"address":[5725979,5726117],"length":1,"stats":{"Line":0}},{"line":177,"address":[3697512],"length":1,"stats":{"Line":0}},{"line":180,"address":[3574454],"length":1,"stats":{"Line":3}},{"line":181,"address":[1633432,1633294],"length":1,"stats":{"Line":0}},{"line":183,"address":[2745883],"length":1,"stats":{"Line":0}},{"line":188,"address":[2745849],"length":1,"stats":{"Line":3}},{"line":189,"address":[3575356,3575593],"length":1,"stats":{"Line":3}},{"line":190,"address":[1890689],"length":1,"stats":{"Line":0}},{"line":191,"address":[5687595,5687457],"length":1,"stats":{"Line":0}},{"line":193,"address":[3575710],"length":1,"stats":{"Line":0}},{"line":198,"address":[3575487],"length":1,"stats":{"Line":3}},{"line":199,"address":[1890789,1891400],"length":1,"stats":{"Line":6}},{"line":200,"address":[5687792],"length":1,"stats":{"Line":3}},{"line":208,"address":[5727614,5727694],"length":1,"stats":{"Line":6}},{"line":213,"address":[1892172,1891801,1891593,1891654],"length":1,"stats":{"Line":6}},{"line":215,"address":[3699705,3699888],"length":1,"stats":{"Line":3}},{"line":216,"address":[3576674],"length":1,"stats":{"Line":3}},{"line":217,"address":[5688448],"length":1,"stats":{"Line":0}},{"line":221,"address":[5727756,5728318],"length":1,"stats":{"Line":6}},{"line":222,"address":[5688662,5688601],"length":1,"stats":{"Line":6}},{"line":226,"address":[1635421,1635192],"length":1,"stats":{"Line":6}},{"line":227,"address":[1892547,1896970],"length":1,"stats":{"Line":0}},{"line":231,"address":[3577305],"length":1,"stats":{"Line":3}},{"line":232,"address":[1635648,1635739],"length":1,"stats":{"Line":6}},{"line":234,"address":[5730312,5728994,5729074,5729935,5729239,5729301,5729169,5729564,5729821,5730068,5729450],"length":1,"stats":{"Line":30}},{"line":235,"address":[5689349],"length":1,"stats":{"Line":3}},{"line":236,"address":[5689452],"length":1,"stats":{"Line":3}},{"line":237,"address":[2748842],"length":1,"stats":{"Line":3}},{"line":242,"address":[3578050],"length":1,"stats":{"Line":3}},{"line":245,"address":[1636264],"length":1,"stats":{"Line":3}},{"line":255,"address":[3578446],"length":1,"stats":{"Line":3}},{"line":259,"address":[2749479],"length":1,"stats":{"Line":3}},{"line":263,"address":[5730001],"length":1,"stats":{"Line":3}},{"line":265,"address":[3581697,3577754,3578893],"length":1,"stats":{"Line":3}},{"line":267,"address":[3702049],"length":1,"stats":{"Line":3}},{"line":268,"address":[5730395],"length":1,"stats":{"Line":3}},{"line":273,"address":[3579165,3579091],"length":1,"stats":{"Line":6}},{"line":274,"address":[2750264,2752142],"length":1,"stats":{"Line":6}},{"line":275,"address":[1896462,1896672,1896894],"length":1,"stats":{"Line":3}},{"line":276,"address":[5725709,5732768,5732866],"length":1,"stats":{"Line":9}},{"line":280,"address":[3579130],"length":1,"stats":{"Line":3}},{"line":281,"address":[1894597],"length":1,"stats":{"Line":3}},{"line":283,"address":[3579579,3579708],"length":1,"stats":{"Line":0}},{"line":285,"address":[5730708,5730786],"length":1,"stats":{"Line":0}},{"line":290,"address":[3702421,3702886],"length":1,"stats":{"Line":6}},{"line":293,"address":[1895102,1895175],"length":1,"stats":{"Line":6}},{"line":294,"address":[5731384,5731319,5731519],"length":1,"stats":{"Line":9}},{"line":295,"address":[2751089],"length":1,"stats":{"Line":3}},{"line":296,"address":[1895296],"length":1,"stats":{"Line":0}},{"line":299,"address":[3580221,3580720,3581068,3580342,3580473],"length":1,"stats":{"Line":9}},{"line":300,"address":[3703409,3704146,3703293],"length":1,"stats":{"Line":6}},{"line":301,"address":[3773040,3772944],"length":1,"stats":{"Line":6}},{"line":302,"address":[5706457],"length":1,"stats":{"Line":3}},{"line":304,"address":[1638657],"length":1,"stats":{"Line":3}},{"line":307,"address":[1896077],"length":1,"stats":{"Line":3}},{"line":309,"address":[3580773],"length":1,"stats":{"Line":3}},{"line":310,"address":[3580805],"length":1,"stats":{"Line":3}},{"line":311,"address":[3580837],"length":1,"stats":{"Line":3}},{"line":315,"address":[1640544,1640649,1639808],"length":1,"stats":{"Line":3}},{"line":319,"address":[3705012,3704937],"length":1,"stats":{"Line":6}},{"line":320,"address":[5693650],"length":1,"stats":{"Line":3}},{"line":322,"address":[3705212,3705130],"length":1,"stats":{"Line":6}},{"line":324,"address":[2753266],"length":1,"stats":{"Line":3}},{"line":326,"address":[1897561],"length":1,"stats":{"Line":3}},{"line":327,"address":[5733745],"length":1,"stats":{"Line":3}},{"line":330,"address":[1640437,1640370],"length":1,"stats":{"Line":6}},{"line":335,"address":[2753760,2754012],"length":1,"stats":{"Line":2}},{"line":336,"address":[3705872],"length":1,"stats":{"Line":2}},{"line":337,"address":[1898112],"length":1,"stats":{"Line":2}},{"line":340,"address":[1640816,1640878],"length":1,"stats":{"Line":4}},{"line":345,"address":[1732512],"length":1,"stats":{"Line":3}},{"line":346,"address":[2581577],"length":1,"stats":{"Line":3}}],"covered":99,"coverable":117},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","legacy_tor_version.rs"],"content":"// standard\nuse std::cmp::Ordering;\nuse std::option::Option;\nuse std::str::FromStr;\nuse std::string::ToString;\n\n/// `LegacyTorVersion`-specific error type\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"{}\", .0)]\n    ParseError(String),\n}\n\n/// Type representing a legacy c-tor daemon's version number. This version conforms c-tor's [version-spec](https://spec.torproject.org/version-spec.htm).\n#[derive(Clone)]\npub struct LegacyTorVersion {\n    pub(crate) major: u32,\n    pub(crate) minor: u32,\n    pub(crate) micro: u32,\n    pub(crate) patch_level: u32,\n    pub(crate) status_tag: Option\u003cString\u003e,\n}\n\nimpl LegacyTorVersion {\n    fn status_tag_pattern_is_match(status_tag: \u0026str) -\u003e bool {\n        if status_tag.is_empty() {\n            return false;\n        }\n\n        for c in status_tag.chars() {\n            if c.is_whitespace() {\n                return false;\n            }\n        }\n        true\n    }\n\n    /// Construct a new `LegacyTorVersion` object.\n    pub fn new(\n        major: u32,\n        minor: u32,\n        micro: u32,\n        patch_level: Option\u003cu32\u003e,\n        status_tag: Option\u003c\u0026str\u003e,\n    ) -\u003e Result\u003cLegacyTorVersion, Error\u003e {\n        let status_tag = if let Some(status_tag) = status_tag {\n            if Self::status_tag_pattern_is_match(status_tag) {\n                Some(status_tag.to_string())\n            } else {\n                return Err(Error::ParseError(\n                    \"tor version status tag may not be empty or contain white-space\".to_string(),\n                ));\n            }\n        } else {\n            None\n        };\n\n        Ok(LegacyTorVersion {\n            major,\n            minor,\n            micro,\n            patch_level: patch_level.unwrap_or(0u32),\n            status_tag,\n        })\n    }\n}\n\nimpl FromStr for LegacyTorVersion {\n    type Err = Error;\n\n    fn from_str(s: \u0026str) -\u003e Result\u003cLegacyTorVersion, Self::Err\u003e {\n        // MAJOR.MINOR.MICRO[.PATCHLEVEL][-STATUS_TAG][ (EXTRA_INFO)]*\n        let mut tokens = s.split(' ');\n        let (major, minor, micro, patch_level, status_tag) =\n            if let Some(version_status_tag) = tokens.next() {\n                let mut tokens = version_status_tag.split('-');\n                let (major, minor, micro, patch_level) = if let Some(version) = tokens.next() {\n                    let mut tokens = version.split('.');\n                    let major: u32 = if let Some(major) = tokens.next() {\n                        match major.parse() {\n                            Ok(major) =\u003e major,\n                            Err(_) =\u003e {\n                                return Err(Error::ParseError(format!(\n                                    \"failed to parse '{}' as MAJOR portion of tor version\",\n                                    major\n                                )))\n                            }\n                        }\n                    } else {\n                        return Err(Error::ParseError(\n                            \"failed to find MAJOR portion of tor version\".to_string(),\n                        ));\n                    };\n                    let minor: u32 = if let Some(minor) = tokens.next() {\n                        match minor.parse() {\n                            Ok(minor) =\u003e minor,\n                            Err(_) =\u003e {\n                                return Err(Error::ParseError(format!(\n                                    \"failed to parse '{}' as MINOR portion of tor version\",\n                                    minor\n                                )))\n                            }\n                        }\n                    } else {\n                        return Err(Error::ParseError(\n                            \"failed to find MINOR portion of tor version\".to_string(),\n                        ));\n                    };\n                    let micro: u32 = if let Some(micro) = tokens.next() {\n                        match micro.parse() {\n                            Ok(micro) =\u003e micro,\n                            Err(_) =\u003e {\n                                return Err(Error::ParseError(format!(\n                                    \"failed to parse '{}' as MICRO portion of tor version\",\n                                    micro\n                                )))\n                            }\n                        }\n                    } else {\n                        return Err(Error::ParseError(\n                            \"failed to find MICRO portion of tor version\".to_string(),\n                        ));\n                    };\n                    let patch_level: u32 = if let Some(patch_level) = tokens.next() {\n                        match patch_level.parse() {\n                            Ok(patch_level) =\u003e patch_level,\n                            Err(_) =\u003e {\n                                return Err(Error::ParseError(format!(\n                                    \"failed to parse '{}' as PATCHLEVEL portion of tor version\",\n                                    patch_level\n                                )))\n                            }\n                        }\n                    } else {\n                        0u32\n                    };\n                    (major, minor, micro, patch_level)\n                } else {\n                    // if there were '-' the previous next() would have returned the enire string\n                    unreachable!();\n                };\n                let status_tag = tokens.next().map(|status_tag| status_tag.to_string());\n\n                (major, minor, micro, patch_level, status_tag)\n            } else {\n                // if there were no ' ' character the previou snext() would have returned the enire string\n                unreachable!();\n            };\n        for extra_info in tokens {\n            if !extra_info.starts_with('(') || !extra_info.ends_with(')') {\n                return Err(Error::ParseError(format!(\n                    \"failed to parse '{}' as [ (EXTRA_INFO)]\",\n                    extra_info\n                )));\n            }\n        }\n        LegacyTorVersion::new(\n            major,\n            minor,\n            micro,\n            Some(patch_level),\n            status_tag.as_deref(),\n        )\n    }\n}\n\nimpl ToString for LegacyTorVersion {\n    fn to_string(\u0026self) -\u003e String {\n        match \u0026self.status_tag {\n            Some(status_tag) =\u003e format!(\n                \"{}.{}.{}.{}-{}\",\n                self.major, self.minor, self.micro, self.patch_level, status_tag\n            ),\n            None =\u003e format!(\n                \"{}.{}.{}.{}\",\n                self.major, self.minor, self.micro, self.patch_level\n            ),\n        }\n    }\n}\n\nimpl PartialEq for LegacyTorVersion {\n    fn eq(\u0026self, other: \u0026Self) -\u003e bool {\n        self.major == other.major\n            \u0026\u0026 self.minor == other.minor\n            \u0026\u0026 self.micro == other.micro\n            \u0026\u0026 self.patch_level == other.patch_level\n            \u0026\u0026 self.status_tag == other.status_tag\n    }\n}\n\nimpl PartialOrd for LegacyTorVersion {\n    fn partial_cmp(\u0026self, other: \u0026Self) -\u003e Option\u003cOrdering\u003e {\n        if let Some(order) = self.major.partial_cmp(\u0026other.major) {\n            if order != Ordering::Equal {\n                return Some(order);\n            }\n        }\n\n        if let Some(order) = self.minor.partial_cmp(\u0026other.minor) {\n            if order != Ordering::Equal {\n                return Some(order);\n            }\n        }\n\n        if let Some(order) = self.micro.partial_cmp(\u0026other.micro) {\n            if order != Ordering::Equal {\n                return Some(order);\n            }\n        }\n\n        if let Some(order) = self.patch_level.partial_cmp(\u0026other.patch_level) {\n            if order != Ordering::Equal {\n                return Some(order);\n            }\n        }\n\n        // version-spect.txt *does* say that we should compare tags lexicgraphically\n        // if all of the version numbers are the same when comparing, but we are\n        // going to diverge here and say we can only compare tags for equality.\n        //\n        // In practice we will be comparing tor daemon tags against tagless (stable)\n        // versions so this shouldn't be an issue\n\n        if self.status_tag == other.status_tag {\n            return Some(Ordering::Equal);\n        }\n\n        None\n    }\n}\n\n#[test]\nfn test_version() -\u003e anyhow::Result\u003c()\u003e {\n    assert!(LegacyTorVersion::from_str(\"1.2.3\")? == LegacyTorVersion::new(1, 2, 3, None, None)?);\n    assert!(\n        LegacyTorVersion::from_str(\"1.2.3.4\")? == LegacyTorVersion::new(1, 2, 3, Some(4), None)?\n    );\n    assert!(\n        LegacyTorVersion::from_str(\"1.2.3-test\")?\n            == LegacyTorVersion::new(1, 2, 3, None, Some(\"test\"))?\n    );\n    assert!(\n        LegacyTorVersion::from_str(\"1.2.3.4-test\")?\n            == LegacyTorVersion::new(1, 2, 3, Some(4), Some(\"test\"))?\n    );\n    assert!(\n        LegacyTorVersion::from_str(\"1.2.3 (extra_info)\")?\n            == LegacyTorVersion::new(1, 2, 3, None, None)?\n    );\n    assert!(\n        LegacyTorVersion::from_str(\"1.2.3.4 (extra_info)\")?\n            == LegacyTorVersion::new(1, 2, 3, Some(4), None)?\n    );\n    assert!(\n        LegacyTorVersion::from_str(\"1.2.3.4-tag (extra_info)\")?\n            == LegacyTorVersion::new(1, 2, 3, Some(4), Some(\"tag\"))?\n    );\n\n    assert!(\n        LegacyTorVersion::from_str(\"1.2.3.4-tag (extra_info) (extra_info)\")?\n            == LegacyTorVersion::new(1, 2, 3, Some(4), Some(\"tag\"))?\n    );\n\n    assert!(LegacyTorVersion::new(1, 2, 3, Some(4), Some(\"spaced tag\")).is_err());\n    assert!(LegacyTorVersion::new(1, 2, 3, Some(4), Some(\"\" /* empty tag */)).is_err());\n    assert!(LegacyTorVersion::from_str(\"\").is_err());\n    assert!(LegacyTorVersion::from_str(\"1.2\").is_err());\n    assert!(LegacyTorVersion::from_str(\"1.2-foo\").is_err());\n    assert!(LegacyTorVersion::from_str(\"1.2.3.4-foo bar\").is_err());\n    assert!(LegacyTorVersion::from_str(\"1.2.3.4-foo bar (extra_info)\").is_err());\n    assert!(LegacyTorVersion::from_str(\"1.2.3.4-foo (extra_info) badtext\").is_err());\n    assert!(\n        LegacyTorVersion::new(0, 0, 0, Some(0), None)?\n            \u003c LegacyTorVersion::new(1, 0, 0, Some(0), None)?\n    );\n    assert!(\n        LegacyTorVersion::new(0, 0, 0, Some(0), None)?\n            \u003c LegacyTorVersion::new(0, 1, 0, Some(0), None)?\n    );\n    assert!(\n        LegacyTorVersion::new(0, 0, 0, Some(0), None)?\n            \u003c LegacyTorVersion::new(0, 0, 1, Some(0), None)?\n    );\n\n    // ensure status tags make comparison between equal versions (apart from\n    // tags) unknowable\n    let zero_version = LegacyTorVersion::new(0, 0, 0, Some(0), None)?;\n    let zero_version_tag = LegacyTorVersion::new(0, 0, 0, Some(0), Some(\"tag\"))?;\n\n    assert!(!(zero_version \u003c zero_version_tag));\n    assert!(!(zero_version \u003c= zero_version_tag));\n    assert!(!(zero_version \u003e zero_version_tag));\n    assert!(!(zero_version \u003e= zero_version_tag));\n\n    Ok(())\n}\n","traces":[{"line":25,"address":[2727040],"length":1,"stats":{"Line":1}},{"line":26,"address":[1480247],"length":1,"stats":{"Line":1}},{"line":27,"address":[1480294],"length":1,"stats":{"Line":1}},{"line":30,"address":[1871645,1871691,1871609],"length":1,"stats":{"Line":3}},{"line":31,"address":[1871699],"length":1,"stats":{"Line":1}},{"line":32,"address":[3679516],"length":1,"stats":{"Line":1}},{"line":35,"address":[5707572],"length":1,"stats":{"Line":1}},{"line":39,"address":[5667888,5668506],"length":1,"stats":{"Line":3}},{"line":46,"address":[1872122,1871938,1871846],"length":1,"stats":{"Line":7}},{"line":47,"address":[5707796],"length":1,"stats":{"Line":1}},{"line":48,"address":[5668226],"length":1,"stats":{"Line":1}},{"line":50,"address":[2727445],"length":1,"stats":{"Line":1}},{"line":51,"address":[3556711],"length":1,"stats":{"Line":1}},{"line":55,"address":[2727395],"length":1,"stats":{"Line":3}},{"line":58,"address":[2727735],"length":1,"stats":{"Line":3}},{"line":62,"address":[1480801],"length":1,"stats":{"Line":3}},{"line":63,"address":[3680016],"length":1,"stats":{"Line":3}},{"line":71,"address":[5712386,5708272],"length":1,"stats":{"Line":3}},{"line":73,"address":[5668561],"length":1,"stats":{"Line":3}},{"line":74,"address":[5711392],"length":1,"stats":{"Line":3}},{"line":76,"address":[3680313],"length":1,"stats":{"Line":3}},{"line":77,"address":[5668684,5668776,5671463],"length":1,"stats":{"Line":9}},{"line":78,"address":[2728136],"length":1,"stats":{"Line":3}},{"line":79,"address":[5708663,5708571],"length":1,"stats":{"Line":6}},{"line":80,"address":[2728279],"length":1,"stats":{"Line":3}},{"line":81,"address":[3680804],"length":1,"stats":{"Line":3}},{"line":83,"address":[1481863,1481998],"length":1,"stats":{"Line":2}},{"line":90,"address":[3557678],"length":1,"stats":{"Line":0}},{"line":91,"address":[3557648],"length":1,"stats":{"Line":0}},{"line":94,"address":[1482100,1481685],"length":1,"stats":{"Line":6}},{"line":95,"address":[5709365],"length":1,"stats":{"Line":3}},{"line":96,"address":[5709570],"length":1,"stats":{"Line":3}},{"line":98,"address":[2729350,2729485],"length":1,"stats":{"Line":0}},{"line":105,"address":[2729052],"length":1,"stats":{"Line":0}},{"line":106,"address":[3681342],"length":1,"stats":{"Line":0}},{"line":109,"address":[5710003,5709588],"length":1,"stats":{"Line":6}},{"line":110,"address":[1482801],"length":1,"stats":{"Line":3}},{"line":111,"address":[1483005],"length":1,"stats":{"Line":3}},{"line":113,"address":[3559451,3559316],"length":1,"stats":{"Line":0}},{"line":120,"address":[5670394],"length":1,"stats":{"Line":1}},{"line":121,"address":[5670364],"length":1,"stats":{"Line":1}},{"line":124,"address":[1483438,1483546,1483572,1483023],"length":1,"stats":{"Line":10}},{"line":125,"address":[1483470],"length":1,"stats":{"Line":3}},{"line":126,"address":[3559667],"length":1,"stats":{"Line":3}},{"line":128,"address":[1483687,1483822],"length":1,"stats":{"Line":0}},{"line":135,"address":[2730355],"length":1,"stats":{"Line":1}},{"line":137,"address":[5711172],"length":1,"stats":{"Line":3}},{"line":142,"address":[2730863],"length":1,"stats":{"Line":5}},{"line":144,"address":[2730916],"length":1,"stats":{"Line":3}},{"line":149,"address":[5672074,5671752,5671913],"length":1,"stats":{"Line":7}},{"line":150,"address":[1484606,1484843,1484725],"length":1,"stats":{"Line":3}},{"line":151,"address":[1485022,1484896],"length":1,"stats":{"Line":2}},{"line":161,"address":[1875883],"length":1,"stats":{"Line":3}},{"line":162,"address":[5711789],"length":1,"stats":{"Line":3}},{"line":168,"address":[5672672],"length":1,"stats":{"Line":0}},{"line":169,"address":[3561326],"length":1,"stats":{"Line":0}},{"line":170,"address":[2732950,2732764,2732666,2733141,2732857],"length":1,"stats":{"Line":0}},{"line":174,"address":[3684389,3684482,3684668,3684976,3684758,3684575],"length":1,"stats":{"Line":0}},{"line":183,"address":[5713808],"length":1,"stats":{"Line":1}},{"line":184,"address":[1877943],"length":1,"stats":{"Line":1}},{"line":185,"address":[5713855],"length":1,"stats":{"Line":1}},{"line":186,"address":[1486608],"length":1,"stats":{"Line":1}},{"line":187,"address":[2733473],"length":1,"stats":{"Line":1}},{"line":188,"address":[3562786],"length":1,"stats":{"Line":1}},{"line":193,"address":[5713936],"length":1,"stats":{"Line":3}},{"line":194,"address":[1486696],"length":1,"stats":{"Line":3}},{"line":195,"address":[5714007],"length":1,"stats":{"Line":3}},{"line":196,"address":[5714080],"length":1,"stats":{"Line":1}},{"line":200,"address":[5714039,5714097],"length":1,"stats":{"Line":6}},{"line":201,"address":[2733689],"length":1,"stats":{"Line":3}},{"line":202,"address":[2733762],"length":1,"stats":{"Line":1}},{"line":206,"address":[3563017,3563068],"length":1,"stats":{"Line":6}},{"line":207,"address":[1878308],"length":1,"stats":{"Line":3}},{"line":208,"address":[3563149],"length":1,"stats":{"Line":1}},{"line":212,"address":[2733812,2733866],"length":1,"stats":{"Line":6}},{"line":213,"address":[5674546],"length":1,"stats":{"Line":3}},{"line":214,"address":[1487069],"length":1,"stats":{"Line":2}},{"line":225,"address":[1878434],"length":1,"stats":{"Line":1}},{"line":226,"address":[2733941],"length":1,"stats":{"Line":0}},{"line":229,"address":[2733931],"length":1,"stats":{"Line":1}}],"covered":68,"coverable":80},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","lib.rs"],"content":"#![doc = include_str!(\"../README.md\")]\n\n/// Implementation of an in-process [`arti-client`](https://crates.io/crates/arti-client)-based `TorProvider`\n#[cfg(feature = \"arti-client-tor-provider\")]\npub mod arti_client_tor_client;\n#[cfg(feature = \"legacy-tor-provider\")]\n/// Censorship circumvention configuration for pluggable-transports and bridge settings\npub mod censorship_circumvention;\n/// Implementation of an out-of-process legacy [c-tor daemon](https://gitlab.torproject.org/tpo/core/tor)-based `TorProvider`\n#[cfg(feature = \"legacy-tor-provider\")]\npub mod legacy_tor_client;\n#[cfg(feature = \"legacy-tor-provider\")]\nmod legacy_tor_control_stream;\n#[cfg(feature = \"legacy-tor-provider\")]\nmod legacy_tor_controller;\n#[cfg(feature = \"legacy-tor-provider\")]\nmod legacy_tor_process;\n/// Legacy c-tor daemon version.\n#[cfg(feature = \"legacy-tor-provider\")]\npub mod legacy_tor_version;\n/// Implementation of a local, in-process, mock `TorProvider` for testing.\n#[cfg(feature = \"mock-tor-provider\")]\npub mod mock_tor_client;\n#[cfg(feature = \"legacy-tor-provider\")]\n/// Proxy settings\npub mod proxy;\n/// Tor-specific cryptographic primitives, operations, and conversion functions.\npub mod tor_crypto;\n/// Traits and types for connecting to the Tor Network.\npub mod tor_provider;\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","mock_tor_client.rs"],"content":"// standard\nuse std::collections::BTreeMap;\nuse std::net::{SocketAddr, TcpListener, TcpStream};\nuse std::sync::{atomic, Arc, Mutex};\n\n// internal crates\nuse crate::tor_crypto::*;\nuse crate::tor_provider;\nuse crate::tor_provider::*;\n\n\n/// [`MockTorClient`]-specific error type\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"client not bootstrapped\")]\n    ClientNotBootstrapped(),\n\n    #[error(\"client already bootstrapped\")]\n    ClientAlreadyBootstrapped(),\n\n    #[error(\"onion service not found: {}\", .0)]\n    OnionServiceNotFound(OnionAddr),\n\n    #[error(\"onion service not published: {}\", .0)]\n    OnionServiceNotPublished(OnionAddr),\n\n    #[error(\"onion service requires onion auth\")]\n    OnionServiceRequiresOnionAuth(),\n\n    #[error(\"provided onion auth key invalid\")]\n    OnionServiceAuthInvalid(),\n\n    #[error(\"unable to bind TCP listener\")]\n    TcpListenerBindFailed(#[source] std::io::Error),\n\n    #[error(\"unable to get TCP listener's local adress\")]\n    TcpListenerLocalAddrFailed(#[source] std::io::Error),\n\n    #[error(\"unable to connect to {}\", .0)]\n    ConnectFailed(TargetAddr),\n\n    #[error(\"not implemented\")]\n    NotImplemented(),\n}\n\nimpl From\u003cError\u003e for crate::tor_provider::Error {\n    fn from(error: Error) -\u003e Self {\n        crate::tor_provider::Error::Generic(error.to_string())\n    }\n}\n\nstruct MockTorNetwork {\n    onion_services: Option\u003cBTreeMap\u003cOnionAddr, (Vec\u003cX25519PublicKey\u003e, SocketAddr)\u003e\u003e,\n}\n\nimpl MockTorNetwork {\n    const fn new() -\u003e MockTorNetwork {\n        MockTorNetwork {\n            onion_services: None,\n        }\n    }\n\n    fn connect_to_onion(\n        \u0026mut self,\n        service_id: \u0026V3OnionServiceId,\n        virt_port: u16,\n        client_auth: Option\u003c\u0026X25519PublicKey\u003e,\n    ) -\u003e Result\u003cOnionStream, Error\u003e {\n        let onion_addr = OnionAddr::V3(OnionAddrV3::new(service_id.clone(), virt_port));\n\n        match \u0026mut self.onion_services {\n            Some(onion_services) =\u003e {\n                if let Some((client_auth_keys, socket_addr)) = onion_services.get(\u0026onion_addr) {\n                    match (client_auth_keys.len(), client_auth) {\n                        (0, None) =\u003e (),\n                        (_, None) =\u003e return Err(Error::OnionServiceRequiresOnionAuth()),\n                        (0, Some(_)) =\u003e return Err(Error::OnionServiceAuthInvalid()),\n                        (_, Some(client_auth)) =\u003e {\n                            if !client_auth_keys.contains(client_auth) {\n                                return Err(Error::OnionServiceAuthInvalid());\n                            }\n                        }\n                    }\n\n                    if let Ok(stream) = TcpStream::connect(socket_addr) {\n                        Ok(OnionStream {\n                            stream,\n                            local_addr: None,\n                            peer_addr: Some(TargetAddr::OnionService(onion_addr)),\n                        })\n                    } else {\n                        Err(Error::OnionServiceNotFound(onion_addr))\n                    }\n                } else {\n                    Err(Error::OnionServiceNotPublished(onion_addr))\n                }\n            }\n            None =\u003e Err(Error::OnionServiceNotPublished(onion_addr)),\n        }\n    }\n\n    fn start_onion(\n        \u0026mut self,\n        service_id: V3OnionServiceId,\n        virt_port: u16,\n        client_auth_keys: Vec\u003cX25519PublicKey\u003e,\n        address: SocketAddr,\n    ) {\n        let onion_addr = OnionAddr::V3(OnionAddrV3::new(service_id, virt_port));\n        match \u0026mut self.onion_services {\n            Some(onion_services) =\u003e {\n                onion_services.insert(onion_addr, (client_auth_keys, address));\n            }\n            None =\u003e {\n                let mut onion_services = BTreeMap::new();\n                onion_services.insert(onion_addr, (client_auth_keys, address));\n                self.onion_services = Some(onion_services);\n            }\n        }\n    }\n\n    fn stop_onion(\u0026mut self, onion_addr: \u0026OnionAddr) {\n        if let Some(onion_services) = \u0026mut self.onion_services {\n            onion_services.remove(onion_addr);\n        }\n    }\n}\n\nstatic MOCK_TOR_NETWORK: Mutex\u003cMockTorNetwork\u003e = Mutex::new(MockTorNetwork::new());\n\n/// A mock `TorProvider` implementation for testing.\n///\n/// `MockTorClient` implements the [`TorProvider`] trait. It creates a fake, in-process Tor Network using local socekts and listeners. No actual traffic ever leaves the local host.\n///\n/// Mock onion-services can be created, connected to, and communiccated with. Connecting to clearnet targets always succeeds by connecting to single local endpoint, but will never send any traffic to connecting clients.\npub struct MockTorClient {\n    events: Vec\u003cTorEvent\u003e,\n    bootstrapped: bool,\n    client_auth_keys: BTreeMap\u003cV3OnionServiceId, X25519PublicKey\u003e,\n    onion_services: Vec\u003c(OnionAddr, Arc\u003catomic::AtomicBool\u003e)\u003e,\n    loopback: TcpListener,\n}\n\nimpl MockTorClient {\n    /// Construt a new `MockTorClient`.\n    pub fn new() -\u003e MockTorClient {\n        let mut events: Vec\u003cTorEvent\u003e = Default::default();\n        let line = \"[notice] MockTorClient running\".to_string();\n        events.push(TorEvent::LogReceived { line });\n\n        let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n        let listener = TcpListener::bind(socket_addr).expect(\"tcplistener bind failed\");\n\n        MockTorClient {\n            events,\n            bootstrapped: false,\n            client_auth_keys: Default::default(),\n            onion_services: Default::default(),\n            loopback: listener,\n        }\n    }\n}\n\nimpl Default for MockTorClient {\n    fn default() -\u003e Self {\n        Self::new()\n    }\n}\n\nimpl TorProvider for MockTorClient {\n    fn update(\u0026mut self) -\u003e Result\u003cVec\u003cTorEvent\u003e, tor_provider::Error\u003e {\n        match MOCK_TOR_NETWORK.lock() {\n            Ok(mut mock_tor_network) =\u003e {\n                let mut i = 0;\n                while i \u003c self.onion_services.len() {\n                    // remove onion services with no active listeners\n                    if !self.onion_services[i].1.load(atomic::Ordering::Relaxed) {\n                        let entry = self.onion_services.swap_remove(i);\n                        let onion_addr = entry.0;\n                        mock_tor_network.stop_onion(\u0026onion_addr);\n                    } else {\n                        i += 1;\n                    }\n                }\n            }\n            Err(_) =\u003e unreachable!(\"another thread panicked while holding mock tor network's lock\"),\n        }\n\n        Ok(std::mem::take(\u0026mut self.events))\n    }\n\n    fn bootstrap(\u0026mut self) -\u003e Result\u003c(), tor_provider::Error\u003e {\n        if self.bootstrapped {\n            Err(Error::ClientAlreadyBootstrapped())?\n        } else {\n            self.events.push(TorEvent::BootstrapStatus {\n                progress: 0u32,\n                tag: \"start\".to_string(),\n                summary: \"bootstrapping started\".to_string(),\n            });\n            self.events.push(TorEvent::BootstrapStatus {\n                progress: 50u32,\n                tag: \"middle\".to_string(),\n                summary: \"bootstrapping continues\".to_string(),\n            });\n            self.events.push(TorEvent::BootstrapStatus {\n                progress: 100u32,\n                tag: \"finished\".to_string(),\n                summary: \"bootstrapping completed\".to_string(),\n            });\n            self.events.push(TorEvent::BootstrapComplete);\n            self.bootstrapped = true;\n            Ok(())\n        }\n    }\n\n    fn add_client_auth(\n        \u0026mut self,\n        service_id: \u0026V3OnionServiceId,\n        client_auth: \u0026X25519PrivateKey,\n    ) -\u003e Result\u003c(), tor_provider::Error\u003e {\n        let client_auth_public = X25519PublicKey::from_private_key(client_auth);\n        if let Some(key) = self.client_auth_keys.get_mut(service_id) {\n            *key = client_auth_public;\n        } else {\n            self.client_auth_keys\n                .insert(service_id.clone(), client_auth_public);\n        }\n        Ok(())\n    }\n\n    fn remove_client_auth(\n        \u0026mut self,\n        service_id: \u0026V3OnionServiceId,\n    ) -\u003e Result\u003c(), tor_provider::Error\u003e {\n        self.client_auth_keys.remove(service_id);\n        Ok(())\n    }\n\n    fn connect(\n        \u0026mut self,\n        target: TargetAddr,\n        _circuit: Option\u003cCircuitToken\u003e,\n    ) -\u003e Result\u003cOnionStream, tor_provider::Error\u003e {\n        let (service_id, virt_port) = match target {\n            TargetAddr::OnionService(OnionAddr::V3(OnionAddrV3 {\n                service_id,\n                virt_port,\n            })) =\u003e (service_id, virt_port),\n            target_address =\u003e {\n                if let Ok(stream) = TcpStream::connect(\n                    self.loopback\n                        .local_addr()\n                        .expect(\"loopback local_addr failed\"),\n                ) {\n                    return Ok(OnionStream {\n                        stream,\n                        local_addr: None,\n                        peer_addr: Some(target_address),\n                    });\n                } else {\n                    return Err(Error::ConnectFailed(target_address).into());\n                }\n            }\n        };\n        let client_auth = self.client_auth_keys.get(\u0026service_id);\n\n        match MOCK_TOR_NETWORK.lock() {\n            Ok(mut mock_tor_network) =\u003e {\n                Ok(mock_tor_network.connect_to_onion(\u0026service_id, virt_port, client_auth)?)\n            }\n            Err(_) =\u003e unreachable!(\"another thread panicked while holding mock tor network's lock\"),\n        }\n    }\n\n    fn listener(\n        \u0026mut self,\n        private_key: \u0026Ed25519PrivateKey,\n        virt_port: u16,\n        authorized_clients: Option\u003c\u0026[X25519PublicKey]\u003e,\n    ) -\u003e Result\u003cOnionListener, tor_provider::Error\u003e {\n        // convert inputs to relevant types\n        let service_id = V3OnionServiceId::from_private_key(private_key);\n        let onion_addr = OnionAddr::V3(OnionAddrV3::new(service_id.clone(), virt_port));\n        let authorized_clients: Vec\u003cX25519PublicKey\u003e = match authorized_clients {\n            Some(keys) =\u003e keys.into(),\n            None =\u003e Default::default(),\n        };\n\n        // try to bind to a local address, let OS pick our port\n        let socket_addr = SocketAddr::from(([127, 0, 0, 1], 0u16));\n        let listener = TcpListener::bind(socket_addr).map_err(Error::TcpListenerBindFailed)?;\n        let socket_addr = listener\n            .local_addr()\n            .map_err(Error::TcpListenerLocalAddrFailed)?;\n\n        // register the onion service with the mock tor network\n        match MOCK_TOR_NETWORK.lock() {\n            Ok(mut mock_tor_network) =\u003e mock_tor_network.start_onion(\n                service_id.clone(),\n                virt_port,\n                authorized_clients,\n                socket_addr,\n            ),\n            Err(_) =\u003e unreachable!(\"another thread panicked while holding mock tor network's lock\"),\n        }\n\n        // init flag for signaling when listener goes out of scope so we can tear down onion service\n        let is_active = Arc::new(atomic::AtomicBool::new(true));\n        self.onion_services\n            .push((onion_addr.clone(), Arc::clone(\u0026is_active)));\n\n        // onion service published event\n        self.events\n            .push(TorEvent::OnionServicePublished { service_id });\n\n\n        Ok(OnionListener::new(listener, onion_addr, is_active, |is_active| {\n            is_active.store(false, atomic::Ordering::Relaxed);\n        }))\n    }\n\n    fn generate_token(\u0026mut self) -\u003e CircuitToken {\n        0usize\n    }\n\n    fn release_token(\u0026mut self, _token: CircuitToken) {}\n}\n\nimpl Drop for MockTorClient {\n    fn drop(\u0026mut self) {\n        // remove all our onion services\n        match MOCK_TOR_NETWORK.lock() {\n            Ok(mut mock_tor_network) =\u003e {\n                for entry in self.onion_services.iter() {\n                    let onion_addr = \u0026entry.0;\n                    mock_tor_network.stop_onion(onion_addr);\n                }\n            }\n            Err(_) =\u003e unreachable!(\"another thread panicked while holding mock tor network's lock\"),\n        }\n    }\n}\n","traces":[{"line":47,"address":[5708720,5708853],"length":1,"stats":{"Line":1}},{"line":48,"address":[2767949,2767891],"length":1,"stats":{"Line":2}},{"line":57,"address":[3866208],"length":1,"stats":{"Line":0}},{"line":63,"address":[5250880],"length":1,"stats":{"Line":2}},{"line":69,"address":[2115407],"length":1,"stats":{"Line":2}},{"line":71,"address":[3742654],"length":1,"stats":{"Line":2}},{"line":72,"address":[3742738],"length":1,"stats":{"Line":2}},{"line":73,"address":[5251357,5251197,5251134,5251995],"length":1,"stats":{"Line":6}},{"line":74,"address":[3743136,3742859,3742978],"length":1,"stats":{"Line":6}},{"line":76,"address":[2115924],"length":1,"stats":{"Line":1}},{"line":77,"address":[2115984],"length":1,"stats":{"Line":0}},{"line":78,"address":[3866961],"length":1,"stats":{"Line":2}},{"line":79,"address":[2116054],"length":1,"stats":{"Line":2}},{"line":80,"address":[2532298],"length":1,"stats":{"Line":0}},{"line":85,"address":[2116134,2116323,2115875],"length":1,"stats":{"Line":6}},{"line":86,"address":[1458951],"length":1,"stats":{"Line":2}},{"line":88,"address":[2116160],"length":1,"stats":{"Line":2}},{"line":89,"address":[5291466],"length":1,"stats":{"Line":2}},{"line":92,"address":[2116325],"length":1,"stats":{"Line":0}},{"line":95,"address":[5251286],"length":1,"stats":{"Line":0}},{"line":98,"address":[3866420],"length":1,"stats":{"Line":0}},{"line":102,"address":[5252032,5252859,5252831],"length":1,"stats":{"Line":2}},{"line":109,"address":[3743689,3743773],"length":1,"stats":{"Line":4}},{"line":110,"address":[5291926],"length":1,"stats":{"Line":2}},{"line":111,"address":[5252225],"length":1,"stats":{"Line":2}},{"line":112,"address":[2117288,2116685],"length":1,"stats":{"Line":4}},{"line":115,"address":[2116636],"length":1,"stats":{"Line":2}},{"line":116,"address":[3743984,3744159],"length":1,"stats":{"Line":4}},{"line":117,"address":[3744183],"length":1,"stats":{"Line":2}},{"line":122,"address":[3744512],"length":1,"stats":{"Line":2}},{"line":123,"address":[2117368],"length":1,"stats":{"Line":2}},{"line":124,"address":[3868321],"length":1,"stats":{"Line":2}},{"line":146,"address":[3869054,3868352,3869085],"length":1,"stats":{"Line":2}},{"line":147,"address":[2533649],"length":1,"stats":{"Line":2}},{"line":148,"address":[3868399],"length":1,"stats":{"Line":2}},{"line":149,"address":[2533744],"length":1,"stats":{"Line":2}},{"line":151,"address":[1460246],"length":1,"stats":{"Line":2}},{"line":152,"address":[3744878],"length":1,"stats":{"Line":2}},{"line":157,"address":[2534064],"length":1,"stats":{"Line":2}},{"line":158,"address":[3868847],"length":1,"stats":{"Line":2}},{"line":165,"address":[1460816],"length":1,"stats":{"Line":1}},{"line":166,"address":[2534408],"length":1,"stats":{"Line":1}},{"line":171,"address":[2118224,2118903,2119007],"length":1,"stats":{"Line":2}},{"line":172,"address":[1460878],"length":1,"stats":{"Line":2}},{"line":173,"address":[2118280],"length":1,"stats":{"Line":2}},{"line":174,"address":[1460923],"length":1,"stats":{"Line":2}},{"line":175,"address":[2118309,2118321,2118399],"length":1,"stats":{"Line":6}},{"line":177,"address":[5254163,5254474,5253977],"length":1,"stats":{"Line":6}},{"line":178,"address":[5254230],"length":1,"stats":{"Line":0}},{"line":179,"address":[3869662],"length":1,"stats":{"Line":0}},{"line":180,"address":[2118874,2118798],"length":1,"stats":{"Line":0}},{"line":182,"address":[5254479,5254469,5254258],"length":1,"stats":{"Line":4}},{"line":189,"address":[5293808],"length":1,"stats":{"Line":2}},{"line":192,"address":[5294336,5295153],"length":1,"stats":{"Line":2}},{"line":193,"address":[5294366,5295225],"length":1,"stats":{"Line":2}},{"line":194,"address":[1461720,1462512,1462460],"length":1,"stats":{"Line":0}},{"line":196,"address":[2119258],"length":1,"stats":{"Line":2}},{"line":198,"address":[3746244],"length":1,"stats":{"Line":2}},{"line":199,"address":[2535309],"length":1,"stats":{"Line":2}},{"line":201,"address":[3746627],"length":1,"stats":{"Line":2}},{"line":203,"address":[5294654],"length":1,"stats":{"Line":2}},{"line":204,"address":[2119383],"length":1,"stats":{"Line":2}},{"line":206,"address":[5255212],"length":1,"stats":{"Line":2}},{"line":208,"address":[3870487],"length":1,"stats":{"Line":2}},{"line":209,"address":[2119584],"length":1,"stats":{"Line":2}},{"line":211,"address":[5255346],"length":1,"stats":{"Line":2}},{"line":212,"address":[3746994],"length":1,"stats":{"Line":2}},{"line":213,"address":[3746998],"length":1,"stats":{"Line":2}},{"line":217,"address":[2536208],"length":1,"stats":{"Line":2}},{"line":222,"address":[1462640],"length":1,"stats":{"Line":2}},{"line":223,"address":[5295470,5295381],"length":1,"stats":{"Line":2}},{"line":224,"address":[3747307],"length":1,"stats":{"Line":0}},{"line":226,"address":[2120211,2120186],"length":1,"stats":{"Line":4}},{"line":227,"address":[3871122],"length":1,"stats":{"Line":2}},{"line":229,"address":[1462818],"length":1,"stats":{"Line":2}},{"line":232,"address":[5295568],"length":1,"stats":{"Line":1}},{"line":236,"address":[1462871],"length":1,"stats":{"Line":1}},{"line":237,"address":[1462894],"length":1,"stats":{"Line":1}},{"line":240,"address":[1464919,1464127,1462928],"length":1,"stats":{"Line":2}},{"line":245,"address":[3747758,3747571],"length":1,"stats":{"Line":4}},{"line":246,"address":[5295754],"length":1,"stats":{"Line":2}},{"line":250,"address":[2536909],"length":1,"stats":{"Line":0}},{"line":252,"address":[3747932,3748894],"length":1,"stats":{"Line":0}},{"line":256,"address":[1464447],"length":1,"stats":{"Line":0}},{"line":258,"address":[5297146],"length":1,"stats":{"Line":0}},{"line":259,"address":[5257412],"length":1,"stats":{"Line":0}},{"line":262,"address":[2122015,2122249],"length":1,"stats":{"Line":0}},{"line":266,"address":[5295959,5296132],"length":1,"stats":{"Line":4}},{"line":268,"address":[1463416],"length":1,"stats":{"Line":2}},{"line":269,"address":[1463449],"length":1,"stats":{"Line":2}},{"line":270,"address":[3871929,3871841,3872264],"length":1,"stats":{"Line":5}},{"line":276,"address":[5258016,5260089,5259918],"length":1,"stats":{"Line":2}},{"line":283,"address":[5297836],"length":1,"stats":{"Line":2}},{"line":284,"address":[3749743],"length":1,"stats":{"Line":2}},{"line":285,"address":[3873577],"length":1,"stats":{"Line":2}},{"line":286,"address":[5297995],"length":1,"stats":{"Line":2}},{"line":287,"address":[2122675],"length":1,"stats":{"Line":2}},{"line":291,"address":[3873682],"length":1,"stats":{"Line":2}},{"line":292,"address":[2123126,2122923,2124535],"length":1,"stats":{"Line":2}},{"line":293,"address":[3750428,3750635,3750259],"length":1,"stats":{"Line":4}},{"line":295,"address":[3750571],"length":1,"stats":{"Line":0}},{"line":298,"address":[2123372,2123496],"length":1,"stats":{"Line":4}},{"line":299,"address":[3750675,3750850],"length":1,"stats":{"Line":4}},{"line":300,"address":[2539833],"length":1,"stats":{"Line":2}},{"line":302,"address":[5259194],"length":1,"stats":{"Line":2}},{"line":309,"address":[5259377,5259411],"length":1,"stats":{"Line":4}},{"line":310,"address":[5299240,5299417],"length":1,"stats":{"Line":4}},{"line":311,"address":[5259569,5259521],"length":1,"stats":{"Line":4}},{"line":314,"address":[2540419],"length":1,"stats":{"Line":2}},{"line":315,"address":[2124145],"length":1,"stats":{"Line":2}},{"line":318,"address":[1466654],"length":1,"stats":{"Line":4}},{"line":319,"address":[3814376,3814318],"length":1,"stats":{"Line":4}},{"line":323,"address":[5299872],"length":1,"stats":{"Line":0}},{"line":327,"address":[2124602,2124592],"length":1,"stats":{"Line":0}},{"line":331,"address":[2582068,2581616,2582139],"length":1,"stats":{"Line":2}},{"line":333,"address":[1711044],"length":1,"stats":{"Line":2}},{"line":334,"address":[3532339],"length":1,"stats":{"Line":2}},{"line":335,"address":[3532359,3532600,3532440],"length":1,"stats":{"Line":6}},{"line":336,"address":[3532621],"length":1,"stats":{"Line":2}},{"line":337,"address":[2582056,2581957],"length":1,"stats":{"Line":4}}],"covered":100,"coverable":120},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","proxy.rs"],"content":"// internal crates\nuse crate::tor_provider::TargetAddr;\n\n#[derive(thiserror::Error, Debug)]\n/// Error type for the proxy module\npub enum ProxyConfigError {\n    #[error(\"{0}\")]\n    /// An error returned when constructing a proxy configuration with invalid parameters\n    Generic(String),\n}\n\n#[derive(Clone, Debug)]\n/// Configuration for a SOCKS4 proxy\npub struct Socks4ProxyConfig {\n    pub(crate) address: TargetAddr,\n}\n\nimpl Socks4ProxyConfig {\n    /// Construct a new `Socks4ProxyConfig`. The `address` argument must not be a [`crate::tor_provider::TargetAddr::OnionService`] and its port must not be 0.\n    pub fn new(address: TargetAddr) -\u003e Result\u003cSelf, ProxyConfigError\u003e {\n        let port = match \u0026address {\n            TargetAddr::Socket(addr) =\u003e addr.port(),\n            TargetAddr::Domain(addr) =\u003e addr.port(),\n            TargetAddr::OnionService(_) =\u003e {\n                return Err(ProxyConfigError::Generic(\n                    \"proxy address may not be onion service\".to_string(),\n                ))\n            }\n        };\n        if port == 0 {\n            return Err(ProxyConfigError::Generic(\"proxy port not be 0\".to_string()));\n        }\n\n        Ok(Self { address })\n    }\n}\n\n#[derive(Clone, Debug)]\n/// Configuration for a SOCKS5 proxy\npub struct Socks5ProxyConfig {\n    pub(crate) address: TargetAddr,\n    pub(crate) username: Option\u003cString\u003e,\n    pub(crate) password: Option\u003cString\u003e,\n}\n\nimpl Socks5ProxyConfig {\n    /// Construct a new `Socks5ProxyConfig`. The `address` argument must not be a  [`crate::tor_provider::TargetAddr::OnionService`] and its port must not be 0. The `username` and `password` arguments, if present, must each be less than 256 bytes long.\n    pub fn new(\n        address: TargetAddr,\n        username: Option\u003cString\u003e,\n        password: Option\u003cString\u003e,\n    ) -\u003e Result\u003cSelf, ProxyConfigError\u003e {\n        let port = match \u0026address {\n            TargetAddr::Socket(addr) =\u003e addr.port(),\n            TargetAddr::Domain(addr) =\u003e addr.port(),\n            TargetAddr::OnionService(_) =\u003e {\n                return Err(ProxyConfigError::Generic(\n                    \"proxy address may not be onion service\".to_string(),\n                ))\n            }\n        };\n        if port == 0 {\n            return Err(ProxyConfigError::Generic(\"proxy port not be 0\".to_string()));\n        }\n\n        // username must be less than 255 bytes\n        if let Some(username) = \u0026username {\n            if username.len() \u003e 255 {\n                return Err(ProxyConfigError::Generic(\n                    \"socks5 username must be \u003c= 255 bytes\".to_string(),\n                ));\n            }\n        }\n        // password must be less than 255 bytes\n        if let Some(password) = \u0026password {\n            if password.len() \u003e 255 {\n                return Err(ProxyConfigError::Generic(\n                    \"socks5 password must be \u003c= 255 bytes\".to_string(),\n                ));\n            }\n        }\n\n        Ok(Self {\n            address,\n            username,\n            password,\n        })\n    }\n}\n\n#[derive(Clone, Debug)]\n/// Configuration for an HTTP CONNECT proxy (`HTTPSProxy` in c-tor torrc configuration)\npub struct HttpsProxyConfig {\n    pub(crate) address: TargetAddr,\n    pub(crate) username: Option\u003cString\u003e,\n    pub(crate) password: Option\u003cString\u003e,\n}\n\nimpl HttpsProxyConfig {\n    /// Construct a new `HttpsProxyConfig`. The `address` argument must not be a [`crate::tor_provider::TargetAddr::OnionService`] and its port must not be 0. The `username` argument, if present, must not contain the `:` (colon) character.\n    pub fn new(\n        address: TargetAddr,\n        username: Option\u003cString\u003e,\n        password: Option\u003cString\u003e,\n    ) -\u003e Result\u003cSelf, ProxyConfigError\u003e {\n        let port = match \u0026address {\n            TargetAddr::Socket(addr) =\u003e addr.port(),\n            TargetAddr::Domain(addr) =\u003e addr.port(),\n            TargetAddr::OnionService(_) =\u003e {\n                return Err(ProxyConfigError::Generic(\n                    \"proxy address may not be onion service\".to_string(),\n                ))\n            }\n        };\n        if port == 0 {\n            return Err(ProxyConfigError::Generic(\"proxy port not be 0\".to_string()));\n        }\n\n        // username may not contain ':' character (per RFC 2617)\n        if let Some(username) = \u0026username {\n            if username.contains(':') {\n                return Err(ProxyConfigError::Generic(\n                    \"username may not contain ':' character\".to_string(),\n                ));\n            }\n        }\n\n        Ok(Self {\n            address,\n            username,\n            password,\n        })\n    }\n}\n\n#[derive(Clone, Debug)]\n/// An enum representing a possible proxy server configuration with address and possible credentials.\npub enum ProxyConfig {\n    /// A SOCKS4 proxy\n    Socks4(Socks4ProxyConfig),\n    /// A SOCKS5 proxy\n    Socks5(Socks5ProxyConfig),\n    /// An HTTP CONNECT proxy\n    Https(HttpsProxyConfig),\n}\n\nimpl From\u003cSocks4ProxyConfig\u003e for ProxyConfig {\n    fn from(config: Socks4ProxyConfig) -\u003e Self {\n        ProxyConfig::Socks4(config)\n    }\n}\n\nimpl From\u003cSocks5ProxyConfig\u003e for ProxyConfig {\n    fn from(config: Socks5ProxyConfig) -\u003e Self {\n        ProxyConfig::Socks5(config)\n    }\n}\n\nimpl From\u003cHttpsProxyConfig\u003e for ProxyConfig {\n    fn from(config: HttpsProxyConfig) -\u003e Self {\n        ProxyConfig::Https(config)\n    }\n}\n","traces":[{"line":20,"address":[3861550,3861056],"length":1,"stats":{"Line":0}},{"line":21,"address":[3737318],"length":1,"stats":{"Line":0}},{"line":22,"address":[3737485,3737355],"length":1,"stats":{"Line":0}},{"line":23,"address":[2925908,2925728],"length":1,"stats":{"Line":0}},{"line":25,"address":[2110337],"length":1,"stats":{"Line":0}},{"line":26,"address":[3861139],"length":1,"stats":{"Line":0}},{"line":30,"address":[5245874],"length":1,"stats":{"Line":0}},{"line":31,"address":[1500018,1500124],"length":1,"stats":{"Line":0}},{"line":34,"address":[5246011],"length":1,"stats":{"Line":0}},{"line":48,"address":[3737824,3739092],"length":1,"stats":{"Line":0}},{"line":53,"address":[3737856],"length":1,"stats":{"Line":0}},{"line":54,"address":[1500309,1500435],"length":1,"stats":{"Line":0}},{"line":55,"address":[3861903,3861706],"length":1,"stats":{"Line":0}},{"line":57,"address":[2926366],"length":1,"stats":{"Line":0}},{"line":58,"address":[2926237],"length":1,"stats":{"Line":0}},{"line":62,"address":[2110860],"length":1,"stats":{"Line":0}},{"line":63,"address":[2926470,2926542],"length":1,"stats":{"Line":0}},{"line":67,"address":[2111161,2111014],"length":1,"stats":{"Line":0}},{"line":68,"address":[2111230,2111169],"length":1,"stats":{"Line":0}},{"line":69,"address":[2926758],"length":1,"stats":{"Line":0}},{"line":70,"address":[2111238],"length":1,"stats":{"Line":0}},{"line":75,"address":[5246738,5246929],"length":1,"stats":{"Line":0}},{"line":76,"address":[5246937,5247214],"length":1,"stats":{"Line":0}},{"line":77,"address":[3738874],"length":1,"stats":{"Line":0}},{"line":78,"address":[1501254],"length":1,"stats":{"Line":0}},{"line":83,"address":[3738671],"length":1,"stats":{"Line":0}},{"line":84,"address":[2926893],"length":1,"stats":{"Line":0}},{"line":85,"address":[3738601],"length":1,"stats":{"Line":0}},{"line":86,"address":[3862396],"length":1,"stats":{"Line":0}},{"line":101,"address":[2113038,2111952],"length":1,"stats":{"Line":0}},{"line":106,"address":[5247536],"length":1,"stats":{"Line":0}},{"line":107,"address":[2927509,2927639],"length":1,"stats":{"Line":0}},{"line":108,"address":[3739242,3739442],"length":1,"stats":{"Line":0}},{"line":110,"address":[5247726],"length":1,"stats":{"Line":0}},{"line":111,"address":[5247597],"length":1,"stats":{"Line":0}},{"line":115,"address":[5287452],"length":1,"stats":{"Line":0}},{"line":116,"address":[2927841,2927769],"length":1,"stats":{"Line":0}},{"line":120,"address":[2927948,2927801],"length":1,"stats":{"Line":0}},{"line":121,"address":[3739923,3739636],"length":1,"stats":{"Line":0}},{"line":122,"address":[1502400],"length":1,"stats":{"Line":0}},{"line":123,"address":[2928276],"length":1,"stats":{"Line":0}},{"line":128,"address":[3863519],"length":1,"stats":{"Line":0}},{"line":129,"address":[3739661],"length":1,"stats":{"Line":0}},{"line":130,"address":[2928009],"length":1,"stats":{"Line":0}},{"line":131,"address":[1502136],"length":1,"stats":{"Line":0}},{"line":148,"address":[3740240],"length":1,"stats":{"Line":0}},{"line":149,"address":[5248641],"length":1,"stats":{"Line":0}},{"line":154,"address":[1502704],"length":1,"stats":{"Line":0}},{"line":155,"address":[3740321],"length":1,"stats":{"Line":0}},{"line":160,"address":[2928688],"length":1,"stats":{"Line":0}},{"line":161,"address":[2928705],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":51},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","tor_crypto.rs"],"content":"// standard\nuse std::convert::TryInto;\nuse std::str;\n\n// extern crates\nuse curve25519_dalek::Scalar;\nuse data_encoding::{BASE32_NOPAD, BASE64};\nuse data_encoding_macro::new_encoding;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse rand::distributions::Alphanumeric;\nuse rand::rngs::OsRng;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse rand::Rng;\nuse sha3::{Digest, Sha3_256};\nuse static_assertions::const_assert_eq;\nuse tor_llcrypto::pk::keymanip::*;\nuse tor_llcrypto::*;\n\n/// Represents various errors that can occur in the tor_crypto module.\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    /// A error encountered converting a String to a tor_crypto type\n    #[error(\"{0}\")]\n    ParseError(String),\n\n    /// An error encountered converting between tor_crypto types\n    #[error(\"{0}\")]\n    ConversionError(String),\n\n    /// An error encountered converting from a raw byte representation\n    #[error(\"invalid key\")]\n    KeyInvalid,\n}\n\n/// The number of bytes in an ed25519 secret key\n/// cbindgen:ignore\npub const ED25519_PRIVATE_KEY_SIZE: usize = 64;\n/// The number of bytes in an ed25519 public key\n/// cbindgen:ignore\npub const ED25519_PUBLIC_KEY_SIZE: usize = 32;\n/// The number of bytes in an ed25519 signature\n/// cbindgen:ignore\npub const ED25519_SIGNATURE_SIZE: usize = 64;\n/// The number of bytes needed to store onion service id as an ASCII c-string (not including null-terminator)\npub const V3_ONION_SERVICE_ID_STRING_LENGTH: usize = 56;\n/// The number of bytes needed to store onion service id as an ASCII c-string (including null-terminator)\npub const V3_ONION_SERVICE_ID_STRING_SIZE: usize = 57;\nconst_assert_eq!(\n    V3_ONION_SERVICE_ID_STRING_SIZE,\n    V3_ONION_SERVICE_ID_STRING_LENGTH + 1\n);\n/// The number of bytes needed to store base64 encoded ed25519 private key as an ASCII c-string (not including null-terminator)\npub const ED25519_PRIVATE_KEYBLOB_BASE64_LENGTH: usize = 88;\n/// key klob header string\nconst ED25519_PRIVATE_KEY_KEYBLOB_HEADER: \u0026str = \"ED25519-V3:\";\n/// The number of bytes needed to store the keyblob header\npub const ED25519_PRIVATE_KEY_KEYBLOB_HEADER_LENGTH: usize = 11;\nconst_assert_eq!(\n    ED25519_PRIVATE_KEY_KEYBLOB_HEADER_LENGTH,\n    ED25519_PRIVATE_KEY_KEYBLOB_HEADER.len()\n);\n/// The number of bytes needed to store ed25519 private keyblob as an ASCII c-string (not including a null terminator)\npub const ED25519_PRIVATE_KEY_KEYBLOB_LENGTH: usize = 99;\nconst_assert_eq!(\n    ED25519_PRIVATE_KEY_KEYBLOB_LENGTH,\n    ED25519_PRIVATE_KEY_KEYBLOB_HEADER_LENGTH + ED25519_PRIVATE_KEYBLOB_BASE64_LENGTH\n);\n/// The number of bytes needed to store ed25519 private keyblob as an ASCII c-string (including a null terminator)\npub const ED25519_PRIVATE_KEY_KEYBLOB_SIZE: usize = 100;\nconst_assert_eq!(\n    ED25519_PRIVATE_KEY_KEYBLOB_SIZE,\n    ED25519_PRIVATE_KEY_KEYBLOB_LENGTH + 1\n);\n// number of bytes in an onion service id after base32 decode\nconst V3_ONION_SERVICE_ID_RAW_SIZE: usize = 35;\n// byte index of the start of the public key checksum\nconst V3_ONION_SERVICE_ID_CHECKSUM_OFFSET: usize = 32;\n// byte index of the v3 onion service version\nconst V3_ONION_SERVICE_ID_VERSION_OFFSET: usize = 34;\n/// The number of bytes in a v3 service id's truncated checksum\nconst TRUNCATED_CHECKSUM_SIZE: usize = 2;\n/// The number of bytes in an x25519 private key\n/// cbindgen:ignore\npub const X25519_PRIVATE_KEY_SIZE: usize = 32;\n/// The number of bytes in an x25519 publickey\n/// cbindgen:ignore\npub const X25519_PUBLIC_KEY_SIZE: usize = 32;\n/// The number of bytes needed to store base64 encoded x25519 private key as an ASCII c-string (not including null-terminator)\npub const X25519_PRIVATE_KEY_BASE64_LENGTH: usize = 44;\n/// The number of bytes needed to store base64 encoded x25519 private key as an ASCII c-string (including a null terminator)\npub const X25519_PRIVATE_KEY_BASE64_SIZE: usize = 45;\nconst_assert_eq!(\n    X25519_PRIVATE_KEY_BASE64_SIZE,\n    X25519_PRIVATE_KEY_BASE64_LENGTH + 1\n);\n/// The number of bytes needed to store base32 encoded x25519 public key as an ASCII c-string (not including null-terminator)\npub const X25519_PUBLIC_KEY_BASE32_LENGTH: usize = 52;\n/// The number of bytes needed to store base32 encoded x25519 public key as an ASCII c-string (including a null terminator)\npub const X25519_PUBLIC_KEY_BASE32_SIZE: usize = 53;\nconst_assert_eq!(\n    X25519_PUBLIC_KEY_BASE32_SIZE,\n    X25519_PUBLIC_KEY_BASE32_LENGTH + 1\n);\n\nconst ONION_BASE32: data_encoding::Encoding = new_encoding! {\n    symbols: \"abcdefghijklmnopqrstuvwxyz234567\",\n    padding: '=',\n};\n\n// Free functions\n\n// securely generate password using OsRng\n#[cfg(feature = \"legacy-tor-provider\")]\npub(crate) fn generate_password(length: usize) -\u003e String {\n    let password: String = std::iter::repeat(())\n        .map(|()| OsRng.sample(Alphanumeric))\n        .map(char::from)\n        .take(length)\n        .collect();\n\n    password\n}\n\n// Struct deinitions\n\n/// An ed25519 private key.\n///\n/// This key type is used with [`crate::tor_provider::TorProvider`] trait for hosting onion-services and can be convertd to an [`Ed25519PublicKey`]. It can also be used to sign messages and create an [`Ed25519Signature`].\npub struct Ed25519PrivateKey {\n    expanded_keypair: pk::ed25519::ExpandedKeypair,\n}\n\n/// An ed25519 public key.\n///\n/// This key type is derived from [`Ed25519PrivateKey`] and can be converted to a [`V3OnionServiceId`]. It can also be used to verify a [`Ed25519Signature`].\n#[derive(Clone)]\npub struct Ed25519PublicKey {\n    public_key: pk::ed25519::PublicKey,\n}\n\n/// An ed25519 cryptographic signature\n#[derive(Clone)]\npub struct Ed25519Signature {\n    signature: pk::ed25519::Signature,\n}\n\n/// An x25519 private key\n#[derive(Clone)]\npub struct X25519PrivateKey {\n    secret_key: pk::curve25519::StaticSecret,\n}\n\n/// An x25519 public key\n#[derive(Clone, PartialEq, Eq, Hash)]\npub struct X25519PublicKey {\n    public_key: pk::curve25519::PublicKey,\n}\n\n/// A v3 onion-service id\n#[derive(Clone, PartialEq, Eq, Hash, PartialOrd, Ord)]\npub struct V3OnionServiceId {\n    data: [u8; V3_ONION_SERVICE_ID_STRING_LENGTH],\n}\n\n/// An enum representing a single bit\n#[derive(Clone, Copy)]\npub enum SignBit {\n    Zero,\n    One,\n}\n\nimpl From\u003cSignBit\u003e for u8 {\n    fn from(signbit: SignBit) -\u003e Self {\n        match signbit {\n            SignBit::Zero =\u003e 0u8,\n            SignBit::One =\u003e 1u8,\n        }\n    }\n}\n\nimpl From\u003cSignBit\u003e for bool {\n    fn from(signbit: SignBit) -\u003e Self {\n        match signbit {\n            SignBit::Zero =\u003e false,\n            SignBit::One =\u003e true,\n        }\n    }\n}\n\nimpl From\u003cbool\u003e for SignBit {\n    fn from(signbit: bool) -\u003e Self {\n        if signbit {\n            SignBit::One\n        } else {\n            SignBit::Zero\n        }\n    }\n}\n\n// which validation method to use when constructing an ed25519 expanded key from\n// a byte array\nenum FromRawValidationMethod {\n    // expanded ed25519 keys coming from legacy c-tor daemon; the scalar portion\n    // is clamped, but not reduced\n    #[cfg(feature = \"legacy-tor-provider\")]\n    LegacyCTor,\n    // expanded ed25519 keys coming from ed25519-dalek crate; the scalar portion\n    // has been clamped AND reduced\n    Ed25519Dalek,\n}\n\n/// A wrapper around `tor_llcrypto::pk::ed25519::ExpandedKeypair`.\nimpl Ed25519PrivateKey {\n    /// Securely generate a new `Ed25519PrivateKey`.\n    pub fn generate() -\u003e Ed25519PrivateKey {\n        let csprng = \u0026mut OsRng;\n        let keypair = pk::ed25519::Keypair::generate(csprng);\n\n        Ed25519PrivateKey {\n            expanded_keypair: pk::ed25519::ExpandedKeypair::from(\u0026keypair),\n        }\n    }\n\n    fn from_raw_impl(\n        raw: \u0026[u8; ED25519_PRIVATE_KEY_SIZE],\n        method: FromRawValidationMethod,\n    ) -\u003e Result\u003cEd25519PrivateKey, Error\u003e {\n        // see: https://gitlab.torproject.org/tpo/core/arti/-/issues/1343\n        match method {\n            #[cfg(feature = \"legacy-tor-provider\")]\n            FromRawValidationMethod::LegacyCTor =\u003e {\n                // Verify the scalar portion of the expanded key has been clamped\n                // see: https://gitlab.torproject.org/tpo/core/arti/-/issues/1021\n                if !(raw[0] == raw[0] \u0026 248 \u0026\u0026 raw[31] == (raw[31] \u0026 63) | 64) {\n                    return Err(Error::KeyInvalid);\n                }\n            }\n            FromRawValidationMethod::Ed25519Dalek =\u003e {\n                // Verify the scalar is non-zero and it has been reduced\n                let scalar: [u8; 32] = raw[..32].try_into().unwrap();\n                if scalar.iter().all(|\u0026x| x == 0x00u8) {\n                    return Err(Error::KeyInvalid);\n                }\n                let reduced_scalar = Scalar::from_bytes_mod_order(scalar).to_bytes();\n                if scalar != reduced_scalar {\n                    return Err(Error::KeyInvalid);\n                }\n            }\n        }\n\n        if let Some(expanded_keypair) = pk::ed25519::ExpandedKeypair::from_secret_key_bytes(*raw) {\n            Ok(Ed25519PrivateKey { expanded_keypair })\n        } else {\n            Err(Error::KeyInvalid)\n        }\n    }\n\n    /// Attempt to create an `Ed25519PrivateKey` from an array of bytes. Not all byte buffers of the required size can create a valid `Ed25519PrivateKey`. Only buffers derived from [`Ed25519PrivateKey::to_bytes()`] are required to convert correctly.\n    ///\n    /// To securely generate a valid `Ed25519PrivateKey`, use [`Ed25519PrivateKey::generate()`].\n    pub fn from_raw(raw: \u0026[u8; ED25519_PRIVATE_KEY_SIZE]) -\u003e Result\u003cEd25519PrivateKey, Error\u003e {\n        Self::from_raw_impl(raw, FromRawValidationMethod::Ed25519Dalek)\n    }\n\n    fn from_key_blob_impl(\n        key_blob: \u0026str,\n        method: FromRawValidationMethod,\n    ) -\u003e Result\u003cEd25519PrivateKey, Error\u003e {\n        if key_blob.len() != ED25519_PRIVATE_KEY_KEYBLOB_LENGTH {\n            return Err(Error::ParseError(format!(\n                \"expects string of length '{}'; received string with length '{}'\",\n                ED25519_PRIVATE_KEY_KEYBLOB_LENGTH,\n                key_blob.len()\n            )));\n        }\n\n        if !key_blob.starts_with(ED25519_PRIVATE_KEY_KEYBLOB_HEADER) {\n            return Err(Error::ParseError(format!(\n                \"expects string that begins with '{}'; received '{}'\",\n                \u0026ED25519_PRIVATE_KEY_KEYBLOB_HEADER, \u0026key_blob\n            )));\n        }\n\n        let base64_key: \u0026str = \u0026key_blob[ED25519_PRIVATE_KEY_KEYBLOB_HEADER.len()..];\n        let private_key_data = match BASE64.decode(base64_key.as_bytes()) {\n            Ok(private_key_data) =\u003e private_key_data,\n            Err(_) =\u003e {\n                return Err(Error::ParseError(format!(\n                    \"could not parse '{}' as base64\",\n                    base64_key\n                )))\n            }\n        };\n        let private_key_data_len = private_key_data.len();\n        let private_key_data_raw: [u8; ED25519_PRIVATE_KEY_SIZE] = match private_key_data.try_into()\n        {\n            Ok(private_key_data) =\u003e private_key_data,\n            Err(_) =\u003e {\n                return Err(Error::ParseError(format!(\n                    \"expects decoded private key length '{}'; actual '{}'\",\n                    ED25519_PRIVATE_KEY_SIZE, private_key_data_len\n                )))\n            }\n        };\n\n        Ed25519PrivateKey::from_raw_impl(\u0026private_key_data_raw, method)\n    }\n\n    #[cfg(feature = \"legacy-tor-provider\")]\n    pub(crate) fn from_key_blob_legacy(key_blob: \u0026str) -\u003e Result\u003cEd25519PrivateKey, Error\u003e {\n        Self::from_key_blob_impl(key_blob, FromRawValidationMethod::LegacyCTor)\n    }\n\n    /// Create an `Ed25519PrivateKey` from a [`String`] in the legacy c-tor daemon key blob format used in the `ADD_ONION` control-port command. From the c-tor control [specification](https://spec.torproject.org/control-spec/commands.html#add_onion):\n    /// \u003e For a \"ED25519-V3\" key is the Base64 encoding of the concatenation of the 32-byte ed25519 secret scalar in little-endian and the 32-byte ed25519 PRF secret.\n    ///\n    /// Only key blob strings derived from [`Ed25519PrivateKey::to_key_blob()`] are required to convert correctly.\n    pub fn from_key_blob(key_blob: \u0026str) -\u003e Result\u003cEd25519PrivateKey, Error\u003e {\n        Self::from_key_blob_impl(key_blob, FromRawValidationMethod::Ed25519Dalek)\n    }\n\n    /// Construct an `Ed25519PrivateKEy` from an [`X25519PrivateKey`].\n    pub fn from_private_x25519(\n        x25519_private: \u0026X25519PrivateKey,\n    ) -\u003e Result\u003c(Ed25519PrivateKey, SignBit), Error\u003e {\n        if let Some((result, signbit)) =\n            convert_curve25519_to_ed25519_private(\u0026x25519_private.secret_key)\n        {\n            Ok((\n                Ed25519PrivateKey {\n                    expanded_keypair: result,\n                },\n                match signbit {\n                    0u8 =\u003e SignBit::Zero,\n                    1u8 =\u003e SignBit::One,\n                    invalid_signbit =\u003e {\n                        return Err(Error::ConversionError(format!(\n                            \"convert_curve25519_to_ed25519_private() returned invalid signbit: {}\",\n                            invalid_signbit\n                        )))\n                    }\n                },\n            ))\n        } else {\n            Err(Error::ConversionError(\n                \"could not convert x25519 private key to ed25519 private key\".to_string(),\n            ))\n        }\n    }\n\n    /// Write `Ed25519PrivateKey` to a c-tor key blob formatted [`String`].\n    pub fn to_key_blob(\u0026self) -\u003e String {\n        let mut key_blob = ED25519_PRIVATE_KEY_KEYBLOB_HEADER.to_string();\n        key_blob.push_str(\u0026BASE64.encode(\u0026self.expanded_keypair.to_secret_key_bytes()));\n\n        key_blob\n    }\n\n    /// Sign the provided message and return an [`Ed25519Signature`].\n    /// ## ⚠ Warning ⚠\n    ///Only ever sign messages the private key owner controls the contents of!\n    pub fn sign_message(\u0026self, message: \u0026[u8]) -\u003e Ed25519Signature {\n        let signature = self.expanded_keypair.sign(message);\n        Ed25519Signature { signature }\n    }\n\n    /// Convert this private key to an array of bytes.\n    pub fn to_bytes(\u0026self) -\u003e [u8; ED25519_PRIVATE_KEY_SIZE] {\n        self.expanded_keypair.to_secret_key_bytes()\n    }\n\n    #[cfg(feature = \"arti-client-tor-provider\")]\n    pub(crate) fn inner(\u0026self) -\u003e \u0026pk::ed25519::ExpandedKeypair {\n        \u0026self.expanded_keypair\n    }\n}\n\nimpl PartialEq for Ed25519PrivateKey {\n    fn eq(\u0026self, other: \u0026Self) -\u003e bool {\n        self.to_bytes().eq(\u0026other.to_bytes())\n    }\n}\n\nimpl Clone for Ed25519PrivateKey {\n    fn clone(\u0026self) -\u003e Ed25519PrivateKey {\n        match Ed25519PrivateKey::from_raw(\u0026self.to_bytes()) {\n            Ok(ed25519_private_key) =\u003e ed25519_private_key,\n            Err(_) =\u003e unreachable!(),\n        }\n    }\n}\n\nimpl std::fmt::Debug for Ed25519PrivateKey {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        write!(f, \"--- ed25519 private key ---\")\n    }\n}\n\n/// A wrapper around `tor_llcrypto::pk::ed25519::PublicKey`\nimpl Ed25519PublicKey {\n    /// Construct an `Ed25519PublicKey` from an array of bytes. Not all byte buffers of the required size can create a valid `Ed25519PublicKey`. Only buffers derived from [`Ed25519PublicKey::as_bytes()`] are required to convert correctly.\n    pub fn from_raw(raw: \u0026[u8; ED25519_PUBLIC_KEY_SIZE]) -\u003e Result\u003cEd25519PublicKey, Error\u003e {\n        Ok(Ed25519PublicKey {\n            public_key: match pk::ed25519::PublicKey::from_bytes(raw) {\n                Ok(public_key) =\u003e public_key,\n                Err(_) =\u003e return Err(Error::KeyInvalid),\n            },\n        })\n    }\n\n    /// Construct an `Ed25519PublicKey` from a [`V3OnionServiceId`].\n    pub fn from_service_id(service_id: \u0026V3OnionServiceId) -\u003e Result\u003cEd25519PublicKey, Error\u003e {\n        // decode base32 encoded service id\n        let mut decoded_service_id = [0u8; V3_ONION_SERVICE_ID_RAW_SIZE];\n        let decoded_byte_count =\n            match ONION_BASE32.decode_mut(service_id.as_bytes(), \u0026mut decoded_service_id) {\n                Ok(decoded_byte_count) =\u003e decoded_byte_count,\n                Err(_) =\u003e {\n                    return Err(Error::ConversionError(format!(\n                        \"failed to decode '{}' as V3OnionServiceId\",\n                        service_id\n                    )))\n                }\n            };\n        if decoded_byte_count != V3_ONION_SERVICE_ID_RAW_SIZE {\n            return Err(Error::ConversionError(format!(\n                \"decoded byte count is '{}', expected '{}'\",\n                decoded_byte_count, V3_ONION_SERVICE_ID_RAW_SIZE\n            )));\n        }\n\n        Ed25519PublicKey::from_raw(\n            decoded_service_id[0..ED25519_PUBLIC_KEY_SIZE]\n                .try_into()\n                .unwrap(),\n        )\n    }\n\n    /// Construct an `Ed25519PublicKey` from an [`Ed25519PrivateKey`].\n    pub fn from_private_key(private_key: \u0026Ed25519PrivateKey) -\u003e Ed25519PublicKey {\n        Ed25519PublicKey {\n            public_key: *private_key.expanded_keypair.public(),\n        }\n    }\n\n    fn from_public_x25519(\n        public_x25519: \u0026X25519PublicKey,\n        signbit: SignBit,\n    ) -\u003e Result\u003cEd25519PublicKey, Error\u003e {\n        match convert_curve25519_to_ed25519_public(\u0026public_x25519.public_key, signbit.into()) {\n            Some(public_key) =\u003e Ok(Ed25519PublicKey { public_key }),\n            None =\u003e Err(Error::ConversionError(\n                \"failed to create ed25519 public key from x25519 public key and signbit\"\n                    .to_string(),\n            )),\n        }\n    }\n\n    /// View this public key as an array of bytes\n    pub fn as_bytes(\u0026self) -\u003e \u0026[u8; ED25519_PUBLIC_KEY_SIZE] {\n        self.public_key.as_bytes()\n    }\n}\n\nimpl PartialEq for Ed25519PublicKey {\n    fn eq(\u0026self, other: \u0026Self) -\u003e bool {\n        self.public_key.eq(\u0026other.public_key)\n    }\n}\n\nimpl std::fmt::Debug for Ed25519PublicKey {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        self.public_key.fmt(f)\n    }\n}\n\n\n/// A wrapper around `tor_llcrypto::pk::ed25519::Signature`\nimpl Ed25519Signature {\n    /// Construct an `Ed25519Signature` from an array of bytes.\n    pub fn from_raw(raw: \u0026[u8; ED25519_SIGNATURE_SIZE]) -\u003e Result\u003cEd25519Signature, Error\u003e {\n        // todo: message cannot fail so should not return a Result\u003c\u003e\n        Ok(Ed25519Signature {\n            signature: pk::ed25519::Signature::from_bytes(raw),\n        })\n    }\n\n    /// Verify this `Ed25519Signature` for the given message and [`Ed25519PublicKey`].\n    pub fn verify(\u0026self, message: \u0026[u8], public_key: \u0026Ed25519PublicKey) -\u003e bool {\n        if let Ok(()) = public_key\n            .public_key\n            .verify_strict(message, \u0026self.signature)\n        {\n            return true;\n        }\n        false\n    }\n\n    /// Verify this `Ed25519Signature` for the given message, [`X25519PublicKey`], and [`SignBit`]. This signature must have been created by first converting an [`X25519PrivateKey`] to a [`Ed25519PrivateKey`] and [`SignBit`], and then signing the message using this [`Ed25519PrivateKey`]. This method verifies the signature using the [`Ed25519PublicKey`] derived from the provided  [`X25519PublicKey`] and [`SignBit`].\n    pub fn verify_x25519(\n        \u0026self,\n        message: \u0026[u8],\n        public_key: \u0026X25519PublicKey,\n        signbit: SignBit,\n    ) -\u003e bool {\n        if let Ok(public_key) = Ed25519PublicKey::from_public_x25519(public_key, signbit) {\n            return self.verify(message, \u0026public_key);\n        }\n        false\n    }\n\n    /// Convert this signature to an array of bytes\n    pub fn to_bytes(\u0026self) -\u003e [u8; ED25519_SIGNATURE_SIZE] {\n        self.signature.to_bytes()\n    }\n}\n\nimpl PartialEq for Ed25519Signature {\n    fn eq(\u0026self, other: \u0026Self) -\u003e bool {\n        self.signature.eq(\u0026other.signature)\n    }\n}\n\nimpl std::fmt::Debug for Ed25519Signature {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        self.signature.fmt(f)\n    }\n}\n\n/// A wrapper around `tor_llcrypto::pk::curve25519::StaticSecret`\nimpl X25519PrivateKey {\n    /// Securely generate a new `X25519PrivateKey`\n    pub fn generate() -\u003e X25519PrivateKey {\n        let csprng = \u0026mut OsRng;\n        X25519PrivateKey {\n            secret_key: pk::curve25519::StaticSecret::random_from_rng(csprng),\n        }\n    }\n\n    /// Attempt to create an `X25519PrivateKey` from an array of bytes. Not all byte buffers of the required size can create a valid `X25519PrivateKey`. Only buffers derived from [`X25519PrivateKey::to_bytes()`] are required to convert correctly.\n    ///\n    /// To securely generate a valid `X25519PrivateKey`, use [`X25519PrivateKey::generate()`].\n    pub fn from_raw(raw: \u0026[u8; X25519_PRIVATE_KEY_SIZE]) -\u003e Result\u003cX25519PrivateKey, Error\u003e {\n        // see: https://docs.rs/x25519-dalek/2.0.0-pre.1/src/x25519_dalek/x25519.rs.html#197\n        if raw[0] == raw[0] \u0026 240 \u0026\u0026 raw[31] == (raw[31] \u0026 127) | 64 {\n            Ok(X25519PrivateKey {\n                secret_key: pk::curve25519::StaticSecret::from(*raw),\n            })\n        } else {\n            Err(Error::KeyInvalid)\n        }\n    }\n\n    /// Create an `X25519PrivateKey` from a [`String`] in the legacy c-tor daemon key blob format used in the `ONION_CLIENT_AUTH_ADD` control-port command. From the c-tor control [specification](https://spec.torproject.org/control-spec/commands.html#onion_client_auth_add):\n    /// \u003e ```text\n    /// \u003e PrivateKeyBlob = base64 encoding of x25519 key\n    /// \u003e ```\n    ///\n    /// Only key blob strings derived from [`X25519PrivateKey::to_base64()`] are required to convert correctly.\n    pub fn from_base64(base64: \u0026str) -\u003e Result\u003cX25519PrivateKey, Error\u003e {\n        // todo: see if this should be from/to key blob like with ed25519 rather than base64\n        if base64.len() != X25519_PRIVATE_KEY_BASE64_LENGTH {\n            return Err(Error::ParseError(format!(\n                \"expects string of length '{}'; received string with length '{}'\",\n                X25519_PRIVATE_KEY_BASE64_LENGTH,\n                base64.len()\n            )));\n        }\n\n        let private_key_data = match BASE64.decode(base64.as_bytes()) {\n            Ok(private_key_data) =\u003e private_key_data,\n            Err(_) =\u003e {\n                return Err(Error::ParseError(format!(\n                    \"could not parse '{}' as base64\",\n                    base64\n                )))\n            }\n        };\n        let private_key_data_len = private_key_data.len();\n        let private_key_data_raw: [u8; X25519_PRIVATE_KEY_SIZE] = match private_key_data.try_into()\n        {\n            Ok(private_key_data) =\u003e private_key_data,\n            Err(_) =\u003e {\n                return Err(Error::ParseError(format!(\n                    \"expects decoded private key length '{}'; actual '{}'\",\n                    X25519_PRIVATE_KEY_SIZE, private_key_data_len\n                )))\n            }\n        };\n\n        X25519PrivateKey::from_raw(\u0026private_key_data_raw)\n    }\n\n    /// Sign the provided message and return an [`Ed25519Signature`] and [`SignBit`].\n    ///\n    /// This method first converts this `X25519PrivateKey` to an [`Ed25519PrivateKey`] and [`SignBit`]. Then, the message is signed using the derived [`Ed25519PrivateKey`]. To verify the signature, both the [`X25519PublicKey`] and this calculated [`SignBit`] are required.\n    ///\n    /// ## ⚠ Warning ⚠\n    ///Only ever sign messages the private key owner controls the contents of!\n    pub fn sign_message(\u0026self, message: \u0026[u8]) -\u003e Result\u003c(Ed25519Signature, SignBit), Error\u003e {\n        let (ed25519_private, signbit) = Ed25519PrivateKey::from_private_x25519(self)?;\n        Ok((ed25519_private.sign_message(message), signbit))\n    }\n\n    /// Write `X25519PrivateKey` to a base64 encocded [`String`].\n    pub fn to_base64(\u0026self) -\u003e String {\n        BASE64.encode(\u0026self.secret_key.to_bytes())\n    }\n\n    /// Convert this private key to an array of bytes.\n    pub fn to_bytes(\u0026self) -\u003e [u8; X25519_PRIVATE_KEY_SIZE] {\n        self.secret_key.to_bytes()\n    }\n}\n\nimpl PartialEq for X25519PrivateKey {\n    fn eq(\u0026self, other: \u0026Self) -\u003e bool {\n        self.secret_key.to_bytes() == other.secret_key.to_bytes()\n    }\n}\n\nimpl std::fmt::Debug for X25519PrivateKey {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        write!(f, \"--- x25519 private key ---\")\n    }\n}\n\n/// A wrapper around `tor_llcrypto::pk::curve25519::PublicKey`\nimpl X25519PublicKey {\n    /// Construct an `X25519PublicKey` from an [`X25519PrivateKey`].\n    pub fn from_private_key(private_key: \u0026X25519PrivateKey) -\u003e X25519PublicKey {\n        X25519PublicKey {\n            public_key: pk::curve25519::PublicKey::from(\u0026private_key.secret_key),\n        }\n    }\n\n    /// Construct an `X25519PublicKey` from an array of bytes.\n    pub fn from_raw(raw: \u0026[u8; X25519_PUBLIC_KEY_SIZE]) -\u003e X25519PublicKey {\n        X25519PublicKey {\n            public_key: pk::curve25519::PublicKey::from(*raw),\n        }\n    }\n\n    /// Create an `X25519PublicKey` from a [`String`] in the legacy c-tor daemon key base32 format used in the `ADD_ONION` control-port command. From the c-tor control [specification](https://spec.torproject.org/control-spec/commands.html#add_onion):\n    /// \u003e ```text\n    /// \u003e V3Key = The client's base32-encoded x25519 public key, using only the key\n    /// \u003e         part of rend-spec-v3.txt section G.1.2 (v3 only).\n    /// \u003e ```\n    ///\n    /// Only key base32 strings derived from [`X25519PublicKey::to_base32()`] are required to convert correctly.\n    pub fn from_base32(base32: \u0026str) -\u003e Result\u003cX25519PublicKey, Error\u003e {\n        if base32.len() != X25519_PUBLIC_KEY_BASE32_LENGTH {\n            return Err(Error::ParseError(format!(\n                \"expects string of length '{}'; received '{}' with length '{}'\",\n                X25519_PUBLIC_KEY_BASE32_LENGTH,\n                base32,\n                base32.len()\n            )));\n        }\n\n        let public_key_data = match BASE32_NOPAD.decode(base32.as_bytes()) {\n            Ok(public_key_data) =\u003e public_key_data,\n            Err(_) =\u003e {\n                return Err(Error::ParseError(format!(\n                    \"failed to decode '{}' as X25519PublicKey\",\n                    base32\n                )))\n            }\n        };\n        let public_key_data_len = public_key_data.len();\n        let public_key_data_raw: [u8; X25519_PUBLIC_KEY_SIZE] = match public_key_data.try_into() {\n            Ok(public_key_data) =\u003e public_key_data,\n            Err(_) =\u003e {\n                return Err(Error::ParseError(format!(\n                    \"expects decoded public key length '{}'; actual '{}'\",\n                    X25519_PUBLIC_KEY_SIZE, public_key_data_len\n                )))\n            }\n        };\n\n        Ok(X25519PublicKey::from_raw(\u0026public_key_data_raw))\n    }\n\n    /// Write `X25519PublicKey` to a base32 encocded [`String`].\n    pub fn to_base32(\u0026self) -\u003e String {\n        BASE32_NOPAD.encode(self.public_key.as_bytes())\n    }\n\n    /// View this public key as an array of bytes\n    pub fn as_bytes(\u0026self) -\u003e \u0026[u8; X25519_PUBLIC_KEY_SIZE] {\n        self.public_key.as_bytes()\n    }\n}\n\nimpl std::fmt::Debug for X25519PublicKey {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        write!(f, \"{}\", self.to_base32())\n    }\n}\n\n/// Strongly-typed representation of a v3 onion-service id\nimpl V3OnionServiceId {\n    // see https://github.com/torproject/torspec/blob/main/rend-spec-v3.txt#L2143\n    fn calc_truncated_checksum(\n        public_key: \u0026[u8; ED25519_PUBLIC_KEY_SIZE],\n    ) -\u003e [u8; TRUNCATED_CHECKSUM_SIZE] {\n        let mut hasher = Sha3_256::new();\n\n        // calculate checksum\n        hasher.update(b\".onion checksum\");\n        hasher.update(public_key);\n        hasher.update([0x03u8]);\n        let hash_bytes = hasher.finalize();\n\n        [hash_bytes[0], hash_bytes[1]]\n    }\n\n    /// Create a `V3OnionServiceId` from a [`String`] in the version 3 onion service digest format. From the tor address [specification](https://spec.torproject.org/address-spec.html#onion):\n    /// \u003e ```text\n    /// \u003e onion_address = base32(PUBKEY | CHECKSUM | VERSION)\n    /// \u003e CHECKSUM = H(\".onion checksum\" | PUBKEY | VERSION)[:2]\n    /// \u003e\n    /// \u003e where:\n    /// \u003e - PUBKEY is the 32 bytes ed25519 master pubkey of the onion service.\n    /// \u003e - VERSION is a one byte version field (default value '\\x03')\n    /// \u003e - \".onion checksum\" is a constant string\n    /// \u003e - H is SHA3-256\n    /// \u003e - CHECKSUM is truncated to two bytes before inserting it in onion_address\n    /// \u003e ```\n    pub fn from_string(service_id: \u0026str) -\u003e Result\u003cV3OnionServiceId, Error\u003e {\n        if !V3OnionServiceId::is_valid(service_id) {\n            return Err(Error::ParseError(format!(\n                \"'{}' is not a valid v3 onion service id\",\n                service_id\n            )));\n        }\n        Ok(V3OnionServiceId {\n            data: service_id.as_bytes().try_into().unwrap(),\n        })\n    }\n\n    /// Create a `V3OnionServiceId` from an [`Ed25519PublicKey`].\n    pub fn from_public_key(public_key: \u0026Ed25519PublicKey) -\u003e V3OnionServiceId {\n        let mut raw_service_id = [0u8; V3_ONION_SERVICE_ID_RAW_SIZE];\n\n        raw_service_id[..ED25519_PUBLIC_KEY_SIZE].copy_from_slice(\u0026public_key.as_bytes()[..]);\n        let truncated_checksum = Self::calc_truncated_checksum(public_key.as_bytes());\n        raw_service_id[V3_ONION_SERVICE_ID_CHECKSUM_OFFSET] = truncated_checksum[0];\n        raw_service_id[V3_ONION_SERVICE_ID_CHECKSUM_OFFSET + 1] = truncated_checksum[1];\n        raw_service_id[V3_ONION_SERVICE_ID_VERSION_OFFSET] = 0x03u8;\n\n        let mut service_id = [0u8; V3_ONION_SERVICE_ID_STRING_LENGTH];\n        // panics on wrong buffer size, but given our constant buffer sizes should be fine\n        ONION_BASE32.encode_mut(\u0026raw_service_id, \u0026mut service_id);\n\n        V3OnionServiceId { data: service_id }\n    }\n\n    /// Create a `V3OnionServiceId` from an [`Ed25519PrivateKey`].\n    pub fn from_private_key(private_key: \u0026Ed25519PrivateKey) -\u003e V3OnionServiceId {\n        Self::from_public_key(\u0026Ed25519PublicKey::from_private_key(private_key))\n    }\n\n    /// Determine if the provided string is a valid representation of a `V3OnionServiceId`\n    pub fn is_valid(service_id: \u0026str) -\u003e bool {\n        if service_id.len() != V3_ONION_SERVICE_ID_STRING_LENGTH {\n            return false;\n        }\n\n        let mut decoded_service_id = [0u8; V3_ONION_SERVICE_ID_RAW_SIZE];\n        match ONION_BASE32.decode_mut(service_id.as_bytes(), \u0026mut decoded_service_id) {\n            Ok(decoded_byte_count) =\u003e {\n                // ensure right size\n                if decoded_byte_count != V3_ONION_SERVICE_ID_RAW_SIZE {\n                    return false;\n                }\n                // ensure correct version\n                if decoded_service_id[V3_ONION_SERVICE_ID_VERSION_OFFSET] != 0x03 {\n                    return false;\n                }\n                // copy public key into own buffer\n                let mut public_key = [0u8; ED25519_PUBLIC_KEY_SIZE];\n                public_key[..].copy_from_slice(\u0026decoded_service_id[..ED25519_PUBLIC_KEY_SIZE]);\n                // ensure checksum is correct\n                let truncated_checksum = Self::calc_truncated_checksum(\u0026public_key);\n                if truncated_checksum[0] != decoded_service_id[V3_ONION_SERVICE_ID_CHECKSUM_OFFSET]\n                    || truncated_checksum[1]\n                        != decoded_service_id[V3_ONION_SERVICE_ID_CHECKSUM_OFFSET + 1]\n                {\n                    return false;\n                }\n                true\n            }\n            Err(_) =\u003e false,\n        }\n    }\n\n    /// View this service id as an array of bytes\n    pub fn as_bytes(\u0026self) -\u003e \u0026[u8; V3_ONION_SERVICE_ID_STRING_LENGTH] {\n        \u0026self.data\n    }\n}\n\nimpl std::fmt::Display for V3OnionServiceId {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        unsafe { write!(f, \"{}\", str::from_utf8_unchecked(\u0026self.data)) }\n    }\n}\n\nimpl std::fmt::Debug for V3OnionServiceId {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        unsafe { write!(f, \"{}\", str::from_utf8_unchecked(\u0026self.data)) }\n    }\n}\n","traces":[{"line":114,"address":[5604848],"length":1,"stats":{"Line":3}},{"line":115,"address":[2665240],"length":1,"stats":{"Line":3}},{"line":116,"address":[3530192,3530201],"length":1,"stats":{"Line":6}},{"line":173,"address":[5604928],"length":1,"stats":{"Line":3}},{"line":174,"address":[1810265],"length":1,"stats":{"Line":3}},{"line":175,"address":[1810280],"length":1,"stats":{"Line":1}},{"line":176,"address":[1712255],"length":1,"stats":{"Line":3}},{"line":182,"address":[5604976],"length":1,"stats":{"Line":2}},{"line":183,"address":[1712281],"length":1,"stats":{"Line":2}},{"line":184,"address":[3618120],"length":1,"stats":{"Line":1}},{"line":185,"address":[1712303],"length":1,"stats":{"Line":2}},{"line":191,"address":[2665392],"length":1,"stats":{"Line":2}},{"line":192,"address":[1712341,1712332],"length":1,"stats":{"Line":3}},{"line":193,"address":[3495143],"length":1,"stats":{"Line":2}},{"line":195,"address":[1712336],"length":1,"stats":{"Line":1}},{"line":215,"address":[3618192,3618348],"length":1,"stats":{"Line":5}},{"line":216,"address":[1712389],"length":1,"stats":{"Line":5}},{"line":217,"address":[1810429],"length":1,"stats":{"Line":5}},{"line":220,"address":[5644869],"length":1,"stats":{"Line":5}},{"line":224,"address":[3495360],"length":1,"stats":{"Line":4}},{"line":229,"address":[1712581],"length":1,"stats":{"Line":4}},{"line":234,"address":[1810972,1810656],"length":1,"stats":{"Line":2}},{"line":235,"address":[3618706],"length":1,"stats":{"Line":0}},{"line":240,"address":[5645096],"length":1,"stats":{"Line":3}},{"line":241,"address":[2665890],"length":1,"stats":{"Line":9}},{"line":242,"address":[5605874],"length":1,"stats":{"Line":0}},{"line":244,"address":[3495841],"length":1,"stats":{"Line":3}},{"line":245,"address":[5645585],"length":1,"stats":{"Line":3}},{"line":246,"address":[2666319],"length":1,"stats":{"Line":1}},{"line":251,"address":[1810992,1811351,1811454],"length":1,"stats":{"Line":12}},{"line":252,"address":[5645805],"length":1,"stats":{"Line":4}},{"line":254,"address":[2666501],"length":1,"stats":{"Line":0}},{"line":261,"address":[3496352],"length":1,"stats":{"Line":3}},{"line":262,"address":[5606272],"length":1,"stats":{"Line":3}},{"line":265,"address":[5648561,5646048],"length":1,"stats":{"Line":2}},{"line":269,"address":[5606346],"length":1,"stats":{"Line":2}},{"line":270,"address":[2667024,2667176],"length":1,"stats":{"Line":0}},{"line":273,"address":[2666891],"length":1,"stats":{"Line":0}},{"line":277,"address":[5646119],"length":1,"stats":{"Line":2}},{"line":278,"address":[5646869,5647036],"length":1,"stats":{"Line":0}},{"line":280,"address":[1714282],"length":1,"stats":{"Line":0}},{"line":284,"address":[3497508],"length":1,"stats":{"Line":2}},{"line":285,"address":[3497775,3497602],"length":1,"stats":{"Line":4}},{"line":286,"address":[3497837],"length":1,"stats":{"Line":2}},{"line":288,"address":[3622104,3621978],"length":1,"stats":{"Line":0}},{"line":294,"address":[3498087],"length":1,"stats":{"Line":2}},{"line":295,"address":[1813354],"length":1,"stats":{"Line":2}},{"line":297,"address":[3621235],"length":1,"stats":{"Line":2}},{"line":299,"address":[1715836,1715978],"length":1,"stats":{"Line":0}},{"line":306,"address":[5608380],"length":1,"stats":{"Line":2}},{"line":310,"address":[2669488],"length":1,"stats":{"Line":1}},{"line":311,"address":[5609142],"length":1,"stats":{"Line":1}},{"line":318,"address":[3622304],"length":1,"stats":{"Line":1}},{"line":319,"address":[3622326],"length":1,"stats":{"Line":1}},{"line":323,"address":[2670374,2670557,2669616],"length":1,"stats":{"Line":3}},{"line":326,"address":[2669668,2670502],"length":1,"stats":{"Line":3}},{"line":329,"address":[5609601],"length":1,"stats":{"Line":3}},{"line":330,"address":[3499493],"length":1,"stats":{"Line":3}},{"line":333,"address":[2669771],"length":1,"stats":{"Line":3}},{"line":334,"address":[3622703],"length":1,"stats":{"Line":1}},{"line":335,"address":[1716857],"length":1,"stats":{"Line":3}},{"line":336,"address":[5649205],"length":1,"stats":{"Line":0}},{"line":337,"address":[3499823,3499949],"length":1,"stats":{"Line":0}},{"line":345,"address":[1815348],"length":1,"stats":{"Line":0}},{"line":346,"address":[5649171],"length":1,"stats":{"Line":0}},{"line":352,"address":[1717488,1717859],"length":1,"stats":{"Line":4}},{"line":353,"address":[1717518],"length":1,"stats":{"Line":4}},{"line":354,"address":[5610281],"length":1,"stats":{"Line":4}},{"line":356,"address":[2670929],"length":1,"stats":{"Line":4}},{"line":362,"address":[3500720],"length":1,"stats":{"Line":3}},{"line":363,"address":[3623772],"length":1,"stats":{"Line":3}},{"line":368,"address":[5650448],"length":1,"stats":{"Line":3}},{"line":369,"address":[5650465],"length":1,"stats":{"Line":3}},{"line":379,"address":[1816080],"length":1,"stats":{"Line":1}},{"line":380,"address":[5610785],"length":1,"stats":{"Line":1}},{"line":385,"address":[3501163,3501134,3500944],"length":1,"stats":{"Line":2}},{"line":386,"address":[1816201],"length":1,"stats":{"Line":2}},{"line":387,"address":[1718181],"length":1,"stats":{"Line":2}},{"line":394,"address":[3624208],"length":1,"stats":{"Line":0}},{"line":395,"address":[1718354],"length":1,"stats":{"Line":0}},{"line":402,"address":[2671520],"length":1,"stats":{"Line":3}},{"line":403,"address":[1816559],"length":1,"stats":{"Line":3}},{"line":404,"address":[1718425],"length":1,"stats":{"Line":3}},{"line":405,"address":[3624321],"length":1,"stats":{"Line":3}},{"line":406,"address":[1816639],"length":1,"stats":{"Line":0}},{"line":412,"address":[2671776,2673113],"length":1,"stats":{"Line":3}},{"line":414,"address":[5651174],"length":1,"stats":{"Line":3}},{"line":415,"address":[3501647,3501547],"length":1,"stats":{"Line":6}},{"line":417,"address":[3624733],"length":1,"stats":{"Line":3}},{"line":419,"address":[1719853,1719727],"length":1,"stats":{"Line":0}},{"line":425,"address":[5611653],"length":1,"stats":{"Line":3}},{"line":426,"address":[3502286,3502453],"length":1,"stats":{"Line":0}},{"line":433,"address":[1817117],"length":1,"stats":{"Line":3}},{"line":440,"address":[5612784],"length":1,"stats":{"Line":4}},{"line":442,"address":[1720070],"length":1,"stats":{"Line":4}},{"line":446,"address":[3626000],"length":1,"stats":{"Line":3}},{"line":450,"address":[3503019],"length":1,"stats":{"Line":3}},{"line":451,"address":[2673490],"length":1,"stats":{"Line":3}},{"line":452,"address":[1818333],"length":1,"stats":{"Line":0}},{"line":453,"address":[5652720],"length":1,"stats":{"Line":0}},{"line":460,"address":[3503328],"length":1,"stats":{"Line":5}},{"line":461,"address":[3503333],"length":1,"stats":{"Line":5}},{"line":466,"address":[1818576],"length":1,"stats":{"Line":1}},{"line":467,"address":[1720510],"length":1,"stats":{"Line":1}},{"line":472,"address":[3626400],"length":1,"stats":{"Line":0}},{"line":473,"address":[1818622],"length":1,"stats":{"Line":0}},{"line":481,"address":[5653056],"length":1,"stats":{"Line":3}},{"line":483,"address":[1818675],"length":1,"stats":{"Line":3}},{"line":484,"address":[3626456],"length":1,"stats":{"Line":3}},{"line":489,"address":[1720672],"length":1,"stats":{"Line":3}},{"line":490,"address":[5653209],"length":1,"stats":{"Line":3}},{"line":494,"address":[5613484],"length":1,"stats":{"Line":3}},{"line":496,"address":[5613513],"length":1,"stats":{"Line":1}},{"line":500,"address":[3626656,3626921],"length":1,"stats":{"Line":3}},{"line":506,"address":[2673986],"length":1,"stats":{"Line":3}},{"line":507,"address":[1819020,1819095],"length":1,"stats":{"Line":6}},{"line":509,"address":[5613718],"length":1,"stats":{"Line":0}},{"line":513,"address":[5613824],"length":1,"stats":{"Line":2}},{"line":514,"address":[5613841],"length":1,"stats":{"Line":2}},{"line":519,"address":[3626992],"length":1,"stats":{"Line":1}},{"line":520,"address":[1721134],"length":1,"stats":{"Line":1}},{"line":525,"address":[3627024],"length":1,"stats":{"Line":0}},{"line":526,"address":[3504014],"length":1,"stats":{"Line":0}},{"line":533,"address":[3627056],"length":1,"stats":{"Line":3}},{"line":534,"address":[5613950],"length":1,"stats":{"Line":3}},{"line":536,"address":[3627080],"length":1,"stats":{"Line":3}},{"line":543,"address":[5614032],"length":1,"stats":{"Line":1}},{"line":545,"address":[2674509,2674430],"length":1,"stats":{"Line":1}},{"line":546,"address":[5653972],"length":1,"stats":{"Line":1}},{"line":547,"address":[2674540],"length":1,"stats":{"Line":1}},{"line":550,"address":[1819406],"length":1,"stats":{"Line":0}},{"line":560,"address":[2676400,2674688],"length":1,"stats":{"Line":1}},{"line":562,"address":[1819675],"length":1,"stats":{"Line":1}},{"line":563,"address":[5614687,5614836],"length":1,"stats":{"Line":0}},{"line":566,"address":[1819882],"length":1,"stats":{"Line":0}},{"line":570,"address":[1722221,1721624],"length":1,"stats":{"Line":2}},{"line":571,"address":[2675403],"length":1,"stats":{"Line":1}},{"line":573,"address":[3506295,3506169],"length":1,"stats":{"Line":0}},{"line":579,"address":[3505372],"length":1,"stats":{"Line":1}},{"line":580,"address":[2675679],"length":1,"stats":{"Line":1}},{"line":582,"address":[5615396],"length":1,"stats":{"Line":1}},{"line":584,"address":[5655673,5655531],"length":1,"stats":{"Line":0}},{"line":591,"address":[5615593],"length":1,"stats":{"Line":1}},{"line":600,"address":[5656547,5656080],"length":1,"stats":{"Line":1}},{"line":601,"address":[5616387,5616577],"length":1,"stats":{"Line":1}},{"line":602,"address":[2676918,2677073],"length":1,"stats":{"Line":2}},{"line":606,"address":[1822160,1822297],"length":1,"stats":{"Line":3}},{"line":607,"address":[3629970,3630042],"length":1,"stats":{"Line":6}},{"line":611,"address":[5616992],"length":1,"stats":{"Line":0}},{"line":612,"address":[5617009],"length":1,"stats":{"Line":0}},{"line":617,"address":[1724240],"length":1,"stats":{"Line":0}},{"line":618,"address":[5656792],"length":1,"stats":{"Line":0}},{"line":623,"address":[2677472],"length":1,"stats":{"Line":0}},{"line":624,"address":[2677490],"length":1,"stats":{"Line":0}},{"line":631,"address":[2677536],"length":1,"stats":{"Line":4}},{"line":633,"address":[3630306],"length":1,"stats":{"Line":4}},{"line":638,"address":[5617248],"length":1,"stats":{"Line":3}},{"line":640,"address":[3507362],"length":1,"stats":{"Line":3}},{"line":651,"address":[1724592,1726479],"length":1,"stats":{"Line":1}},{"line":652,"address":[5657147],"length":1,"stats":{"Line":1}},{"line":653,"address":[5617844,5618025],"length":1,"stats":{"Line":0}},{"line":657,"address":[2678079],"length":1,"stats":{"Line":0}},{"line":661,"address":[5657906,5657176],"length":1,"stats":{"Line":2}},{"line":662,"address":[1725440],"length":1,"stats":{"Line":1}},{"line":664,"address":[3509420,3509546],"length":1,"stats":{"Line":0}},{"line":670,"address":[2678833],"length":1,"stats":{"Line":1}},{"line":671,"address":[2678868],"length":1,"stats":{"Line":1}},{"line":672,"address":[3508681],"length":1,"stats":{"Line":1}},{"line":674,"address":[1824508,1824366],"length":1,"stats":{"Line":0}},{"line":681,"address":[1726004],"length":1,"stats":{"Line":1}},{"line":685,"address":[2680102,2679952],"length":1,"stats":{"Line":3}},{"line":686,"address":[2679982,2680060],"length":1,"stats":{"Line":6}},{"line":690,"address":[1726960],"length":1,"stats":{"Line":2}},{"line":691,"address":[2680133],"length":1,"stats":{"Line":2}},{"line":696,"address":[5659520,5659787],"length":1,"stats":{"Line":0}},{"line":697,"address":[5659554,5659700],"length":1,"stats":{"Line":0}},{"line":704,"address":[3633200],"length":1,"stats":{"Line":5}},{"line":707,"address":[5659844],"length":1,"stats":{"Line":5}},{"line":710,"address":[5620111],"length":1,"stats":{"Line":6}},{"line":711,"address":[2680502],"length":1,"stats":{"Line":6}},{"line":712,"address":[1727326],"length":1,"stats":{"Line":6}},{"line":713,"address":[1825514],"length":1,"stats":{"Line":6}},{"line":715,"address":[1727455,1727593,1727518],"length":1,"stats":{"Line":10}},{"line":730,"address":[1727616],"length":1,"stats":{"Line":5}},{"line":731,"address":[3510571],"length":1,"stats":{"Line":5}},{"line":732,"address":[3510696,3510804],"length":1,"stats":{"Line":2}},{"line":737,"address":[5620959],"length":1,"stats":{"Line":5}},{"line":738,"address":[3510887],"length":1,"stats":{"Line":5}},{"line":743,"address":[1728208,1728719],"length":1,"stats":{"Line":4}},{"line":744,"address":[1826398],"length":1,"stats":{"Line":5}},{"line":746,"address":[5660831],"length":1,"stats":{"Line":5}},{"line":747,"address":[5621188],"length":1,"stats":{"Line":4}},{"line":748,"address":[2681591],"length":1,"stats":{"Line":4}},{"line":749,"address":[1826747,1826559],"length":1,"stats":{"Line":5}},{"line":750,"address":[5661047],"length":1,"stats":{"Line":5}},{"line":752,"address":[5661052],"length":1,"stats":{"Line":4}},{"line":754,"address":[3511536,3511440],"length":1,"stats":{"Line":4}},{"line":760,"address":[1728752],"length":1,"stats":{"Line":3}},{"line":761,"address":[5621608],"length":1,"stats":{"Line":3}},{"line":765,"address":[3634768,3635496],"length":1,"stats":{"Line":5}},{"line":766,"address":[3511777],"length":1,"stats":{"Line":5}},{"line":767,"address":[2682155],"length":1,"stats":{"Line":1}},{"line":770,"address":[3634822],"length":1,"stats":{"Line":5}},{"line":771,"address":[2682097,2682219],"length":1,"stats":{"Line":11}},{"line":772,"address":[1827242],"length":1,"stats":{"Line":5}},{"line":774,"address":[2682298],"length":1,"stats":{"Line":5}},{"line":775,"address":[1827278],"length":1,"stats":{"Line":0}},{"line":778,"address":[2682316,2682328],"length":1,"stats":{"Line":10}},{"line":779,"address":[5661769],"length":1,"stats":{"Line":1}},{"line":782,"address":[3635090],"length":1,"stats":{"Line":5}},{"line":783,"address":[2682423,2682357],"length":1,"stats":{"Line":10}},{"line":785,"address":[2682507],"length":1,"stats":{"Line":5}},{"line":786,"address":[1827508],"length":1,"stats":{"Line":5}},{"line":787,"address":[3635324,3635336,3635408],"length":1,"stats":{"Line":16}},{"line":788,"address":[3635347,3635421],"length":1,"stats":{"Line":6}},{"line":790,"address":[3512302],"length":1,"stats":{"Line":0}},{"line":792,"address":[1827652],"length":1,"stats":{"Line":5}},{"line":794,"address":[5621938],"length":1,"stats":{"Line":1}},{"line":799,"address":[1729568],"length":1,"stats":{"Line":3}},{"line":805,"address":[2682784],"length":1,"stats":{"Line":4}},{"line":806,"address":[3635558,3635673],"length":1,"stats":{"Line":8}},{"line":811,"address":[1827952],"length":1,"stats":{"Line":0}},{"line":812,"address":[2683129,2683014],"length":1,"stats":{"Line":0}}],"covered":177,"coverable":223},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","src","tor_provider.rs"],"content":"// standard\nuse std::any::Any;\nuse std::boxed::Box;\nuse std::convert::TryFrom;\nuse std::io::{Read, Write};\nuse std::net::{SocketAddr, TcpListener, TcpStream};\nuse std::ops::{Deref, DerefMut};\nuse std::str::FromStr;\nuse std::sync::OnceLock;\n\n// extern crates\nuse domain::base::name::Name;\nuse idna::uts46::{Hyphens, Uts46};\nuse idna::{domain_to_ascii_cow, AsciiDenyList};\nuse regex::Regex;\n\n// internal crates\nuse crate::tor_crypto::*;\n\n\n/// Various `tor_provider` errors.\n#[derive(thiserror::Error, Debug)]\npub enum Error {\n    #[error(\"Failed to parse '{0}' as {1}\")]\n    /// Failure parsing some string into a type\n    ParseFailure(String, String),\n\n    #[error(\"{0}\")]\n    /// Other miscellaneous error\n    Generic(String),\n}\n\n//\n// OnionAddr\n//\n\n/// A version 3 onion service address.\n///\n/// Version 3 Onion Service addresses const of a [`crate::tor_crypto::V3OnionServiceId`] and a 16-bit port number.\n#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]\npub struct OnionAddrV3 {\n    pub(crate) service_id: V3OnionServiceId,\n    pub(crate) virt_port: u16,\n}\n\nimpl OnionAddrV3 {\n    /// Create a new `OnionAddrV3` from a [`crate::tor_crypto::V3OnionServiceId`] and port number.\n    pub fn new(service_id: V3OnionServiceId, virt_port: u16) -\u003e OnionAddrV3 {\n        OnionAddrV3 {\n            service_id,\n            virt_port,\n        }\n    }\n\n    /// Return the service id associated with this onion address.\n    pub fn service_id(\u0026self) -\u003e \u0026V3OnionServiceId {\n        \u0026self.service_id\n    }\n\n    /// Return the port numebr associated with this onion address.\n    pub fn virt_port(\u0026self) -\u003e u16 {\n        self.virt_port\n    }\n}\n\nimpl std::fmt::Display for OnionAddrV3 {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        write!(f, \"{}.onion:{}\", self.service_id, self.virt_port)\n    }\n}\n\n/// An onion service address analog to [`std::net::SocketAddr`]\n#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]\npub enum OnionAddr {\n    V3(OnionAddrV3),\n}\n\nimpl FromStr for OnionAddr {\n    type Err = Error;\n    fn from_str(s: \u0026str) -\u003e Result\u003cSelf, Self::Err\u003e {\n        static ONION_SERVICE_PATTERN: OnceLock\u003cRegex\u003e = OnceLock::new();\n        let onion_service_pattern = ONION_SERVICE_PATTERN.get_or_init(|| {\n            Regex::new(r\"(?m)^(?P\u003cservice_id\u003e[a-z2-7]{56})\\.onion:(?P\u003cport\u003e[1-9][0-9]{0,4})$\")\n                .unwrap()\n        });\n\n        if let Some(caps) = onion_service_pattern.captures(s.to_lowercase().as_ref()) {\n            let service_id = caps\n                .name(\"service_id\")\n                .expect(\"missing service_id group\")\n                .as_str()\n                .to_lowercase();\n            let port = caps.name(\"port\").expect(\"missing port group\").as_str();\n            if let (Ok(service_id), Ok(port)) = (\n                V3OnionServiceId::from_string(service_id.as_ref()),\n                u16::from_str(port),\n            ) {\n                return Ok(OnionAddr::V3(OnionAddrV3::new(service_id, port)));\n            }\n        }\n        Err(Self::Err::ParseFailure(s.to_string(), \"OnionAddr\".to_string()))\n    }\n}\n\nimpl std::fmt::Display for OnionAddr {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        match self {\n            OnionAddr::V3(onion_addr) =\u003e onion_addr.fmt(f),\n        }\n    }\n}\n\n//\n// DomainAddr\n//\n\n/// A domain name analog to `std::net::SocketAddr`\n///\n/// A `DomainAddr` must not end in \".onion\"\n#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]\npub struct DomainAddr {\n    domain: String,\n    port: u16,\n}\n\n/// A `DomainAddr` has a domain name (scuh as `www.example.com`) and a port\nimpl DomainAddr {\n    /// Returns the domain name associated with this domain address.\n    pub fn domain(\u0026self) -\u003e \u0026str {\n        self.domain.as_ref()\n    }\n\n    /// Returns the port number associated with this domain address.\n    pub fn port(\u0026self) -\u003e u16 {\n        self.port\n    }\n}\n\nimpl std::fmt::Display for DomainAddr {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        let uts46: Uts46 = Default::default();\n        let (ui_str, _err) = uts46.to_user_interface(\n            self.domain.as_str().as_bytes(),\n            AsciiDenyList::URL,\n            Hyphens::Allow,\n            |_, _, _| -\u003e bool { false },\n        );\n        write!(f, \"{}:{}\", ui_str, self.port)\n    }\n}\n\nimpl TryFrom\u003c(String, u16)\u003e for DomainAddr {\n    type Error = Error;\n\n    fn try_from(value: (String, u16)) -\u003e Result\u003cSelf, Self::Error\u003e {\n        let (domain, port) = (\u0026value.0, value.1);\n        if let Ok(domain) = domain_to_ascii_cow(domain.as_bytes(), AsciiDenyList::URL) {\n            let domain = domain.to_string();\n            if let Ok(domain) = Name::\u003cVec\u003cu8\u003e\u003e::from_str(domain.as_ref()) {\n                let domain = domain.to_string();\n                if !domain.ends_with(\".onion\") {\n                    return Ok(Self {\n                        domain,\n                        port,\n                    });\n                }\n            }\n        }\n        Err(Self::Error::ParseFailure(format!(\n            \"{}:{}\",\n            domain, port\n        ), \"DomainAddr\".to_string()))\n    }\n}\n\nimpl FromStr for DomainAddr {\n    type Err = Error;\n    fn from_str(s: \u0026str) -\u003e Result\u003cSelf, Self::Err\u003e {\n        static DOMAIN_PATTERN: OnceLock\u003cRegex\u003e = OnceLock::new();\n        let domain_pattern = DOMAIN_PATTERN\n            .get_or_init(|| Regex::new(r\"(?m)^(?P\u003cdomain\u003e.*):(?P\u003cport\u003e[1-9][0-9]{0,4})$\").unwrap());\n        if let Some(caps) = domain_pattern.captures(s) {\n            let domain = caps\n                .name(\"domain\")\n                .expect(\"missing domain group\")\n                .as_str()\n                .to_string();\n            let port = caps.name(\"port\").expect(\"missing port group\").as_str();\n            if let Ok(port) = u16::from_str(port) {\n                return Self::try_from((domain, port));\n            }\n        }\n        Err(Self::Err::ParseFailure(s.to_string(), \"DomainAddr\".to_string()))\n    }\n}\n\n//\n// TargetAddr\n//\n\n/// An enum representing the various types of addresses a [`TorProvider`] implementation may connect to.\n#[derive(Clone, Debug)]\npub enum TargetAddr {\n    /// An ip address and port\n    Socket(std::net::SocketAddr),\n    /// An onion-service id and virtual port\n    OnionService(OnionAddr),\n    /// A domain name and port\n    Domain(DomainAddr),\n}\n\nimpl From\u003c(V3OnionServiceId, u16)\u003e for TargetAddr {\n    fn from(target_tuple: (V3OnionServiceId, u16)) -\u003e Self {\n        TargetAddr::OnionService(OnionAddr::V3(OnionAddrV3::new(\n            target_tuple.0,\n            target_tuple.1,\n        )))\n    }\n}\n\nimpl FromStr for TargetAddr {\n    type Err = Error;\n    fn from_str(s: \u0026str) -\u003e Result\u003cSelf, Self::Err\u003e {\n        if let Ok(socket_addr) = SocketAddr::from_str(s) {\n            return Ok(TargetAddr::Socket(socket_addr));\n        } else if let Ok(onion_addr) = OnionAddr::from_str(s) {\n            return Ok(TargetAddr::OnionService(onion_addr));\n        } else if let Ok(domain_addr) = DomainAddr::from_str(s) {\n            return Ok(TargetAddr::Domain(domain_addr));\n        }\n        Err(Self::Err::ParseFailure(s.to_string(), \"TargetAddr\".to_string()))\n    }\n}\n\nimpl std::fmt::Display for TargetAddr {\n    fn fmt(\u0026self, f: \u0026mut std::fmt::Formatter\u003c'_\u003e) -\u003e std::fmt::Result {\n        match self {\n            TargetAddr::Socket(socket_addr) =\u003e socket_addr.fmt(f),\n            TargetAddr::OnionService(onion_addr) =\u003e onion_addr.fmt(f),\n            TargetAddr::Domain(domain_addr) =\u003e domain_addr.fmt(f),\n        }\n    }\n}\n\n/// Various events possibly returned by a [`TorProvider`] implementation's `update()` method.\n#[derive(Debug)]\npub enum TorEvent {\n    /// A status update received connecting to the Tor Network.\n    BootstrapStatus {\n        /// A number from 0 to 100 for how through the bootstrap process the `TorProvider` is.\n        progress: u32,\n        /// A short string to identify the current phase of the bootstrap process.\n        tag: String,\n        /// A longer string with a summary of the current phase of the bootstrap process.\n        summary: String,\n    },\n    /// Indicates successful connection to the Tor Network. The [`TorProvider::connect()`] and [`TorProvider::listener()`] methods may now be used.\n    BootstrapComplete,\n    /// Messages which may be useful for troubleshooting.\n    LogReceived {\n        /// A message\n        line: String,\n    },\n    /// An onion-service has been published to the Tor Network and may now be reachable by clients.\n    OnionServicePublished {\n        /// The service-id of the onion-service which has been published.\n        service_id: V3OnionServiceId,\n    },\n}\n\n/// A `CircuitToken` is used to specify circuits used to connect to clearnet services.\npub type CircuitToken = usize;\n\n//\n// Onion Stream\n//\n\n/// A wrapper around a [`std::net::TcpStream`] with some Tor-specific customisations\n///\n/// An onion-listener can be constructed using the [`TorProvider::connect()`] method.\npub struct OnionStream {\n    pub(crate) stream: TcpStream,\n    pub(crate) local_addr: Option\u003cOnionAddr\u003e,\n    pub(crate) peer_addr: Option\u003cTargetAddr\u003e,\n}\n\nimpl Deref for OnionStream {\n    type Target = TcpStream;\n    fn deref(\u0026self) -\u003e \u0026Self::Target {\n        \u0026self.stream\n    }\n}\n\nimpl DerefMut for OnionStream {\n    fn deref_mut(\u0026mut self) -\u003e \u0026mut Self::Target {\n        \u0026mut self.stream\n    }\n}\n\nimpl From\u003cOnionStream\u003e for TcpStream {\n    fn from(onion_stream: OnionStream) -\u003e Self {\n        onion_stream.stream\n    }\n}\n\nimpl Read for OnionStream {\n    fn read(\u0026mut self, buf: \u0026mut [u8]) -\u003e Result\u003cusize, std::io::Error\u003e {\n        self.stream.read(buf)\n    }\n}\n\nimpl Write for OnionStream {\n    fn write(\u0026mut self, buf: \u0026[u8]) -\u003e Result\u003cusize, std::io::Error\u003e {\n        self.stream.write(buf)\n    }\n\n    fn flush(\u0026mut self) -\u003e Result\u003c(), std::io::Error\u003e {\n        self.stream.flush()\n    }\n}\n\nimpl OnionStream {\n    /// Returns the target address of the remote peer of this onion connection.\n    pub fn peer_addr(\u0026self) -\u003e Option\u003cTargetAddr\u003e {\n        self.peer_addr.clone()\n    }\n\n    /// Returns the onion address of the local connection for an incoming onion-service connection. Returns `None` for outgoing connections.\n    pub fn local_addr(\u0026self) -\u003e Option\u003cOnionAddr\u003e {\n        self.local_addr.clone()\n    }\n\n    /// Tries to clone the underlying connection and data. A simple pass-through to [`std::net::TcpStream::try_clone()`].\n    pub fn try_clone(\u0026self) -\u003e Result\u003cSelf, std::io::Error\u003e {\n        Ok(Self {\n            stream: self.stream.try_clone()?,\n            local_addr: self.local_addr.clone(),\n            peer_addr: self.peer_addr.clone(),\n        })\n    }\n}\n\n//\n// Onion Listener\n//\n\n/// A wrapper around a [`std::net::TcpListener`] with some Tor-specific customisations.\n///\n/// An onion-listener can be constructed using the [`TorProvider::listener()`] method.\npub struct OnionListener {\n    pub(crate) listener: TcpListener,\n    pub(crate) onion_addr: OnionAddr,\n    pub(crate) data: Option\u003cBox\u003cdyn Any + Send\u003e\u003e,\n    pub(crate) drop: Option\u003cBox\u003cdyn FnMut(Box\u003cdyn Any\u003e) + Send\u003e\u003e,\n}\n\nimpl OnionListener {\n    /// Construct an `OnionListener`. The `data` and `drop` parameters are to allow custom `TorProvider` implementations their own data and cleanup procedures.\n    pub(crate) fn new\u003cT: 'static + Send\u003e(\n        listener: TcpListener,\n        onion_addr: OnionAddr,\n        data: T,\n        mut drop: impl FnMut(T) + 'static + Send) -\u003e Self {\n        // marshall our data into an Any\n        let data: Option\u003cBox\u003cdyn Any + Send\u003e\u003e = Some(Box::new(data));\n        // marhsall our drop into a function which takes an Any\n        let drop: Option\u003cBox\u003cdyn FnMut(Box\u003cdyn Any\u003e) + Send\u003e\u003e  = Some(Box::new(move |data: Box\u003cdyn std::any::Any\u003e| {\n            // encapsulate extracting our data from the Any\n            if let Ok(data) = data.downcast::\u003cT\u003e() {\n                // and call our provided drop\n                drop(*data);\n            }\n        }));\n\n        Self{\n            listener,\n            onion_addr,\n            data,\n            drop,\n        }\n    }\n\n    /// Moves the underlying `TcpListener` into or out of nonblocking mode.\n    pub fn set_nonblocking(\u0026self, nonblocking: bool) -\u003e Result\u003c(), std::io::Error\u003e {\n        self.listener.set_nonblocking(nonblocking)\n    }\n\n    /// Accept a new incoming connection from this listener.\n    pub fn accept(\u0026self) -\u003e Result\u003cOption\u003cOnionStream\u003e, std::io::Error\u003e {\n        match self.listener.accept() {\n            Ok((stream, _socket_addr)) =\u003e Ok(Some(OnionStream {\n                stream,\n                local_addr: Some(self.onion_addr.clone()),\n                peer_addr: None,\n            })),\n            Err(err) =\u003e {\n                if err.kind() == std::io::ErrorKind::WouldBlock {\n                    Ok(None)\n                } else {\n                    Err(err)\n                }\n            }\n        }\n    }\n}\n\nimpl Drop for OnionListener {\n    fn drop(\u0026mut self) {\n        if let (Some(data), Some(mut drop)) = (self.data.take(), self.drop.take()) {\n            drop(data)\n        }\n    }\n}\n\n/// The `TorProvider` trait allows for high-level Tor Network functionality. Implementations ay connect to the Tor Network, anonymously connect to both clearnet and onion-service endpoints, and host onion-services.\npub trait TorProvider: Send {\n    /// Process and return `TorEvent`s handled by this `TorProvider`.\n    fn update(\u0026mut self) -\u003e Result\u003cVec\u003cTorEvent\u003e, Error\u003e;\n    /// Begin connecting to the Tor Network.\n    fn bootstrap(\u0026mut self) -\u003e Result\u003c(), Error\u003e;\n    /// Add v3 onion-service authorisation credentials, allowing this `TorProvider` to connect to an onion-service whose service-descriptor is encrypted using the assocciated x25519 public key.\n    fn add_client_auth(\n        \u0026mut self,\n        service_id: \u0026V3OnionServiceId,\n        client_auth: \u0026X25519PrivateKey,\n    ) -\u003e Result\u003c(), Error\u003e;\n    /// Remove a previously added client authorisation credential. This `TorProvider` will be unable to connect to the onion-service associated with the removed credentail.\n    fn remove_client_auth(\u0026mut self, service_id: \u0026V3OnionServiceId) -\u003e Result\u003c(), Error\u003e;\n    /// Anonymously connect to the address specified by `target` over the Tor Network and return the associated [`OnionStream`].\n    ///\n    /// When conecting to clearnet targets, an optional [`CircuitToken`] may be used to enforce usage of different circuits through the Tor Network. If `circuit` is `None`, the default circuit is used.\n    ///\n    ///Connections made with different `CircuitToken`s are required to use different circuits through the Tor Network. However, connections made with identical `CircuitToken`s are *not* required to use identical circuits through the Tor Network.\n    ///\n    /// Specifying a circuit token when connecting to an onion-service has no effect on the resulting circuit.\n    fn connect(\n        \u0026mut self,\n        target: TargetAddr,\n        circuit: Option\u003cCircuitToken\u003e,\n    ) -\u003e Result\u003cOnionStream, Error\u003e;\n    /// Anonymously start an onion-service and return the associated [`OnionListener`].\n    ///\n    ///The resulting onion-service will not be reachable by clients until [`TorProvider::update()`] returns a [`TorEvent::OnionServicePublished`] event. The optional `authorised_clients` parameter may be used to require client authorisation keys to connect to resulting onion-service. For further information, see the Tor Project's onion-services [client-auth documentation](https://community.torproject.org/onion-services/advanced/client-auth).\n    fn listener(\n        \u0026mut self,\n        private_key: \u0026Ed25519PrivateKey,\n        virt_port: u16,\n        authorised_clients: Option\u003c\u0026[X25519PublicKey]\u003e,\n    ) -\u003e Result\u003cOnionListener, Error\u003e;\n    /// Create a new [`CircuitToken`].\n    fn generate_token(\u0026mut self) -\u003e CircuitToken;\n    /// Releaes a previously generated [`CircuitToken`].\n    fn release_token(\u0026mut self, token: CircuitToken);\n}\n","traces":[{"line":48,"address":[2768032],"length":1,"stats":{"Line":2}},{"line":56,"address":[5748688],"length":1,"stats":{"Line":0}},{"line":61,"address":[2768112],"length":1,"stats":{"Line":0}},{"line":62,"address":[5748709],"length":1,"stats":{"Line":0}},{"line":67,"address":[1738048],"length":1,"stats":{"Line":1}},{"line":68,"address":[3597000,3597084],"length":1,"stats":{"Line":2}},{"line":80,"address":[3598593,3597184,3598929],"length":1,"stats":{"Line":1}},{"line":82,"address":[1546736],"length":1,"stats":{"Line":2}},{"line":83,"address":[2601198],"length":1,"stats":{"Line":1}},{"line":87,"address":[3597277,3597400],"length":1,"stats":{"Line":2}},{"line":88,"address":[5749467,5749353],"length":1,"stats":{"Line":2}},{"line":93,"address":[1738887,1738966],"length":1,"stats":{"Line":2}},{"line":94,"address":[1913171,1913269,1913341],"length":1,"stats":{"Line":3}},{"line":95,"address":[3720967],"length":1,"stats":{"Line":1}},{"line":96,"address":[2769294,2769231],"length":1,"stats":{"Line":2}},{"line":98,"address":[1739377,1739412,1739468],"length":1,"stats":{"Line":3}},{"line":101,"address":[3598696,3598747],"length":1,"stats":{"Line":1}},{"line":106,"address":[1740064],"length":1,"stats":{"Line":1}},{"line":108,"address":[3598957],"length":1,"stats":{"Line":1}},{"line":129,"address":[5711072],"length":1,"stats":{"Line":0}},{"line":130,"address":[3722021],"length":1,"stats":{"Line":0}},{"line":134,"address":[5750832],"length":1,"stats":{"Line":0}},{"line":135,"address":[5750837],"length":1,"stats":{"Line":0}},{"line":140,"address":[5751511,5750848],"length":1,"stats":{"Line":1}},{"line":141,"address":[1914145],"length":1,"stats":{"Line":1}},{"line":142,"address":[2770410],"length":1,"stats":{"Line":1}},{"line":143,"address":[5750900],"length":1,"stats":{"Line":1}},{"line":145,"address":[1740290],"length":1,"stats":{"Line":1}},{"line":146,"address":[2601424,2601458],"length":1,"stats":{"Line":2}},{"line":148,"address":[3599550,3599460],"length":1,"stats":{"Line":2}},{"line":155,"address":[2772036,2772772,2770944],"length":1,"stats":{"Line":1}},{"line":156,"address":[2770966],"length":1,"stats":{"Line":1}},{"line":157,"address":[5751661,5751588],"length":1,"stats":{"Line":2}},{"line":158,"address":[3599963],"length":1,"stats":{"Line":1}},{"line":159,"address":[3600131,3600063],"length":1,"stats":{"Line":2}},{"line":160,"address":[1741365],"length":1,"stats":{"Line":1}},{"line":161,"address":[1915490,1915422],"length":1,"stats":{"Line":2}},{"line":162,"address":[5752304],"length":1,"stats":{"Line":1}},{"line":163,"address":[5712528],"length":1,"stats":{"Line":1}},{"line":169,"address":[1916269,1916482],"length":1,"stats":{"Line":2}},{"line":172,"address":[2772550],"length":1,"stats":{"Line":1}},{"line":178,"address":[5713648,5714535],"length":1,"stats":{"Line":1}},{"line":180,"address":[3724635],"length":1,"stats":{"Line":1}},{"line":181,"address":[5538480,5538701,5538494],"length":1,"stats":{"Line":3}},{"line":182,"address":[1742764],"length":1,"stats":{"Line":1}},{"line":183,"address":[3724802,3724913],"length":1,"stats":{"Line":2}},{"line":188,"address":[1743168,1743092],"length":1,"stats":{"Line":2}},{"line":189,"address":[1743261],"length":1,"stats":{"Line":1}},{"line":190,"address":[3725269],"length":1,"stats":{"Line":1}},{"line":193,"address":[1917646,1917601],"length":1,"stats":{"Line":1}},{"line":213,"address":[1917840],"length":1,"stats":{"Line":2}},{"line":214,"address":[1743883],"length":1,"stats":{"Line":2}},{"line":215,"address":[5714853],"length":1,"stats":{"Line":2}},{"line":223,"address":[3725920,3726825],"length":1,"stats":{"Line":1}},{"line":224,"address":[1918026],"length":1,"stats":{"Line":1}},{"line":225,"address":[1744105],"length":1,"stats":{"Line":1}},{"line":226,"address":[2774365,2774322],"length":1,"stats":{"Line":2}},{"line":227,"address":[5715243],"length":1,"stats":{"Line":1}},{"line":228,"address":[1744332,1744397],"length":1,"stats":{"Line":2}},{"line":229,"address":[3603403],"length":1,"stats":{"Line":1}},{"line":231,"address":[1918675],"length":1,"stats":{"Line":1}},{"line":236,"address":[5715904],"length":1,"stats":{"Line":0}},{"line":237,"address":[1744919],"length":1,"stats":{"Line":0}},{"line":238,"address":[1918976],"length":1,"stats":{"Line":0}},{"line":239,"address":[2775152],"length":1,"stats":{"Line":0}},{"line":240,"address":[3726976],"length":1,"stats":{"Line":0}},{"line":289,"address":[2775232],"length":1,"stats":{"Line":0}},{"line":290,"address":[5755832],"length":1,"stats":{"Line":0}},{"line":295,"address":[5755840],"length":1,"stats":{"Line":0}},{"line":296,"address":[2775256],"length":1,"stats":{"Line":0}},{"line":301,"address":[5202576],"length":1,"stats":{"Line":1}},{"line":302,"address":[2006401],"length":1,"stats":{"Line":1}},{"line":307,"address":[1745104],"length":1,"stats":{"Line":1}},{"line":308,"address":[3727074],"length":1,"stats":{"Line":1}},{"line":313,"address":[5716160],"length":1,"stats":{"Line":1}},{"line":314,"address":[2775330],"length":1,"stats":{"Line":1}},{"line":317,"address":[3604128],"length":1,"stats":{"Line":1}},{"line":318,"address":[2775365],"length":1,"stats":{"Line":1}},{"line":324,"address":[2775376],"length":1,"stats":{"Line":0}},{"line":325,"address":[5755985],"length":1,"stats":{"Line":0}},{"line":329,"address":[1919280],"length":1,"stats":{"Line":0}},{"line":330,"address":[1919297],"length":1,"stats":{"Line":0}},{"line":334,"address":[3727264,3727594],"length":1,"stats":{"Line":0}},{"line":335,"address":[5716556],"length":1,"stats":{"Line":0}},{"line":336,"address":[1919463,1919357],"length":1,"stats":{"Line":0}},{"line":337,"address":[5716427],"length":1,"stats":{"Line":0}},{"line":338,"address":[5716537],"length":1,"stats":{"Line":0}},{"line":359,"address":[3430395,3429360,3430422,3429904,3429851,3429878],"length":1,"stats":{"Line":4}},{"line":365,"address":[3552418,3552604,3553148,3552962],"length":1,"stats":{"Line":8}},{"line":367,"address":[1752982,1753979,1753526,1753696,1754064,1754358,1753389,1753990,1754347,1752845],"length":1,"stats":{"Line":12}},{"line":369,"address":[1548696,1548344],"length":1,"stats":{"Line":4}},{"line":371,"address":[3553558,3553623,3553926,3553991],"length":1,"stats":{"Line":8}},{"line":384,"address":[1745648],"length":1,"stats":{"Line":1}},{"line":385,"address":[3727637],"length":1,"stats":{"Line":1}},{"line":389,"address":[3727664,3728058],"length":1,"stats":{"Line":2}},{"line":390,"address":[3727694],"length":1,"stats":{"Line":2}},{"line":391,"address":[1745764,1745958],"length":1,"stats":{"Line":4}},{"line":392,"address":[1919827],"length":1,"stats":{"Line":2}},{"line":393,"address":[2775978,2776084],"length":1,"stats":{"Line":4}},{"line":394,"address":[1919980],"length":1,"stats":{"Line":2}},{"line":396,"address":[1919853],"length":1,"stats":{"Line":1}},{"line":397,"address":[1920262,1920189,1919882],"length":1,"stats":{"Line":2}},{"line":398,"address":[3605181],"length":1,"stats":{"Line":1}},{"line":400,"address":[1920237],"length":1,"stats":{"Line":0}},{"line":408,"address":[2582539,2582176],"length":1,"stats":{"Line":2}},{"line":409,"address":[3409840,3410070],"length":1,"stats":{"Line":4}},{"line":410,"address":[2582475],"length":1,"stats":{"Line":2}}],"covered":81,"coverable":107},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","tests","tor_crypto.rs"],"content":"// internal crates\nuse tor_interface::tor_crypto::*;\n\n#[test]\nfn test_crypto_ed25519() -\u003e Result\u003c(), anyhow::Error\u003e {\n    let private_key_blob = \"ED25519-V3:rP3u8mZaKohap0lKsB8Z8qXbXqK456JKKGONDBhV+gPBVKa2mHVQqnRTVuFXe3inU3YW6qvc7glYEwe9rK0LhQ==\";\n    let private_raw: [u8; ED25519_PRIVATE_KEY_SIZE] = [\n        0xacu8, 0xfdu8, 0xeeu8, 0xf2u8, 0x66u8, 0x5au8, 0x2au8, 0x88u8, 0x5au8, 0xa7u8, 0x49u8,\n        0x4au8, 0xb0u8, 0x1fu8, 0x19u8, 0xf2u8, 0xa5u8, 0xdbu8, 0x5eu8, 0xa2u8, 0xb8u8, 0xe7u8,\n        0xa2u8, 0x4au8, 0x28u8, 0x63u8, 0x8du8, 0x0cu8, 0x18u8, 0x55u8, 0xfau8, 0x03u8, 0xc1u8,\n        0x54u8, 0xa6u8, 0xb6u8, 0x98u8, 0x75u8, 0x50u8, 0xaau8, 0x74u8, 0x53u8, 0x56u8, 0xe1u8,\n        0x57u8, 0x7bu8, 0x78u8, 0xa7u8, 0x53u8, 0x76u8, 0x16u8, 0xeau8, 0xabu8, 0xdcu8, 0xeeu8,\n        0x09u8, 0x58u8, 0x13u8, 0x07u8, 0xbdu8, 0xacu8, 0xadu8, 0x0bu8, 0x85u8,\n    ];\n    let public_raw: [u8; ED25519_PUBLIC_KEY_SIZE] = [\n        0xf2u8, 0xfdu8, 0xa2u8, 0xdbu8, 0xf3u8, 0x80u8, 0xa6u8, 0xbau8, 0x74u8, 0xa4u8, 0x90u8,\n        0xe1u8, 0x45u8, 0x55u8, 0xeeu8, 0xb9u8, 0x32u8, 0xa0u8, 0x5cu8, 0x39u8, 0x5au8, 0xe2u8,\n        0x02u8, 0x83u8, 0x55u8, 0x27u8, 0x89u8, 0x6au8, 0x1fu8, 0x2fu8, 0x3du8, 0xc5u8,\n    ];\n    let service_id_string = \"6l62fw7tqctlu5fesdqukvpoxezkaxbzllrafa2ve6ewuhzphxczsjyd\";\n    assert!(V3OnionServiceId::is_valid(\u0026service_id_string));\n\n    let mut message = [0x00u8; 256];\n    let null_message = [0x00u8; 256];\n    for (i, ptr) in message.iter_mut().enumerate() {\n        *ptr = i as u8;\n    }\n    let signature_raw: [u8; ED25519_SIGNATURE_SIZE] = [\n        0xa6u8, 0xd6u8, 0xc6u8, 0x1au8, 0x03u8, 0xbcu8, 0x43u8, 0x6fu8, 0x38u8, 0x53u8, 0x94u8,\n        0xcdu8, 0xdcu8, 0x86u8, 0x0au8, 0x88u8, 0x64u8, 0x43u8, 0x1du8, 0x18u8, 0x84u8, 0x30u8,\n        0x2fu8, 0xcdu8, 0xa6u8, 0x79u8, 0xcau8, 0x87u8, 0xd0u8, 0x29u8, 0xe7u8, 0x2bu8, 0x32u8,\n        0x9bu8, 0xa2u8, 0xa4u8, 0x3cu8, 0x74u8, 0x6au8, 0x08u8, 0x67u8, 0x0eu8, 0x63u8, 0x60u8,\n        0xcbu8, 0x46u8, 0x22u8, 0x55u8, 0x43u8, 0x5bu8, 0x84u8, 0x68u8, 0x0fu8, 0x47u8, 0xceu8,\n        0x6cu8, 0xd2u8, 0xb8u8, 0xebu8, 0xfeu8, 0xf6u8, 0x9eu8, 0x97u8, 0x0au8,\n    ];\n\n    // test the golden path first\n    let service_id = V3OnionServiceId::from_string(\u0026service_id_string)?;\n\n    let private_key = Ed25519PrivateKey::from_raw(\u0026private_raw)?;\n    assert_eq!(\n        private_key,\n        Ed25519PrivateKey::from_key_blob(\u0026private_key_blob)?\n    );\n    assert_eq!(private_key_blob, private_key.to_key_blob());\n\n    let public_key = Ed25519PublicKey::from_raw(\u0026public_raw)?;\n    assert_eq!(public_key, Ed25519PublicKey::from_service_id(\u0026service_id)?);\n    assert_eq!(public_key, Ed25519PublicKey::from_private_key(\u0026private_key));\n    assert_eq!(service_id, V3OnionServiceId::from_public_key(\u0026public_key));\n\n    let signature = private_key.sign_message(\u0026message);\n    assert_eq!(signature, Ed25519Signature::from_raw(\u0026signature_raw)?);\n    assert!(signature.verify(\u0026message, \u0026public_key));\n    assert!(!signature.verify(\u0026null_message, \u0026public_key));\n\n    // some invalid service ids\n    assert!(!V3OnionServiceId::is_valid(\"\"));\n    assert!(!V3OnionServiceId::is_valid(\n        \"\n        aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"\n    ));\n    assert!(!V3OnionServiceId::is_valid(\n        \"6L62FW7TQCTLU5FESDQUKVPOXEZKAXBZLLRAFA2VE6EWUHZPHXCZSJYD\"\n    ));\n\n    // generate a new key, get the public key and sign/verify a message\n    let private_key = Ed25519PrivateKey::generate();\n    let public_key = Ed25519PublicKey::from_private_key(\u0026private_key);\n    let signature = private_key.sign_message(\u0026message);\n    assert!(signature.verify(\u0026message, \u0026public_key));\n\n    // test invalid private key blob returns an error\n    // https://gitlab.torproject.org/tpo/core/arti/-/issues/1021\n    let private_raw: [u8; ED25519_PRIVATE_KEY_SIZE] = [\n        0x2eu8, 0x26u8, 0x0au8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x0au8, 0x77u8, 0x77u8,\n        0x77u8, 0x77u8, 0x5du8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8,\n        0x82u8, 0xb4u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8,\n        0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0xffu8,\n        0xffu8, 0xffu8, 0xffu8, 0xffu8, 0xffu8, 0xffu8, 0xffu8, 0xffu8, 0xffu8, 0xffu8, 0xffu8,\n        0xffu8, 0xffu8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x77u8, 0x82u8, 0x88u8,\n    ];\n    match Ed25519PrivateKey::from_raw(\u0026private_raw) {\n        Ok(_) =\u003e panic!(\"invalid key accepted\"),\n        Err(tor_interface::tor_crypto::Error::KeyInvalid) =\u003e (),\n        Err(err) =\u003e panic!(\"unexpected error: {:?}\", err),\n    }\n\n    Ok(())\n}\n\n#[test]\nfn test_crypto_x25519() -\u003e Result\u003c(), anyhow::Error\u003e {\n    // private/public key pair\n    const SECRET_BASE64: \u0026str = \"0GeSReJXdNcgvWRQdnDXhJGdu5UiwP2fefgT93/oqn0=\";\n    const SECRET_RAW: [u8; X25519_PRIVATE_KEY_SIZE] = [\n        0xd0u8, 0x67u8, 0x92u8, 0x45u8, 0xe2u8, 0x57u8, 0x74u8, 0xd7u8, 0x20u8, 0xbdu8, 0x64u8,\n        0x50u8, 0x76u8, 0x70u8, 0xd7u8, 0x84u8, 0x91u8, 0x9du8, 0xbbu8, 0x95u8, 0x22u8, 0xc0u8,\n        0xfdu8, 0x9fu8, 0x79u8, 0xf8u8, 0x13u8, 0xf7u8, 0x7fu8, 0xe8u8, 0xaau8, 0x7du8,\n    ];\n    const PUBLIC_BASE32: \u0026str = \"AEXCBCEDJ5KU34YGGMZ7PVHVDEA7D7YB7VQAPJTMTZGRJLN3JASA\";\n    const PUBLIC_RAW: [u8; X25519_PUBLIC_KEY_SIZE] = [\n        0x01u8, 0x2eu8, 0x20u8, 0x88u8, 0x83u8, 0x4fu8, 0x55u8, 0x4du8, 0xf3u8, 0x06u8, 0x33u8,\n        0x33u8, 0xf7u8, 0xd4u8, 0xf5u8, 0x19u8, 0x01u8, 0xf1u8, 0xffu8, 0x01u8, 0xfdu8, 0x60u8,\n        0x07u8, 0xa6u8, 0x6cu8, 0x9eu8, 0x4du8, 0x14u8, 0xadu8, 0xbbu8, 0x48u8, 0x24u8,\n    ];\n\n    // ensure we can convert from raw as expected\n    assert_eq!(\n        \u0026X25519PrivateKey::from_raw(\u0026SECRET_RAW)?.to_base64(),\n        SECRET_BASE64\n    );\n    assert_eq!(\n        \u0026X25519PublicKey::from_raw(\u0026PUBLIC_RAW).to_base32(),\n        PUBLIC_BASE32\n    );\n\n    // ensure we can round-trip as expected\n    assert_eq!(\n        \u0026X25519PrivateKey::from_base64(\u0026SECRET_BASE64)?.to_base64(),\n        SECRET_BASE64\n    );\n    assert_eq!(\n        \u0026X25519PublicKey::from_base32(\u0026PUBLIC_BASE32)?.to_base32(),\n        PUBLIC_BASE32\n    );\n\n    // ensure we generate the expected public key from private key\n    let private_key = X25519PrivateKey::from_base64(\u0026SECRET_BASE64)?;\n    let public_key = X25519PublicKey::from_private_key(\u0026private_key);\n    assert_eq!(public_key.to_base32(), PUBLIC_BASE32);\n\n    let message = b\"All around me are familiar faces\";\n\n    let (signature, signbit) = private_key.sign_message(message)?;\n    assert!(signature.verify_x25519(message, \u0026public_key, signbit));\n\n    Ok(())\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","runner","work","gosling","gosling","source","gosling","crates","tor-interface","tests","tor_provider.rs"],"content":"// stanndard\n#[cfg(feature = \"legacy-tor-provider\")]\nuse std::fs::File;\nuse std::io::{Read, Write};\n#[cfg(feature = \"legacy-tor-provider\")]\nuse std::process;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse std::process::{Child, Command, Stdio};\nuse std::str::FromStr;\n#[cfg(feature = \"arti-client-tor-provider\")]\nuse std::sync::Arc;\n\n// extern crates\nuse serial_test::serial;\n#[cfg(feature = \"arti-client-tor-provider\")]\nuse tokio::runtime;\n\n// internal crates\n#[cfg(feature = \"arti-client-tor-provider\")]\nuse tor_interface::arti_client_tor_client::*;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse tor_interface::censorship_circumvention::*;\n#[cfg(feature = \"legacy-tor-provider\")]\nuse tor_interface::legacy_tor_client::*;\n#[cfg(feature = \"mock-tor-provider\")]\nuse tor_interface::mock_tor_client::*;\nuse tor_interface::tor_crypto::*;\nuse tor_interface::tor_provider::*;\n\n#[allow(dead_code)]\npub(crate) fn bootstrap_test(mut tor: Box\u003cdyn TorProvider\u003e) -\u003e anyhow::Result\u003c()\u003e {\n    tor.bootstrap()?;\n\n    let mut received_log = false;\n    let mut bootstrap_complete = false;\n    while !bootstrap_complete {\n        for event in tor.update()?.iter() {\n            match event {\n                TorEvent::BootstrapStatus {\n                    progress,\n                    tag,\n                    summary,\n                } =\u003e println!(\n                    \"BootstrapStatus: {{ progress: {}, tag: {}, summary: '{}' }}\",\n                    progress, tag, summary\n                ),\n                TorEvent::BootstrapComplete =\u003e {\n                    println!(\"Bootstrap Complete!\");\n                    bootstrap_complete = true;\n                }\n                TorEvent::LogReceived { line } =\u003e {\n                    received_log = true;\n                    println!(\"--- {}\", line);\n                }\n                _ =\u003e {}\n            }\n        }\n    }\n    assert!(\n        received_log,\n        \"should have received a log line from tor provider\"\n    );\n\n    Ok(())\n}\n\n#[allow(dead_code)]\npub(crate) fn basic_onion_service_test(\n    mut server_provider: Box\u003cdyn TorProvider\u003e,\n    mut client_provider: Box\u003cdyn TorProvider\u003e,\n) -\u003e anyhow::Result\u003c()\u003e {\n    server_provider.bootstrap()?;\n    client_provider.bootstrap()?;\n\n    let mut server_provider_bootstrap_complete = false;\n    let mut client_provider_bootstrap_complete = false;\n\n    while !server_provider_bootstrap_complete || !client_provider_bootstrap_complete {\n        for event in server_provider.update()?.iter() {\n            match event {\n                TorEvent::BootstrapStatus {\n                    progress,\n                    tag,\n                    summary,\n                } =\u003e println!(\n                    \"Server Provider BootstrapStatus: {{ progress: {}, tag: {}, summary: '{}' }}\",\n                    progress, tag, summary\n                ),\n                TorEvent::BootstrapComplete =\u003e {\n                    println!(\"Server Provider Bootstrap Complete!\");\n                    server_provider_bootstrap_complete = true;\n                }\n                TorEvent::LogReceived { line } =\u003e {\n                    println!(\"--- {}\", line);\n                }\n                _ =\u003e {}\n            }\n        }\n\n        for event in client_provider.update()?.iter() {\n            match event {\n                TorEvent::BootstrapStatus {\n                    progress,\n                    tag,\n                    summary,\n                } =\u003e println!(\n                    \"Client Provider BootstrapStatus: {{ progress: {}, tag: {}, summary: '{}' }}\",\n                    progress, tag, summary\n                ),\n                TorEvent::BootstrapComplete =\u003e {\n                    println!(\"Client Provider Bootstrap Complete!\");\n                    client_provider_bootstrap_complete = true;\n                }\n                TorEvent::LogReceived { line } =\u003e {\n                    println!(\"--- {}\", line);\n                }\n                _ =\u003e {}\n            }\n        }\n    }\n\n    // vanilla V3 onion service\n    {\n        let tor = \u0026mut server_provider;\n\n        // create an onion service for this test\n        let private_key = Ed25519PrivateKey::generate();\n\n        println!(\"Starting and listening to onion service\");\n        const VIRT_PORT: u16 = 42069u16;\n        let listener = tor.listener(\u0026private_key, VIRT_PORT, None)?;\n\n        let mut onion_published = false;\n        while !onion_published {\n            for event in tor.update()?.iter() {\n                match event {\n                    TorEvent::LogReceived { line } =\u003e {\n                        println!(\"--- {}\", line);\n                    }\n                    TorEvent::OnionServicePublished { service_id } =\u003e {\n                        let expected_service_id = V3OnionServiceId::from_private_key(\u0026private_key);\n                        if expected_service_id == *service_id {\n                            println!(\"Onion Service {} published\", service_id.to_string());\n                            onion_published = true;\n                        }\n                    }\n                    _ =\u003e {}\n                }\n            }\n        }\n\n        const MESSAGE: \u0026str = \"Hello World!\";\n\n        {\n            let tor = \u0026mut client_provider;\n            let service_id = V3OnionServiceId::from_private_key(\u0026private_key);\n\n            println!(\"Connecting to onion service\");\n            let mut attempt_count = 0;\n            let mut client = loop {\n                match tor.connect((service_id.clone(), VIRT_PORT).into(), None) {\n                    Ok(client) =\u003e break client,\n                    Err(err) =\u003e {\n                        println!(\"connect error: {:?}\", err);\n                        attempt_count += 1;\n                        if attempt_count == 3 {\n                            panic!(\"failed to connect :(\");\n                        }\n                    }\n                }\n            };\n            println!(\"Client writing message: '{}'\", MESSAGE);\n            client.write_all(MESSAGE.as_bytes())?;\n            client.flush()?;\n            println!(\"End of client scope\");\n        }\n\n        if let Some(mut server) = listener.accept()? {\n            println!(\"Server reading message\");\n            let mut buffer = Vec::new();\n            server.read_to_end(\u0026mut buffer)?;\n            let msg = String::from_utf8(buffer)?;\n\n            assert_eq!(MESSAGE, msg);\n            println!(\"Message received: '{}'\", msg);\n        } else {\n            panic!(\"no listener\");\n        }\n    }\n    Ok(())\n}\n\n#[allow(dead_code)]\npub(crate) fn authenticated_onion_service_test(\n    mut server_provider: Box\u003cdyn TorProvider\u003e,\n    mut client_provider: Box\u003cdyn TorProvider\u003e,\n) -\u003e anyhow::Result\u003c()\u003e {\n    server_provider.bootstrap()?;\n    client_provider.bootstrap()?;\n\n    let mut server_provider_bootstrap_complete = false;\n    let mut client_provider_bootstrap_complete = false;\n\n    while !server_provider_bootstrap_complete || !client_provider_bootstrap_complete {\n        for event in server_provider.update()?.iter() {\n            match event {\n                TorEvent::BootstrapStatus {\n                    progress,\n                    tag,\n                    summary,\n                } =\u003e println!(\n                    \"Server Provider BootstrapStatus: {{ progress: {}, tag: {}, summary: '{}' }}\",\n                    progress, tag, summary\n                ),\n                TorEvent::BootstrapComplete =\u003e {\n                    println!(\"Server Provider Bootstrap Complete!\");\n                    server_provider_bootstrap_complete = true;\n                }\n                TorEvent::LogReceived { line } =\u003e {\n                    println!(\"--- {}\", line);\n                }\n                _ =\u003e {}\n            }\n        }\n\n        for event in client_provider.update()?.iter() {\n            match event {\n                TorEvent::BootstrapStatus {\n                    progress,\n                    tag,\n                    summary,\n                } =\u003e println!(\n                    \"Client Provider BootstrapStatus: {{ progress: {}, tag: {}, summary: '{}' }}\",\n                    progress, tag, summary\n                ),\n                TorEvent::BootstrapComplete =\u003e {\n                    println!(\"Client Provider Bootstrap Complete!\");\n                    client_provider_bootstrap_complete = true;\n                }\n                TorEvent::LogReceived { line } =\u003e {\n                    println!(\"--- {}\", line);\n                }\n                _ =\u003e {}\n            }\n        }\n    }\n\n    // authenticated onion service\n    {\n        // create an onion service for this test\n        let private_key = Ed25519PrivateKey::generate();\n\n        let private_auth_key = X25519PrivateKey::generate();\n        let public_auth_key = X25519PublicKey::from_private_key(\u0026private_auth_key);\n\n        println!(\"Starting and listening to authenticated onion service\");\n        const VIRT_PORT: u16 = 42069u16;\n        let listener =\n            server_provider.listener(\u0026private_key, VIRT_PORT, Some(\u0026[public_auth_key]))?;\n\n        let mut onion_published = false;\n        while !onion_published {\n            for event in server_provider.update()?.iter() {\n                match event {\n                    TorEvent::LogReceived { line } =\u003e {\n                        println!(\"--- {}\", line);\n                    }\n                    TorEvent::OnionServicePublished { service_id } =\u003e {\n                        let expected_service_id = V3OnionServiceId::from_private_key(\u0026private_key);\n                        if expected_service_id == *service_id {\n                            println!(\n                                \"Authenticated Onion Service {} published\",\n                                service_id.to_string()\n                            );\n                            onion_published = true;\n                        }\n                    }\n                    _ =\u003e {}\n                }\n            }\n        }\n\n        const MESSAGE: \u0026str = \"Hello World!\";\n\n        {\n            let service_id = V3OnionServiceId::from_private_key(\u0026private_key);\n\n            println!(\"Connecting to onion service (should fail)\");\n            assert!(\n                client_provider\n                    .connect((service_id.clone(), VIRT_PORT).into(), None)\n                    .is_err(),\n                \"should not able to connect to an authenticated onion service without auth key\"\n            );\n\n            println!(\"Add auth key for onion service\");\n            client_provider.add_client_auth(\u0026service_id, \u0026private_auth_key)?;\n\n            println!(\"Connecting to onion service with authentication\");\n            let mut client =\n                client_provider.connect((service_id.clone(), VIRT_PORT).into(), None)?;\n\n            println!(\"Client writing message: '{}'\", MESSAGE);\n            client.write_all(MESSAGE.as_bytes())?;\n            client.flush()?;\n            println!(\"End of client scope\");\n\n            println!(\"Remove auth key for onion service\");\n            client_provider.remove_client_auth(\u0026service_id)?;\n        }\n\n        if let Some(mut server) = listener.accept()? {\n            println!(\"Server reading message\");\n            let mut buffer = Vec::new();\n            server.read_to_end(\u0026mut buffer)?;\n            let msg = String::from_utf8(buffer)?;\n\n            assert!(MESSAGE == msg);\n            println!(\"Message received: '{}'\", msg);\n        } else {\n            panic!(\"no listener\");\n        }\n    }\n    Ok(())\n}\n\n//\n// Mock TorProvider tests\n//\n\n#[test]\n#[cfg(feature = \"mock-tor-provider\")]\nfn test_mock_bootstrap() -\u003e anyhow::Result\u003c()\u003e {\n    bootstrap_test(Box::new(MockTorClient::new()))\n}\n\n#[test]\n#[cfg(feature = \"mock-tor-provider\")]\nfn test_mock_onion_service() -\u003e anyhow::Result\u003c()\u003e {\n    let server_provider = Box::new(MockTorClient::new());\n    let client_provider = Box::new(MockTorClient::new());\n    basic_onion_service_test(server_provider, client_provider)\n}\n\n#[test]\n#[cfg(feature = \"mock-tor-provider\")]\nfn test_mock_authenticated_onion_service() -\u003e anyhow::Result\u003c()\u003e {\n    let server_provider = Box::new(MockTorClient::new());\n    let client_provider = Box::new(MockTorClient::new());\n    authenticated_onion_service_test(server_provider, client_provider)\n}\n\n//\n// Legacy TorProvider tests\n//\n\n#[test]\n#[serial]\n#[cfg(feature = \"legacy-tor-provider\")]\nfn test_legacy_bootstrap() -\u003e anyhow::Result\u003c()\u003e {\n    let tor_path = which::which(format!(\"tor{}\", std::env::consts::EXE_SUFFIX))?;\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_legacy_bootstrap\");\n\n    let tor_config = LegacyTorClientConfig::BundledTor {\n        tor_bin_path: tor_path,\n        data_directory: data_path,\n        proxy_settings: None,\n        allowed_ports: None,\n        pluggable_transports: None,\n        bridge_lines: None,\n    };\n\n    bootstrap_test(Box::new(LegacyTorClient::new(tor_config)?))\n}\n\n#[test]\n#[serial]\n#[cfg(feature = \"legacy-tor-provider\")]\nfn test_legacy_pluggable_transport_bootstrap() -\u003e anyhow::Result\u003c()\u003e {\n    let tor_path = which::which(format!(\"tor{}\", std::env::consts::EXE_SUFFIX))?;\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_legacy_pluggable_transport_bootstrap\");\n\n    // find the lyrebird bin\n    let teb_path = std::env::var(\"TEB_PATH\")?;\n    if teb_path.is_empty() {\n        println!(\"TEB_PATH environment variable empty, so skipping test_legacy_pluggable_transport_bootstrap()\");\n        return Ok(());\n    }\n    let mut lyrebird_path = std::path::PathBuf::from(\u0026teb_path);\n    let lyrebird_bin = format!(\"lyrebird{}\", std::env::consts::EXE_SUFFIX);\n    lyrebird_path.push(lyrebird_bin.clone());\n    assert!(std::path::Path::exists(\u0026lyrebird_path));\n    assert!(std::path::Path::is_file(\u0026lyrebird_path));\n\n    // configure lyrebird pluggable transport\n    let pluggable_transport =\n        PluggableTransportConfig::new(vec![\"obfs4\".to_string()], lyrebird_path)?;\n\n    // obfs4 bridgeline\n    let bridge_line = BridgeLine::from_str(\"obfs4 207.172.185.193:22223 F34AC0CDBC06918E54292A474578C99834A58893 cert=MjqosoyVylLQuLo4LH+eQ5hS7Z44s2CaMfQbIjJtn4bGRnvLv8ldSvSED5JpvWSxm09XXg iat-mode=0\")?;\n\n    let tor_config = LegacyTorClientConfig::BundledTor {\n        tor_bin_path: tor_path,\n        data_directory: data_path,\n        proxy_settings: None,\n        allowed_ports: None,\n        pluggable_transports: Some(vec![pluggable_transport]),\n        bridge_lines: Some(vec![bridge_line]),\n    };\n\n    bootstrap_test(Box::new(LegacyTorClient::new(tor_config)?))\n}\n\n#[test]\n#[serial]\n#[cfg(feature = \"legacy-tor-provider\")]\nfn test_legacy_onion_service() -\u003e anyhow::Result\u003c()\u003e {\n    let tor_path = which::which(format!(\"tor{}\", std::env::consts::EXE_SUFFIX))?;\n\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_legacy_onion_service_server\");\n    let tor_config = LegacyTorClientConfig::BundledTor {\n        tor_bin_path: tor_path.clone(),\n        data_directory: data_path,\n        proxy_settings: None,\n        allowed_ports: None,\n        pluggable_transports: None,\n        bridge_lines: None,\n    };\n    let server_provider = Box::new(LegacyTorClient::new(tor_config)?);\n\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_legacy_onion_service_cient\");\n    let tor_config = LegacyTorClientConfig::BundledTor {\n        tor_bin_path: tor_path,\n        data_directory: data_path,\n        proxy_settings: None,\n        allowed_ports: None,\n        pluggable_transports: None,\n        bridge_lines: None,\n    };\n    let client_provider = Box::new(LegacyTorClient::new(tor_config)?);\n\n    basic_onion_service_test(server_provider, client_provider)\n}\n\n#[test]\n#[serial]\n#[cfg(feature = \"legacy-tor-provider\")]\nfn test_legacy_authenticated_onion_service() -\u003e anyhow::Result\u003c()\u003e {\n    let tor_path = which::which(format!(\"tor{}\", std::env::consts::EXE_SUFFIX))?;\n\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_legacy_authenticated_onion_service_server\");\n    let tor_config = LegacyTorClientConfig::BundledTor {\n        tor_bin_path: tor_path.clone(),\n        data_directory: data_path,\n        proxy_settings: None,\n        allowed_ports: None,\n        pluggable_transports: None,\n        bridge_lines: None,\n    };\n    let server_provider = Box::new(LegacyTorClient::new(tor_config)?);\n\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_legacy_authenticated_onion_service_cient\");\n    let tor_config = LegacyTorClientConfig::BundledTor {\n        tor_bin_path: tor_path,\n        data_directory: data_path,\n        proxy_settings: None,\n        allowed_ports: None,\n        pluggable_transports: None,\n        bridge_lines: None,\n    };\n    let client_provider = Box::new(LegacyTorClient::new(tor_config)?);\n\n    authenticated_onion_service_test(server_provider, client_provider)\n}\n\n//\n// System Legacy TorProvider tests\n//\n\n#[cfg(test)]\n#[cfg(feature = \"legacy-tor-provider\")]\nfn start_system_tor_daemon(\n    tor_path: \u0026std::ffi::OsStr,\n    name: \u0026str,\n    control_port: u16,\n    socks_port: u16,\n) -\u003e anyhow::Result\u003cChild\u003e {\n    let mut data_path = std::env::temp_dir();\n    data_path.push(name);\n    std::fs::create_dir_all(\u0026data_path)?;\n    let default_torrc = data_path.join(\"default_torrc\");\n    {\n        let _ = File::create(\u0026default_torrc)?;\n    }\n    let torrc = data_path.join(\"torrc\");\n    {\n        let _ = File::create(\u0026torrc)?;\n    }\n\n    let tor_daemon = Command::new(tor_path)\n        .stdout(Stdio::null())\n        .stdin(Stdio::null())\n        .stderr(Stdio::null())\n        // point to our above written torrc file\n        .arg(\"--defaults-torrc\")\n        .arg(default_torrc)\n        // location of torrc\n        .arg(\"--torrc-file\")\n        .arg(torrc)\n        // enable networking\n        .arg(\"DisableNetwork\")\n        .arg(\"0\")\n        // root data directory\n        .arg(\"DataDirectory\")\n        .arg(data_path)\n        // daemon will assign us a port, and we will\n        // read it from the control port file\n        .arg(\"ControlPort\")\n        .arg(control_port.to_string())\n        // password: foobar1\n        .arg(\"HashedControlPassword\")\n        .arg(\"16:E807DCE69AFE9979600760C9758B95ADB2F95E8740478AEA5356C95358\")\n        // socks port\n        .arg(\"SocksPort\")\n        .arg(socks_port.to_string())\n        // tor process will shut down after this process shuts down\n        // to avoid orphaned tor daemon\n        .arg(\"__OwningControllerProcess\")\n        .arg(process::id().to_string())\n        .spawn()?;\n\n    Ok(tor_daemon)\n}\n\n#[test]\n#[serial]\n#[cfg(feature = \"legacy-tor-provider\")]\nfn test_system_legacy_onion_service() -\u003e anyhow::Result\u003c()\u003e {\n    let tor_path = which::which(format!(\"tor{}\", std::env::consts::EXE_SUFFIX))?;\n\n    let mut server_tor_daemon = start_system_tor_daemon(\n        tor_path.as_os_str(),\n        \"test_system_legacy_onion_service_server\",\n        9251u16,\n        9250u16,\n    )?;\n    let mut client_tor_daemon = start_system_tor_daemon(\n        tor_path.as_os_str(),\n        \"test_system_legacy_onion_service_client\",\n        9351u16,\n        9350u16,\n    )?;\n\n    // give daemons time to start\n    std::thread::sleep(std::time::Duration::from_secs(5));\n\n    let tor_config = LegacyTorClientConfig::SystemTor {\n        tor_socks_addr: std::net::SocketAddr::from_str(\"127.0.0.1:9250\")?,\n        tor_control_addr: std::net::SocketAddr::from_str(\"127.0.0.1:9251\")?,\n        tor_control_passwd: \"password\".to_string(),\n    };\n    let server_provider = Box::new(LegacyTorClient::new(tor_config)?);\n\n    let tor_config = LegacyTorClientConfig::SystemTor {\n        tor_socks_addr: std::net::SocketAddr::from_str(\"127.0.0.1:9350\")?,\n        tor_control_addr: std::net::SocketAddr::from_str(\"127.0.0.1:9351\")?,\n        tor_control_passwd: \"password\".to_string(),\n    };\n    let client_provider = Box::new(LegacyTorClient::new(tor_config)?);\n\n    basic_onion_service_test(server_provider, client_provider)?;\n\n    server_tor_daemon.kill()?;\n    client_tor_daemon.kill()?;\n\n    Ok(())\n}\n\n#[test]\n#[serial]\n#[cfg(feature = \"legacy-tor-provider\")]\nfn test_system_legacy_authenticated_onion_service() -\u003e anyhow::Result\u003c()\u003e {\n    let tor_path = which::which(format!(\"tor{}\", std::env::consts::EXE_SUFFIX))?;\n\n    let mut server_tor_daemon = start_system_tor_daemon(\n        tor_path.as_os_str(),\n        \"test_system_legacy_authenticated_onion_service_server\",\n        9251u16,\n        9250u16,\n    )?;\n    let mut client_tor_daemon = start_system_tor_daemon(\n        tor_path.as_os_str(),\n        \"test_system_legacy_authenticated_onion_service_client\",\n        9351u16,\n        9350u16,\n    )?;\n\n    // give daemons time to start\n    std::thread::sleep(std::time::Duration::from_secs(5));\n\n    let tor_config = LegacyTorClientConfig::SystemTor {\n        tor_socks_addr: std::net::SocketAddr::from_str(\"127.0.0.1:9250\")?,\n        tor_control_addr: std::net::SocketAddr::from_str(\"127.0.0.1:9251\")?,\n        tor_control_passwd: \"password\".to_string(),\n    };\n    let server_provider = Box::new(LegacyTorClient::new(tor_config)?);\n\n    let tor_config = LegacyTorClientConfig::SystemTor {\n        tor_socks_addr: std::net::SocketAddr::from_str(\"127.0.0.1:9350\")?,\n        tor_control_addr: std::net::SocketAddr::from_str(\"127.0.0.1:9351\")?,\n        tor_control_passwd: \"password\".to_string(),\n    };\n    let client_provider = Box::new(LegacyTorClient::new(tor_config)?);\n\n    authenticated_onion_service_test(server_provider, client_provider)?;\n\n    server_tor_daemon.kill()?;\n    client_tor_daemon.kill()?;\n\n    Ok(())\n}\n\n//\n// Arti TorProvider tests\n//\n\n#[test]\n#[serial]\n#[cfg(feature = \"arti-client-tor-provider\")]\nfn test_arti_client_bootstrap() -\u003e anyhow::Result\u003c()\u003e {\n    let runtime: Arc\u003cruntime::Runtime\u003e = Arc::new(runtime::Runtime::new().unwrap());\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_arti_bootstrap\");\n    let tor_provider = Box::new(ArtiClientTorClient::new(runtime, \u0026data_path).unwrap());\n\n    bootstrap_test(tor_provider)\n}\n\n#[test]\n#[cfg(feature = \"arti-client-tor-provider\")]\nfn test_arti_client_onion_service() -\u003e anyhow::Result\u003c()\u003e {\n    let runtime: Arc\u003cruntime::Runtime\u003e = Arc::new(runtime::Runtime::new().unwrap());\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_arti_basic_onion_service_server\");\n    let server_provider = Box::new(ArtiClientTorClient::new(runtime.clone(), \u0026data_path).unwrap());\n\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_arti_basic_onion_service_client\");\n    let client_provider = Box::new(ArtiClientTorClient::new(runtime.clone(), \u0026data_path).unwrap());\n\n    basic_onion_service_test(server_provider, client_provider)\n}\n\n/*\nTODO: re-enable once client-auth is available in arti\n#[test]\n#[serial]\n#[cfg(feature = \"arti-client-tor-provider\")]\nfn test_arti_authenticated_onion_service() -\u003e anyhow::Result\u003c()\u003e {\n    let runtime: Arc\u003cruntime::Runtime\u003e = Arc::new(runtime::Runtime::new().unwrap());\n\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_arti_basic_onion_service_server\");\n    let server_provider = Box::new(ArtiClientTorClient::new(runtime.clone(), \u0026data_path).unwrap());\n\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_arti_basic_onion_service_client\");\n    let client_provider = Box::new(ArtiClientTorClient::new(runtime.clone(), \u0026data_path).unwrap());\n\n    authenticated_onion_service_test(server_provider, client_provider)\n}\n*/\n\n//\n// Mixed Arti/Legacy TorProvider tests\n//\n\n#[test]\n#[serial]\n#[cfg(all(feature = \"arti-client-tor-provider\", feature = \"legacy-tor-provider\"))]\nfn test_mixed_arti_client_legacy_onion_service() -\u003e anyhow::Result\u003c()\u003e {\n    let runtime: Arc\u003cruntime::Runtime\u003e = Arc::new(runtime::Runtime::new().unwrap());\n\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_arti_legacy_basic_onion_service_server\");\n    let server_provider = Box::new(ArtiClientTorClient::new(runtime, \u0026data_path)?);\n\n    let tor_path = which::which(format!(\"tor{}\", std::env::consts::EXE_SUFFIX))?;\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_arti_legacy_basic_onion_service_client\");\n    let tor_config = LegacyTorClientConfig::BundledTor {\n        tor_bin_path: tor_path,\n        data_directory: data_path,\n        proxy_settings: None,\n        allowed_ports: None,\n        pluggable_transports: None,\n        bridge_lines: None,\n    };\n    let client_provider = Box::new(LegacyTorClient::new(tor_config)?);\n\n    basic_onion_service_test(server_provider, client_provider)\n}\n\n#[test]\n#[serial]\n#[cfg(all(feature = \"arti-client-tor-provider\", feature = \"legacy-tor-provider\"))]\nfn test_mixed_legacy_arti_client_onion_service() -\u003e anyhow::Result\u003c()\u003e {\n    let tor_path = which::which(format!(\"tor{}\", std::env::consts::EXE_SUFFIX))?;\n\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_legacy_arty_basic_onion_service_client\");\n    let tor_config = LegacyTorClientConfig::BundledTor {\n        tor_bin_path: tor_path,\n        data_directory: data_path,\n        proxy_settings: None,\n        allowed_ports: None,\n        pluggable_transports: None,\n        bridge_lines: None,\n    };\n    let server_provider = Box::new(LegacyTorClient::new(tor_config)?);\n\n    let runtime: Arc\u003cruntime::Runtime\u003e = Arc::new(runtime::Runtime::new().unwrap());\n\n    let mut data_path = std::env::temp_dir();\n    data_path.push(\"test_legacy_arti_basic_onion_service_server\");\n    let client_provider = Box::new(ArtiClientTorClient::new(runtime, \u0026data_path)?);\n\n    basic_onion_service_test(server_provider, client_provider)\n}\n\n//\n// Misc Utils\n//\n\n#[test]\nfn test_tor_provider_target_addr() -\u003e anyhow::Result\u003c()\u003e {\n    let valid_ip_addr: \u0026[\u0026str] = \u0026[\n        \"192.168.1.1:80\",\n        \"10.0.0.1:443\",\n        \"172.16.0.1:8080\",\n        \"8.8.8.8:53\",\n        \"255.255.255.255:65535\",\n        \"0.0.0.0:22\",\n        \"192.168.0.254:21\",\n        \"127.0.0.1:3306\",\n        \"1.1.1.1:123\",\n        \"224.0.0.1:554\",\n        \"169.254.0.1:179\",\n        \"203.0.113.1:80\",\n        \"198.51.100.1:443\",\n        \"100.64.0.1:8080\",\n        \"192.0.2.1:53\",\n        \"192.88.99.1:22\",\n        \"192.0.0.1:21\",\n        \"240.0.0.1:3306\",\n        \"198.18.0.1:123\",\n        \"233.252.0.1:554\",\n        \"[2001:0db8:85a3:0000:0000:8a2e:0370:7334]:80\",\n        \"[2001:db8:85a3::8a2e:370:7334]:443\",\n        \"[::1]:8080\",\n        \"[::ffff:192.168.1.1]:53\",\n        \"[2001:0db8::1]:22\",\n        \"[fe80::1ff:fe23:4567:890a]:21\",\n        \"[2001:db8::1:0:0:1]:3306\",\n        \"[2001:0db8:0000:0042:0000:8a2e:0370:7334]:123\",\n        \"[ff02::1]:554\",\n        \"[fe80::abcd:ef01:2345:6789]:179\",\n        \"[2001:0db8:85a3:0000:0000:8a2e:0370:7334]:80\",\n        \"[2001:db8:85a3::8a2e:370:7334]:443\",\n        \"[::1]:8080\",\n        \"[::ffff:c0a8:101]:53\",\n        \"[2001:db8::1:0:0:1]:22\",\n        \"[fe80::1ff:fe23:4567:890a]:21\",\n        \"[2001:db8:0000:0042:0000:8a2e:0370:7334]:3306\",\n        \"[ff02::1]:123\",\n        \"[fe80::abcd:ef01:2345:6789]:554\",\n        \"[2001:db8::1]:179\",\n    ];\n\n    for target_addr_str in valid_ip_addr {\n        match TargetAddr::from_str(target_addr_str) {\n            Ok(TargetAddr::Socket(socket_addr)) =\u003e println!(\"{} =\u003e {}\", target_addr_str, socket_addr),\n            Ok(TargetAddr::OnionService(onion_addr)) =\u003e panic!(\n                \"unexpected conversion: {} =\u003e OnionService({})\",\n                target_addr_str, onion_addr\n            ),\n            Ok(TargetAddr::Domain(domain_addr)) =\u003e panic!(\n                \"unexpected conversion: {} =\u003e DomainAddr({})\",\n                target_addr_str, domain_addr\n            ),\n            Err(err) =\u003e Err(err)?,\n        }\n    }\n\n    let valid_onion_addr: \u0026[\u0026str] = \u0026[\n        \"6l62fw7tqctlu5fesdqukvpoxezkaxbzllrafa2ve6ewuhzphxczsjyd.onion:65535\",\n        \"6L62FW7TQCTLU5FESDQUKVPOXEZKAXBZLLRAFA2VE6EWUHZPHXCZSJYD.onion:1\",\n    ];\n\n    for target_addr_str in valid_onion_addr {\n        match TargetAddr::from_str(target_addr_str) {\n            Ok(TargetAddr::Socket(socket_addr)) =\u003e panic!(\n                \"unexpected conversion: {} =\u003e Ip({})\",\n                target_addr_str, socket_addr\n            ),\n            Ok(TargetAddr::OnionService(onion_addr)) =\u003e {\n                println!(\"{} =\u003e {}\", target_addr_str, onion_addr)\n            }\n            Ok(TargetAddr::Domain(domain_addr)) =\u003e panic!(\n                \"unexpected conversion: {} =\u003e DomainAddr({})\",\n                target_addr_str, domain_addr\n            ),\n            Err(err) =\u003e Err(err)?,\n        }\n    }\n\n    let valid_domain_addr: \u0026[\u0026str] = \u0026[\n        \"example.com:80\",\n        \"subdomain.example.com:443\",\n        \"xn--e1afmkfd.xn--p1ai:8080\",       // domain in Punycode for \"пример.рф\"\n        \"xn--fsqu00a.xn--0zwm56d:53\",       // domain in Punycode for \"例子.测试\"\n        \"münich.com:22\",                    // domain with UTF-8 characters\n        \"xn--mnich-kva.com:21\",             // Punycode for \"münich.com\"\n        \"exämple.com:3306\",                 // domain with UTF-8 characters\n        \"xn--exmple-cua.com:123\",           // Punycode for \"exämple.com\"\n        \"例子.com:554\",                      // domain with UTF-8 characters\n        \"xn--fsqu00a.com:179\",              // Punycode for \"例子.com\"\n        \"täst.de:80\",                       // domain with UTF-8 characters\n        \"xn--tst-qla.de:443\",               // Punycode for \"täst.de\"\n        \"xn--fiqs8s:80\",                    // Punycode for \"中国\"\n        \"xn--wgbh1c:8080\",                  // Punycode for \"مصر\"\n        \"münster.de:22\",                    // domain with UTF-8 characters\n        \"xn--mnster-3ya.de:21\",             // Punycode for \"münster.de\"\n        \"bücher.com:3306\",                  // domain with UTF-8 characters\n        \"xn--bcher-kva.com:123\",            // Punycode for \"bücher.com\"\n        \"xn--vermgensberatung-pwb.com:554\", // Punycode for \"vermögensberatung.com\"\n        // Max Length\n        \"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb.ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc.ddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd:65535\"\n    ];\n\n    for target_addr_str in valid_domain_addr {\n        match TargetAddr::from_str(target_addr_str) {\n            Ok(TargetAddr::Socket(socket_addr)) =\u003e panic!(\n                \"unexpected conversion: {} =\u003e SocketAddr({})\",\n                target_addr_str, socket_addr\n            ),\n            Ok(TargetAddr::OnionService(onion_addr)) =\u003e panic!(\n                \"unexpected conversion: {} =\u003e OnionService({})\",\n                target_addr_str, onion_addr\n            ),\n            Ok(TargetAddr::Domain(domain_addr)) =\u003e {\n                println!(\"{} =\u003e {}\", target_addr_str, domain_addr)\n            }\n            Err(err) =\u003e Err(err)?,\n        }\n    }\n\n    let invalid_target_addr: \u0026[\u0026str] = \u0026[\n        // ipv4-ish\n        \"192.168.1.1:99999\", // Port number out of range\n        \"192.168.1.1:abc\",   // Invalid port number\n        \"192.168.1.1:\",      // Missing port number\n        \"192.168.1.1: 80\",   // Space in port number\n        \"192.168.1.1:80a\",   // Non-numeric characters in port number\n        // ipv6-ish\n        \"[2001:db8:::1]:80\",                            // Triple colons\n        \"[2001:db8:85a3::8a2e:370:7334:1234::abcd]:80\", // Too many groups\n        \"[2001:db8:85a3::8a2e:370g:7334]:80\",           // Invalid character in group\n        \"[2001:db8:85a3::8a2e:370:7334]:99999\",         // Port number out of range\n        \"[2001:db8:85a3:8a2e:370:7334]:80\",             // Missing double colons\n        \"[::12345]:80\",                                 // Excessive leading zeroes\n        \"[2001:db8:85a3::8a2e:370:7334:]:80\",           // Trailing colon\n        \"[2001:db8:85a3::8a2e:370:7334]\",               // Missing port number\n        \"2001:db8:85a3::8a2e:370:7334:80\",              // Missing square brackets\n        \"[2001:db8:85a3::8a2e:370:7334]: 80\",           // Space in port number\n        \"[2001:db8:85a3::8a2e:370:7334]:80a\",           // Non-numeric characters in port number\n        // onion service-ish\n        \"6l62fw7tqctlu5fesdqukvpoxezkaxbzllrafa2ve6ewuhzphxczsjyd234567.onion:80\", // Too long for v3\n        \"6l62fw7tqctlu5fesdqukvpoxezkaxbzllrafa2ve6ewuhzphxcz.onion:443\", // Too short for v3\n        \"6l62fw7tqctlu5fesdqukvpoxezkaxbzllrafa2ve6ewuhzphxczsjyd.onion:99999\", // Port number out of range\n        \"abcdefghijklmnopqrstuvwxyz0123456789abcdefghijklmnopqrst.onion:21\", // Invalid characters\n        \"6l62fw7tqctlu5fesdqukvpoxezkaxbzllrafa2ve6ewuhzphxczsjyd.onion:abc\", // Invalid port number\n        \"6l62fw7tqctlu5fesdqukvpoxezkaxbzllrafa2ve6ewuhzphxczsjyd.onion: 80\", // Space in port number\n        \"6l62fw7tqctlu5fesdqukvpoxezkaxbzllrafa2ve6ewuhzphxczsjyd.onion:80a\", // Non-numeric characters in port number\n        \"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.onion:80\",  // Invalid service id\n        // domain-ish\n        \"example..com:80\",        // Double dots\n        \"exa mple.com:53\",        // Space in domain\n        \"example.com:99999\",      // Port number out of range\n        \"exaample.com:abc\",       // Invalid port number\n        \"exaample.com:\",          // Missing port number\n        \"exaample.com: 80\",       // Space in port number\n        \"ex@mple.com:80\",         // Special character in domain\n        \"example.com:80a\",        // Non-numeric characters in port number\n        \"exämple..com:80\",        // UTF-8 with double dot\n        \"xn--exmple-cua.com: 80\", // Punycode with space in port number\n        \"xn--exmple-cua.com:80a\", // Punycode with non-numeric port\n        \"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.com:65535\", // Label too long\n    ];\n\n    for target_addr_str in invalid_target_addr {\n        match TargetAddr::from_str(target_addr_str) {\n            Ok(TargetAddr::Socket(socket_addr)) =\u003e panic!(\n                \"unexpected conversion: {} =\u003e SocketAddr({})\",\n                target_addr_str, socket_addr\n            ),\n            Ok(TargetAddr::OnionService(onion_addr)) =\u003e panic!(\n                \"unexpected conversion: {} =\u003e OnionService({})\",\n                target_addr_str, onion_addr\n            ),\n            Ok(TargetAddr::Domain(domain_addr)) =\u003e panic!(\n                \"unexpected conversion: {} =\u003e DomainAddr({})\",\n                target_addr_str, domain_addr\n            ),\n            Err(_) =\u003e (),\n        }\n    }\n\n    Ok(())\n}\n","traces":[{"line":31,"address":[1477844,1476176,1477713],"length":1,"stats":{"Line":1}},{"line":32,"address":[1476272,1476183,1476332,1476948,1477837],"length":1,"stats":{"Line":2}},{"line":34,"address":[1476314],"length":1,"stats":{"Line":1}},{"line":35,"address":[1476322],"length":1,"stats":{"Line":1}},{"line":36,"address":[1476410,1476330],"length":1,"stats":{"Line":2}},{"line":37,"address":[1476744,1476898,1476481,1476420,1477727],"length":1,"stats":{"Line":4}},{"line":38,"address":[1476919],"length":1,"stats":{"Line":1}},{"line":39,"address":[1477501],"length":1,"stats":{"Line":1}},{"line":47,"address":[1477634],"length":1,"stats":{"Line":1}},{"line":48,"address":[1477112,1477607],"length":1,"stats":{"Line":2}},{"line":49,"address":[1477626],"length":1,"stats":{"Line":1}},{"line":51,"address":[1477146],"length":1,"stats":{"Line":1}},{"line":52,"address":[1477158],"length":1,"stats":{"Line":1}},{"line":53,"address":[1477639],"length":1,"stats":{"Line":1}},{"line":59,"address":[1477791,1477744],"length":1,"stats":{"Line":0}},{"line":64,"address":[1477770],"length":1,"stats":{"Line":1}},{"line":68,"address":[1480298,1486250,1477872],"length":1,"stats":{"Line":1}},{"line":72,"address":[1477926,1486219,1478104,1479535,1478030],"length":1,"stats":{"Line":2}},{"line":73,"address":[1478201,1486198,1478072,1478261],"length":1,"stats":{"Line":2}},{"line":75,"address":[1478243],"length":1,"stats":{"Line":1}},{"line":76,"address":[1478251],"length":1,"stats":{"Line":1}},{"line":78,"address":[1478259,1478384,1478342],"length":1,"stats":{"Line":3}},{"line":79,"address":[1481110,1478448,1478726,1478352,1478907],"length":1,"stats":{"Line":4}},{"line":80,"address":[1478931],"length":1,"stats":{"Line":1}},{"line":81,"address":[1480349],"length":1,"stats":{"Line":1}},{"line":89,"address":[1481023],"length":1,"stats":{"Line":1}},{"line":90,"address":[1480506,1480996],"length":1,"stats":{"Line":2}},{"line":91,"address":[1481015],"length":1,"stats":{"Line":1}},{"line":93,"address":[1480543],"length":1,"stats":{"Line":1}},{"line":94,"address":[1481028],"length":1,"stats":{"Line":1}},{"line":100,"address":[1479292,1480315,1478966,1479476],"length":1,"stats":{"Line":3}},{"line":101,"address":[1479500],"length":1,"stats":{"Line":1}},{"line":102,"address":[1479575],"length":1,"stats":{"Line":1}},{"line":110,"address":[1480219],"length":1,"stats":{"Line":1}},{"line":111,"address":[1479702,1480192],"length":1,"stats":{"Line":2}},{"line":112,"address":[1480211],"length":1,"stats":{"Line":1}},{"line":114,"address":[1479739],"length":1,"stats":{"Line":1}},{"line":115,"address":[1480224],"length":1,"stats":{"Line":1}},{"line":124,"address":[1478402],"length":1,"stats":{"Line":1}},{"line":127,"address":[1478410],"length":1,"stats":{"Line":1}},{"line":129,"address":[1481193,1481123],"length":1,"stats":{"Line":2}},{"line":131,"address":[1481212,1481395,1486177],"length":1,"stats":{"Line":1}},{"line":133,"address":[1481385],"length":1,"stats":{"Line":1}},{"line":134,"address":[1481476,1481393],"length":1,"stats":{"Line":2}},{"line":135,"address":[1482750,1481624,1482086,1481902,1481486],"length":1,"stats":{"Line":4}},{"line":136,"address":[1482110],"length":1,"stats":{"Line":1}},{"line":137,"address":[1482160],"length":1,"stats":{"Line":0}},{"line":138,"address":[1482338],"length":1,"stats":{"Line":0}},{"line":140,"address":[1482292],"length":1,"stats":{"Line":1}},{"line":141,"address":[1482311],"length":1,"stats":{"Line":1}},{"line":142,"address":[1482737,1482428],"length":1,"stats":{"Line":2}},{"line":143,"address":[1482597,1482466],"length":1,"stats":{"Line":1}},{"line":144,"address":[1482729],"length":1,"stats":{"Line":1}},{"line":155,"address":[1481526],"length":1,"stats":{"Line":1}},{"line":156,"address":[1481534],"length":1,"stats":{"Line":1}},{"line":158,"address":[1482780],"length":1,"stats":{"Line":1}},{"line":159,"address":[1482825],"length":1,"stats":{"Line":1}},{"line":161,"address":[1482836],"length":1,"stats":{"Line":1}},{"line":162,"address":[1483087],"length":1,"stats":{"Line":1}},{"line":163,"address":[1483251],"length":1,"stats":{"Line":0}},{"line":164,"address":[1485961],"length":1,"stats":{"Line":0}},{"line":165,"address":[1486030,1486071],"length":1,"stats":{"Line":0}},{"line":166,"address":[1486059],"length":1,"stats":{"Line":0}},{"line":167,"address":[1486140,1486092],"length":1,"stats":{"Line":0}},{"line":172,"address":[1483436],"length":1,"stats":{"Line":1}},{"line":173,"address":[1483532,1485885,1483655],"length":1,"stats":{"Line":1}},{"line":174,"address":[1483631,1483782,1485850,1477894,1483698],"length":1,"stats":{"Line":3}},{"line":175,"address":[1483820,1483756],"length":1,"stats":{"Line":2}},{"line":178,"address":[1483858,1485752],"length":1,"stats":{"Line":1}},{"line":179,"address":[1484298,1484199],"length":1,"stats":{"Line":2}},{"line":180,"address":[1484317],"length":1,"stats":{"Line":1}},{"line":181,"address":[1484569,1485512,1484336,1484432],"length":1,"stats":{"Line":2}},{"line":182,"address":[1484506,1484607,1484775,1485487],"length":1,"stats":{"Line":2}},{"line":184,"address":[1484901,1484733],"length":1,"stats":{"Line":2}},{"line":185,"address":[1485086],"length":1,"stats":{"Line":1}},{"line":187,"address":[1485641,1484225],"length":1,"stats":{"Line":0}},{"line":190,"address":[1485386],"length":1,"stats":{"Line":1}},{"line":194,"address":[1486272,1495500,1488682],"length":1,"stats":{"Line":1}},{"line":198,"address":[1486504,1487919,1486430,1495469,1486326],"length":1,"stats":{"Line":2}},{"line":199,"address":[1486601,1495448,1486472,1486661],"length":1,"stats":{"Line":2}},{"line":201,"address":[1486643],"length":1,"stats":{"Line":1}},{"line":202,"address":[1486651],"length":1,"stats":{"Line":1}},{"line":204,"address":[1486784,1486659,1486742],"length":1,"stats":{"Line":3}},{"line":205,"address":[1489494,1486832,1486752,1487110,1487291],"length":1,"stats":{"Line":4}},{"line":206,"address":[1487315],"length":1,"stats":{"Line":1}},{"line":207,"address":[1489274],"length":1,"stats":{"Line":1}},{"line":215,"address":[1489407],"length":1,"stats":{"Line":1}},{"line":216,"address":[1488890,1489380],"length":1,"stats":{"Line":2}},{"line":217,"address":[1489399],"length":1,"stats":{"Line":1}},{"line":219,"address":[1488927],"length":1,"stats":{"Line":1}},{"line":220,"address":[1489412],"length":1,"stats":{"Line":1}},{"line":226,"address":[1487676,1488699,1487350,1487860],"length":1,"stats":{"Line":3}},{"line":227,"address":[1487884],"length":1,"stats":{"Line":1}},{"line":228,"address":[1487959],"length":1,"stats":{"Line":1}},{"line":236,"address":[1488603],"length":1,"stats":{"Line":1}},{"line":237,"address":[1488086,1488576],"length":1,"stats":{"Line":2}},{"line":238,"address":[1488595],"length":1,"stats":{"Line":1}},{"line":240,"address":[1488123],"length":1,"stats":{"Line":1}},{"line":241,"address":[1488608],"length":1,"stats":{"Line":1}},{"line":251,"address":[1486794],"length":1,"stats":{"Line":1}},{"line":253,"address":[1489507],"length":1,"stats":{"Line":1}},{"line":254,"address":[1489570],"length":1,"stats":{"Line":1}},{"line":256,"address":[1489638],"length":1,"stats":{"Line":1}},{"line":258,"address":[1489914,1489683,1495408],"length":1,"stats":{"Line":1}},{"line":261,"address":[1489904],"length":1,"stats":{"Line":1}},{"line":262,"address":[1489995,1489912],"length":1,"stats":{"Line":2}},{"line":263,"address":[1490405,1490005,1490127,1490589,1491253],"length":1,"stats":{"Line":4}},{"line":264,"address":[1490613],"length":1,"stats":{"Line":1}},{"line":265,"address":[1490663],"length":1,"stats":{"Line":0}},{"line":266,"address":[1490841],"length":1,"stats":{"Line":0}},{"line":268,"address":[1490795],"length":1,"stats":{"Line":1}},{"line":269,"address":[1490814],"length":1,"stats":{"Line":1}},{"line":270,"address":[1490931,1491240],"length":1,"stats":{"Line":2}},{"line":271,"address":[1490969],"length":1,"stats":{"Line":1}},{"line":275,"address":[1491232],"length":1,"stats":{"Line":1}},{"line":286,"address":[1490037],"length":1,"stats":{"Line":1}},{"line":288,"address":[1491283],"length":1,"stats":{"Line":1}},{"line":289,"address":[1491515,1491328,1491624],"length":1,"stats":{"Line":3}},{"line":296,"address":[1491714],"length":1,"stats":{"Line":1}},{"line":297,"address":[1491891,1491759,1495368],"length":1,"stats":{"Line":1}},{"line":299,"address":[1491972,1491865],"length":1,"stats":{"Line":2}},{"line":300,"address":[1491991,1492432,1495347],"length":1,"stats":{"Line":1}},{"line":303,"address":[1492557],"length":1,"stats":{"Line":1}},{"line":304,"address":[1492653,1492776,1495329],"length":1,"stats":{"Line":1}},{"line":305,"address":[1492819,1495314,1492752,1492903],"length":1,"stats":{"Line":2}},{"line":306,"address":[1492877,1492941],"length":1,"stats":{"Line":2}},{"line":308,"address":[1492960],"length":1,"stats":{"Line":1}},{"line":309,"address":[1493005,1493122,1486294,1495279],"length":1,"stats":{"Line":2}},{"line":312,"address":[1493200,1495121],"length":1,"stats":{"Line":1}},{"line":313,"address":[1493541,1493640],"length":1,"stats":{"Line":2}},{"line":314,"address":[1493659],"length":1,"stats":{"Line":1}},{"line":315,"address":[1493911,1493678,1494862,1493774],"length":1,"stats":{"Line":2}},{"line":316,"address":[1494101,1493949,1494837,1493848],"length":1,"stats":{"Line":2}},{"line":318,"address":[1494075,1494227],"length":1,"stats":{"Line":2}},{"line":319,"address":[1494376],"length":1,"stats":{"Line":1}},{"line":321,"address":[1493567,1495010],"length":1,"stats":{"Line":0}},{"line":324,"address":[1494736],"length":1,"stats":{"Line":1}},{"line":488,"address":[1495520,1498034,1497833],"length":1,"stats":{"Line":1}},{"line":494,"address":[1495627],"length":1,"stats":{"Line":1}},{"line":495,"address":[1495708],"length":1,"stats":{"Line":1}},{"line":496,"address":[1495587,1495894,1498003,1495768],"length":1,"stats":{"Line":2}},{"line":497,"address":[1495943,1495863],"length":1,"stats":{"Line":2}},{"line":499,"address":[1496067,1495983,1497938],"length":1,"stats":{"Line":2}},{"line":501,"address":[1496176],"length":1,"stats":{"Line":1}},{"line":503,"address":[1496255,1497873,1496339],"length":1,"stats":{"Line":2}},{"line":506,"address":[1497419,1497610,1496456,1496624,1496792,1497068,1496900,1497304,1496554,1497153,1496686],"length":1,"stats":{"Line":10}},{"line":507,"address":[1496475],"length":1,"stats":{"Line":1}},{"line":508,"address":[1496581],"length":1,"stats":{"Line":1}},{"line":509,"address":[1496643],"length":1,"stats":{"Line":1}},{"line":512,"address":[1496752],"length":1,"stats":{"Line":1}},{"line":515,"address":[1496860],"length":1,"stats":{"Line":1}},{"line":521,"address":[1497028],"length":1,"stats":{"Line":1}},{"line":525,"address":[1497141],"length":1,"stats":{"Line":1}},{"line":531,"address":[1497292],"length":1,"stats":{"Line":1}},{"line":535,"address":[1497361],"length":1,"stats":{"Line":1}},{"line":538,"address":[1497679],"length":1,"stats":{"Line":1}}],"covered":144,"coverable":156}]};
         var previousData = null;
     </script>
     <script crossorigin>/** @license React v16.13.1
