aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: 37a50fa84157eb360f69643066b0b8ff764d6a8d (plain)
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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

                      _          
      __ _  ___ _ __ (_)______ _ 
     / _` |/ _ \ '_ \| |_  / _` |
    | (_| |  __/ | | | |/ / (_| |
     \__, |\___|_| |_|_/___\__,_|
     |___/                       


this is a poor / partial / non-compliant dat implementation in rust.

it will eat-your-data.

### Status

[![Build Status](https://travis-ci.org/bnewbold/geniza.svg?branch=master)](https://travis-ci.org/bnewbold/geniza)

- [ ] SLEEP v2 Files
    - [x] read/write file headers
    - [x] read/write file chunks as raw bytes
    - [ ] pread/pwrite file chunks without seeking
    - [x] read data entries by index
    - [x] append data entries
    - [ ] verify entire register (signatures and merkel tree)
    - [ ] bitfields
- [ ] Drive metadata and files
    - [ ] add file to register
    - [ ] checkout file from register
    - [ ] print file tree ("ls")
    - [ ] add directory recursively
    - [ ] checkout directory recursively
- [ ] Networking
    - [x] send/receive encrypted messages to a known host
    - [ ] pull register from a known host
    - [ ] sync register to a known host
    - [ ] lookup hosts in DHT swarm by discovery key
- [ ] Wrapper command
    - [ ] clone
    - [ ] share
    - [ ] log
    - [ ] status
    - [ ] add

### Dependencies

While (temporarily?) using Cargo's `[patch]` feature to patch sodiumoxide,
builds require Rust 1.21 (stable circa Oct 2017).

Requires libsodium-dev system-wide (for now).

Notable Rust Libraries:
- rust-crypto for blake2b 
- sodiumoxide Ed25519 (signing) and XSalsa20 (stream)
- integer-encoding for simple varints (network protocol)
- rust-protobuf for protobuf (network protocol)
- ??? for Kademlia Mainline DHT

protobuf code generated with `rust-protobuf`; the `protoc` tool (`sudo apt
install protobuf-compiler`) and rust plugin `protoc-gen-rust` (`cargo install
protobuf`) are only needed when changing .proto files, eg:

    protoc --rust_out . network_proto.proto