onion_crypto.h

Go to the documentation of this file.

/* Copyright (c) 2001 Matej Pfajfar.
 * Copyright (c) 2001-2004, Roger Dingledine.
 * Copyright (c) 2004-2006, Roger Dingledine, Nick Mathewson.
 * Copyright (c) 2007-2021, The Tor Project, Inc. */
/* See LICENSE for licensing information */
 
/**
 * \file onion_crypto.h
 * \brief Header file for onion_crypto.c.
 **/
 
#ifndef TOR_ONION_CRYPTO_H
#define TOR_ONION_CRYPTO_H
 
#include "lib/crypt_ops/crypto_ed25519.h"
#include "core/crypto/relay_crypto.h"
 
typedef struct server_onion_keys_t {
  uint8_t my_identity[DIGEST_LEN];
  ed25519_public_key_t my_ed_identity;
  crypto_pk_t *onion_key;
  crypto_pk_t *last_onion_key;
  struct di_digest256_map_t *curve25519_key_map;
  struct curve25519_keypair_t *junk_keypair;
} server_onion_keys_t;
 
void onion_handshake_state_release(onion_handshake_state_t *state);
 
/**
 * Parameters negotiated as part of a circuit handshake.
 */
typedef struct circuit_params_t {
  /** Is true if congestion control is enabled in consensus or param,
   * as per congestion_control_enabled() result. */
  bool cc_enabled;
  /** The number of cells in a sendme increment. Only used if cc_enabled=1. */
  uint8_t sendme_inc_cells;
 
  /** Which algorithm did we negotiate? */
  relay_crypto_alg_t crypto_alg;
  /** Which cell format did we negotiate? */
  relay_cell_fmt_t cell_fmt;
} circuit_params_t;
 
int onion_skin_create(int type,
                      const extend_info_t *node,
                      onion_handshake_state_t *state_out,
                      uint8_t *onion_skin_out,
                      size_t onion_skin_out_maxlen);
int onion_skin_server_handshake(int type,
                      const uint8_t *onion_skin, size_t onionskin_len,
                      const server_onion_keys_t *keys,
                      const circuit_params_t *ns_params,
                      uint8_t *reply_out,
                      size_t reply_out_maxlen,
                      uint8_t *keys_out, size_t *keys_len_out,
                      uint8_t *rend_nonce_out,
                      circuit_params_t *negotiated_params_out);
int onion_skin_client_handshake(int type,
                      const onion_handshake_state_t *handshake_state,
                      const uint8_t *reply, size_t reply_len,
                      uint8_t *keys_out, size_t *keys_out_len,
                      uint8_t *rend_authenticator_out,
                      circuit_params_t *negotiated_params_out,
                      const char **msg_out);
 
server_onion_keys_t *server_onion_keys_new(void);
void server_onion_keys_free_(server_onion_keys_t *keys);
#define server_onion_keys_free(keys) \
  FREE_AND_NULL(server_onion_keys_t, server_onion_keys_free_, (keys))
 
struct trn_extension_st;
struct trn_extension_field_st;
const struct trn_extension_field_st *trn_extension_find(
                                        const struct trn_extension_st *ext,
                                        uint8_t ext_type);
 
#endif /* !defined(TOR_ONION_CRYPTO_H) */