i0 0.1.6

thei.rs/i0 reference implementation written in rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

# i0.rs

[i0](https://thei.rs/i0) reference implementation written in rust

## cli

`cargo install i0 -F cli,dig,bench`

there are 3 different binaries:
- `i0` (`-F cli`) to generate i0-dentifiers
- `i0-dig` (`-F dig`) tries to cause an intentional hash collision for getting vanity i0-dentifiers
- `i0-bench` (`-F bench`) is a small benchmarking tool, because i0 turned out surprisingly useful for comparing raw CPU compute

## usage

`cargo add i0`

```rust
use i0::{v3, Timestamp};
use rand::{TryRngCore, rngs::OsRng};

let mut seed: [u8; 32] = [0u8; 32];
OsRng.try_fill_bytes(&mut seed)?;

let metadata = v3::Metadata {
    designation: "some user-defined string",
    timestamp: &Timestamp::new(),
    seed: &seed,
};

let (short: String, long: String) = v3::generate(&metadata);
```

## license

dual-licensed under either [Apache 2.0](./license-apache) or
[MIT](./license-mit)