f2e5af4058
This commit changes the Stream interface, so as to allow the yamux protocol to have channels. It is necessary, but touches many areas. The codebase is better for it.
67 lines
2.3 KiB
C
67 lines
2.3 KiB
C
#pragma once
|
|
|
|
#include "libp2p/crypto/key.h"
|
|
#include "libp2p/crypto/rsa.h"
|
|
#include "libp2p/conn/session.h"
|
|
#include "libp2p/peer/peerstore.h"
|
|
#include "libp2p/net/protocol.h"
|
|
|
|
/**
|
|
* Handling of a secure connection
|
|
*/
|
|
|
|
struct SecioContext {
|
|
struct Stream* stream;
|
|
struct SessionContext* session_context;
|
|
struct RsaPrivateKey* private_key;
|
|
struct Peerstore* peer_store;
|
|
struct StreamMessage* buffered_message;
|
|
size_t buffered_message_pos;
|
|
};
|
|
|
|
struct Libp2pProtocolHandler* libp2p_secio_build_protocol_handler(struct RsaPrivateKey* private_key, struct Peerstore* peer_store);
|
|
|
|
/***
|
|
* Initiates a secio handshake. Use this method when you want to initiate a secio
|
|
* session. This should not be used to respond to incoming secio requests
|
|
* @param parent_stream the parent stream
|
|
* @param remote_peer the remote peer
|
|
* @param peerstore the peerstore
|
|
* @param rsa_private_key the local private key
|
|
* @returns a Secio Stream
|
|
*/
|
|
struct Stream* libp2p_secio_stream_new(struct Stream* parent_stream, struct Libp2pPeer* remote_peer, struct Peerstore* peerstore, struct RsaPrivateKey* rsa_private_key);
|
|
|
|
/***
|
|
* Initiates a secio handshake. Use this method when you want to initiate a secio
|
|
* session. This should not be used to respond to incoming secio requests
|
|
* @param ctx the SecioContext
|
|
* @returns true(1) on success, false(0) otherwise
|
|
*/
|
|
int libp2p_secio_initiate_handshake(struct SecioContext* ctx);
|
|
|
|
/***
|
|
* Send the protocol string to the remote stream
|
|
* @param stream stream
|
|
* @returns true(1) on success, false(0) otherwise
|
|
*/
|
|
int libp2p_secio_send_protocol(struct Stream* stream);
|
|
|
|
/***
|
|
* Attempt to read the secio protocol as a reply from the remote
|
|
* @param session the context
|
|
* @returns true(1) if we received what we think we should have, false(0) otherwise
|
|
*/
|
|
int libp2p_secio_receive_protocol(struct Stream* stream);
|
|
|
|
/***
|
|
* performs initial communication over an insecure channel to share
|
|
* keys, IDs, and initiate connection. This is a framed messaging system
|
|
* NOTE: session must contain a valid socket_descriptor that is a multistream.
|
|
* @param local_session the secure session to be filled
|
|
* @param private_key our private key to use
|
|
* @param peerstore the collection of peers
|
|
* @returns true(1) on success, false(0) otherwise
|
|
*/
|
|
int libp2p_secio_handshake(struct SecioContext* secio_context);
|
|
|