ServeIrohTcpUpstreamOptions
Defined in: src/launcher/serve-iroh.ts:11
Options for the raw loopback upstream consumed by vgi-iroh-bridge.
Extends
Section titled “Extends”Omit<ServeTcpOptions, |"host"|"peerIdentityProviders"|"peerAuthenticationPolicy"|"proxyProtocolV2Required"|"trustedProxyAddresses"|"irohProxyIssuer">
Properties
Section titled “Properties”announcementSink?
Section titled “announcementSink?”optional announcementSink?: WritableStream;Defined in: src/launcher/serve-tcp.ts:100
Override the stream used for the TCP:<host>:<port> line. Defaults to
process.stdout.
Inherited from
Section titled “Inherited from”ServeTcpOptions.announcementSink
authenticate?
Section titled “authenticate?”readonly optional authenticate?: boolean;Defined in: src/launcher/serve-iroh.ts:28
Promote the verified EndpointId to AuthContext. Defaults to true.
backlog?
Section titled “backlog?”optional backlog?: number;Defined in: src/launcher/serve-tcp.ts:93
Maximum listen backlog. Default: 128.
Inherited from
Section titled “Inherited from”dispatchHook?
Section titled “dispatchHook?”optional dispatchHook?: DispatchHook;Defined in: src/launcher/serve-tcp.ts:87
Optional dispatch hook for observability.
Inherited from
Section titled “Inherited from”enableDescribe?
Section titled “enableDescribe?”optional enableDescribe?: boolean;Defined in: src/launcher/serve-tcp.ts:85
Host vgi_rpc.Reflection.v1. Default: true.
Named for the __describe__ method it used to switch on. What it gates
is introspection, which is now a co-hosted protocol rather than a
reserved method answered before dispatch.
Inherited from
Section titled “Inherited from”ServeTcpOptions.enableDescribe
externalLocation?
Section titled “externalLocation?”optional externalLocation?: ExternalLocationConfig;Defined in: src/launcher/serve-tcp.ts:89
Optional external-storage config for large-batch externalisation.
Inherited from
Section titled “Inherited from”ServeTcpOptions.externalLocation
readonly optional host?: "localhost" | "127.0.0.1" | "::1";Defined in: src/launcher/serve-iroh.ts:24
Loopback bind address. Defaults to 127.0.0.1.
identityResolutionTimeoutMs?
Section titled “identityResolutionTimeoutMs?”optional identityResolutionTimeoutMs?: number;Defined in: src/launcher/serve-tcp.ts:109
Total provider-resolution budget per accepted connection. Default: 1000 ms.
Inherited from
Section titled “Inherited from”ServeTcpOptions.identityResolutionTimeoutMs
idleTimeout?
Section titled “idleTimeout?”optional idleTimeout?: number;Defined in: src/launcher/serve-tcp.ts:71
Self-terminate after this many seconds with zero connected clients.
Default: 300. 0 disables the timer (server runs until killed).
Inherited from
Section titled “Inherited from”issuer
Section titled “issuer”readonly issuer: string;Defined in: src/launcher/serve-iroh.ts:22
Operator-controlled identity namespace.
maximumProxyPreambleBytes?
Section titled “maximumProxyPreambleBytes?”optional maximumProxyPreambleBytes?: number;Defined in: src/launcher/serve-tcp.ts:119
Maximum complete PROXY v2 preamble size, including bounded unknown TLVs. Default: 536.
Inherited from
Section titled “Inherited from”ServeTcpOptions.maximumProxyPreambleBytes
onBound?
Section titled “onBound?”optional onBound?: (host, port) => void;Defined in: src/launcher/serve-tcp.ts:97
Called after listen() returns successfully but before
TCP:<host>:<port> is printed. Invoked with the bound host and the
actual bound port (resolved when port=0).
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
host |
string |
port |
number |
Returns
Section titled “Returns”void
Inherited from
Section titled “Inherited from”onServeStart?
Section titled “onServeStart?”optional onServeStart?: ServeStartHook;Defined in: src/launcher/serve-tcp.ts:91
Lifecycle hook fired once before the first dispatched request.
Inherited from
Section titled “Inherited from”peerProviderConcurrency?
Section titled “peerProviderConcurrency?”optional peerProviderConcurrency?: number;Defined in: src/launcher/serve-tcp.ts:111
Maximum provider calls that may remain active after connection deadlines. Default: 64.
Inherited from
Section titled “Inherited from”ServeTcpOptions.peerProviderConcurrency
peerServiceName?
Section titled “peerServiceName?”optional peerServiceName?: string;Defined in: src/launcher/serve-tcp.ts:107
Logical service destination supplied to destination-aware providers.
Inherited from
Section titled “Inherited from”ServeTcpOptions.peerServiceName
optional port?: number;Defined in: src/launcher/serve-tcp.ts:68
TCP port to bind. Defaults to 0, which lets the OS pick a free port
(reported via the TCP:<host>:<port> line and onBound).
Inherited from
Section titled “Inherited from”protocolVersion?
Section titled “protocolVersion?”optional protocolVersion?: string;Defined in: src/launcher/serve-tcp.ts:77
Optional logical-service / protocol-contract version label.
Inherited from
Section titled “Inherited from”ServeTcpOptions.protocolVersion
proxyPreambleTimeoutMs?
Section titled “proxyPreambleTimeoutMs?”optional proxyPreambleTimeoutMs?: number;Defined in: src/launcher/serve-tcp.ts:117
Independent deadline for the complete PROXY v2 preamble. Default: 1000 ms.
Inherited from
Section titled “Inherited from”ServeTcpOptions.proxyPreambleTimeoutMs
serverId?
Section titled “serverId?”optional serverId?: string;Defined in: src/launcher/serve-tcp.ts:79
Custom server identifier.
Inherited from
Section titled “Inherited from”startupGraceSeconds?
Section titled “startupGraceSeconds?”optional startupGraceSeconds?: number;Defined in: src/launcher/serve-tcp.ts:75
Grace period after listen() succeeds before the idle timer starts
ticking. Default: 5 — gives the first launcher caller a chance to
connect after the TCP:<host>:<port> announcement.
Inherited from
Section titled “Inherited from”ServeTcpOptions.startupGraceSeconds
trustedProxyAddresses?
Section titled “trustedProxyAddresses?”readonly optional trustedProxyAddresses?: readonly string[];Defined in: src/launcher/serve-iroh.ts:26
Exact immediate bridge addresses. Defaults to IPv4 loopback.