pyvsystems

DEPRECATED. Please use the new Python SDK py-vsys instead.

A python wrapper for vsys api.

For more detail, please refer:

PYVSYSTEMS User Guide Specification (English)

PYVSYSTEMS 使用详细指南(中文)

Install

Library can be pulled via pip directly:

git+https://github.com/virtualeconomy/pyvsystems.git

Or:

1. clone the repo under you workspace git clone https://github.com/virtualeconomy/pyvsystems.git
2. install the package pip3 install pyvsystems/.
3. Then you can import pyvsystems in your workspace

Usage

chain object

1. For testnet:

   import pyvsystems as pv
   ts_chain = pv.testnet_chain()

2. For default chain:

   import pyvsystems as pv
   main_chain = pv.default_chain()

3. For custom api node:

   import pyvsystems as pv
   # you can set the request timeout
   custom_wrapper = pv.create_api_wrapper('http://<full node ip>:9922', api_key='', timeout=None)
   ts_chain = pv.testnet_chain(custom_wrapper)

4. For completely custom chain:

   import pyvsystems as pv
   custom_wrapper = pv.create_api_wrapper('http://<full node ip>:9922', api_key='',  timeout=None))
   t_chain = pv.Chain(chain_name='testnet', chain_id='T', address_version=5, api_wrapper=custom_wrapper)
   custom_wrapper2 = pv.create_api_wrapper('http://<full node ip>:9922', api_key='',  timeout=None))
   m_chain = pv.Chain(chain_name='mainnet', chain_id='M', address_version=5, api_wrapper=custom_wrapper2)
   custom_wrapper3 = pv.create_api_wrapper('http://<full node ip>:9922', api_key='',  timeout=None))
   c_chain = pv.Chain(chain_name='mychain', chain_id='C', address_version=1, api_wrapper=custom_wrapper3)

chain api list

1. look up current block height of the chain:

   ts_chain.height()

2. look up the last block info of the chain:

   ts_chain.lastblock()

3. look up a block info at n in the chain:

   ts_chain.block(n)

4. Get a transaction info by transacion id in the chain:

   ts_chain.tx(tx_id)

5. Validate an address of the chain:

   ts_chain.validate_address(addr)

address object

1. constructed by seed

   from pyvsystems import Account
   my_address = Account(chain=ts_chain, seed='<your seed>', nonce=0)

2. constructed by private key

   from pyvsystems import Account
   my_address = Account(chain=ts_chain, private_key='<your base58 private key>')

3. constructed by public key

   from pyvsystems import Account
   recipient = Account(chain=ts_chain, public_key='<base58 public key>')

4. constructed by wallet address

   from pyvsystems import Account
   recipient = Account(chain=ts_chain, address='<base58 wallet address>')

address api list

1. Get balance

   # get balance
   balance = my_address.balance()
   print("The balance is {}".format(balance))
   # get balance after 16 confirmations 
   balance = my_address.balance(confirmations = 16)
   print("The balance is {}".format(balance))

2. Send payment transaction

   # send payment (100000000 = 1 VSYS)
   my_address.send_payment(recipient, amount=100000000)

3. Send and cancel lease transaction

   # send lease (100000000 = 1 VSYS)
   response = my_address.lease(recipient, amount=100000000)
   tx_id = response["id"]
   # cancel lease
   my_address.lease_cancel(tx_id)

Sample code for Send Transaction for reference

Sample Code for Exchange for reference

Sample Code for Non Fungible Token Contract for reference

Sample Code for Payment Channel Contract for reference

Sample Code for System Contract for reference

Sample Code for Token Contract for reference