0006_ws2p_v2.md

[8, 56, 211, ..., 12] // array of 32 8-bits numbers
[8, 56, 211, ..., 12] // array of 64 8-bits numbers
```json
{
    "ws2p_version": 2,
    "currency_name": "g1",
    "issuer_node_id": 395,
    "issuer_pubkey": {
        "algo": "Ed25519",
        "content": [52, 147, .., 93], // 32 bytes pubkey
    },
    "payload": {
        "type": "MESSAGE_TYPE_NAME",
        "content": {} // depends on payload.type
    },
}
```
```json
{
    "api": "WS2P",
    "api_version": 2,
    "network_features": [], // array of bytes, defined below
    "api_features": [], // array of bytes, defined below
    "host": "subdomain.domaine.tld",
    "ip_v4": "5.135.188.170",
    "ip_v6": "2001:41d0:8:c5aa::1",
    "port": 443,
    "path": "ws2p",
}
```
API_NAME VERSION NF1 .. NFn AF PORT HOST IP4 [IP6] PATH
WS2P V2 TLS 0x7 443 g1.durs.info ws2p
```json
{
    "version": "v11",
    "currency_name": "g1",
    "issuer": {
        "algo": "Ed25519",
        "content": [122, 11, .., 95] // 32 bytes pubkey
    },
    "node_id": 10623,
    "created_on": 542,
    "endpoints": [], // Array of endpoitns v2
    "endpoints_str": [], // Array of Strings (endpoitn v2 in utf8 format)
    "sig": {
        "algo": "Ed25519",
        "content": [187, 7, .., 23] // 64 bytes signature
    },
    "certifiers": [
        {
            "certifier": {
                "algo": "Ed25519",
                "content": [122, 11, .., 95] // 32 bytes pubkey
            },
            "blockstamp": {
                "id": 327,
                "hash": [85, 132, .., 27] // 32 bytes hash
            },
            "sig": {
                "algo": "Ed25519",
                "content": [187, 7, .., 23] // 64 bytes signature
            },
        }
    ]
}
```
VERSION:CURRENCY:NODE_ID:PUBLIC_KEY:CREATED_ON
ENDPOINT 1
...
ENDPOINT n
SIGNATURE
11:g1:0:7iMV3b6j2hSj5WtrfchfvxivS9swN3opDgxudeHq64fb:50
WS2P V2 S 7 g1.durs.ifee.fr 443 ws2p
WS2P V2 S 7 84.16.72.210 443 ws2p
EQ2D5almq2RNUi3XZNtTpjo9nWtJF0PzsCW7ROAzCQKiEtpI7/fW8Z23GJ2a/SIxfYSzlq/cZqksE4EoVe1rAw==
```pest
// Single character rules
nl = _{ "\n" }
no_zero_hexa_lower = @{ '1'..'9' | 'a'..'f' }
hexa_lower = @{ ASCII_DIGIT | 'a'..'f' }
hexa_upper = @{ ASCII_DIGIT | 'A'..'F' }
base58 = { !("O" | "I" | "l") ~ ASCII_ALPHANUMERIC }
base64 = { ASCII_ALPHANUMERIC | "+" | "/" }

// Numbers rules
tens = @{ '1'..'9' ~ ASCII_DIGIT }
u8_hundreds = @{ ("2" ~ ('0'..'4' ~ ASCII_DIGIT | ('0'..'5'){2})) | ("1" ~ ASCII_DIGIT{2}) }
u8 = @{ u8_hundreds | tens | ASCII_DIGIT }
no_zero_u_int = @{ '1'..'9' ~ ASCII_DIGIT* }
u_int = @{ "0" | no_zero_u_int }

// Usefull types rules
currency = @{ ASCII_ALPHA ~ (ASCII_ALPHANUMERIC | "-" | "_"){,255} }
block_id = @{ u_int }
hash = @{ hexa_upper{64} }
pubkey = @{ base58{43,44} }
ed25519_sig = @{ base64{88} | (base64{87} ~ "=") | (base64{86} ~ "==") }

// IP v6 rules
ip6_seg  = _{ hexa_lower{1,4} }
ip6_full = _{ (ip6_seg ~ ":"){7} ~ ip6_seg }
ip6_no_full = @{
    ip6_seg? ~
    (":" ~ ip6_seg){0,6} ~
    "::" ~
    (ip6_seg ~ ":"){0,6} ~
    ip6_seg?
}
ip6_inner = @{ ip6_full | ip6_no_full }
ip6 = _{ "[" ~ ip6_inner ~ "] " }

// Endpoint v2 rules
api_version_inner = @{ no_zero_u_int }
api_version = _{ "V" ~ api_version_inner ~ " " }
http = @{ "HTTP " }
ws = @{ "WS " }
tls = @{ "S " }
tor = @{ "TOR " }
network_features = _{ http? ~ ws? ~ tls? ~ tor? }
api_features_inner = @{ (hexa_lower{2})+ | no_zero_hexa_lower }
api_features = _{ "0x" ~ api_features_inner ~ " " }
domain_name_part = @{ ASCII_ALPHA_LOWER ~ (alphanum_lower | "-" | "_")* }
domain_name_ext = @{ alphanum_lower+ }
domain_name_parts = @{ (domain_name_part ~ ".")+ ~ domain_name_ext }
domain_name_onion = @{ alphanum_lower{16} ~ ".onion" }
domain_name_inner = @{ domain_name_parts | domain_name_onion | domain_name_part }
domain_name = _{ domain_name_inner ~ " " }
ip4_inner = { u8 ~ "." ~ u8 ~ "." ~ u8 ~ "." ~ u8 }
ip4 = _{ ip4_inner ~ " " }
path = _{ " " ~ path_inner }
endpoint_v2 = ${ api_name ~ " " ~ (api_version)? ~ (network_features)? ~ (api_features)? ~ ip4? ~ ip6? ~ domain_name? ~ port ~ path? }

// Peer v11 rules
peer_v11 = ${ "11:" ~ currency ~ ":" ~ node_id ~ ":" ~ pubkey ~ ":" ~ block_id ~ nl ~ (endpoint_v2 ~ nl)+ ~ ed25519_sig? }
```
```json
{
    "version": 11,
    "currency": 1,
    "node_id": "15af24db",
    "algorithm": "Ed25519",
    "pubkey": "D9D2zaJoWYWveii1JRYLVK3J4Z7ZH3QczoKrnQeiM6mx"
    "blockstamp": "128310-000002A569DCEED62227CAC0ABDFE6B2647B21B3193A40398CD12BC2A95C24D9",
    "endpoinds": [
        "WS2P 2 1 TLS 3 DEF LOW ABF 443 g1.domaine.tld ws2p"
    ],
    "signature": "e2BtWtLs3Uqw80bvOx8YGfmDLfA44/apzpZA8YfH+WtnmPY5r4XUlgvctPsq2bHVw3iPWxuxx5oJh0JHITrECw==",
    "certifiers": [
        "Ez4huJahi6qfG8eVjyc84CwVtpHagmfUTtRFazXY4G2h:81234-0000047F1D3BB30C24CBD9D60977FC9474D3A985DF88BB9C9CAFE9160D94AC17:oP5iHvXRx1mI+Nic621/tU42kk8Mr+m5wgNZiBPJf4vGSlGSPkTSbzMJgHehnCcEF/UB+xPoLZ2WK1AMODlFDg=="
    ]
}
```
```json
{
  "challenge": [...], // 32 bytes hash
  "api_features": [...], // list of 4 integers corresponding to api_features (see in endpoint definition)
  "connect_type": {...}, // see below
  "peer_card": {...} // look at the peercard definition above
}
```
{
    "Sync": {
      "from_blockstamp": "128310-000002A569DCEED62227CAC0ABDFE6B2647B21B3193A40398CD12BC2A95C24D9"
    }
},
{
    "SyncAskChunk": "128310-000002A569DCEED62227CAC0ABDFE6B2647B21B3193A40398CD12BC2A95C24D9",
}
```json
{
	"hash": [...] // 32 bytes hash
}
```
```json
{
  "prefix": ... // null or non-zero integer
}
```
```json
{
  "chunk_size": 500,
  "target_blockstamp": {
    "id": 0,
    "hash": [...] // 32 bytes hash
  },
  "milestones": [...], // list of 32 bytes hashes
  "peer_cards": [...] // list of peercards
}
```
```json
0 // number representing reason
```
VERSION:CURRENCY:OUTGOING_CONF:INCOMING_CONF:FREE_MIRROR_ROOMS:FREE_MEMBER_ROOMS:NODE_ID:PUBLIC_KEY:BLOCKSTAMP:SOFTWARE:SOFT_VERSION
SIGNATURE
STEP
3:g1:0:0:0:0:0:7iMV3b6j2hSj5WtrfchfvxivS9swN3opDgxudeHq64fb:50-000005B1CEB4EC5245EF7E33101A330A1C9A358EC45A25FC13F78BB58C9E7370:durs:0.2.0-a
vwlxpkCbv83qYSiClYA/GD35hs0AsZBnqv7uoE8hqlarT2c6jVRKhjp8JBqmRI7Se4IDwC2owk0mF4CglvyACQ==
2
```
// Single character rules
nl = _{ "\n" }
no_zero_hexa_lower = @{ '1'..'9' | 'a'..'f' }
hexa_lower = @{ ASCII_DIGIT | 'a'..'f' }
hexa_upper = @{ ASCII_DIGIT | 'A'..'F' }
base58 = { !("O" | "I" | "l") ~ ASCII_ALPHANUMERIC }
base64 = { ASCII_ALPHANUMERIC | "+" | "/" }

// Numbers rules
tens = @{ '1'..'9' ~ ASCII_DIGIT }
u8_hundreds = @{ ("2" ~ ('0'..'4' ~ ASCII_DIGIT | ('0'..'5'){2})) | ("1" ~ ASCII_DIGIT{2}) }
u8 = @{ u8_hundreds | tens | ASCII_DIGIT }
no_zero_u_int = @{ '1'..'9' ~ ASCII_DIGIT* }
u_int = @{ "0" | no_zero_u_int }

// Usefull types rules
currency = @{ ASCII_ALPHA ~ (ASCII_ALPHANUMERIC | "-" | "_"){,255} }
block_id = @{ u_int }
hash = @{ hexa_upper{64} }
pubkey = @{ base58{43,44} }
blockstamp =  ${ block_id ~ "-" ~ hash }
ed25519_sig = @{ base64{88} | (base64{87} ~ "=") | (base64{86} ~ "==") }

// HEADv3 rules
api_outgoing_conf = @{ u8 }
api_incoming_conf = @{ u8 }
free_member_rooms = @{ u8 }
free_mirror_rooms = @{ u8 }
software = @{ ASCII_ALPHA ~ ASCII_ALPHANUMERIC* }
soft_version = @{ ASCII_DIGIT ~ "." ~ ASCII_DIGIT ~ "." ~ ASCII_DIGIT ~ ("-" ~ ("a" | "b" | "rc") ~ ASCII_DIGIT ~ ("." ~ ASCII_DIGIT){0,2})? }
step = @{ u_int }

head_v3 = ${
    "3:" ~ currency ~ ":" ~
    api_outgoing_conf ~ ":" ~
    api_incoming_conf ~ ":" ~
    free_member_rooms ~ ":" ~
    free_mirror_rooms ~ ":" ~
    node_id ~ ":" ~
    pubkey ~ ":" ~
    blockstamp ~ ":" ~
    software ~ ":" ~
    soft_version ~ nl ~
    ed25519_sig? ~
    (nl ~ step)?
}
```
```json
{
    "content": "VERSION:CURRENCY:OUTGOING_CONF:INCOMING_CONF:FREE_MIRROR_ROOMS:FREE_MEMBER_ROOMS:NODE_ID:PUBLIC_KEY:BLOCKSTAMP:SOFTWARE:SOFT_VERSION",
    "signature": "SIGNATURE", // Signature in base64
    "step": 3
}
```
```json
{
    "content": "3:g1:0:0:0:0:0:7iMV3b6j2hSj5WtrfchfvxivS9swN3opDgxudeHq64fb:50-000005B1CEB4EC5245EF7E33101A330A1C9A358EC45A25FC13F78BB58C9E7370:durs:0.2.0-a",
    "signature": "vwlxpkCbv83qYSiClYA/GD35hs0AsZBnqv7uoE8hqlarT2c6jVRKhjp8JBqmRI7Se4IDwC2owk0mF4CglvyACQ==",
    "step": 2,
}
```