Baileys.NET 1.9.1

Baileys — WhatsApp Web Library for .NET 10

A .NET 10 port of the Baileys TypeScript library for interacting with the WhatsApp Web API.

Installation

dotnet add package Baileys.NET

Or via the NuGet Package Manager:

Install-Package Baileys.NET

Documentation

Full documentation is available in the docs/ folder:

Features

• Binary Protocol Codec — Encode and decode the WhatsApp binary node wire format (WABinary), including zlib decompression
• Cryptographic Utilities — AES-256-GCM/CBC/CTR, HMAC-SHA-256/512, SHA-256/MD5, HKDF, PBKDF2 — all via System.Security.Cryptography (no third-party deps)
• JID Utilities — Encode, decode, normalise, and classify JIDs (user, group, broadcast, newsletter, LID, hosted)
• Auth Utilities — InitAuthCreds(), Curve25519 key-pair generation, signed pre-key generation
• Noise Protocol Handler — Noise_XX_25519_AESGCM_SHA256 handshake state machine
• Complete Type Definitions — All WhatsApp types: Contact, Chat, GroupMetadata, Message, Call, Label, Newsletter, Business, Product, State, Event payloads
• Signal Key Store — ISignalKeyStore interface with in-memory (InMemorySignalKeyStore) and directory-backed (DirectorySignalKeyStore) implementations; typed extension helpers for every Signal data category (pre-key, session, sender-key, app-state-sync, lid-mapping, device-list, tctoken, identity-key)
• Full Authentication State — AuthenticationState bundles AuthenticationCreds + ISignalKeyStore exactly like the TypeScript AuthenticationState type; LoadAuthStateAsync() extension builds one from any IAuthStateProvider
• Directory Auth Provider — DirectoryAuthStateProvider stores credentials in creds.json and Signal keys as individual files in one directory, mirroring the TypeScript useMultiFileAuthState(folder) integration pattern
• Default Constants — WebSocket URL, noise-protocol constants, media HKDF key mappings, browser description presets, timing defaults
• Structured Logging — ILogger interface + NullLogger and ConsoleLogger implementations
• Dependency Injection — AddBaileys(), AddBaileysWithFileStorage(), AddBaileysWithDirectoryStorage(), AddBaileysWithProvider<T>() helpers
• Pluggable Session Storage — IAuthStateProvider interface with in-memory, file-based, and directory-based implementations
• Automatic Session Initiation — BaileysClient and BaileysClientHostedService automatically manage the WebSocket connection, Noise handshake, and QR code lifecycle

Quick Start

using Baileys;
using Baileys.Types;
using Baileys.Utils;
using Baileys.Extensions;

// ── Dependency injection (Program.cs) ────────────────────────────────────────
// This will automatically initiate a session and print the QR code to the console
// when the application starts.
builder.Services.AddBaileysWithDirectoryStorage(
    directory: "baileys_auth_info",
    configure: o => 
    {
        o.PhoneNumber = "15551234567";
        o.PrintQrInTerminal = true; // Default is true
    });

// ── Manual Connection (optional) ────────────────────────────────────────────
// If you prefer manual control, you can inject BaileysClient:
public class MyService(BaileysClient client)
{
    public async Task StartAsync()
    {
        // Subscribe to events
        client.Ev.On<ConnectionUpdateEvent>("connection.update", update => {
            if(update.Connection == WaConnectionState.Open) {
                Console.WriteLine("Connected!");
            }
        });

        await client.ConnectAsync();
    }
}

Namespace Map

Requirements

• .NET 10+
• Runtime NuGet dependencies: Microsoft.Extensions.DependencyInjection.Abstractions and Microsoft.Extensions.Options

License

MIT — see LICENSE