tonic-h3

Experimental implementation of running tonic grpc on h3, following the proposal: G2-http3-protocol

tonic-h3 is targeted to support all quic transport implementations that integrates with h3. Currently the following are incoporated and tested:

• Quinn (h3-quinn)
• s2n-quic (s2n-quic-h3)
• msquic (msquic-h3).

See examples and tests for getting started.

Compatibility with grpc-dotnet with http3 is tested here.

Supporting crates

• axum-h3 Use axum with h3, used by tonic-h3 server.
• h3-util Http3 server and client utilities used by axum-h3 and tonic-h3.
• Other quic wrapping crates to support alternative quic implementations.

tonic examples

Server:

  async fn run_server(endpoint: h3_quinn::quinn::Endpoint) -> Result<(), tonic_h3::Error> {
      let router = tonic::transport::Server::builder()
          .add_service(GreeterServer::new(HelloWorldService {}));
      let acceptor = tonic_h3::quinn::H3QuinnAcceptor::new(endpoint.clone());
      tonic_h3::server::H3Router::from(router)
          .serve(acceptor)
          .await?;
      endpoint.wait_idle().await;
      Ok(())
  }

Client:

  async fn run_client(
      uri: http::Uri,
      client_endpoint: h3_quinn::quinn::Endpoint,
  ) -> Result<(), tonic_h3::Error> {
      let channel = tonic_h3::quinn::new_quinn_h3_channel(uri.clone(), client_endpoint.clone());
      let mut client = crate::greeter_client::GreeterClient::new(channel);
      let request = tonic::Request::new(crate::HelloRequest {
          name: "Tonic".into(),
      });
      let response = client.say_hello(request).await?;
      println!("RESPONSE={:?}", response);
      Ok(())
  }

License

MIT license. See LICENSE.