将相应修改的demo.rs的Emyzelium文件放置在这些PC上，并且成功构建了demo可执行文件后，执行以下操作

pc1$ cargo run --release --example demo Alien

pc2$ cargo run --release --example demo John

pc3$ cargo run --release --example demo Mary

并且应该观察到几乎与上面相同的结果。

安全和密钥

Emyzelium依赖于ZeroMQ的Curve和ZAP加密和身份验证方案，以及各种公钥加密（假定具备基本知识）。因此，emyzelium中的每个“主题”都需要并部分由一个密钥和一个相应的公钥定义。此类密钥有2种编码：原始（32字节，每个字节从0-255范围）和可打印的Z85（40个符号，每个符号来自ASCII的85元素集合）。

Emyzelium的方法期望以Z85编码的&str形式提供密钥。

use std::ffi::{
    c_int,
    c_char
};

#[link(name = "zmq")]
extern "C" {
    fn zmq_curve_keypair(z85_public_key: *mut c_char, z85_secret_key: *mut c_char) -> c_int;
}

const KEY_Z85_LEN: usize = 40;
const KEY_Z85_CSTR_LEN: usize = KEY_Z85_LEN + 1;

fn zmqe_curve_keypair() -> (String, String, i32) {
    let mut publickey_bufn = vec![0u8; KEY_Z85_CSTR_LEN];
    let mut secretkey_bufn = vec![0u8; KEY_Z85_CSTR_LEN];
    let r = unsafe {
        zmq_curve_keypair(
            (&mut publickey_bufn).as_mut_ptr() as *mut c_char,
            (&mut secretkey_bufn).as_mut_ptr() as *mut c_char
        )
    } as i32;
    (String::from_utf8(publickey_bufn[..KEY_Z85_LEN].to_vec()).unwrap(), String::from_utf8(secretkey_bufn[..KEY_Z85_LEN].to_vec()).unwrap(), r)
}

fn main() {
    let (publickey, secretkey, _) = zmqe_curve_keypair();
    println!("Public key: {}", &publickey);
    // Make sure no one is behind your back...
    println!("Secret key: {}", &secretkey);
}

显然，密钥不是长度为40的任意ASCII字符串，不能通过键盘敲击输入。特别是，

...
#[link(name = "zmq")]
extern "C" {
    fn zmq_curve_public(z85_public_key: *mut c_char, z85_secret_key: *mut c_char) -> c_int;
}
...
    unsafe {
        secretkey.as_ptr().copy_to((&mut secretkey_bufn).as_mut_ptr(), KEY_Z85_LEN);
        zmq_curve_public(
            (&mut publickey_bufn).as_mut_ptr() as *mut c_char,
            (&mut secretkey_bufn).as_mut_ptr() as *mut c_char
        );
    }
    println!("Public key: {}", String::from_utf8(publickey_bufn[..KEY_Z85_LEN].to_vec()).unwrap());

您使用独特的密钥构建对等方，每个对等方一个。除了您和您信任的人，没有人应该知道这些密钥。任何想与您的对等方通信的人都必须知道相应的公钥。相应地，如果您想与别人运行的对等方通信，除了他们的洋葱地址和端口，您还必须知道这些对等方的公钥。基于ZAP的“白名单”功能（见下文），对等方的所有者可以限制那些能够与此对等方通信的人。

现在我们仔细看看这些

实体，它们的角色和用法

简而言之，efunguz发布etales，伸出ehyphae来接触其他efungi并接收它们发布的etales（在这里你应该有似曾相识的感觉，因为这和Synopsis中的“真菌学”隐喻有关）。

这一群blob更好地服务于某种目的——有需要连接以交换数据的程序。我们称这样的程序为“领域”，以强调它们可能属于非常不同的环境，可能用不同的语言编写，不能轻易一次性全部替换。就像森林中的两朵蘑菇，一朵长在洞穴里，另一朵长在河岸上，但它们是同一个菌丝体的一部分，您附加到每个程序上的efungi进行通信，通过efungi，“洞穴程序”和“河岸程序”也能通信。请参阅演示屏幕录制，终端1-3。

遵循发布-订阅模式，Emyzelium模型更倾向于“读取”而不是“写入”：在对方想要读取并对其进行操作之前，您不能将某些数据写入对方的程序内存，除非您想读取这些数据并对其进行操作，没有人可以将他们的数据写入您程序的内存，除非您想读取这些数据并对其进行操作。

此模式的另一个重要属性是多播：数据没有单一的目标接收者。任何允许订阅您的efunguz的etales的人都可以接收它发布的任何etale，如果他们知道其标题。此外，即使他们收到了，您也不知道谁实际上收到了什么etale，直到他们以某种方式将其传达给您。

关于这一点将在下面进一步说明，但就现在而言，请考虑这些限制，并决定它们是否符合您的目标。

如果它们确实如此，并且您的某个程序是用Rust编写的，请继续。否则，请参阅S&B、此列表等。

下面的代码片段假定

[dependencies]
emyzelium = "X.Y.Z"

和

extern crate emyzelium;

use emyzelium::{self as emz, Efunguz};

另请参阅demo.rs。此外，它还包含带有更多参数的方法调用。

因此，Efunguz、Ehypha和Etale只是对知名概念的时髦名称

Efunguz，又称对等方，是某些“领域”（由您的Rust程序表示）与Tor网络（由托尔SOCKS代理上的ZeroMQ表示）之间的中介。对于前者，它简化了安全、（重）连接和数据流任务。

构建efunguz的最简单方法是

let my_secretkey: &str = "gbMF0ZKztI28i6}ax!&Yw/US<CCA9PLs.Osr3APc";
let mut efunguz = Efunguz::new(my_secretkey, & HashSet::new(), emz::DEF_PUBSUB_PORT, emz::DEF_TOR_PROXY_PORT, emz::DEF_TOR_PROXY_HOST);

更多定制

let whitelist_publickeys = HashSet::from([String::from("WR)%3-d9dw)%3VQ@O37dVe<09FuNzI{vh}Vfi+]0"), String::from("iGxlt)JYh!P9xPCY%BlY4Y]c^<=W)k^$T7GirF[R")]);
let mut efunguz = Efunguz::new(my_secretkey, &whitelist_publickeys, 54321, 9955, emz::DEF_TOR_PROXY_HOST);

现在只有与whitelist_publickeys对应的密钥的所有者才能订阅并接收此efunguz的etales。他们必须连接到端口号54321，而不是“默认”端口号。

默认情况下，白名单为空，这意味着...与您的预期相反：任何人都可以订阅。

Efunguz是可变的。您可以

• 通过Efunguz对象的add_whitelist_publickeys()、read_whitelist_publickeys()、del_whitelist_publickeys()和clear_whitelist_publickeys()方法，添加和删除白名单中的密钥。

• 通过add_ehypha()和del_ehypha()添加和删除（以下定义的）ehyphae。

let that_publickey: &str = "WR)%3-d9dw)%3VQ@O37dVe<09FuNzI{vh}Vfi+]0";
let that_onion: &str = "abcde23456abcde23456abcde23456abcde23456abcde23456abcdef";
let that_port: u16 = 12345;
if let Ok(ehypha) = efunguz.add_ehypha(that_publickey, that_onion, that_port) {
    ...
}

• 通过get_ehypha()和get_mut_ehypha()方法，通过公钥获取ehypha的不可变和可变引用。

let that_publickey: &str = "iGxlt)JYh!P9xPCY%BlY4Y]c^<=W)k^$T7GirF[R";
if let Some(ehypha) = efunguz.get_ehypha(that_publickey) {
    ...
}

• 通过emit_etale()发布/发出etales。

let title: &str = "status2";
let parts: Vec<Vec<u8>> = vec![vec![2, 1], vec![255, 0, 2, 1]];
efunguz.emit_etale(title, &parts);

标题可以是空的，即""。这可能是一种协议，在空标题下发布一些关于“正常”etales的描述，以便其他efungi能够获取可用的etales列表。

efunguz.emit_etale("",
 vec!["status2".as_bytes().to_vec(), "2B humidity, 4B kappa level".as_bytes().to_vec(),
  "advice".as_bytes().to_vec(), "C string with today's advice".as_bytes().to_vec()]);

• 通过update()方法使用从连接的efungi接收到的数据更新其状态、ehypha及其etales。

调用update()的合适位置是您程序的主循环。例如：

while !quit { // main program loop
    // do something here
    efunguz.update();
    if my_status_updated {
        efunguz.emit_etale("status2", &status_parts);
    }
    if that_etale.t_in() > t_last_etale {
        if (that_etale.parts.len() == 2) && (that_etale.parts[1].len() == 4) { // sanity checks
            let mut buf: [0u8; 4];
            buf.copy_from_slice(& that_etale.parts[1]);
            let kappa_level = i32::from_le_bytes(buf);
            // do something with kappa level
        }
        t_last_etale = that_etale.t_in;
    }
}

• 通过in_absorbing_num()获取从其他efungi成功认证的传入连接的当前数量（以下用IN1表示）。

• 通过in_permitted_num()获取成功认证的传入连接的总数（IN2）。

• 通过in_attempted_num()获取尝试的传入连接的总数（IN3）。

大多数情况下，IN1 ≤ IN2，因为一些efungi可能已经断开连接，且IN2 ≤ IN3，因为一些efungi可能甚至没有通过认证过滤器。

• 获取最后发生的以下时间点：1) 尝试的传入连接，通过t_last_attempt()，2) 认证的传入连接，通过t_last_permit()，3) 断开连接，通过t_last_disconnect()。

if let Ok(that_etale) = ehypha.add_etale("status3") {
    ...
}

let title: &str = "status7";
if let Some(etale) = ehypha.get_etale(title) {
    ...
}