Skip to main content Link Search Menu Expand Document (external link)

WireguardServer overview

Utilities for connecting to the Wireguard demo server at demo.wireguard.com

Added in v1.0.0


Table of contents


Encoded types

WireguardDemoServerSchemaEncoded (type alias)

Signature

export type WireguardDemoServerSchemaEncoded = Schema.Schema.Encoded<typeof WireguardDemoServerSchema>

Added in v1.0.0

Schema

WireguardDemoServerSchema

Signature

export declare const WireguardDemoServerSchema: Schema.transform<
  Schema.TemplateLiteral<`OK:${string}:${number}:${string}\n`>,
  Schema.Struct<{
    serverPort: InternetSchemas.$Port
    serverPublicKey: Schema.brand<Schema.refine<string, Schema.Schema<string, string, never>>, "WireguardKey">
    yourWireguardAddress: InternetSchemas.$Address
  }>
>

Added in v1.0.0

Unbranded types

WireguardDemoServerSchema (type alias)

Signature

export type WireguardDemoServerSchema = Schema.Schema.Type<typeof WireguardDemoServerSchema>

Added in v1.0.0

utils

WireguardDemoServer

Mock implementation of the Wireguard demo server at demo.wireguard.com

Signature

export declare const WireguardDemoServer: (options: {
  maxPeers?: number | undefined
  serverEndpoint: InternetSchemas.Endpoint
  wireguardNetwork: InternetSchemas.CidrBlockFromStringEncoded
}) => Effect.Effect<
  void,
  | Socket.SocketError
  | ParseResult.ParseError
  | Cause.TimeoutException
  | WireguardErrors.WireguardError
  | PlatformError.PlatformError
  | SocketServer.SocketServerError,
  | Scope.Scope
  | FileSystem.FileSystem
  | Path.Path
  | SocketServer.SocketServer
  | WireguardControl.WireguardControl
  | CommandExecutor.CommandExecutor
>

Added in v1.0.0

requestGoogle

Attempts to connect to https://www.google.com to ensure that dns is still working and we can connect to the internet when the wireguard tunnel is up.

Signature

export declare const requestGoogle: Effect.Effect<
  void,
  Cause.TimeoutException | HttpClientError.HttpClientError,
  HttpClient.HttpClient.Default
>

Added in v1.0.0

requestHiddenPage

Attempts to view the hidden page on the demo.wireguard.com server, you should only be able to see it when connected as a peer.

Signature

export declare const requestHiddenPage: (
  hiddenPageLocation: string
) => Effect.Effect<string, HttpClientError.HttpClientError | Cause.TimeoutException, HttpClient.HttpClient.Default>

Added in v1.0.0

requestWireguardDemoConfig

Creates a Wireguard configuration to connect to demo.wireguard.com. When connected, you should be able to see the hidden page at 192.168.4.1

Signature

export declare const requestWireguardDemoConfig: (
  connectOptions?: { port: number; host: string },
  {
    privateKey,
    publicKey
  }?: { readonly privateKey: string & Brand<"WireguardKey">; readonly publicKey: string & Brand<"WireguardKey"> }
) => Effect.Effect<WireguardConfig.WireguardConfig, Socket.SocketError | ParseResult.ParseError, never>

Added in v1.0.0