Giter VIP home page Giter VIP logo

galtproject-docs's Introduction

logo-black-360

Galt Project Documentation

This repository contains Software Design Documents for Galt Project.

For each smart contract Documentation contains:

  • problems descriptions;
  • goals;
  • requirements;
  • specifications;
  • user scenarios;
  • user inteface design;

File structure

  • ru - directory contains documentation in Russian Language. One file for each contract.
  • en - directory contains documentation in English Language. One file for each contract.

About Galt Project

Galt Project is an international decentralized land and real estate property registry governed by DAO (Decentralized autonomous organization) and self-governance protocol for communities of homeowners built on top of Ethereum blockchain. Unlike the state property registries, the Galt Project is managed by a decentralized community of property owners using smart contracts. Creation of property records, resolution of disputes between owners, trading, mortgage, title insurance, and many other operations are performed on smart contracts. Also, property owners can unite in communities for voting, fundraising, and managing the common property.

Galt Project Tokens

GALT - ERC20 standart ethereum based token.

SPACE - ERC721 standart ethereum based token.

Galt Project Contact information

https://galtproject.io/

galtproject-docs's People

Contributors

chebykin avatar goodstemy avatar igorfrolov avatar microwavedev avatar npopeka avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

galtproject-docs's Issues

Штраф репутации при факте сдачи участка в аренду

Каким образом произойдет штраф репутации если репутация SPACE токена уже распределена между арендаторами?

Вариант решения:

  • Невозможность совершить штраф, пока не будет revoke-нута вся репутация space токена

Возможная проблема при таком решении:

  • Владелец участка постоянно передает в аренду часть репутации участка, не давая тем самым оштрафовать свой участок

Предложение: Сделать PlotManager из AddNewPlot

Сейчас AddNewPlot используется только для создания новой территории, но если мы даем ему права owner над контрактом SpaceToken, то может стоит расширить его функционал на исправление возникающих ошибок?
Тоесть обозначить функции и логику с помощью которой можно будет при определенных обстаятельствах делать transfer между владельцами и прочие функции которые могут понадобиться после добавления множества участков в проект.
Ну и если расширять его функционал на такую логику, то можно и переименовать в PlotManager чтобы больше соответствовал тому, что мы хотим добиться от этого контракта

Вопросы по Reputation, которые нужно описать в документации

  • При передачи токена от одного владельцу к другому: каким образом новый владелец может получить себе репутацию токена?
  • Какие действия новый владелец токена может выполнять с репутацией токена до того как сделает revoke?(Волнует безопасность)
  • Можно ли распределять сданную в аренду пользователю репутацию между другими пользователями?
  • Что за периоды аренды в Примере 3, как они работают, на что влияют?
  • Чем отличается контракт совместной аренды от сдачи репутации в аренду другим пользователям? Какие правила прописаны в контракте совместной аренды, которые дают арендатору какие-то гарантии в отличии от сдачи репутации в аренду другим пользователям?

Дополнить описание Galt Genesis (Crowdsale)

в спецификацию добавить

Работа с Видео

Видео № 3, надо добавить:

  1. Обмен происходит автоматически при помощей умного контракта. Проект берет комиссию, от каждой транзакции. Если пользователь отправляет эфиры, то комиссия берется в эфирах, если GALT, то в GALT. Эфиры и токены GALT за вычетом комиссии полностью попадают на умных контракт и используются для дальнейших обменных операций. Создатели проекта не имеют доступа к этим средствам.
  2. Курс обмена определяется автоматически, исходя из того, сколько Эфиров находится на умном контракте GaltDex и сколько токенов  GALT находится у пользователей.

Видео 4:

  1. Переделать с учетом нового интерфейса.
  2. Сказать, что “сдача” от перечисленных на внутренний кошелек средств будет возвращена автоматически.
  3. Сказать, что временный кошелек создается каждый раз новый.
  4. Сказать, что приложение просит дать право на выполнение операции с заявкой внутреннему кошельку.
  5. Сказать, что приложение блокируется пока право не будет отозвано от внутреннего кошелька на основной адрес пользователя.
  6. Дать определение Валидатору - нотариус, юрист или геодезист, которые проверяют заявку.

Видео 6

  1. Мало комментариев. Нужно говорить, что заходим в таком то меню и нажимаем то - то.
  2. В меню выбора геохешей нужно сказать: Каждый геохеш добавляется вручную, Вы можете нажать на карту и Геохей максимальной точности будет скопирован в буфер обмена. Вам останется только вставить его в поле для ввода и убрать лишние символы. Обратите внимание, что введенный геохеш подсвечивается на карте. Вы можете добавить новый геохеш только, если он соседствует с геохешем, который был добавлен ранее.

Добавить в документацию Delegate Voting возможность распределять репутацию между несколькими кандидатами

Добавить в документацию Delegate Voting возможность распределять репутацию между несколькими кандидатами в рамках одного фонда.
Так же нужен общий случай, когда Пользователь имеет репутацию в нескольких фондах и распределяет ее между делегатами в этих фондах.

Оформить навигацию по доке

  • На главной странице ссылки EN/RU/*
  • На странице локали - структурированная навигация по существующим документам

Необходимо определиться с терминами

Как мы будем именовать И в документации И в коде нижеперечисленные сущности:

  • контракт, где хранятся активы фонда MultiSig или Avatar?
  • фонд или ДАО? (Fund/DAO)?

Так же необходимы термины для именования участников системы. На данный момент я предлагаю:

  • user (пользователь) - человек, офф-чейн скрипт
  • address (адрес) - за адресом могут стоять: человек, офф-чейн скрипт, контракт

Выбранные варианты необходимо зафиксировать в документации.

Разработать vickrey аукцион для создания нового DAO

Текущая проблема: мы не можем заранее определить адекватную комиссию в GALT токенах для создания нового DAO

Предполагаемое решение: в определенный период времени (цикл/раунд) возможно создание только одного DAO, право на его создание определяется с помощью vickrey аукциона

Сделать доку на контракт выпуска новых больших территорий

Вводные:

  • все большие территории - 721 токены, которые принадлежат аукциону.
  • смысле этих токенов в том, что это whitelist, в рамках которого можно создавать новые 721 на аукционе. Это сделано, чтобы невозможно было вывести на аукцион и купить тихий океан.
  • введем новый термин и назовем их Территории.

Новые Территории должны вводиться следующим образом:

  • любой адрес может заплатить газ и создать заявку на создание нового 721 токена Территории.
  • В заявке указывается геохеш и ВНИМАНИЕ galt, в которые оценивается эта территория. Цифра может быть любая. Так же указываются минимальный и максимальный размер лота на аукционе. Так же может быть указан Адрес Владельца Территории.
  • Голосуют 100% текущих владельцев землю. Если проголосовало более 66% за, то создается новый 721 токен Территории, владелец - глобальный аукцион. Минтятся новые ГАЛТЫ и ВНИМАНИЕ отправляются на адрес Владельца Территории.
  • Таким образом если я владею землей в текущей правовой системе я могу при желании и оформив все юридически правильно - добавить свою землю в экосистему GALT project в обмен на галты. Если земля мне не принадлежит или все оформлено неправильно, то за заявку не проголосуют.

Зачем это нужно и почему принципально? Нужно иметь возможность выйти за границы одной Территории.

Над точным механизмом конечно нужно подумать и все детально взвесить.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.