General-Beck/ag-blockchain

Активный гражданин. Блокчейн для проверки результатов голосования

Репозиторий содержит конфигурацию для запуска блокчейн-ноды на любой системе для просмотра результатов опросов на сайте Активный гражданин

Инструкция по развертыванию Parity UI (используемая реализация блокчейн)

Установка на Windows

1. Скачать и установить Parity
2. Найти папку, куда установилась программа parity.exe (обычно C:\Program Files\Parity\Parity) и перейти в нее
3. Открыть ссылку и сохранить файл (Ctrl+S) в папку из предыдущего пункта
4. Открыть командную строку (нажать Windows+R и напечатать cmd, нажать Выполнить)
5. Перейти в папку с parity.exe командой cd C:\Program Files\Parity\Parity
6. В командной строке выполнить parity ui --bootnodes enode://9076c143a487aa163437a86f7d009f257f405c50bb2316800b9c9cc40e5a38fef5b414a47636ec38fdabc8a1872b563effa8574a7f8f85dc6bde465c368f1bf5@213.79.88.177:30303 --chain chain.json
7. Откроется веб-интерфейс, дальше выполнить пункты из Инструкция по просмотру результатов опросов

Установка на MacOS

1. Открыть терминал и выполнить brew tap paritytech/paritytech а затем brew install parity --stable
2. Открыть ссылку и сохранить файл (Ctrl+S) в произвольную папку
3. Перейти в папку в терминале
4. Выполнить parity ui --bootnodes enode://9076c143a487aa163437a86f7d009f257f405c50bb2316800b9c9cc40e5a38fef5b414a47636ec38fdabc8a1872b563effa8574a7f8f85dc6bde465c368f1bf5@213.79.88.177:30303 --chain chain.json
5. Откроется веб-интерфейс, дальше выполнить пункты из Инструкция по просмотру результатов опросов

Установка в Docker (любая ОС)

Предварительно выполнить

1. Установить и запустить Docker (все необходимые требования и инструкции по установке есть на указанном сайте)
2. Установить git (Git for Windows, Git for Linux) для того, чтобы скачать необходимую для блокчейн конфигурацию из репозитория.

Выполняем следующие команды в bash (для Linux и MacOS) или powershell (для Windows, от имени администратора):

0. Скачиваем конфигурацию из репозитория git clone https://github.com/moscow-technologies/ag-blockchain.git
1. Переходим в каталог с конфигурацией cd ag-blockchain
2. Запускаем parity командой docker-compose up -d
3. Выполняем docker-compose logs | grep token= и копируем токен (идет после token= примерно такой Q7J9-ofgq-EEJU-9nVt) для авторизации в Parity UI
4. Нода запущена, должна пойти ее синхронизация с блокчейном.
5. Далее можно зайти в ее веб-интерфейс и выолнить его настройку для просмотра результатов опросов (Система запросит токен, вводим полученный предыдущей командой, вводим его)

Инструкция по просмотру результатов опросов

Используя Parity UI, можно узнать общую статистику по конкретному опросу, а также как голосовал конкретный пользователь (по его личному UID). Для этого выполняем следующие действия:

1. Принимаем условия лицензионного соглашения, а также создаем аккаунт в системе (логин и пароль - произвольные)
2. Переходим в раздел Settings и включаем галочку напротив пункта Contracts
3. Переходим в раздел Status. Должна идти синхронизация блоков (число напротив надписи Best block растет быстрее чем на единицу в секунду). Второе число в Peers должно быть больше 0 (если синхронизация работает корректно)!
4. Дожидаемся окончания синхронизации надпись Chain synchronized (yes)
5. Переходим в раздел Contracts
6. Для просмотра адресов смарт-контрактов опросов в блокчейн необходимо добавить в просмотр корневой контракт.
7. Нажимаем Watch, появляется мастер, в нем на первом шаге жмем Next
8. На втором шаге в поле network address вводдим значение 0xFDb76DaAF371bf5C7122f6f1104458440454FBB1, в поле contract name пишем Каталог опросов, в поле contract abi - содержимое файла conracts/Root.abi данного репозитория и нажимаем Add contract
9. Заходим в разделе Contracts в Каталог опросов и в поле под надписью getAddress вставляем идентификатор опроса на АГ, жмем Query. Получаем адрес смарт-контракта с соответствующим опросом, копируем его в буфер обмена
10. Возвращаемся в раздел Contracts, добавляем в просмотр смарт-контракт опроса: нажимаем Watch, Next, дальше в полеnetwork address - адрес из буфера обмена, contract name - будущее название контракта в списке (например Опрос 3196), contract abi - сожержимое файла contracts/Poll.abi из репозитория, нажимаем AddContract
11. Заходим в раздел Contracts в просмотр смарт-контракта Опрос 3196. Здесь хранится соответствие идентификатора вопроса на АГ и адреса смарт-контрактов вопросов (разделы QuestionIds и QuestionsAddress), копируем адрес. Аналогично, необходимо копировать адреса смарт-контрактов и добавлять в разделе Contracts - Watch смарт-контракты, хранящие описание, ответы и результаты голосования по конкретному вопросу опроса. В первое поле вставляем адрес, во второе - название (например Опрос 3195 Вопрос1), в поле contract abi - содержимое файла contracts/PollQuestion.abi из репозитория. Нажимаем AddContract
12. Переходим в просмотр вопроса и видим содержимое блокчейн

• Идентификатор QuestionId
• Заголовок вопроса CurrentVersionTitle
• Количество проголосовавших VoterCount
• Идентифиторы версий опроса AllExistingVersions (каждое изменение опроса ведет к созданию версии, голоса по разным версия считаются отдельно)
• Идентифитор текущей версии CurrentVersion
• Количество голосов за каждый из ответов в списке CurrentVersionResults (в порядке из идентификаторов, совпадает с порядком на сайте АГ)
• Запрос _versions c указанием идентификатора версии вохвращает название вопроса и список ответов с идентификаторами (формат JSON) в указанной версии
• Запрос AnswerIdsByVersion c указанием идентификатора версии возвращает список идентификаторов ответов с портала АГ в указанной версии
• Запрос AnswersByVersion c указанием идентификатора версии возвращает список ответов с идентификаторами (формат JSON) в указанной версии
• Запрос ResultsByVersion c указанием идентификатора версии возвращает количество голосов за каждый из ответов в указанной версии
• Запрос VoteOfUser с указанием UID пользователя на сайте АГ возвразает номер ответа за который голосовал пользователь result и хэш ответа, если пользователь вводил текст ответа value1, value2