v2026.5.3
All Bundles
Bundle Provides network support

TCPSecureSocket

Secure SSL TCP/IP socket

Operations

Close #

Closes the socket

method : public : Close() ~ Nil

Flush #

Flushes the output buffer. This is a no-opt given this socket is not backed by an output buffer.

method : public : Flush() ~ Nil

GetAddress #

Returns the connected network address

method : public : GetAddress() ~ String

Return

TypeDescription
Stringreturn network address

GetCertFingerprint #

Returns the SHA-256 fingerprint of the peer certificate as a hex string

method : public : GetCertFingerprint() ~ String

Return

TypeDescription
String64-char hex fingerprint, or Nil if unavailable

GetIssuer #

Gets the X.509 certificate issuer name

method : public : GetIssuer() ~ String

Return

TypeDescription
Stringcertificate issuer name

GetLastError # function

Get the last error

function : GetLastError() ~ String

Return

TypeDescription
Stringlast error message, or Nil of no error

GetPort #

Returns the connected network port

method : public : GetPort() ~ Int

Return

TypeDescription
Intreturn network port

GetSubject #

Gets the X.509 certificate subject name

method : public : GetSubject() ~ String

Return

TypeDescription
Stringcertificate subject name

IsOpen #

Returns rather the socket is open

method : public : IsOpen() ~ Bool

Return

TypeDescription
Booltrue if socket is open, false otherwise

New # constructor

Default constructor

New(address:System.String, port:Int, pem:String)

Parameters

NameTypeDescription
addressStringnetwork address
portIntnetwork port
pemStringthe Privacy Enhanced Mail file (optional)

ReadBuffer #

Reads bytes into a byte buffer

method : public : ReadBuffer(offset:Int, num:Int, buffer:Byte[]) ~ Int

Parameters

NameTypeDescription
offsetIntdestination buffer offset
numIntnumber of values to read
bufferByteinput buffer

Return

TypeDescription
Intnumber of values read

ReadBuffer #

Reads bytes into a character buffer

method : public : ReadBuffer(offset:Int, num:Int, buffer:Char[]) ~ Int

Parameters

NameTypeDescription
offsetIntdestination buffer offset
numIntnumber of values to read
bufferCharinput buffer

Return

TypeDescription
Intnumber of values read

ReadByte #

Reads a byte

method : public : ReadByte() ~ Byte

Return

TypeDescription
Bytebyte read

ReadLine # native

Reads a string until a newline or character return is detected

method : public : native : ReadLine() ~ System.String

Return

TypeDescription
Stringcharacter string

Select #

Checks if read/write data is available

method : public : Select(is_write:Bool) ~ Int

Parameters

NameTypeDescription
is_writeBoolif true check for write, otherwise read

Return

TypeDescription
Int1 if ready, 0 if not ready, -1 is error

SetKeepAlive #

Sets the TCP keep-alive option

method : public : SetKeepAlive(enable:Bool) ~ Bool

Parameters

NameTypeDescription
enableBooltrue to enable, false to disable

Return

TypeDescription
Booltrue if successful

SetMinTLSVersion #

Sets minimum TLS protocol version. Call before New() to take effect. Use mbedTLS MBEDTLS_SSL_VERSION_* constants.

method : public : SetMinTLSVersion(ver:Int) ~ Bool

Parameters

NameTypeDescription
verIntTLS version constant

Return

TypeDescription
Booltrue if successful

SetNoDelay #

Disables Nagle's algorithm (TCP_NODELAY)

method : public : SetNoDelay(enable:Bool) ~ Bool

Parameters

NameTypeDescription
enableBooltrue to disable Nagle, false to re-enable

Return

TypeDescription
Booltrue if successful

SetRecvBufferSize #

Sets the receive buffer size

method : public : SetRecvBufferSize(bytes:Int) ~ Bool

Parameters

NameTypeDescription
bytesIntbuffer size in bytes

Return

TypeDescription
Booltrue if successful

SetRecvTimeout #

Sets the receive timeout

method : public : SetRecvTimeout(ms:Int) ~ Bool

Parameters

NameTypeDescription
msInttimeout in milliseconds

Return

TypeDescription
Booltrue if successful

SetSendBufferSize #

Sets the send buffer size

method : public : SetSendBufferSize(bytes:Int) ~ Bool

Parameters

NameTypeDescription
bytesIntbuffer size in bytes

Return

TypeDescription
Booltrue if successful

SetSendTimeout #

Sets the send timeout

method : public : SetSendTimeout(ms:Int) ~ Bool

Parameters

NameTypeDescription
msInttimeout in milliseconds

Return

TypeDescription
Booltrue if successful

SetVerifyPeer #

Enables strict peer certificate verification

method : public : SetVerifyPeer(strict:Bool) ~ Bool

Parameters

NameTypeDescription
strictBooltrue to require valid certificate chain

Return

TypeDescription
Booltrue if successful

WriteBuffer #

Writes bytes from a byte buffer

method : public : WriteBuffer(buffer:Byte[]) ~ Int

Parameters

NameTypeDescription
bufferByteinput buffer

Return

TypeDescription
Intnumber of values written

WriteBuffer #

Writes bytes from a byte buffer

method : public : WriteBuffer(offset:Int, num:Int, buffer:Byte[]) ~ Int

Parameters

NameTypeDescription
offsetIntdestination buffer offset
numIntnumber of values to write
bufferByteinput buffer

Return

TypeDescription
Intnumber of values written

WriteBuffer #

Writes characters from a byte buffer

method : public : WriteBuffer(buffer:Char[]) ~ Int

Parameters

NameTypeDescription
bufferCharinput buffer

Return

TypeDescription
Intnumber of values written

WriteBuffer #

Writes characters from a character buffer

method : public : WriteBuffer(offset:Int, num:Int, buffer:Char[]) ~ Int

Parameters

NameTypeDescription
offsetIntdestination buffer offset
numIntnumber of values to write
bufferCharinput buffer

Return

TypeDescription
Intnumber of values written

WriteByte #

Writes a byte

method : public : WriteByte(b:Int) ~ Bool

Parameters

NameTypeDescription
bIntbyte to write

Return

TypeDescription
Booltrue if byte was written, false otherwise

WriteString #

Writes a character string

method : public : WriteString(str:System.String) ~ Nil

Parameters

NameTypeDescription
strStringstring to be written