https://github.com/covenantsql/covenantforum
CovenantForum is a simple Decentralized forum powered by CovenantSQL.
https://github.com/covenantsql/covenantforum
blockchain covenantsql cql forum p2p
Last synced: 9 months ago
JSON representation
CovenantForum is a simple Decentralized forum powered by CovenantSQL.
- Host: GitHub
- URL: https://github.com/covenantsql/covenantforum
- Owner: CovenantSQL
- License: mit
- Created: 2019-03-01T03:14:35.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2019-05-15T03:34:45.000Z (almost 7 years ago)
- Last Synced: 2024-11-09T20:37:51.138Z (over 1 year ago)
- Topics: blockchain, covenantsql, cql, forum, p2p
- Language: Go
- Homepage: https://demo.covenantsql.io
- Size: 63.2 MB
- Stars: 119
- Watchers: 10
- Forks: 10
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
CovenantForum is a simple **decentralized** forum web app powered by [CovenantSQL](https://github.com/CovenantSQL/CovenantSQL).
## Decentralized forum?
- Data and files are saved in **decentralized database**. Anyone with a permission granted private key and the DSN(Database Serial Num) can serve the forum anywhere.
- Also, all posts related data are saved on an unique `SQLChain Block` like [this](https://explorer.dbhub.org/dbs/e08d944b4ebd69e12aa69dade1798bb98cea4e2833e55fb6decc1f447fc720a4/requests/f39f9cb46c2821f6354d001fea9a5eaf2b96b06e83c218d46d810f353a039ec8).
- Anyone can create your "blockchain powered forum" with just [few steps](#create-your-new-forum).
## Twitter Bot
- [@iBlockPin](https://twitter.com/iblockpin) will record your tweet to CovenantForum and the Blockchain.
## Features
- Static files and database are powered by decentralized database: CovenantSQL.
- REST API backend written in Go
- Vue.js-based frontend
- Social login (OAuth 2.0) via three providers:
- Google
- Facebook
- Github
- JSON Web Tokens (JWT) are used for user authentication in the API
- Single binary deploy. All the static assets (frontend JavaScript & CSS files) are embedded into the binary
- Markdown comments
- Avatar upload, including animated GIFs. Auto-generated letter-avatars on user creation
## Arch
Comparison between Traditional and Decentralized forum:
## Demo
[Demo forum](https://demo.covenantsql.io/forum/)
## Quick Start
Just one command to start a mirror of `Demo forum`
```
$ go get -u github.com/CovenantSQL/CovenantForum/cmd/forum && \
cd $GOPATH/src/github.com/CovenantSQL/CovenantForum/cmd/forum && \
$GOPATH/bin/forum start
```
## Create your new Forum
* [Generate a CovenantSQL config and keypair](https://github.com/CovenantSQL/CovenantSQL/wiki/Testnet-Quickstart).
* Get PTC by replying to the [topic](https://demo.covenantsql.io/forum/#/t/2) with your wallet address.
* Create a new empty CovenantSQL database with [cql](https://github.com/CovenantSQL/CovenantSQL/wiki/Testnet-Quickstart#4-create-a-database-using-cli).
* Obtain OAuth 2.0 credentials (client_id and secret) from at least one of the providers (Google, Facebook, Github) so users can log into the web application. The OAuth callback url will be `/oauth/end/`. The `` is where the forum web app will be mounted on your site and the `` is the lowercase provider name. For example, if base_url is `https://my.website.com/forum/`, then the oauth callback url for google will be `https://my.website.com/forum/oauth/end/google`.
* Download and compile the forum binary:
```
$ go get -u github.com/CovenantSQL/CovenantForum/cmd/forum
```
* Inside an empty directory run:
```
$ forum init
```
This will generate an initial configuration file "forum.conf" inside the current dir.
Edit the configuration file to set the server listen address, the base url, the database and file storage parameters, OAuth credentials, etc.
* Fill in `file_storage` and `store` in the forum.conf:
```
file_storage {
type = "covenant_s3"
covenant_s3 {
database = "covenantsql://e08d944b4ebd69e12aa69..."
config = "config.yaml"
masterkey = ""
}
}
store {
type = "covenantsql"
covenantsql {
database = "covenantsql://e08d944b4ebd69e12aa69..."
config = "config.yaml"
masterkey = ""
}
}
```
* Run the following command to start the forum web server.
```
$ forum start
```
* Sign in into your web application using one of the social login providers.
Then run the following command to grant admin privileges to your user.
```
$ forum add-admin
```
## Screenshots
### Topics
### Comments on blockchain
## Todo
- Make creating new forum easier.
- Grant low permission on forum database.
- We are working on [CovenantSQL](https://github.com/CovenantSQL/CovenantSQL).
## License
- CovenantForum is derived from a simple traditional forum [disintegration/bebop](https://github.com/disintegration/bebop), but CovenantForum has a totally different purpose. So, we just create a new project.