Proxylity.Templates 1.0.10

Proxylity Templates for .NET

This package includes templates for creating .NET Lambda function projects for use with Proxylity UDP Gateway.

Template variations include async and synchronous implementations, standard runtime and Ahead-of-Time (AoT) compilation, and support for UDP and WireGuard Listeners:

Choosing a Lambda Template

Templates for UDP include a Handler that receives a UdpGatewayMessage parameter and produces a byte[]? response. Returning null indicates no response to the sending is required. A non-null return will become the response packet payload. These are the right choice for handling raw UDP.

Templates for WireGuard include a Handler that receives PacketDotNet.UdpPacket packet, RemoteEndpoint remote parameters and produces byte[]? return values. The packet parameter will represent the decapsulated IP packet sent over the tunnel (with the tunnel header and encryption removed). These are the right choice when using a WireGuard tunnel to protect packet data in transit to Proxylity.

The async versions of the UDP or WireGuard templates are the best default choice. The Handler will be declared as async and return a Task<?> to allow for asynchronous operations in the handler. In cases where the Lambda will perform compute-intensive work without asynchronous external calls (e.g. to other AWS services), then the non-async variations may be suitable.

The aot versions of the templates offer improved cold-start and overall performance. The project will include the PublishAot setting and a Program.cs file that bootstraps the Lambda. When using AoT, the AWS::Serverless::Function resource will be declared with the Runtime set to provided.al2023 and the Handler to bootstrap. The tradeoff with AoT is giving-up the runtime patching and upgrades that AWS does behind the scenes with the standard runtimes.

Installation

dotnet new install Proxylity.Templates

Usage

To create a UDP handler project:

dotnet new proxylity-udp-async-aot -n "MyCo.UdpHandler"

To create a WireGuard handler project:

dotnet new proxylity-wg-async-aot -n "MyCo.WireGuardHandler"

<small>Copyright 2025 Proxylity LLC. UDP Gateway is a trademark of Proxylity LLC.</small>