Py-EigenTrust
Py-EigenTrust is a python wrapper for https://github.com/Karma3Labs/go-eigentrust
Input
You will need local trust and optionally pre-trust. If pre-trust is not specified, each peer will have an equal weight. Both can be specified
using a CSV or an array of a dict with i, j, and v.
Sample local trust dict variable
localtrust = [{
"i": "ek",
"j": "sd",
"v": 100
}, {
"i": "vm",
"j": "sd",
"v": 100
}, {
"i": "ek",
"j": "sd",
"v": 75
}]
Sample local trust (lt.csv):
from,to,value
ek,sd,100
vm,sd,100
ek,vm,75
Here we have 3 peers: EK, VM, and SD. Both EK and VM trust SD by 100. EK also trusts VM, by 3/4 of how much he trusts SD.
Sample pre trust dict variable
pre = [{
"i": "ek",
"v": 50
}, {
"i": "vm",
"v": 100
}]
Sample pre-trust (pt.csv):
peer_id,value
ek,50
vm,100
Here, both EK and VM are pre-trusted by the network (a priori trust). VM is trusted twice as much as EK.
Running
To run EigenTrust using the above input:
from py_eigentrust import EigenTrust
api_key = 'your_api_key'
a = EigenTrust(api_key=api_key)
# Option A - Use local variable
a.run_eigentrust(localtrust)
## run with pretrust you've defined rather than the one distributed equally
a.run_eigentrust(localtrust, pretrust)
# Option B - Use CSV
a.run_eigentrust_from_csv("./lt.csv")
## run with pretrust you've defined rather than the one distributed equally
a.run_eigentrust_from_csv("./lt.csv", "./pt.csv")
Outputs:
[
{'i': 'vm', 'v': 0.485969387755102},
{'i': 'sd', 'v': 0.2933673469387755},
{'i': 'ek', 'v': 0.22066326530612243}
]
Here, the EigenTrust algorithm distributed the network's trust onto the 3 peers:
- EK gets 22.0%
- SD gets 29.3%
- VM gets 48.5%
Appendix
Tweaking Alpha
The pre-trust input defines the relative ratio by which the network distributes its a priori trust onto trustworthy peers, in this case EK and VM.
You can also tweak the overall absolute strength of the pre-trust. This parameter, named alpha, represents the portion of the EigenTrust output taken from the pre-trust. For example, with alpha of 0.2, the EigenTrust output is a blend of 20% pre-trust and 80% peer-to-peer trust.
The CLI default for alpha is 0.5 (50%). If you re-run EigenTrust using a lower alpha of only 0.01 (1%):
from py_eigentrust import EigenTrust
api_key = 'your_api_key'
a = EigenTrust(api_key=api_key, alpha=0.01)
a.run_eigentrust(localtrust, pretrust)
We get a different result:
[
{'address': 'vm', 'score': 0.39451931175281096},
{'address': 'sd', 'score': 0.4401132971693594},
{'address': 'ek', 'score': 0.16536739107782936}
]
EK and VM's trust shares got lower (EK 21.7% ⇒ 16.5%, VM 48.1% ⇒ 39.5%), whereas SD's trust share soared (30.2% ⇒ 44%) despite not being pre-trusted. This is because, with only 1% pre-trust level, the peer-to-peer trust opinions (where SD is trusted by both EK and VM) make up for a much larger portion of trust.
Metadata
Release files for py-eigentrust 0.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| py_eigentrust-0.0.1.tar.gz | 3.9 kB | Without provenance | Details for py_eigentrust-0.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| py_eigentrust-0.0.1-py3-none-any.whl | Python 3 | none | any | Details for py_eigentrust-0.0.1-py3-none-any.whl |
Total release size: 8.2 kB
Release files / py_eigentrust-0.0.1.tar.gz
| Download URL | py_eigentrust-0.0.1.tar.gz |
|---|---|
| Size | 3.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ce3804028e17b0e34da9d7ef1ec80f9153744d48b9e56ccc8adbcf58c658bd19
|
|
BLAKE2b-256 checksum How to use checksums |
3a4c0e9b2173d9a98716acc37cc351dad436d2a0249fb4796888d0635a18b59b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.8.3 CPython/3.10.11 Darwin/22.6.0
|
Release files / py_eigentrust-0.0.1-py3-none-any.whl
| Download URL | py_eigentrust-0.0.1-py3-none-any.whl |
|---|---|
| Size | 4.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b62c30724f5151f9276207de3b2d6011e46fff4491f2b1ce8b117a0108e694ed
|
|
BLAKE2b-256 checksum How to use checksums |
f5db7df7db53094febab5818c3bca1da1cc52ac8af4b956eb6ec5056f3e6467d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.8.3 CPython/3.10.11 Darwin/22.6.0
|
Security for py-eigentrust 0.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.