static

type AllowList []ed25519.PublicKey

type ConnClosedByDeduplicatorError struct{}

type ConnResult struct {
	// The connection itself
	Conn net.Conn
	// Optional transport lvl public key (may be nil)
	Pkey ed25519.PublicKey
	// Lvl of connection security
	// Here is most used values:
	// - ytl.static.SECURE_LVL_UNSECURE
	// - ytl.static.SECURE_LVL_ENCRYPTED
	// - ytl.static.SECURE_LVL_VERIFIED
	// - ytl.static.SECURE_LVL_ENCRYPTED_AND_VERIFIED
	SecurityLevel uint
}

type ConnTimeoutError struct{}

type InapplicableProxyTypeError struct {
	Transport string
	Proxy     url.URL
}

type InvalidUriError struct {
	Err string
}

type IvalidPeerPublicKey struct {
	Text string
}

type ProtoVersion struct {
	Major uint8 // For now, it is always 0
	Minor uint8
}

type Transport interface {
	// Returns URI scheme of current transport.
	// As example "tcp" or "tls".
	GetScheme() string
	// Establishes and returns a transport connection or returns an error.
	Connect(
		ctx context.Context, uri url.URL,
		proxy *url.URL, key ed25519.PrivateKey,
	) (ConnResult, error)
	// Returns listener object for accepting incoming transport connections.
	Listen(ctx context.Context, uri url.URL, key ed25519.PrivateKey) (TransportListener, error)
}

type TransportListener interface {
	// Accept waits for and returns the next connection to the listener.
	Accept() (net.Conn, error)

	// AcceptConn waits for and returns the next connection
	// with optional transport key to the listener.
	AcceptConn() (ConnResult, error)

	// Close closes the listener.
	// Any blocked Accept operations will be unblocked and return errors.
	Close() error

	// Addr returns the listener's network address.
	Addr() net.Addr
}

type TransportSecurityCheckError struct {
	Expected ed25519.PublicKey
	Received ed25519.PublicKey
}

type UnacceptableAddressError struct {
	Text string
}

type UnknownProtoError struct{}

type UnknownProtoVersionError struct {
	Expected ProtoVersion
	Received ProtoVersion
}

type UnknownSchemeError struct {
	Scheme string
}