soulfire.proxy_check_connect.ProxyCheckService¶
- class soulfire.proxy_check_connect.ProxyCheckService[source]¶
Bases:
ProtocolService for validating proxy servers by testing their ability to connect to Minecraft servers. This is useful for filtering out dead or slow proxies before using them for bot connections.
The service tests proxies by attempting to establish a Minecraft protocol connection through each proxy to a configurable target server and waiting for a status response packet. Results include whether the proxy works and its latency.
- check(request: soulfire.proxy_check_pb2.ProxyCheckRequest, ctx: connectrpc.request.RequestContext[soulfire.proxy_check_pb2.ProxyCheckRequest, soulfire.proxy_check_pb2.ProxyCheckResponse], /) collections.abc.AsyncIterator[soulfire.proxy_check_pb2.ProxyCheckResponse][source]¶
Checks the validity of one or more proxies by attempting to connect through them to a Minecraft server.
The check process: 1. For each proxy in the request, a connection attempt is made through
the proxy to the Minecraft server configured in the instance settings
The connection uses the protocol version configured in the instance
A proxy is considered valid if it successfully connects and receives a server status response within 30 seconds
Results are streamed back as each check completes
A ProxyCheckEnd message is sent when all checks are complete
Concurrency is controlled by the instance’s PROXY_CHECK_CONCURRENCY setting.
Required permission: CHECK_PROXY on the specified instance.
Error cases: - NOT_FOUND: The specified instance_id does not exist - PERMISSION_DENIED: The user lacks CHECK_PROXY permission on the instance - INTERNAL: An unexpected error occurred during proxy checking
The stream can be cancelled by the client at any time, which will terminate any in-progress proxy checks.