docs: Add initialization of rustls crypto provider

README.md

@@ -129,6 +129,9 @@ async fn main() -> anyhow::Result<()> {
     // Initialize the tracing subscriber.
     tracing_subscriber::fmt::init();
 
+    // Select rustls backend
+    rustls::crypto::ring::default_provider().install_default().unwrap();
+
     let token = env::var("DISCORD_TOKEN")?;
 
     // Use intents to only receive guild message events.

book/src/chapter_1_crates/section_2_http.md

@@ -59,6 +59,9 @@ async fn main() -> Result<(), Box<dyn Error + Send + Sync>> {
     // Initialize the tracing subscriber.
     tracing_subscriber::fmt::init();
 
+    // Select rustls backend
+    rustls::crypto::ring::default_provider().install_default().unwrap();
+
     let client = Client::new(env::var("DISCORD_TOKEN")?);
 
     let me = client.current_user().await?.model().await?;

book/src/chapter_1_crates/section_3_gateway.md

@@ -89,6 +89,9 @@ async fn main() -> Result<(), Box<dyn Error + Send + Sync>> {
     // Initialize the tracing subscriber.
     tracing_subscriber::fmt::init();
 
+    // Select rustls backend
+    rustls::crypto::ring::default_provider().install_default().unwrap();
+
     let token = env::var("DISCORD_TOKEN")?;
     let intents = Intents::GUILD_MESSAGES;
     let mut shard = Shard::new(ShardId::ONE, token, intents);

book/src/chapter_1_crates/section_7_first_party/section_3_lavalink.md

@@ -61,6 +61,12 @@ use twilight_lavalink::Lavalink;
 
 #[tokio::main]
 async fn main() -> Result<(), Box<dyn Error + Send + Sync + 'static>> {
+    // Initialize the tracing subscriber.
+    tracing_subscriber::fmt::init();
+
+    // Select rustls backend
+    rustls::crypto::ring::default_provider().install_default().unwrap();
+
     let token = env::var("DISCORD_TOKEN")?;
     let lavalink_host = SocketAddr::from_str(&env::var("LAVALINK_HOST")?)?;
     let lavalink_auth = env::var("LAVALINK_AUTHORIZATION")?;

examples/cache-optimization/main.rs

@@ -12,6 +12,9 @@ mod models;
 async fn main() -> anyhow::Result<()> {
     tracing_subscriber::fmt::init();
 
+    // Select rustls backend
+    rustls::crypto::ring::default_provider().install_default().unwrap();
+
     let event_types = EventTypeFlags::MESSAGE_CREATE
         | EventTypeFlags::GUILD_CREATE
         | EventTypeFlags::GUILD_UPDATE

examples/gateway-queue-http.rs

@@ -39,6 +39,9 @@ impl Queue for HttpQueue {
 async fn main() -> anyhow::Result<()> {
     tracing_subscriber::fmt::init();
 
+    // Select rustls backend
+    rustls::crypto::ring::default_provider().install_default().unwrap();
+
     let token = env::var("DISCORD_TOKEN")?;
     let intents = Intents::GUILDS | Intents::GUILD_VOICE_STATES;
 

examples/gateway-request-members.rs

@@ -6,6 +6,9 @@ use twilight_model::{gateway::payload::outgoing::RequestGuildMembers, id::Id};
 async fn main() -> anyhow::Result<()> {
     tracing_subscriber::fmt::init();
 
+    // Select rustls backend
+    rustls::crypto::ring::default_provider().install_default().unwrap();
+
     let mut shard = Shard::new(
         ShardId::ONE,
         env::var("DISCORD_TOKEN")?,

examples/gateway-reshard.rs

@@ -21,6 +21,9 @@ use twilight_http::Client;
 async fn main() -> anyhow::Result<()> {
     tracing_subscriber::fmt::init();
 
+    // Select rustls backend
+    rustls::crypto::ring::default_provider().install_default().unwrap();
+
     let token = env::var("DISCORD_TOKEN")?;
     let client = Client::new(token.clone());
     let config = Config::new(token, Intents::GUILDS);

examples/http-allowed-mentions.rs

@@ -7,6 +7,9 @@ async fn main() -> anyhow::Result<()> {
     // Initialize the tracing subscriber.
     tracing_subscriber::fmt::init();
 
+    // Select rustls backend
+    rustls::crypto::ring::default_provider().install_default().unwrap();
+
     //if we want to set the default for allowed mentions we need to use the builder, keep in mind these calls can't be chained!
     let client = Client::builder()
         .token(env::var("DISCORD_TOKEN")?)

examples/http-get-message.rs

@@ -8,6 +8,9 @@ async fn main() -> anyhow::Result<()> {
     // Initialize the tracing subscriber.
     tracing_subscriber::fmt::init();
 
+    // Select rustls backend
+    rustls::crypto::ring::default_provider().install_default().unwrap();
+
     let client = Client::new(env::var("DISCORD_TOKEN")?);
     let channel_id = Id::new(381_926_291_785_383_946);
 

examples/http-proxy.rs

@@ -8,6 +8,9 @@ async fn main() -> anyhow::Result<()> {
     // Initialize the tracing subscriber.
     tracing_subscriber::fmt::init();
 
+    // Select rustls backend
+    rustls::crypto::ring::default_provider().install_default().unwrap();
+
     let client = Client::builder()
         .proxy("localhost:3000".to_owned(), true)
         .ratelimiter(None)

examples/lavalink-basic-bot.rs

@@ -44,6 +44,9 @@ async fn main() -> anyhow::Result<()> {
     // Initialize the tracing subscriber.
     tracing_subscriber::fmt::init();
 
+    // Select rustls backend
+    rustls::crypto::ring::default_provider().install_default().unwrap();
+
     let (mut shard, state) = {
         let token = env::var("DISCORD_TOKEN")?;
         let lavalink_host = SocketAddr::from_str(&env::var("LAVALINK_HOST")?)?;

examples/model-webhook-slash.rs

@@ -173,6 +173,9 @@ async fn main() -> anyhow::Result<()> {
     // Initialize the tracing subscriber.
     tracing_subscriber::fmt::init();
 
+    // Select rustls backend
+    rustls::crypto::ring::default_provider().install_default().unwrap();
+
     // Local address to bind the service to.
     let addr = SocketAddr::from(([127, 0, 0, 1], 3030));
 

twilight-gateway/README.md

@@ -50,6 +50,9 @@ use twilight_model::gateway::payload::{incoming::MessageCreate, outgoing::Update
 async fn main() -> anyhow::Result<()> {
     tracing_subscriber::fmt::init();
 
+    // Select rustls backend
+    rustls::crypto::ring::default_provider().install_default().unwrap();
+
     let token = env::var("DISCORD_TOKEN")?;
 
     let (shutdown_tx, shutdown_rx) = watch::channel(false);