.cargo | ||
contracts | ||
contrib | ||
docs | ||
files | ||
migrations | ||
scripts | ||
src | ||
.editorconfig | ||
.env | ||
.gitignore | ||
Cargo.lock | ||
Cargo.toml | ||
config.yaml.example | ||
docker-compose.yaml | ||
FEDERATION.md | ||
LICENSE | ||
README.md |
Mitra
Federated social network with smart contracts.
Built on ActivityPub protocol, self-hosted, lightweight.
Unique features enabled by blockchain integration:
- Sign-in with Ethereum wallet.
- Donations.
- Paid subscriptions.
- Proving membership with a token.
- Converting posts into NFTs.
Smart contracts repo: https://codeberg.org/silverpill/mitra-contracts
Frontend repo: https://codeberg.org/silverpill/mitra-web
Demo instance: https://mitra.social/ (invite-only)
Matrix chat: #mitra:halogen.city
Requirements
- Rust 1.54+ (when building from source)
- PostgreSQL 12+
- IPFS node (optional, see guide)
- Ethereum node (optional)
Installation
Building from source
Run:
cargo build --release
This command will produce two binaries in target/release
directory, mitra
and mitractl
.
Create a database and a configuration file (see example).
When starting Mitra, set the value of ENVIRONMENT
variable to production
and specify the path to configuration file with CONFIG_PATH
:
ENVIRONMENT=production CONFIG_PATH=/etc/mitra/config.yaml 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.
Development
Create database
docker-compose up
Test connection:
psql -h localhost -p 55432 -U mitra mitra
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
Build for production
cargo build --release
Federation
See FEDERATION.md
Client API
Mastodon API
Most methods are similar to Mastodon API, but Mitra is not fully compatible.
OpenAPI spec (incomplete)
CLI commands
Generate RSA private key:
mitractl generate-rsa-key
Generate invite code:
mitractl generate-invite-code
List generated invites:
mitractl list-invite-codes
Delete profile:
mitractl delete-profile -i 55a3005f-f293-4168-ab70-6ab09a879679
Delete post:
mitractl delete-post -i 55a3005f-f293-4168-ab70-6ab09a879679
Remove remote posts and media older than 30 days:
mitractl delete-extraneous-posts -d 30
Generate ethereum address:
mitractl generate-ethereum-address
License
Support
Monero: 8Ahza5RM4JQgtdqvpcF1U628NN5Q87eryXQad3Fy581YWTZU8o3EMbtScuioQZSkyNNEEE1Lkj2cSbG4VnVYCW5L1N4os5p