My DPOS misc repo
Branch: master
Clone or download
Latest commit e43c664 Feb 22, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
dposlib python 2.x behaviour fix Feb 22, 2019
test started unit testing package Feb 21, 2019
wallet moved wallet package Feb 21, 2019
.gitignore
MANIFEST.in distribution fix Feb 22, 2019
README.md readme update Feb 22, 2019
VERSION Lisk blockchain and forks developpement frozen Feb 19, 2019
licence.html rest responses improvement Oct 28, 2018
lisk-network.7z cfg module initialization fix Feb 19, 2019
lisk.7z Lisk blockchain and forks developpement frozen Feb 19, 2019
setup.py python setup.py fix Feb 22, 2019

README.md

dposlib Quick View

dposlib package aims to provide a simple API to ARK blockchain and forks.

Support this project

Overview

Import REST API

>>> from dposlib import rest
>>> rest.use("dark")

Bake Transaction:

>>> from dposlib.blockchain import Transaction
>>> tx = Transaction(
... amount=100000000,
... recipientId="DRgh1n8oyGHDE6xXVq4yhh3sSajAr7uHJY",
... secret="secret",
... secondSecret="secondSecret")
>>> tx.finalize()
>>> tx
{
  "amount": 100000000,
  "fee": 1830000,
  "id": "5a90ea87fb8848c3402e5d6da5d34651eee01124387aa4f499c84621e03dd791",
  "recipientId": "DRgh1n8oyGHDE6xXVq4yhh3sSajAr7uHJY",
  "senderPublicKey": "03a02b9d5fdd1307c2ee4652ba54d492d1fd11a7d1bb3f3a44c4a05e79f19de933",
  "signSignature": "3045022100f297bf2241eb1603c4e91552416bbd900f1335684d3bb8751a043b5ae4569948022067c166322df1374222589d81b4ea52d56d93db8eab7be59a258420cbc6217360",
  "signature": "304402205e609776d7d04a659ab8057e269c26e8b611ed4952ffb6b1af9c9bca19a9e3c50220755b8e2a10783bab0e7da95229e358d8e9e4628241a39640869fb8bf856a953a",
  "timestamp": 45690392,
  "type": 0
}

Broadcast transaction

>>> rest.POST.api.transactions(transactions=[tx])
{'data': {'broadcast': ['5a90ea87fb8848c3402e5d6da5d34651eee01124387aa4f499c84621e03dd791'], 'excess': [], 'invalid': [], 'accept': []}}

Available network

  • Ark
    • mainet : ark
    • devnet : dark
    • forks
      • Kapu : kapu
      • Persona : prs
      • Ripa : ripa
      • Phantom : xph

Network API

>>> rest.use("ark")
>>> dlgt = dposlib.core.api.Delegate("arky") # get delegate by username
>>> dlgt.forged()
{'fees': 3294.7, 'forged': 227230.7, 'rewards': 223936.0}
>>> dlgt.address
'ARfDVWZ7Zwkox3ZXtMQQY1HYSANMB88vWE'
>>> blk = dlgt.lastBlock() # get last forged block
>>> blk
{
  "blockSignature": "304402200a496a628c2741537538f0492f9d683d3c4f1b30c8dd03c33ad8fbe79d08b6eb02206cdec7e1210db53a3ca22da30912479ff3644d3a1ed1d878417d5965f34dfd6d",
  "confirmations": 68,
  "generatorId": "ARfDVWZ7Zwkox3ZXtMQQY1HYSANMB88vWE",
  "generatorPublicKey": "030da05984d579395ce276c0dd6ca0a60140a3c3d964423a04e7abe110d60a15e9",
  "height": 5862354,
  "id": "1894085440657345411",
  "numberOfTransactions": 0,
  "payloadHash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "payloadLength": 0,
  "previousBlock": "11181074894913507025",
  "reward": 2.0,
  "timestamp": 47535768,
  "totalAmount": 0.0,
  "totalFee": 0.0,
  "totalForged": 2.0,
  "version": 0
}
>>> blk.transactions()
[]
>>> wlt = dposlib.core.api.Wallet(dlgt.address) # get wallet by address
>>> wlt.balance
2537.42979112
>>> for elem in [(tx["recipientId"], tx["amount"]) for tx in wlt.lastTransactions(2)]:
...     print(elem)
...
('AHMXV6UdkVxsTwMqeoeqdpotRRmGZZaAtj', 0.08403461)
('AUahWfkfr5J4tYakugRbfow7RWVTK35GPW', 329.32420472)
>>> wlt.link("secret passphrase here")
>>> wlt.send(1, "ARfDVWZ7Zwkox3ZXtMQQY1HYSANMB88vWE")
{'transactionIds': ['bbce72e7a76f5f71209c8ab29b4b4299a409241dfc77835150459a34bd5a5c16'], 'success': True}
  • Ark v1
  • Ark v2

Install

Version

0.1.0

  • First rebrand

0.1.1

  • ARK packaging improvement (v1 and v2)
  • LISK packaging improvement (v09 and v10)
  • ARK dynamicFee implementation
  • Network API created

0.1.2

  • Packaging improvement

0.1.3 : available on PyPi

  • REST requests header bugfix (ubuntu)

0.1.4

  • Python 2.x compatibility fix
  • dposlib.core.Transaction.sign does not set fees anymore
  • dposlib.core.Transaction.finalize set fees before signature
  • dposlib.core.Transaction fee management improved

0.1.5

  • compatibility with both ark-core v2 devnet and mainnet

0.1.6 :

  • Ark-core v 2.1.x compatibility

0.1.7 :

  • added transaction and rest MarkDown documentation files
  • dposlib.core.api is both python 2.x and 3.x compliant
  • added Webhook api (experimental)
  • fee data initialisation improvement
  • transaction broadcasting improvement
  • peer selection improvement
  • Lisk blockchain and forks developpement frozen

0.1.8 current work

TODO

  • integrate LedgerBlue Nano S use
  • doc writing
  • unittest
  • wallet
  • CLI