Convex api
Project description
Convex API
Quick Start
First you need to download the Convex-API-py package from the python package index PyPi.
pip install convex-api
You can now access the convex network, and get a balance from an existing account on the network by doing the following:
>>> from convex_api import ConvexAPI
>>> convex_api = ConvexAPI('https://convex.world')
>>> convex_api.get_balance(9)
99396961137042
You can create a new emtpy account, with now balance:
>>> account = convex_api.create_account()
>>> account.address
809
You can request some funds to the new account and then get the account information:
>>> convex_api.request_funds(1000000, account)
1000000
>>> convex_api.get_account_info(account)
{'environment': {}, 'address': 809, 'is_library': False, 'is_actor': False, 'memory_size': 42, 'balance': 1000000, 'allowance': 0, 'sequence': 0, 'type': 'user'}
You can export the accounts private key encoded as PKCS8 encrypt the key with a password:
>>> account.export_to_text('secret')
'-----BEGIN ENCRYPTED PRIVATE KEY-----\nMIGbMFcGCSqGSIb3DQEFDTBKMCkGCSqGSIb3DQEFDDAcBAiMY42UY4PXHAICCAAw\nDAYIKoZIhvcNAgkFADAdBglghkgBZQMEASoEEJpwDMicGbGj2iSJesktIVYEQBsp\nKMTAHzvUyw8jZRr8WSrmxH7938sjma8XWI6lgd9jwTZzcGamog7p3zatw0Wp+jFK\nKruWAZmIqhBZ/2ezDv8=\n-----END ENCRYPTED PRIVATE KEY-----\n'
>>> account.address
809
To re-use your account again you need to import the encrypted private key and set the correct account address
>>> from convex_api import Account
>>> account = Account.import_from_file('my_key.dat', 'secret', address=809)
To create a new address with the same account keys in your new or imported account object, you can do:
>>> new_account = convex_api.create_account(account)
>>> account.address
809
>>> new_account.address
934
To use account names, where an account name is resolved to a fixed address. You can create or load an account based on it's name by doing the following:
>>> account = convex_api.setup_account('my-account-name', import_account)
>>> account.address
934
>>> convex_api.resolve_account_name('my-account-name')
934
>>> same_account = convex_api.setup_account('my-account-name', import_account)
>>> same_account.address
934
To submit a transaction, use ConvexAPI.send(). This will cost a small about of juice, and reduce your balance
>>> convex_api.request_funds(1000000, account)
1000000
>>> convex_api.send('(map inc [1 2 3 4])', account)
{'value': [2, 3, 4, 5]}
>>> convex_api.get_balance(account)
996360
To send a query a transaction, this is free and can be performed by any valid account address. So for example to query a balance of an account:
>>> convex_api.query(f'(balance {account.address})', account)
{'value': 996360}
# this is the same as above
>>> convex_api.query(f'(balance {account.address})', account.address)
{'value': 996360}
# get the balance using one of the standard account addresses (#1)
>>> convex_api.query(f'(balance {account.address})', 1)
{'value': 996360}
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for convex_api_py-0.1.3-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 74397ac3769ac3b3551ceaab3689ea14f6525b4a4addf7972150a7f8f0f843df |
|
MD5 | 777cfbaeccc8fdc666a3b15ed06f8716 |
|
BLAKE2b-256 | 5ecf0d27fb0f23d2f8e4c761a205648760f23a7afbf60f45eb8d4a5bc404ea38 |