KevaChat is distributed chat platform for open, uncensored and privacy respectable communication with permanent data storage in blockchain.
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.

75 lines
3.2 KiB

1 year ago
# KevaChat - Chat in Blockchain
1 year ago
1 year ago
KevaChat is distributed chat platform for open, uncensored and privacy respectable communication with permanent data storage in blockchain.
1 year ago
1 year ago
![KevaChat](https://github.com/kevachat/webapp/assets/108541346/9b286719-eafe-443f-a6e3-4b4927edde96)
1 year ago
## Tech
10 months ago
Instance require connection to the [KevaCoin](https://github.com/kevacoin-project/) wallet, `memcached` server, [clitor-is-protocol](https://github.com/clitor-is-protocol) for multimedia support and [Symfony](https://github.com/symfony/symfony) for web interface.
1 year ago
## Model
1 year ago
KevaChat following open wallet model, where community boost shared ballance for talks.
1 year ago
10 months ago
* In another way, node able to generate payment addresses to each message sent and charge commission for instance monetization.
* Also registered users have payment accounts where everyone able to boost their balance by donation
10 months ago
1 year ago
Administrators have flexible settings of access levels explained in the `.env` file: read-only rooms, connection and post limits, etc.
## Communication
Everyone able to join the chat, post messages as ghosty or sign ownership by IP. Also users can explore remote rooms by namespaces if option enabled.
Basic social features like identicons, replies, mentions, RSS subscriptions etc are supported.
## Protocol
10 months ago
KevaChat protocol following native KevaCoin's `key`/`value` model, where `key` optionally contain `@username` postfix and `value` - contain message.
1 year ago
10 months ago
All publications related to their room `namespace`.
1 year ago
10 months ago
## Examples
* `http://[201:23b4:991a:634d:8359:4521:5576:15b7]/kevachat/` - [Yggdrasil](https://github.com/yggdrasil-network/) instance
* `http://kevachat.ygg` - [Alfis DNS](https://github.com/Revertron/Alfis) alias
## Install
10 months ago
* `apt install git composer memcached sqlite3 php-curl php-memcached php-sqlite3 php-mbstring`
* `git clone https://github.com/kevachat/webapp.git`
* `cd webapp`
* `composer update`
* `php bin/console doctrine:schema:update --force`
* `* * * * * /usr/bin/wget -q --spider http://../crontab/pool > /dev/null 2>&1`
## Update
10 months ago
* `cd webapp`
* `git pull`
* `composer update`
* `php bin/console doctrine:migrations:migrate`
* `APP_ENV=prod APP_DEBUG=0 php bin/console cache:clear`
1 year ago
## Setup
Application package contain settings preset, just few steps required to launch:
* Make sure `memcached` server enabled
10 months ago
* Setup KevaCoin server connection with `rpcuser`/`rpcpassword` in `~/.kevacoin/kevacoin.conf`
1 year ago
* Copy `rpcuser` to `env`.`APP_KEVACOIN_USERNAME` and `rpcpassword` to `env`.`APP_KEVACOIN_PASSWORD`
* Generate new address using CLI `kevacoin-cli getnewaddress` and copy to `env`.`APP_KEVACOIN_BOOST_ADDRESS`
* Send few coins to this address and wait for new block to continue
* To allow users registration, create namespace `kevacoin-cli keva_namespace "_KEVACHAT_USERS_"`
* Create at least one room namespace with Web UI or CLI `kevacoin-cli keva_namespace "sandbox"`
* Provide at least one namespace for default chat room to `env`.`APP_KEVACOIN_ROOM_NAMESPACE_DEFAULT` (for homepage redirects)
1 year ago
1 year ago
## Contribution
10 months ago
Project created by people for people: MIT License to use it for other needs e.g. new fork, chat instance or KevaCoin blockchain explorer.
1 year ago
Join the development and make your feedback!
10 months ago
## See also
* [KevaChat Gemini Application](https://github.com/kevachat/geminiapp)