Data Model

The basic objects of the protocol as users, contributions and evaluations.

Users

Users have tokens, a number representing the amount of ownership of a contract, and reputation, a number that represents the user reputation within the system.

{
    "id": 1, 
    "reputation": 20.0, 
    "reputation_normalized": 1.0, 
    "tokens": 50.0, 
    "total_reputation": 20.0
}

Contributions

A contribution has a contributor (which is the user that has made the contribution), a score which represents how much the contribution has been valued by the community, and engaged_reputation, a value between 0 and 1 that represents the sum of the reputation of the users that have evaluated the contribution.

{
    "contributor": {
        "id": 2, 
        "reputation": 0.5, 
        "tokens": 49.0
    }, 
    "id": 1, 
    "stats": {
        "engaged_reputation": 0.0, 
        "evaluations": {
            "0": {
                "reputation": 0.0
            }, 
            "1": {
                "reputation": 0.0
            }
        }, 
        "quality": 0.0, 
        "score": 0.0
    }, 
    "type": "article"
}

Evaluations

An evaluation of a contribution has an evaluator, which is the user that has made the evaluation, the contribution that the evaluation pertains to, and a value.

{
    "contribution": {
        "contributor": {
            "id": 3, 
            "reputation": 0.2506265664160401, 
            "tokens": 49.0
        }, 
        "id": 2, 
        "stats": {
            "engaged_reputation": 0.2481203007518797, 
            "evaluations": {
                "0": {
                    "reputation": 0.0
                }, 
                "1": {
                    "reputation": 0.2481203007518797
                }
            }, 
            "quality": 0.2481203007518797, 
            "score": 0.2481203007518797
        }, 
        "type": "article"
    }, 
    "evaluator": {
        "id": 4, 
        "reputation": 19.8, 
        "reputation_normalized": 0.2481203007518797, 
        "tokens": 50.0, 
        "total_reputation": 79.8
    }, 
    "id": 1, 
    "value": 1.0
}