// Matrix Construct // // Copyright (C) Matrix Construct Developers, Authors & Contributors // Copyright (C) 2016-2018 Jason Volk // // Permission to use, copy, modify, and/or distribute this software for any // purpose with or without fee is hereby granted, provided that the above // copyright notice and this permission notice is present in all copies. The // full license for this software is available in the LICENSE file. #pragma once #define HAVE_IRCD_M_EVENT_H namespace ircd::m { struct event; // General util bool my(const id::event &); bool my(const event &); size_t degree(const event &); string_view membership(const event &); // [GET] bool exists(const id::event &); bool exists(const id::event &, const bool &good); bool cached(const id::event &); bool good(const id::event &); bool bad(const id::event &); // Equality tests the event_id only! know this. bool operator==(const event &a, const event &b); // Depth comparison; expect unstable sorting. bool operator<(const event &, const event &); bool operator>(const event &, const event &); bool operator<=(const event &, const event &); bool operator>=(const event &, const event &); // Topological comparison bool before(const event &a, const event &b); id::event make_id(const event &, id::event::buf &buf, const const_buffer &hash); id::event make_id(const event &, id::event::buf &buf); json::object hashes(const mutable_buffer &, const event &); event signatures(const mutable_buffer &, const m::event &); event essential(event, const mutable_buffer &content); bool verify_sha256b64(const event &, const string_view &); bool verify_hash(const event &, const sha256::buf &); bool verify_hash(const event &); bool verify(const event &, const ed25519::pk &, const ed25519::sig &sig); bool verify(const event &, const ed25519::pk &, const string_view &origin, const string_view &pkid); bool verify(const event &, const string_view &origin, const string_view &pkid); // io/yield bool verify(const event &, const string_view &origin); // io/yield bool verify(const event &); // io/yield sha256::buf hash(const event &); ed25519::sig sign(const event &, const ed25519::sk &); ed25519::sig sign(const event &); } /// /// This json::tuple provides at least all of the legal members of the matrix /// standard event. This is the fundamental building block of the matrix /// system. Rooms are collections of events. Messages between servers are /// passed as bundles of events (or directly). /// /// It is better to have 100 functions operate on one data structure than /// to have 10 functions operate on 10 data structures. /// -Alan Perlis /// struct ircd::m::event :json::tuple < json::property, json::property, json::property, json::property, json::property, json::property, json::property, json::property, json::property, json::property, json::property, json::property, json::property, json::property, json::property, json::property > { struct prev; struct refs; struct horizon; struct auth; struct fetch; struct conforms; using keys = json::keys; using id = m::id::event; using idx = uint64_t; using idx_range = std::pair; using closure = std::function; using closure_bool = std::function; using closure_idx = std::function; using closure_idx_bool = std::function; using closure_iov_mutable = std::function; static constexpr const size_t &MAX_SIZE {64_KiB}; static constexpr const size_t &TYPE_MAX_SIZE {256}; static constexpr const size_t &STATE_KEY_MAX_SIZE {256}; static constexpr const size_t &ORIGIN_MAX_SIZE {256}; static conf::item max_size; static void essential(json::iov &event, const json::iov &content, const closure_iov_mutable &); static bool verify(const json::object &, const ed25519::pk &, const ed25519::sig &sig); static ed25519::sig sign(const string_view &, const ed25519::sk &); static ed25519::sig sign(const string_view &); static ed25519::sig sign(const json::object &, const ed25519::sk &); static ed25519::sig sign(const json::object &); static ed25519::sig sign(json::iov &event, const json::iov &content, const ed25519::sk &); static ed25519::sig sign(json::iov &event, const json::iov &content); static json::object signatures(const mutable_buffer &, json::iov &event, const json::iov &content); static sha256::buf hash(json::iov &event, const string_view &content); static sha256::buf hash(const json::object &); static json::object hashes(const mutable_buffer &, json::iov &event, const string_view &content); json::object source; // Contextual availability only. explicit operator id() const; using super_type::tuple; event(const json::object &); event(const json::object &, const keys &); event() = default; }; #include "prev.h" #include "refs.h" #include "horizon.h" #include "auth.h" #include "index.h" #include "event_id.h" #include "fetch.h" #include "get.h" #include "cached.h" #include "prefetch.h" #include "conforms.h" #include "append.h" #include "pretty.h" inline ircd::m::event::operator id() const { return json::get<"event_id"_>(*this)? id{json::get<"event_id"_>(*this)}: id{}; }