fedimovies/README.md

151 lines
2.2 KiB
Markdown
Raw Normal View History

2021-04-09 00:22:17 +00:00
# Mitra
Federated social network with smart contracts.
2022-02-08 01:36:40 +00:00
Built on [ActivityPub](https://activitypub.rocks/) protocol, self-hosted, lightweight.
Unique features enabled by blockchain integration:
2022-04-13 10:43:19 +00:00
- [Sign-in with Ethereum wallet](https://eips.ethereum.org/EIPS/eip-4361).
- Donations.
2022-02-08 01:36:40 +00:00
- Paid subscriptions.
2022-04-13 10:43:19 +00:00
- Proving membership with a token.
2021-04-09 00:22:17 +00:00
- Converting posts into NFTs.
2021-10-10 09:55:33 +00:00
Smart contracts repo: https://codeberg.org/silverpill/mitra-contracts
2021-11-29 21:24:44 +00:00
Frontend repo: https://codeberg.org/silverpill/mitra-web
2021-11-20 20:34:33 +00:00
Demo instance: https://mitra.social/ (invite-only)
2022-04-13 10:43:19 +00:00
Matrix chat: [#mitra:halogen.city](https://matrix.to/#/#mitra:halogen.city)
2021-04-09 00:22:17 +00:00
## Requirements
2022-04-08 18:52:13 +00:00
- Rust 1.54+
2022-01-02 13:38:40 +00:00
- PostgreSQL 10.2+
2022-01-11 23:02:56 +00:00
- IPFS node (optional, see [guide](./docs/ipfs.md))
2021-04-09 00:22:17 +00:00
- Ethereum node (optional)
## Development
### Create database
```
docker-compose up
```
Test connection:
```
2022-03-05 12:48:30 +00:00
psql -h localhost -p 55432 -U mitra mitra
2021-04-09 00:22:17 +00:00
```
### Run web service
2021-11-26 22:37:20 +00:00
Generate instance key:
```
cargo run --bin mitractl generate-rsa-key
```
Create config file, set `instance_rsa_key`, adjust other settings if needed:
2021-04-09 00:22:17 +00:00
```
cp config.yaml.example config.yaml
```
Compile and run service:
```
cargo run
```
### Run CLI
```
cargo run --bin mitractl
```
2021-11-13 17:37:31 +00:00
### Run linter
```
cargo clippy
```
2021-10-10 09:55:33 +00:00
### Run tests
```
cargo test
```
2021-04-09 00:22:17 +00:00
### Build for production
```
cargo build --release
```
2021-11-14 20:09:46 +00:00
## Federation
2022-04-13 10:43:19 +00:00
See [FEDERATION.md](./FEDERATION.md)
2021-11-14 20:09:46 +00:00
## Client API
2021-04-09 00:22:17 +00:00
### Mastodon API
2022-02-08 01:36:40 +00:00
Most methods are similar to Mastodon API, but Mitra is not fully compatible.
2021-04-09 00:22:17 +00:00
[OpenAPI spec](./docs/openapi.yaml) (incomplete)
2021-12-03 15:29:50 +00:00
2021-04-09 00:22:17 +00:00
## CLI commands
Generate RSA private key:
```
mitractl generate-rsa-key
```
Generate invite code:
2021-04-09 00:22:17 +00:00
```
mitractl generate-invite-code
2021-04-09 00:22:17 +00:00
```
List generated invites:
2021-09-25 20:46:19 +00:00
```
mitractl list-invite-codes
2021-09-25 20:46:19 +00:00
```
Delete profile:
2021-04-09 00:22:17 +00:00
```
mitractl delete-profile -i 55a3005f-f293-4168-ab70-6ab09a879679
2021-04-09 00:22:17 +00:00
```
Delete post:
2021-04-09 00:22:17 +00:00
```
mitractl delete-post -i 55a3005f-f293-4168-ab70-6ab09a879679
2021-04-09 00:22:17 +00:00
```
2022-04-13 10:43:19 +00:00
Remove remote posts and media older than 30 days:
```
mitractl delete-extraneous-posts -d 30
```
2021-04-09 00:22:17 +00:00
Generate ethereum address:
```
mitractl generate-ethereum-address
```
2021-10-10 09:55:33 +00:00
## License
[AGPL-3.0](./LICENSE)
2022-04-13 10:43:19 +00:00
## Support
Monero: 8Ahza5RM4JQgtdqvpcF1U628NN5Q87eryXQad3Fy581YWTZU8o3EMbtScuioQZSkyNNEEE1Lkj2cSbG4VnVYCW5L1N4os5p