Privex的GOLOS Python库

这是一个为GOLOS Classic（可能与其他GOLOS分支兼容）设计的Python 3库，由Privex Inc开发和发布。

大部分代码最初来源于@ksantoprotein，我们对代码进行了清理，做出了一些改进，添加了单元测试，并将其打包成PyPi包。

    +===================================================+
    |                 © 2019 Privex Inc.                |
    |               https://www.privex.io               |
    +===================================================+
    |                                                   |
    |        Originally Developed by Privex Inc.        |
    |                                                   |
    |        Core Developer(s):                         |
    |                                                   |
    |          (+)  Chris (@someguy123) [Privex]        |
    |                                                   |
    +===================================================+

安装

使用pip从PyPi下载并安装（推荐）

pip3 install golos-python

（替代）从Git手动安装

选项1 - 使用pip直接从Github安装

pip3 install git+https://github.com/Privex/golos-python

选项2 - 克隆并手动安装

# Clone the repository from Github
git clone https://github.com/Privex/golos-python
cd golos-python

# RECOMMENDED MANUAL INSTALL METHOD
# Use pip to install the source code
pip3 install .

# ALTERNATIVE MANUAL INSTALL METHOD
# If you don't have pip, or have issues with installing using it, then you can use setuptools instead.
python3 setup.py install

许可

此Python模块由伯利兹城Privex Inc创建，并使用X11/MIT许可协议许可。请参阅文件LICENSE以获取许可协议文本。

TL;DR; 许可协议

我们不提供任何保证。您可以将它复制、修改，用于具有不同许可协议的项目，甚至用于商业（付费）软件。

最重要的规则是 - 您必须在任何副本中保留原始许可协议文本可见（见LICENSE）。

示例用途

from golos import Api
from decimal import Decimal

golos = Api(nodes=['wss://golosd.privex.io', 'wss://api.golos.blckchnd.com/ws'])

###
# Get account information + balances
###

accounts = golos.get_accounts(['someguy123'])
acc = accounts[0]
print(acc['owner'])
# 'someguy123'

print('GOLOS:', acc['GOLOS'], 'GBG:', acc['GBG'])
# GOLOS: 157560.231 GBG: 6420.916

###
# Get witness information
###

witness = golos.get_witness_by_account(account='someguy123')
print(witness['url'])
# 'https://golos.io/ru--delegaty/@someguy123/delegat-someguy123'

###
# Get account history
###

history = golos.get_account_history(account='someguy123')

print(history[0])
# {'account': 'huso', 'witness': 'someguy123', 'approve': False, 'number': 127286, 'block': 30494335, 
#  'timestamp': '2019-09-17T14:20:21', 'type_op': 'account_witness_vote'}

###
# Transfer GOLOS / GBG to another account
#
# WARNING: To reduce the risk of rounding errors, pass the amount as either a string or a Decimal() - avoid float's!
###

tf = golos.transfer(
    to='ksantoprotein', amount='0.1', asset='GOLOS', from_account='someguy123',
    wif='5Jq19TeeVmGrBFnu32oxfxQMiipnSCKmwW7fZGUVLAoqsKJ9JwP', memo='this is an example transfer'
)

print('TXID:', tf['id'], 'Block:', tf['block_num'])
# TXID: c901c52daf57b60242d9d7be67f790e023cf2780 Block: 30895436

贡献

我们乐于接受任何大小的拉取请求。

请确保您所做的任何更改都符合以下基本要求

• 从其他项目获取的任何代码都必须与MIT许可协议兼容
• 这是一个新项目，因此，支持低于3.4的Python版本的重要性非常低。
• 然而，我们乐于接受PR以改善与旧版Python的兼容性，只要它不会
  • 大大增加代码的复杂性
  • 或者给Python新版本的用户带来问题。

贡献的法律免责声明

没有人愿意阅读充斥着法律文本的长篇文档，所以我们在这里总结了重要内容。

如果您向由 Privex 创建/拥有的项目贡献您自己创建/拥有的内容，例如代码或文档，那么您可能自动授予我们无限使用您内容的使用权，无论我们的项目适用的开源许可证是什么。

如果您不想授予我们无限使用您的内容，请确保将您的内容放在单独的文件中，确保在文件开始处（例如代码注释）或其包含的文件夹内（例如名为 LICENSE 的文件）清楚地显示您内容的许可证。

请在您的 pull request 或 issue 中让我们知道您已包含单独许可的文件，以便我们可以确保没有可能阻止我们接受您的贡献的许可证冲突。

如果您想阅读整个法律文本，它应包含为 privex_contribution_agreement.txt。

感谢阅读！

如果这个项目对您有帮助，请考虑从 Privex 购买 VPS 或专用服务器 - 价格低至每月 8 美元（我们接受加密货币！）