PyWaves is an object-oriented Python interface to the Waves blockchain platform.
You can install PyWaves using:
pip install pywaves
The library utilizes classes to represent various Waves data structures:
- pywaves.Address
- pywaves.Asset
- pywaves.AssetPair
- pywaves.Order
importpywavesaspwmyAddress=pw.Address(privateKey='CtMQWJZqfc7PRzSWiMKaGmWFm4q2VN5fMcYyKDBPDx6S')
otherAddress=pw.Address('3PNTcNiUzppQXDL9RZrK3BcftbujiFqrAfM')
myAddress.sendWaves(otherAddress, 10000000)
myToken=myAddress.issueAsset('Token1', 'My Token', 1000, 0)
whilenotmyToken.status():
passmyAddress.sendAsset(otherAddress, myToken, 50)pywaves.Address(address, publicKey, privateKey, seed)Creates a new Address object
- address
- publicKey
- privateKey
- seed
balance(assetId='', confirmations=0) returns balance of Waves or other assets
assets() returns a list of assets owned by the address
issueAsset(name, description, quantity, decimals=0, reissuable=False, txFee=DEFAULT_ASSET_FEE, timestamp=0) issue a new asset
reissueAsset(Asset, quantity, reissuable=False, txFee=DEFAULT_ASSET_FEE, timestamp=0) reissue an asset
burnAsset(Asset, quantity, txFee=DEFAULT_ASSET_FEE, timestamp=0) burn the specified quantity of an asset
sendWaves(recipient, amount, attachment='', txFee=DEFAULT_TX_FEE, timestamp=0) send specified amount of Waves to recipient
massTransferWaves(transfers, attachment='', timestamp=0) sending Waves tokens via a mass transfer
sendAsset(recipient, asset, amount, attachment='', txFee=DEFAULT_TX_FEE, timestamp=0) send specified amount of an asset to recipient
massTransferWaves(self, transfers, attachment='', timestamp=0) sending an asset via mass transfer
cancelOrder(assetPair, order) cancel an order
buy(assetPair, amount price, maxLifetime=30*86400, matcherFee=DEFAULT_MATCHER_FEE, timestamp=0) post a buy order
tradableBalance(assetPair) get tradable balance for the specified asset pair
sell(assetPair, amount, price, maxLifetime=30*86400, matcherFee=DEFAULT_MATCHER_FEE, timestamp=0) post a sell order
lease(recipient, amount, txFee=DEFAULT_LEASE_FEE, timestamp=0) post a lease transaction
leaseCancel(leaseId, txFee=DEFAULT_LEASE_FEE, timestamp=0) cancel a lease
getOrderHistory(assetPair) get order history for the specified asset pair
cancelOpenOrders(assetPair) cancel all open orders for the specified asset pair
deleteOrderHistory(assetPair) delete order history for the specified asset pair
createAlias(alias, txFee=DEFAULT_ALIAS_FEE, timestamp=0) create alias
sponsorAsset(assetId, minimalFeeInAssets, txFee=pywaves.DEFAULT_SPONSOR_FEE, timestamp=0) sponsoring assets
setScript(script, txFee=pywaves.DEFAULT_SCRIPT_FEE, timestamp=0) sets a script for this address
dataTransaction(data, timestamp=0) sets data for the account. data should be a json array with entries including type (bool, binary, int, string), key and value
deleteDataEntry(key) deletes a given data entry, identified by key, from the data storage of the account
setScript(scriptSource, txFee=pywaves.DEFAULT_SCRIPT_FEE, timestamp=0) issue a smart asset
setAssetScript(asset, scriptSource, txFee=pywaves.DEFAULT_ASSET_SCRIPT_FEE, timestamp=0) set a new script for a smart asset
invokeScript(dappAddress, functionName, params, payments, feeAsset = None, txFee=pywaves.DEFAULT_INVOKE_SCRIPT_FEE) invoke a script on a given dapp address
pywaves.Asset(assetId)Creates a new Asset object
- status
- assetId
- issuer
- name
- description
- quantity
- decimals = 0
- reissuable = False
status() returns 'Issued' if the asset exists
pywaves.AssetPair(asset1, asset2)Creates a new AssetPair object with 2 Asset objects
- asset1
- asset2
orderbook() get order book
ticker() get ticker with 24h ohlcv data
last() get traded price
open() get 24h open price
high() get 24h high price
low() get 24h low price
close() get 24h close price (same as last())
vwap() get 24h vwap price
volume() get 24h volume
priceVolume() get 24h price volume
trades(n) get the last n trades
trades(from, to) get the trades in from/to interval
candles(timeframe, n) get the last n candles in the specified timeframe
candles(timeframe, from, to) get the candles in from/to interval in the specified timeframe
pywaves.Order(orderId, assetPair, address='') Creates a new Order object
- status
- orderId
- assetPair
- address
- matcher
- matcherPublicKey
status() returns current order status
cancel() cancel the order
This class is meant to provide the necessary functionality to calculate fees according to the new WX fee structure
All values here for price and amounts of tokens are always in the smallest unit of the token ("satoshis").
calculateDynamicFee() calculates the dynamic fee for a trade
calculateDynamicDiscountFee() calculates the dynamic discounted fee for a trade
calculatePercentSellingFee(priceAssetId, amountAssetId, amountToSell) calculates the percentage selling fee for a trade
calculatePercentDiscountedSellingFee(priceAssetId, amountAssetId, amountToSell) calculates the discounted percentage selling fee for a trade
calculatePercentBuyingFee(priceAssetId, price, amountToBuy) calculates the percentage buying fee for a trade
calculatePercentDiscountedBuyingFee(priceAssetId, price, amountToBuy) calculates the discounted percentage buying fee for a trade
import pywaves as pw
config = {
'amountAsset': 'WAVES',
'priceAsset': '25FEqEjRkqK6yCkiT7Lz6SAYz7gUFCtxfCChnrVFD5AT',
'privateKey': 'xxx'
}
pw.setNode('https://nodes-testnet.wavesnodes.com/', chain='testnet')
pw.setMatcher('http://matcher-testnet.waves.exchange')
wxFeeCalculator = pw.WXFeeCalculator()
address = pw.Address(privateKey=config['privateKey'])
tradingPair = pw.AssetPair(pw.Asset(config['amountAsset']), pw.Asset(config['priceAsset']))
price = 5
amountToBuy = 1000000000
matcherFee = wxFeeCalculator.calculatePercentDiscountedBuyingFee(config['priceAsset'], price, amountToBuy)
tx = address.buy(tradingPair, amountToBuy, price, matcherFee = matcherFee, matcherFeeAssetId = 'EMAMLxDnv3xiz8RXg8Btj33jcEw3wLczL3JKYYmuubpc')
print (tx)
pywaves.setNode(node, chain, chain_id) set node URL ('http://ip-address:port') and chain (either 'mainnet' or 'testnet', or any other chain, if you also define the chain id)
pywaves.setChain(chain, chain_id) set chain (either 'mainnet' or 'testnet', or any other chain if you also supply the chain id)
pywaves.setOffline() switch to offline mode; sign tx locally without broadcasting to network
pywaves.setOnline() switch to online mode; sign tx locally a broadcast to network
pywaves.validateAddress(address) checks if the provided address is a valid Waves address
pywaves.setMatcher(node) set matcher URL ('http://ip-address:port')
pywaves.setDatafeed(node) set datafeed URL ('http://ip-address:port')
pywaves.height() get blockchain height
pywaves.lastblock() get last block
pywaves.block(n) get block at specified height
pywaves.tx(id) get transaction details
pywaves.stateChangeForTx(id): get the state changes for the given tx by id
pywaves.stateChangesForAddress(address, limit = 1000): get the last (with a default of 1000) state changes for the given address
pywaves.symbols() get list of symbol-asset mapping
pywaves.markets() get all traded markets with tickers
pywaves.{SYMBOL_NAME} get predefined asset for the specified symbol (pywaves.WAVES, pywaves.BTC, pywaves.USD,...)
The fees for waves/asset transfers, asset issue/reissue/burn and matcher transactions are set by default as follows:
- DEFAULT_TX_FEE = 100000
- DEFAULT_ASSET_FEE = 100000000
- DEFAULT_MATCHER_FEE = 1000000
- DEFAULT_LEASE_FEE = 100000
- DEFAULT_ALIAS_FEE = 100000
- DEFAULT_SPONSOR_FEE = 100000000
- DEFAULT_SCRIPT_FEE = 100000
importpywavesaspw# generate a new addressmyAddress=pw.Address("<some address>")
myAddress._generate()
# set an address with an addressmyAddress=pw.Address('3P6WfA4qYtkgwVAsWiiB6yaea2X8zyXncJh')
# get an existing address from seedmyAddress=pw.Address(seed='seven wrist bargain hope pattern banner plastic maple student chaos grit next space visa answer')
# get an existing address from privateKeymyAddress=pw.Address(privateKey='CtMQWJZqfc7PRzSWiMKaGmWFm4q2VN5fMcYyKDBPDx6S')
# get an existing address from a publicKeyaddress=pw.Address(publicKey=“EYNuSmW4Adtcc6AMCZyxkiHMPmF2BZ2XxvjpBip3UFZL”)
# get an address from a seed with a different nonce (This is especially useful for accessing addresses generated by nodes)myAddress=pw.Address(seed='seven wrist bargain hope pattern banner plastic maple student chaos grit next space visa answer', nonce=1)importpywavesaspwmyAddress=pw.Address('3P6WfA4qYtkgwVAsWiiB6yaea2X8zyXncJh')
# get Waves balanceprint("Your balance is %18d"%myAddress.balance())
# get Waves balance after 20 confirmations print("Your balance is %18d"%myAddress.balance(confirmations=20))
# get an asset balanceprint("Your asset balance is %18d"%myAddress.balance('DHgwrRvVyqJsepd32YbBqUeDH4GJ1N984X8QoekjgH8J'))importpywavesaspwmyAddress=pw.Address(privateKey='CtMQWJZqfc7PRzSWiMKaGmWFm4q2VN5fMcYyKDBPDx6S')
# send Waves to another addressmyAddress.sendWaves(recipient=pw.Address('3PNTcNiUzppQXDL9RZrK3BcftbujiFqrAfM'),
amount=100000000)
# send asset to another addressmyToken=pw.Asset('4ZzED8WJXsvuo2MEm2BmZ87Azw8Sx7TVC6ufSUA5LyTV')
myAddress.sendAsset(recipient=pw.Address('3PNTcNiUzppQXDL9RZrK3BcftbujiFqrAfM'),
asset=myToken,
amount=1000)importpywavesaspwmyToken=myAddress.issueAsset( name="MyToken",
description="This is my first token",
quantity=1000000,
decimals=2 )importpywavesaspwpw.setNode(node='http://127.0.0.1:6869', chain='testnet')
myAddress=pw.Address(privateKey='CtMQWJZqfc7PRzSWiMKaGmWFm4q2VN5fMcYyKDBPDx6S')
myAddress.createAlias("MYALIAS1")importpywavesaspwrecipients= ['3PBbp6bg2YEnHfdJtYM7jzzXYQeb7sx5oFg',
'3P4A27aCd3skNja46pcgrLYEnK36TkSzgUp',
'3P81U3ujotNUwZMWALdcJQLzBVbrAuUQMfs',
'3PGcKEMwQcEbmeL8Jhe9nZQRBNCNdcHCoZP',
'3PKjtzZ4FhKrJUikbQ1hRk5xbwVKDyTyvkn']
myAddress=pw.Address(privateKey="CtMQWJZqfc7PRzSWiMKaGmWFm4q2VN5fMcYyKDBPDx6S")
foraddressinrecipients:
myAddress.sendWaves(pw.Address(address), 1000000)importpywavesaspwtransfers= [
{ 'recipient': '3N1xca2DY8AEwqRDAJpzUgY99eq8J9h4rB3', 'amount': 1 },
{ 'recipient': '3N3YWbQ27NnK7tek6ASFh38Bj93guLxxSi1', 'amount': 2 },
{ 'recipient': '3MwiB5UkWxt4X1qJ8DQpP2LpM3m48V1z5rC', 'amount': 3 }
]
address=pw.Address(privateKey="CtMQWJZqfc7PRzSWiMKaGmWFm4q2VN5fMcYyKDBPDx6S")
address.massTransferWaves(transfers)importpywavesaspwtransfers= [
{ 'recipient': '3N1xca2DY8AEwqRDAJpzUgY99eq8J9h4rB3', 'amount': 1 },
{ 'recipient': '3N3YWbQ27NnK7tek6ASFh38Bj93guLxxSi1', 'amount': 2 },
{ 'recipient': '3MwiB5UkWxt4X1qJ8DQpP2LpM3m48V1z5rC', 'amount': 3 }
]
address=pw.Address(privateKey="CtMQWJZqfc7PRzSWiMKaGmWFm4q2VN5fMcYyKDBPDx6S")
address.massTransferAssets(transfers, pw.Asset('9DtBNdyBCyViLZHptyF1HbQk73F6s7nQ5dXhNHubtBhd'))importpywavesaspymyAddress=py.Address(privateKey='CtMQWJZqfc7PRzSWiMKaGmWFm4q2VN5fMcYyKDBPDx6S')
data= [{
'type':'string', 'key': 'test', 'value':'testval'
}]
myAddress.dataTransaction(data)importpywavesaspwmyAddress=pw.Address(privateKey='`')
myToken=pw.Asset('4ZzED8WJXsvuo2MEm2BmZ87Azw8Sx7TVC6ufSUA5LyTV')
amount=1000withopen('recipients.txt') asf:
lines=f.readlines()
foraddressinlines:
myAddress.sendAsset(pw.Address(address.strip()), myToken, amount)importpywavesaspwimportbase64pw.setNode(node='<node>', chain='testnet')
script='match tx { \n'+ \
' case _ => true\n'+ \
'}'address=pw.Address(privateKey="<private key>")
tx=address.setScript(script, txFee=1000000)imortpywavesaspwimportbase64pw.setNode(node='<node>', chain='testnet')
script='match tx { \n'+ \
' case _ => true\n'+ \
'}'address=pw.Address(privateKey='<private key>')
tx=address.issueSmartAsset('smartTestAsset', 'an asset for testingsmart assets', 1000, script, 2)importpywavesaspwimportbase64pw.setNode(node='<node>', chain='testnet')
script='match tx { \n'+ \
' case _ => true\n'+ \
'}'address=pw.Address(privateKey='<private key>')
tx=address.setAssetScript(pw.Asset('<asset id>'), script)importpywavesaspwpw.setNode(node='<node>', chain='testnet')
address=pw.Address(privateKey='<private key>')
tx=address.invokeScript('3N5Wq22bLSf3gt5VwHTCRbRnETeSwpuT8kK', 'fundRecipient', [{"type": "integer", "value": 100, }, { "type": "string", "value": "test" }, { "type": "boolean", "value": True }], [ { "amount": 100, "assetId": "BGNVLgPKLwiBiZ7vWLcy3r92MzpPCU2DuUb4tv9W6gMi" } ])importpywavesaspwpw.setNode(node='<node>', 'T')
contract=pw.Contract('3N7XfieeJ8dHyMJfs7amukzxKB1PfMXzHzi', '<seed>')
contract.faucet()Querrying oracles:
importpywavesaspworacle=pw.Oracle(oracleAddress='3P4PCxsJqMzQBALo8zANHtBDZRRquobHQp7')
# getting all data entries for an oracleprint(oracle.getData())
# getting data for a specific key of an oracleprint(oracle.getData('order_total_EeH5DRjdMnoYDhNbtkLsRNZq95etJUqWtvMDBCXojBoy'))
# getting all data entries of an oracle filtered by a regular expressionprint(oracle.getData(regex='^order_total_.*$'))Storing data in an oracle:
importpywavesaspwpw.setNode('https://testnode1.wavesnodes.com', 'T')
oracle=pw.Oracle(seed='<your seed here>')
print(oracle.storeData('oracle_test', 'string', 'test entry from oracle class'))importpywavesaspwconfig=pw.ParallelPyWaves()
config.setNode('https://testnode1.wavesnodes.com', 'testnet')
tAddress=pw.Address(seed="test test test", pywaves=config)
address=pw.Address(seed="test test test")
print(tAddress.address)
print(address.address)
print(tAddress.address)importpywavesaspw# set Matcher node to usepw.setMatcher(node='http://127.0.0.1:6886')
# post a buy orderBTC=pw.Asset('4ZzED8WJXsvuo2MEm2BmZ87Azw8Sx7TVC6ufSUA5LyTV')
USD=pw.Asset('6wuo2hTaDyPQVceETj1fc5p4WoMVCGMYNASN8ym4BGiL')
BTC_USD=pw.AssetPair(BTC, USD)
myOrder=myAddress.buy(assetPair=BTC_USD, amount=15e8, price=95075)
# post a sell orderWCT=pw.Asset('6wuo2hTaDyPQVceETj1fc5p4WoMVCGMYNASN8ym4BGiL')
Incent=pw.Asset('FLbGXzrpqkvucZqsHDcNxePTkh2ChmEi4GdBfDRRJVof')
WCT_Incent=pw.AssetPair(WCT, Incent)
myOrder=myAddress.sell(assetPair=WCT_Incent, amount=100e8, price=25e8)
# post a buy order using Waves as price assetBTC=pw.Asset('4ZzED8WJXsvuo2MEm2BmZ87Azw8Sx7TVC6ufSUA5LyTV')
BTC_WAVES=pw.AssetPair(BTC, pw.WAVES)
myOrder=myAddress.buy(assetPair=BTC_WAVES, amount=1e8, price=50e8)
# cancel an ordermyOrder.cancel()
# ormyAddress.cancelOrder(assetPair, myOrder)importpywavesaspw# set the asset pairWAVES_BTC=pw.AssetPair(pw.WAVES, pw.BTC)
# get last price and volumeprint("%s %s"% (WAVES_BTC.last(), WAVES_BTC.volume()))
# get tickerticker=WAVES_BTC.ticker()
print(ticker['24h_open'])
print(ticker['24h_vwap'])
# get last 10 tradestrades=WAVES_BTC.trades(10)
fortintrades:
print("%s %s %s %s"% (t['buyer'], t['seller'], t['price'], t['amount']))
# get last 10 daily OHLCV candlesohlcv=WAVES_BTC.candles(1440, 10)
fortinohlcv:
print("%s %s %s %s %s"% (t['open'], t['high'], t['low'], t['close'], t['volume']))importpywavesaspw# connect to a local testnet nodepw.setNode(node='http://127.0.0.1:6869', chain='testnet')
myAddress=pw.Address(privateKey='CsBpQpNE3Z1THNMS9vJPaXqYwN9Hgmhd9AsAPrM3tiuJ')
minerAddress=pw.Address('3NBThmVJmcexzJ9itP9KiiC2K6qnGQwpqMq')
# lease 1000 Waves to minerAddressleaseId=myAddress.lease(minerAddress, 100000000000)
# revoke the leasemyAddress.leaseCancel(leaseId)Thanks to the new functionality of the TxSigner and TxGenerator classes, new functionality like multisig is possible:
pw.setNode('https://nodes-testnet.wavesnodes.com', 'T')
firstAddress=address.Address(seed='this is just a simple test seed one')
secondAddress=address.Address(seed='this is just a simple test seed two')
generator=txGenerator.TxGenerator()
signer=txSigner.TxSigner()
tx=generator.generateSendWaves(secondAddress, 1, firstAddress.publicKey, txFee=500000)
signer.signTx(tx, firstAddress.privateKey)
signer.signTx(tx, secondAddress.privateKey)
res=firstAddress.broadcastTx(tx)>>> import pywaves as pw
>>> pw.Address('3P31zvGdh6ai6JK6zZ18TjYzJsa1B83YPoj')
address = 3P31zvGdh6ai6JK6zZ18TjYzJsa1B83YPoj
publicKey = privateKey = seed = balances:
Waves = 1186077288304570
BDMRyZsmDZpgKhdM7fUTknKcUbVVkDpMcqEj31PUzjMy (Tokes) = 43570656915
RRBqh2XxcwAdLYEdSickM589Vb4RCemBCPH5mJaWhU9 (Ripto Bux) = 4938300000000
4rmhfoscYcjz1imNDvtz45doouvrQqDpbX7xdfLB4guF (incentCoffee) = 7
Ftim86CXM6hANxArJXZs2Fq7XLs3nJvgBzzEwQWwQn6N (Waves) = 2117290600000000
E4ip4jzTc4PCvebYn1818T4LNoYBVL3Y4Y4dMPatGwa9 (BitCoin) = 500000000000
FLbGXzrpqkvucZqsHDcNxePTkh2ChmEi4GdBfDRRJVof (Incent) = 12302659925430
GQr2fpkfmWjMaZCbqMxefbiwgvpcNgYdev7xpuX6xqcE (KISS) = 1000
DxG3PLganyNzajHGzvWLjc4P3T2CpkBGxY4J9eJAAUPw (UltraCoin) = 200000000000000
4eWBPyY4XNPsFLoQK3iuVUfamqKLDu5o6zQCYyp9d8Ae (LIKE) = 1000
>>> >>> import pywaves as pw
>>> newAddress = pw.Address('<some address>')
>>> newAddress._generate()
address = 3P6WfA4qYtkgwVAsWiiB6yaea2X8zyXncJh
publicKey = EYNuSmW4Adtcc6AMCZyxkiHMPmF2BZ2XxvjpBip3UFZL
privateKey = CtMQWJZqfc7PRzSWiMKaGmWFm4q2VN5fMcYyKDBPDx6S
seed = seven wrist bargain hope pattern banner plastic maple student chaos grit next space visa answer
balances:
Waves = 0
>>> >>> import pywaves as pw
>>> pw.Asset('DHgwrRvVyqJsepd32YbBqUeDH4GJ1N984X8QoekjgH8J')
status = Issued
assetId = DHgwrRvVyqJsepd32YbBqUeDH4GJ1N984X8QoekjgH8J
issuer = 3PPKF2pH4KMYgsDixjrhnWrPycVHr1Ye37V
name = WavesCommunity
description = Waves community token.
quantity = 1000000000
decimals = 2
reissuable = False
>>> myOrder = myAddress.buy(pw.AssetPair(token1, token2), 1, 25)
>>> myOrder
status = Accepted
id = ARZdYgfXz3ksRMvhnGeLLJnn3CQnz7RCa7U6dVw3zert
asset1 = AFzL992FQbhcgSZGKDKAiRWcjtthM55yVCE99hwbHf88
asset2 = 49Aha2RR2eunR3KZFwedfdi7K9v5MLQbLYcmVdp2QkZT
sender.address = 3P6WfA4qYtkgwVAsWiiB6yaea2X8zyXncJh
sender.publicKey = EYNuSmW4Adtcc6AMCZyxkiHMPmF2BZ2XxvjpBip3UFZL
matcher = http://127.0.0.1:6886
>>> myOrder.cancel()
>>> myOrder
status = Cancelled
id = ARZdYgfXz3ksRMvhnGeLLJnn3CQnz7RCa7U6dVw3zert
asset1 = AFzL992FQbhcgSZGKDKAiRWcjtthM55yVCE99hwbHf88
asset2 = 49Aha2RR2eunR3KZFwedfdi7K9v5MLQbLYcmVdp2QkZT
sender.address = 3P6WfA4qYtkgwVAsWiiB6yaea2X8zyXncJh
sender.publicKey = EYNuSmW4Adtcc6AMCZyxkiHMPmF2BZ2XxvjpBip3UFZL
matcher = http://127.0.0.1:6886
>>> import pywaves as pw
>>> pw.setOffline()
>>> myAddress=pw.Address(privateKey="F2jVbjrKzjUsZ1AQRdnd8MmxFc85NQz5jwvZX4BXswXv")
>>> recipient=pw.Address("3P8Ya6Ary5gzwnzbBXDp3xjeNG97JEiPcdA")
# sign a future tx to transfer 100 WAVES to recipient
# the tx is valid on Jan 1st, 2020 12:00pm
>>> myAddress.sendWaves(recipient, amount=100e8, timestamp=1577880000000)
{'api-endpoint': '/assets/broadcast/transfer',
'api-type': 'POST',
'api-data': '{"fee": 100000,
"timestamp": 1577880000000,
"senderPublicKey": "27zdzBa1q46RCMamZ8gw2xrTGypZnbzXs5J1Y2HbUmEv",
"amount": 10000000000,
"attachment": "",
"recipient": "3P8Ya6Ary5gzwnzbBXDp3xjeNG97JEiPcdA"
"signature": "YetPopTJWC4WBPXbneWv9g6YEp6J9g9rquZWjewjdQnFbmaxtXjrRsUu69NZzHebVzUGLrhQiFFoguXJwdUn8BH"}'}
>>> import pywaves as pw
>>> pw.setOffline()
>>> myAddress=pw.Address(privateKey="F2jVbjrKzjUsZ1AQRdnd8MmxFc85NQz5jwvZX4BXswXv")
# generate a lockbox address
>>> lockAddress=pw.Address('<some address>')
>>> lockAddress._generate()
# sign the 'lock' tx to send 100e8 to the lockbox (valid on Nov 1st, 2017)
>>> myAddress.sendWaves(lockAddress, 100e8, timestamp=1509537600000)
{'api-endpoint': '/assets/broadcast/transfer',
'api-type': 'POST',
'api-data': '{"fee": 100000,
"timestamp": 1509537600000,
"senderPublicKey": "27zdzBa1q46RCMamZ8gw2xrTGypZnbzXs5J1Y2HbUmEv",
"amount": 10000000000,
"attachment": "",
"recipient": "3P3UbyQM9W7WzTgjYkLuBrPZZeWsiUtCcpv",
"signature": "5VgT6qWxJwxEyrxFNfsi67QqbyUiGq9Ka7HVzgovRTTDT8nLRyuQv2wBAJQhRiXDkTTV6zsQmHnBkh8keCaFPoNT"}'}
# sign the 'unlock' tx to send funds back to myAddress (valid on Jan 1st, 2020)
>>> lockAddress.sendWaves(myAddress, 100e8-200000, txFee=200000, timestamp=1577880000000)
{'api-endpoint': '/assets/broadcast/transfer',
'api-type': 'POST',
'api-data': '{"fee": 200000,
"timestamp": 1577880000000,
"senderPublicKey": "52XnBGnAVZmw1CHo9aJPiMsVMiTWeNGSNN9aYJ7cDtx4",
"amount": 9999800000,
"attachment": "",
"recipient": "3P7tfdCaTyYCfg5ojxNahEJDSS4MZ7ybXBY",
"signature": "3beyz1sqKefP96LaXWT3CxdPRW86DAxcj6wgWPyyKq3SgdotVqnKyWXDyeHnBzCq1nC7JA9CChTmo1c1iVAv6C4T"}'}
# delete lockbox address and private key
>>> del lockAddress
PyWaves supports both mainnet and testnet chains. By default, PyWaves connects to the mainnet RPC server at https://nodes.wavesnodes.com. It's possible to specify a different server and chain with the setNode() function
importpywavesaspw# connects to a local testnet nodepw.setNode(node='http://127.0.0.1:6869', chain='testnet')
# connects to a local mainnet nodepw.setNode(node='http://127.0.0.1:6869', chain='mainnet')Code released under the MIT License.