// 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_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 &); bool check_size(std::nothrow_t, const event &); void check_size(const event &); // [GET] bool exists(const id::event &); bool exists(const id::event &, const bool &good); 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 bool before(const event &a, const event &b); // A directly referenced by 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); // Informational pretty string condensed to single line. std::ostream &pretty_oneline(std::ostream &, const event &, const bool &content_keys = true); std::string pretty_oneline(const event &, const bool &content_keys = true); // Informational pretty string on multiple lines. std::ostream &pretty(std::ostream &, const event &); std::string pretty(const event &); // Informational content-oriented std::ostream &pretty_msgline(std::ostream &, const event &); std::string pretty_msgline(const event &); } #pragma GCC diagnostic push #pragma GCC diagnostic ignored "-Wsubobject-linkage" /// The Main 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 fetch; struct conforms; using keys = json::keys; // Common convenience aliases using id = m::id::event; using idx = uint64_t; 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 size_t MAX_SIZE = 64_KiB; static conf::item max_size; friend event essential(event, const mutable_buffer &content); static void essential(json::iov &event, const json::iov &content, const closure_iov_mutable &); static bool verify(const string_view &, const ed25519::pk &, const ed25519::sig &sig); static bool verify(const json::object &, const ed25519::pk &, const ed25519::sig &sig); friend bool verify(const event &, const ed25519::pk &, const ed25519::sig &sig); friend bool verify(const event &, const ed25519::pk &, const string_view &origin, const string_view &pkid); friend bool verify(const event &, const string_view &origin, const string_view &pkid); // io/yield friend bool verify(const event &, const string_view &origin); // io/yield friend bool verify(const event &); // io/yield 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 &); friend ed25519::sig sign(const event &, const ed25519::sk &); friend ed25519::sig sign(const event &); 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); friend event signatures(const mutable_buffer &, const m::event &); friend bool verify_sha256b64(const event &, const string_view &); friend bool verify_hash(const event &, const sha256::buf &); friend bool verify_hash(const event &); friend sha256::buf hash(const event &); static sha256::buf hash(json::iov &event, const string_view &content); static json::object hashes(const mutable_buffer &, json::iov &event, const string_view &content); friend json::object hashes(const mutable_buffer &, const event &); using super_type::tuple; using super_type::operator=; event(const idx &, const mutable_buffer &buf); event(const id &, const mutable_buffer &buf); event() = default; }; #pragma GCC diagnostic pop