Federated social network
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
silverpill e83a2676dd Bump version 2 days ago
.cargo Rewrite wallet address validator to work with non-ethereum addresses 4 months ago
contracts Enable contract feature detection 5 months ago
contrib Allow to connect to monero-wallet-rpc when it runs without --wallet-dir option 2 days ago
docs Add API methods for creating user-signed Move() activities 2 days ago
files Add files directory, update readme 1 year ago
migrations Add hostname column to actor_profile table and replace acct with generated column 2 months ago
scripts Add contracts to debian package 6 months ago
src Verify that actor alias exists before moving local followers 2 days ago
.editorconfig Set indent size in JSON files to 2 1 year ago
.env Add cargo feature for making production build 7 months ago
.gitignore Add files directory, update readme 1 year ago
CONTRIBUTING.md Add MSRV policy to CONTRIBUTING.md 2 weeks ago
Cargo.lock Bump version 2 days ago
Cargo.toml Bump version 2 days ago
FEDERATION.md Add FEP-8b32 to the list of supported FEPs 1 week ago
LICENSE Initial commit 1 year ago
README.md Allow to connect to monero-wallet-rpc when it runs without --wallet-dir option 2 days ago
config.yaml.example Rename daemon_url parameter in monero config to node_url 2 months ago
docker-compose.yaml Create docker volume for storing wallet data 3 months ago

README.md

Mitra

Federated micro-blogging platform and content subscription service.

Built on ActivityPub protocol, self-hosted, lightweight. Part of the Fediverse.

Subscriptions provide a way to receive monthly payments from subscribers and to publish private content made exclusively for them.

Supported payment methods:

  • Monero.
  • ERC-20 tokens (on Ethereum and other EVM-compatible blockchains).

Other features:

  • Sign-in with a wallet.
  • Donation buttons.
  • Token-gated registration (can be used to verify membership in some group or to stop bots).
  • Converting posts into NFTs.
  • Saving posts to IPFS.

Demo instance: https://public.mitra.social/ (invite-only)

Network stats: https://the-federation.info/mitra

Matrix chat: #mitra:halogen.city

Code

Server: https://codeberg.org/silverpill/mitra (this repo)

Web client: https://codeberg.org/silverpill/mitra-web

Ethereum contracts: https://codeberg.org/silverpill/mitra-contracts

Requirements

  • Rust 1.54+ (when building from source)
  • PostgreSQL 12+
  • IPFS node (optional, see guide)
  • Ethereum node (optional)
  • Monero node and Monero wallet (optional)

Installation

Building from source

Run:

cargo build --release --features production

This command will produce two binaries in target/release directory, mitra and mitractl.

Install PostgreSQL and create the database:

CREATE USER mitra WITH PASSWORD 'mitra';
CREATE DATABASE mitra OWNER mitra;

Create configuration file by copying contrib/mitra_config.yaml and configure the instance. Default config file path is /etc/mitra/config.yaml, but it can be changed using CONFIG_PATH environment variable.

Start Mitra:

./mitra

An HTTP server will be needed to handle HTTPS requests and serve the frontend. See the example of nginx configuration file.

Building instructions for mitra-web frontend can be found at https://codeberg.org/silverpill/mitra-web#project-setup.

To run Mitra as a systemd service, check out the systemd unit file example.

Debian package

Download and install Mitra package:

dpkg -i mitra.deb

Install PostgreSQL and create the database:

CREATE USER mitra WITH PASSWORD 'mitra';
CREATE DATABASE mitra OWNER mitra;

Open configuration file /etc/mitra/config.yaml and configure the instance.

Start Mitra:

systemctl start mitra

An HTTP server will be needed to handle HTTPS requests and serve the frontend. See the example of nginx configuration file.

Monero

Install Monero node or choose a public one.

Configure and start monero-wallet-rpc daemon. Add disable-rpc-login=1 to your monero-wallet-rpc config (currently RPC auth is not supported in Mitra).

Create a wallet for your instance.

Add blockchain configuration to blockchains array in your configuration file.

Ethereum

Install Ethereum client or choose a JSON-RPC API provider.

Deploy contracts on the blockchain. Instructions can be found at https://codeberg.org/silverpill/mitra-contracts.

Add blockchain configuration to blockchains array in your configuration file.

Development

See CONTRIBUTING.md

Start database server

docker-compose up -d

Test connection:

psql -h localhost -p 55432 -U mitra mitra

Start Monero node and wallet server

(this step is optional)

docker-compose --profile monero up -d

Run web service

Create config file, adjust settings if needed:

cp config.yaml.example config.yaml

Compile and run service:

cargo run

Run CLI

cargo run --bin mitractl

Run linter

cargo clippy

Run tests

cargo test

Federation

See FEDERATION.md

Client API

Most methods are similar to Mastodon API, but Mitra is not fully compatible.

OpenAPI spec

CLI

mitractl is a command-line tool for performing instance maintenance.

Documentation

License

AGPL-3.0

Support

Monero: 8Ahza5RM4JQgtdqvpcF1U628NN5Q87eryXQad3Fy581YWTZU8o3EMbtScuioQZSkyNNEEE1Lkj2cSbG4VnVYCW5L1N4os5p