Implements host pairing helpers. More...

#include "src/network/host_pairing.h"
#include <algorithm>
#include <array>
#include <atomic>
#include <cctype>
#include <cstddef>
#include <cstdint>
#include <cstdio>
#include <cstdlib>
#include <cstring>
#include <functional>
#include <memory>
#include <string>
#include <string_view>
#include <vector>
#include <openssl/bio.h>
#include <openssl/err.h>
#include <openssl/evp.h>
#include <openssl/pem.h>
#include <openssl/rand.h>
#include <openssl/rsa.h>
#include <openssl/ssl.h>
#include <openssl/x509.h>
#include "src/network/runtime_network.h"
#include "src/platform/error_utils.h"
#include "third-party/moonlight-common-c/src/Limelight.h"
#include <errno.h>
#include <hal/debug.h>
#include <lwip/inet.h>
#include <lwip/sockets.h>

Include dependency graph for host_pairing.cpp:

Macros
#define	_CRT_RAND_S
	Request the rand_s prototype on nxdk builds.

#define	INVALID_SOCKET (-1)
	Sentinel socket value used when socket creation fails.

#define	OPENSSL_SUPPRESS_DEPRECATED
	Suppress deprecated OpenSSL APIs used for compatibility with bundled dependencies.

#define	SOCKET_ERROR (-1)
	Sentinel return value used when a socket operation fails.

Typedefs
using	SOCKET = int
	Native socket handle type used on nxdk and POSIX builds.

Functions
void	network::testing::clear_host_pairing_http_test_handler ()
	Remove any scripted HTTP handler previously installed for host-pairing tests.

PairingIdentity	network::create_pairing_identity (std::string *errorMessage=nullptr)
	Create a fresh client identity for Moonlight pairing.

bool	network::error_indicates_unpaired_client (std::string_view errorMessage)
	Return whether an error message indicates the client is not paired.

bool	network::generate_pairing_pin (std::string pin, std::string errorMessage=nullptr)
	Generate a secure four-digit PIN for host pairing.

uint64_t	network::hash_app_list_entries (const std::vector< HostAppEntry > &apps)
	Compute a stable hash for a fetched app list.

bool	network::is_valid_pairing_identity (const PairingIdentity &identity)
	Return whether a pairing identity contains the required PEM materials.

bool	network::launch_or_resume_stream (const std::string &address, uint16_t preferredHttpPort, const PairingIdentity &clientIdentity, const StreamLaunchConfiguration &configuration, StreamLaunchResult result, std::string errorMessage=nullptr)
	Launch or resume one host application and return stream session details.

HostPairingResult	network::pair_host (const HostPairingRequest &request, const std::atomic< bool > *cancelRequested=nullptr)
	Pair the client with a host using the provided request parameters.

bool	network::parse_app_list_response (std::string_view xml, std::vector< HostAppEntry > apps, std::string errorMessage=nullptr)
	Parse the XML response returned by the host app-list endpoint.

bool	network::parse_server_info_response (std::string_view xml, uint16_t fallbackHttpPort, HostPairingServerInfo serverInfo, std::string errorMessage=nullptr)
	Parse the XML response returned by the host server-info endpoint.

bool	network::query_app_asset (const std::string &address, uint16_t httpsPort, const PairingIdentity clientIdentity, int appId, std::vector< unsigned char > assetBytes, std::string *errorMessage=nullptr)
	Query one app asset such as box art over HTTPS.

bool	network::query_app_list (const std::string &address, uint16_t preferredHttpPort, const PairingIdentity clientIdentity, std::vector< HostAppEntry > apps, HostPairingServerInfo serverInfo=nullptr, std::string errorMessage=nullptr)
	Query the app list exported by a host.

bool	network::query_server_info (const std::string &address, uint16_t preferredHttpPort, const PairingIdentity clientIdentity, HostPairingServerInfo serverInfo, std::string *errorMessage=nullptr)
	Query live host status using an optional client identity.

bool	network::query_server_info (const std::string &address, uint16_t preferredHttpPort, HostPairingServerInfo serverInfo, std::string errorMessage)
	Query host status without providing a client identity.

int	rand_s (unsigned int *randomValue)
	Fill a buffer with secure random bytes using the nxdk compatibility entry point.

std::string	network::resolve_reachable_address (const std::string &requestedAddress, const HostPairingServerInfo &serverInfo)
	Choose the best reachable address for a host.

void	network::testing::set_host_pairing_http_test_handler (HostPairingHttpTestHandler handler)
	Install a scripted HTTP handler for host-pairing unit tests.

Detailed Description

Implements host pairing helpers.

Function Documentation

◆ create_pairing_identity()

PairingIdentity network::create_pairing_identity ( std::string * errorMessage = nullptr )

Create a fresh client identity for Moonlight pairing.

Parameters

errorMessage Optional output for key or certificate generation failures.

Returns: Generated pairing identity, or an empty identity on failure.

◆ error_indicates_unpaired_client()

bool network::error_indicates_unpaired_client ( std::string_view errorMessage )

Return whether an error message indicates the client is not paired.

Parameters

errorMessage Candidate error text.

Returns: true when the text maps to an unpaired-client condition.

◆ generate_pairing_pin()

bool network::generate_pairing_pin	(	std::string *	pin,
		std::string *	errorMessage = nullptr )

Generate a secure four-digit PIN for host pairing.

Parameters

pin	Output buffer populated with exactly four decimal digits.
errorMessage	Optional output for entropy or random-byte failures.

Returns: true when a secure PIN was generated successfully.

◆ hash_app_list_entries()

uint64_t network::hash_app_list_entries ( const std::vector< HostAppEntry > & apps )

Compute a stable hash for a fetched app list.

Parameters

apps	App entries to hash.

Returns: Stable hash value for content-change detection.

◆ is_valid_pairing_identity()

bool network::is_valid_pairing_identity ( const PairingIdentity & identity )

Return whether a pairing identity contains the required PEM materials.

Parameters

identity Candidate pairing identity.

Returns: true when the identity is usable for authenticated requests.

◆ launch_or_resume_stream()

bool network::launch_or_resume_stream	(	const std::string &	address,
		uint16_t	preferredHttpPort,
		const PairingIdentity &	clientIdentity,
		const StreamLaunchConfiguration &	configuration,
		StreamLaunchResult *	result,
		std::string *	errorMessage = nullptr )

Launch or resume one host application and return stream session details.

The helper first refreshes /serverinfo using the supplied paired client identity, then resumes the running session when the requested app is already active or launches a new session otherwise.

Parameters

address	Host address to query.
preferredHttpPort	Preferred HTTP port override.
clientIdentity	Paired client identity used for authenticated launch requests.
configuration	Stream launch parameters including app ID and remote-input keys.
result	Output populated with launch metadata required by moonlight-common-c.
errorMessage	Optional output for request or parse failures.

Returns: true when the host accepted the launch or resume request.

◆ pair_host()

HostPairingResult network::pair_host	(	const HostPairingRequest &	request,
		const std::atomic< bool > *	cancelRequested = nullptr )

Pair the client with a host using the provided request parameters.

Parameters

request	Pairing parameters and client identity.
cancelRequested	Optional cancellation flag checked during the request.

Returns: Pairing outcome including success state and user-visible detail.

◆ parse_app_list_response()

bool network::parse_app_list_response	(	std::string_view	xml,
		std::vector< HostAppEntry > *	apps,
		std::string *	errorMessage = nullptr )

Parse the XML response returned by the host app-list endpoint.

Parameters

xml	Raw XML response body.
apps	Output vector populated with parsed app entries.
errorMessage	Optional output for parse or validation failures.

Returns: true when the response was parsed successfully.

◆ parse_server_info_response()

bool network::parse_server_info_response	(	std::string_view	xml,
		uint16_t	fallbackHttpPort,
		HostPairingServerInfo *	serverInfo,
		std::string *	errorMessage = nullptr )

Parse the XML response returned by the host server-info endpoint.

Parameters

xml	Raw XML response body.
fallbackHttpPort	HTTP port to use when the response omits it.
serverInfo	Output structure populated from the response.
errorMessage	Optional output for parse or validation failures.

Returns: true when the response was parsed successfully.

◆ query_app_asset()

bool network::query_app_asset	(	const std::string &	address,
		uint16_t	httpsPort,
		const PairingIdentity *	clientIdentity,
		int	appId,
		std::vector< unsigned char > *	assetBytes,
		std::string *	errorMessage = nullptr )

Query one app asset such as box art over HTTPS.

Parameters

address	Host address to query.
httpsPort	Host HTTPS port.
clientIdentity	Optional client identity for authenticated requests.
appId	Host application identifier.
assetBytes	Output vector populated with downloaded asset bytes.
errorMessage	Optional output for request failures.

Returns: true when the asset was downloaded successfully.

◆ query_app_list()

bool network::query_app_list	(	const std::string &	address,
		uint16_t	preferredHttpPort,
		const PairingIdentity *	clientIdentity,
		std::vector< HostAppEntry > *	apps,
		HostPairingServerInfo *	serverInfo = nullptr,
		std::string *	errorMessage = nullptr )

Query the app list exported by a host.

Parameters

address	Host address to query.
preferredHttpPort	Preferred HTTP port override.
clientIdentity	Optional client identity for authenticated requests.
apps	Output vector populated with parsed app entries.
serverInfo	Optional output populated with the latest host status data.
errorMessage	Optional output for request or parse failures.

Returns: true when the app list was retrieved successfully.

◆ query_server_info() [1/2]

bool network::query_server_info	(	const std::string &	address,
		uint16_t	preferredHttpPort,
		const PairingIdentity *	clientIdentity,
		HostPairingServerInfo *	serverInfo,
		std::string *	errorMessage = nullptr )

Query live host status using an optional client identity.

Parameters

address	Host address to query.
preferredHttpPort	Preferred HTTP port override.
clientIdentity	Optional client identity for authenticated requests.
serverInfo	Output structure populated with parsed status data.
errorMessage	Optional output for request or parse failures.

Returns: true when host status was retrieved successfully.

◆ query_server_info() [2/2]

bool network::query_server_info	(	const std::string &	address,
		uint16_t	preferredHttpPort,
		HostPairingServerInfo *	serverInfo,
		std::string *	errorMessage )

Query host status without providing a client identity.

Parameters

address	Host address to query.
preferredHttpPort	Preferred HTTP port override.
serverInfo	Output structure populated with parsed status data.
errorMessage	Optional output for request or parse failures.

Returns: true when host status was retrieved successfully.

◆ rand_s()

int rand_s ( unsigned int * randomValue )

Fill a buffer with secure random bytes using the nxdk compatibility entry point.

Parameters

randomValue Output integer populated with secure random bits.

Returns: Zero on success, or a non-zero platform error code on failure.

◆ resolve_reachable_address()

std::string network::resolve_reachable_address	(	const std::string &	requestedAddress,
		const HostPairingServerInfo &	serverInfo )

Choose the best reachable address for a host.

Parameters

requestedAddress	Address originally requested by the user.
serverInfo	Parsed host status information.

Returns: Reachable address to use for subsequent requests.

◆ set_host_pairing_http_test_handler()

void network::testing::set_host_pairing_http_test_handler ( HostPairingHttpTestHandler handler )

Install a scripted HTTP handler for host-pairing unit tests.

Parameters

handler Callback that should service subsequent host-pairing HTTP requests.

Macros

Typedefs

Functions

Detailed Description

Function Documentation

◆ create_pairing_identity()

◆ error_indicates_unpaired_client()

◆ generate_pairing_pin()

◆ hash_app_list_entries()

◆ is_valid_pairing_identity()

◆ launch_or_resume_stream()

◆ pair_host()

◆ parse_app_list_response()

◆ parse_server_info_response()

◆ query_app_asset()

◆ query_app_list()

◆ query_server_info() [1/2]

◆ query_server_info() [2/2]

◆ rand_s()

◆ resolve_reachable_address()

◆ set_host_pairing_http_test_handler()