Ircd Specification

Ircd use Hashchain to maintain the synchronization between nodes. The messages are handled as events in Ircd network.

PrivMsgEvent

This is the main message type inside Ircd. The PrivMsgEvent is an event action.

| Description | Data Type | Comments | |-------------- |-------------- | ------------------------------------------------------------------------- | | nickname | String | The nickname for the sender (must be less than 32 chars) | | target | String | The target for the message (recipient) | | message | String | The actual content of the message |

ChannelInfo

Preconfigured channel in the configuration file.

In the TOML configuration file, the channel is set as such:

[channel."#dev"]
secret = "GvH4kno3kUu6dqPrZ8zjMhqxTUDZ2ev16EdprZiZJgj1"
topic = "DarkFi Development Channel"

ContactInfo

Preconfigured contact in the configuration file.

In the TOML configuration file, the contact is set as such:

[contact."nick"]
pubkey = "7CkVuFgwTUpJn5Sv67Q3fyEDpa28yrSeL5Hg2GqQ4jfM"

Description	Data Type	Comments
topic	String	Optional topic for the channel
secret	String	Optional NaCl box for the channel, used for {en,de}cryption.
joined	bool	Indicate whether the user has joined the channel
names	Vec	All nicknames which are visible on the channel

Description	Data Type	Comments
pubkey	String	A Public key for the contact to encrypt the message

IrcConfig

The base Irc configuration for each new IrcClient.

IrcServer

The server start listening to an address specifed in the configuration file.

For each irc client get connected, an IrcClient instance created.

Description	Data Type	Comments
is_nick_init	bool	Confirmation of receiving /nick command
is_user_init	bool	Confirmation of receiving /user command
is_cap_end	bool	Indicate whether the irc client finished the Client Capability Negotiation
is_pass_init	bool	Confirmation of checking the password in the configuration file
is_registered	bool	Indicate the `IrcClient` is initialized and ready to sending/receiving messages
nickname	String	The irc client nickname
password	String	The password for the irc client. (it could be empty)
private_key	Option	A private key to decrypt direct messages from contacts
capabilities	HashMap	A list of capabilities for the irc clients and the server to negotiate
auto_channels	Vec	Auto join channels for the irc clients
channels	HashMap	A list of preconfigured channels in the configuration file
contacts	HashMap	A list of preconfigured contacts in the configuration file for direct message

Description	Data Type	Comments
settings	`Settings`	The base settings parsed from the configuration file
clients_subscriptions	SubscriberPtr<`ClientSubMsg`>	Channels to notify the `IrcClient`s about new data

IrcClient

The IrcClient handle all irc opeartions and commands from the irc client.

Communications between the server and the clients

Two Communication channels get initialized by the server for every new IrcClient.

The channel Channel<(NotifierMsg, u64)> used by the IrcClient to notify the server about new messages/queries received from the irc client.

The channel Subscription<ClientSubMsg> used by the server to notify IrcClients about new messages/queries fetched from the View.

ClientSubMsg

enum ClientSubMsg {
    Privmsg(`PrivMsgEvent`),
    Config(`IrcConfig`),    
}

NotifierMsg

enum NotifierMsg {
    Privmsg(`PrivMsgEvent`),
    UpdateConfig,
}

Description	Data Type	Comments
write_stream	WriteHalf	A writer for sending data to the connection stream
read_stream	ReadHalf	Read data from the connection stream
address	SocketAddr	The actual address for the irc client connection
irc_config	`IrcConfig`	Base configuration for irc
server_notifier	Channel<(`NotifierMsg`, u64)>	A Channel to notify the server about a new data from the irc client
subscription	Subscription<`ClientSubMsg`>	A channel to receive notification from the server

specification.md 5.3 KB Istoric Crud