0
0
Fork 0
mirror of https://github.com/matrix-construct/construct synced 2024-05-20 11:53:46 +02:00
Go to file
2019-12-01 14:10:03 -08:00
construct construct: Default to -matrix switch enabled. 2019-11-30 13:46:35 -08:00
deps gitmodules: Remove riot-* from submodule list; minor cleanup. 2019-08-03 14:33:02 -07:00
doc doc: Update architecture summary. 2019-09-27 20:26:02 -07:00
include/ircd ircd::uleb128: Add #ifdefs for intrinsics. 2019-11-30 10:47:20 -08:00
ircd ircd::server: Relax assertion. 2019-11-30 14:29:01 -08:00
matrix ircd:Ⓜ️🆔 Inline ctors with missy jumps. 2019-10-09 22:15:49 -07:00
modules modules/console: Increase db cache table hits columns width. 2019-11-30 10:52:51 -08:00
share client: Fix defaulting to empty closure. 2019-11-30 10:48:31 -08:00
tools tools: Add m4 macros for testing compiler flags. 2019-12-01 14:10:03 -08:00
.appveyor.yml appveyor.yml: Use --enable-assert so issues in the smoketest cause failure. 2019-06-21 20:13:23 -07:00
.gitignore gitignore: Ignore any files suffixed with .tmp 2019-07-29 17:09:51 -07:00
.gitmodules gitmodules: Remove riot-* from submodule list; minor cleanup. 2019-08-03 14:33:02 -07:00
.travis.yml travis.yml: Travis-CI became useless and inept I guess at some point because 14.04 is not relevant to us. 2018-09-04 23:43:49 -07:00
autogen.sh Move m4 to tools/m4. 2018-09-17 18:52:26 -07:00
configure.ac configure: Tweak/reorg optimization unconditional flags. 2019-11-30 18:55:24 -08:00
LICENSE Update LICENSE copyright year. 2018-01-10 21:34:21 -08:00
Makefile.am ircd: Move matrix application related to derived library. 2019-09-27 19:35:26 -07:00
NEWS.md Update NEWS. 2017-12-12 14:59:41 -07:00
README.md Update README. [ci skip] 2019-10-11 21:25:27 -07:00

This — is The Construct

It all started in 1988 when Jarkko Oikarinen developed a free and open source server at the University of Oulu which facilitated real-time communication over the internet. Its derivatives have underpinned the major networks for decades.

The protocol has since stagnated, largely abandoned except by evangelists. A growing number of proprietary cloud services have filled the vacuum of innovation. Free software projects are relegated to collaborating on non-free platforms for a basic rich user experience. The consensus is that decentralization is needed, and users not be limited to some arcane retro-environment.

This is the Construct — Federated team collaboration built with the WASM Virtual Machine. Clients and servers implement a minimal ABI based on their capabilities while the community at large builds all features as modules. Construct makes the chat room programmable. Applications govern all their basic functions. Everything from the appearance of a room as seen by users to some continuous-integration running in the background for developers is customizable by embedding apps around your room.

A variety of apps have already been created by developers for their own needs. Most choose to make them available to the community, licensed as free software. This is a powerful construct, as you can import these apps to enrich your own rooms.

Installation

Chat in #test:zemos.net

Dependencies

  • Boost library 1.66+
  • RocksDB library 5.16.6.
  • Sodium library for curve ed25519.
  • OpenSSL library for HTTPS TLS / X.509.
  • Magic library for MIME type recognition.
OPTIONAL
  • zlib or lz4 or snappy database compressions.
  • GraphicsMagick for media thumbnails.
  • jemalloc for dynamic memory.
BUILD TOOLS
  • GNU C++ compiler, ld.gold, automake, autoconf, autoconf2.13, autoconf-archive, libtool.

  • A platform capable of loading dynamic shared objects at runtime is required.

Getting Started

  1. At this phase of development the best thing to do is pull the master branch and use the latest head.

  2. See the BUILD instructions to compile Construct from source.

  3. See the SETUP instructions to run Construct for the first time.

TROUBLESHOOTING

See the TROUBLESHOOTING guide for solutions to possible problems.

Developers

DOCUMENTATION

Generate doxygen using /usr/bin/doxygen tools/doxygen.conf the target directory is doc/html. Browse to doc/html/index.html.

ARCHITECTURE GUIDE

See the ARCHITECTURE summary for design choices and things to know when starting out.

DEVELOPMENT STYLE GUIDE

See the STYLE guide for an admittedly tongue-in-cheek lecture on the development approach.

Roadmap

FEATURE EXPERIENCE
  • Phase One: Matrix clients using HTTPS.
  • Phase Two: Legacy IRC network TS6 protocol.
TECHNOLOGY
  • Phase Zero: Core libircd: Utils; Modules; Contexts; JSON; Database; HTTP; etc...
  • Phase One: Matrix Protocol: Core VM; Core modules; Protocol endpoints; etc...
  • Phase Two: Construct Cluster: Kademlia sharding of events; Maymounkov's erasure codes.
DEPLOYMENT
Operating a Construct server which is open to public user registration is unsafe. Local users may
be able to exceed resource limitations and deny service to other users.
  • Personal: One or few users. Few default restrictions; higher log output.
  • Company: Hundreds of users. Moderate default restrictions.
  • Public: Thousands of users. Untrusting configuration defaults.

Due to the breadth of the Matrix client/server protocol we can only endorse production use of Construct gradually while local user restrictions are developed. This notice applies to locally registered users connecting with clients, it does not apply to federation.