discordjs · kodiakhq · Jul 13, 2025 · Jun 4, 2025 · Jun 4, 2025 · Jun 4, 2025
@@ -344,7 +344,11 @@ describe('VoiceConnection#configureNetworking', () => {
 				sessionId: state.session_id,
 				userId: state.user_id,
 			},
-			false,
+			{
+				daveEncryption: true,
+				debug: false,
+				decryptionFailureTolerance: undefined,
+			},
 		);
 		expect(voiceConnection.state).toMatchObject({
 			status: VoiceConnectionStatus.Connecting,

@@ -4,7 +4,7 @@
 import { Buffer } from 'node:buffer';
 import { once } from 'node:events';
 import process from 'node:process';
-import { VoiceOpcodes } from 'discord-api-types/voice/v4';
+import { VoiceOpcodes } from 'discord-api-types/voice/v8';
 import { describe, test, expect, vitest, beforeEach } from 'vitest';
 import {
 	RTP_PACKET_DESKTOP,
@@ -141,36 +141,6 @@ describe('VoiceReceiver', () => {
 				userId: '123abc',
 			});
 		});
-
-		test('CLIENT_CONNECT packet', () => {
-			const spy = vitest.spyOn(receiver.ssrcMap, 'update');
-			receiver['onWsPacket']({
-				op: VoiceOpcodes.ClientConnect,
-				d: {
-					audio_ssrc: 123,
-					video_ssrc: 43,
-					user_id: '123abc',
-				},
-			});
-			expect(spy).toHaveBeenCalledWith({
-				audioSSRC: 123,
-				videoSSRC: 43,
-				userId: '123abc',
-			});
-			receiver['onWsPacket']({
-				op: VoiceOpcodes.ClientConnect,
-				d: {
-					audio_ssrc: 123,
-					video_ssrc: 0,
-					user_id: '123abc',
-				},
-			});
-			expect(spy).toHaveBeenCalledWith({
-				audioSSRC: 123,
-				videoSSRC: undefined,
-				userId: '123abc',
-			});
-		});
 	});
 
 	describe('decrypt', () => {

@@ -1,5 +1,5 @@
 import { type EventEmitter, once } from 'node:events';
-import { VoiceOpcodes } from 'discord-api-types/voice/v4';
+import { VoiceOpcodes } from 'discord-api-types/voice/v8';
 import { describe, test, expect, beforeEach } from 'vitest';
 import WS from 'vitest-websocket-mock';
 import { VoiceWebSocket } from '../src/networking/VoiceWebSocket';

@@ -64,7 +64,7 @@
 	"funding": "https://github.com/discordjs/discord.js?sponsor",
 	"dependencies": {
 		"@types/ws": "^8.18.1",
-		"discord-api-types": "^0.38.1",
+		"discord-api-types": "^0.38.11",
 		"prism-media": "^1.3.5",
 		"tslib": "^2.8.1",
 		"ws": "^8.18.1"
@@ -75,6 +75,7 @@
 		"@discordjs/scripts": "workspace:^",
 		"@favware/cliff-jumper": "^4.1.0",
 		"@noble/ciphers": "^1.2.1",
+		"@snazzah/davey": "^0.1.5",
 		"@types/node": "^22.15.2",
 		"@vitest/coverage-v8": "^3.1.1",
 		"cross-env": "^7.0.3",

@@ -182,6 +182,12 @@ export interface VoiceConnection extends EventEmitter {
 	 * @eventProperty
 	 */
 	on(event: 'stateChange', listener: (oldState: VoiceConnectionState, newState: VoiceConnectionState) => void): this;
+	/**
+	 * Emitted when the end-to-end encrypted session has transitioned
+	 *
+	 * @eventProperty
+	 */
+	on(event: 'transitioned', listener: (transitionId: number) => void): this;
 	/**
 	 * Emitted when the state of the voice connection changes to a specific status
 	 *
@@ -235,6 +241,11 @@ export class VoiceConnection extends EventEmitter {
 	 */
 	private readonly debug: ((message: string) => void) | null;
 
+	/**
+	 * The options used to create this voice connection.
+	 */
+	private readonly options: CreateVoiceConnectionOptions;
+
 	/**
 	 * Creates a new voice connection.
 	 *
@@ -253,6 +264,7 @@ export class VoiceConnection extends EventEmitter {
 		this.onNetworkingStateChange = this.onNetworkingStateChange.bind(this);
 		this.onNetworkingError = this.onNetworkingError.bind(this);
 		this.onNetworkingDebug = this.onNetworkingDebug.bind(this);
+		this.onNetworkingTransitioned = this.onNetworkingTransitioned.bind(this);
 
 		const adapter = options.adapterCreator({
 			onVoiceServerUpdate: (data) => this.addServerPacket(data),
@@ -268,6 +280,7 @@ export class VoiceConnection extends EventEmitter {
 		};
 
 		this.joinConfig = joinConfig;
+		this.options = options;
 	}
 
 	/**
@@ -295,6 +308,7 @@ export class VoiceConnection extends EventEmitter {
 				oldNetworking.off('error', this.onNetworkingError);
 				oldNetworking.off('close', this.onNetworkingClose);
 				oldNetworking.off('stateChange', this.onNetworkingStateChange);
+				oldNetworking.off('transitioned', this.onNetworkingTransitioned);
 				oldNetworking.destroy();
 			}
 
@@ -412,14 +426,20 @@ export class VoiceConnection extends EventEmitter {
 				token: server.token,
 				sessionId: state.session_id,
 				userId: state.user_id,
+				channelId: state.channel_id!,
+			},
+			{
+				debug: Boolean(this.debug),
+				daveEncryption: this.options.daveEncryption ?? true,
+				decryptionFailureTolerance: this.options.decryptionFailureTolerance,
 			},
-			Boolean(this.debug),
 		);
 
 		networking.once('close', this.onNetworkingClose);
 		networking.on('stateChange', this.onNetworkingStateChange);
 		networking.on('error', this.onNetworkingError);
 		networking.on('debug', this.onNetworkingDebug);
+		networking.on('transitioned', this.onNetworkingTransitioned);
 
 		this.state = {
 			...this.state,
@@ -509,6 +529,15 @@ export class VoiceConnection extends EventEmitter {
 		this.debug?.(`[NW] ${message}`);
 	}
 
+	/**
+	 * Propagates transitions from the underlying network instance.
+	 *
+	 * @param transitionId - The transition ID
+	 */
+	private onNetworkingTransitioned(transitionId: number) {
+		this.emit('transitioned', transitionId);
+	}
+
 	/**
 	 * Prepares an audio packet for dispatch.
 	 *
@@ -694,6 +723,41 @@ export class VoiceConnection extends EventEmitter {
 		};
 	}
 
+	/**
+	 * The current voice privacy code of the encrypted session.
+	 *
+	 * @remarks
+	 * For this data to be available, the VoiceConnection must be in the Ready state,
+	 * and the connection would have to be end-to-end encrypted.
+	 */
+	public get voicePrivacyCode() {
+		if (
+			this.state.status === VoiceConnectionStatus.Ready &&
+			this.state.networking.state.code === NetworkingStatusCode.Ready
+		) {
+			return this.state.networking.state.dave?.voicePrivacyCode ?? undefined;
+		}
+
+		return undefined;
+	}
+
+	/**
+	 * Gets the verification code for a user in the session.
+	 *
+	 * @throws Will throw if end-to-end encryption is not on or if the user ID provided is not in the session.
+	 */
+	public async getVerificationCode(userId: string): Promise<string> {
+		if (
+			this.state.status === VoiceConnectionStatus.Ready &&
+			this.state.networking.state.code === NetworkingStatusCode.Ready &&
+			this.state.networking.state.dave
+		) {
+			return this.state.networking.state.dave.getVerificationCode(userId);
+		}
+
+		throw new Error('Session not available');
+	}
+
 	/**
 	 * Called when a subscription of this voice connection to an audio player is removed.
 	 *

@@ -19,6 +19,7 @@ export {
 	VoiceUDPSocket,
 	VoiceWebSocket,
 	type SocketConfig,
+	DAVESession,
 } from './networking/index.js';
 
 export {

@@ -8,11 +8,22 @@ import type { DiscordGatewayAdapterCreator } from './util/adapter';
 export interface CreateVoiceConnectionOptions {
 	adapterCreator: DiscordGatewayAdapterCreator;
 
+	/**
+	 * Whether to use the DAVE protocol for end-to-end encryption. Defaults to true.
+	 */
+	daveEncryption?: boolean | undefined;
+
 	/**
 	 * If true, debug messages will be enabled for the voice connection and its
 	 * related components. Defaults to false.
 	 */
 	debug?: boolean | undefined;
+
+	/**
+	 * The amount of consecutive decryption failures needed to try to
+	 * re-initialize the end-to-end encrypted session to recover. Defaults to 24.
+	 */
+	decryptionFailureTolerance?: number | undefined;
 }
 
 /**
@@ -61,5 +72,7 @@ export function joinVoiceChannel(options: CreateVoiceConnectionOptions & JoinVoi
 	return createVoiceConnection(joinConfig, {
 		adapterCreator: options.adapterCreator,
 		debug: options.debug,
+		daveEncryption: options.daveEncryption,
+		decryptionFailureTolerance: options.decryptionFailureTolerance,
 	});
 }