Package: libra-client-grpc
LibraClient is a collection of tools which allows you interact whithLibra Networkeasily. It provides three ways to access Libra:libra_shell, an interactive shell program. It is compatible with official Libra client. For beginners, it lets you get started directly to try your first transaction with libra without requiring time-consuming downloads and compiles the huge entire Libra project source code.libra, a command line tool. It has a modern colorful text interface and its output is the standard json format. So, it can be integrated to any programming language easily.python api, a collection of apis for client access to libra. For Python programmers, you can call this client side api to interact with Libra Network with more control than by usinglibracommand.In following docuement, all command prefix with$meants it is typed and run in standard linux shell; all command prefix withlibra%meants it is typed and run inlibra_shell.For exmaple,$ librameants runlibracommand in linux shell, which is different thanlibra%.InstallationRequire python 3.7 or above installed.$python3-mpipinstalllibra-client-grpcIf you had a problem during installation, following command should works anyway.$python3-mpipinstall--index-urlhttps://pypi.org/project/--userlibra-client-grpcUsage of 'libra_shell'To start 'libra_shell' and connect to a validator node running on the Libra testnet, just input the 'libra_shell' command on termial as shown below.$libra_shellOnce the client connects to a node on the testnet, you will see the following output.  To quit the client at any time, use thequitcommand.This document will guide you through executing your first transaction on the Libra Blockchain. We will walk you through creating accounts for two users.Usage of 'libra' commandThe command 'libra' contains four subcommands 'account', 'transaction', 'wallet' and 'ledger'. All subcommands have their own parameters.Leger Time ExampleFor example, using 'ledger' command to query the ledger start time and latest transaction time of testnet:$libraledgertimeYou will get the json output like this:{"start_time":"2019-10-03T05:19:59","latest_time":"2019-10-16T17:04:17"}Account Balance ExampleTo query the balance of some account by address,$libraaccountbalance000000000000000000000000000000000000000000000000000000000a550c18You will get the balance of that address:{"balance":24075309756646968}Wallet ExampleTo query the total balance of a wallet,$librawalletbalance<somemnemonicfileofthewallet>You will get the total balance and balance of every accounts in that wallet:{"7af57a0c206fbcc846532f75f373b5d1db9333308dbc4673c5befbca5db60e2f":123,"f1f48f56c4deea75f4393e832edef247547eb76e1cd498c27cc972073ec4dbde":0,"total_balance":123}Help message oflibraIf you inputlibrawithout any parameters as following,$libraYou will get the help message:USAGE:
	libra [options] command [command parameters ...]

Optional arguments:

 -a | --host HOST  Host address/name to connect to. [default:testnet]
 -p | --port PORT  Admission Control port to connect to. [default: 8000]
 -v | --verbose Verbose output
 -V | --version Show program's version number and exit
 -h | --help Show this help message and exit

Use the following commands:

account | a
	Account query by address
transaction | t
	Transaction query
wallet | w
	show account information of a wallet derived from mnemonic file
ledger | lg
	show ledger info of Libra blockchainHelp message of subcommandIf you input the libra subcommand without any parameter, you will get the help message of that subcommand. For example:$librawalletYou will get the help message:USAGE:
        wallet <arg>

Use one of the following args for this command:

show | s <mnemonic_file_path>
        Show the mnemonic words, seed and addresses of a wallet
account | a <mnemonic_file_path>
        Show the keypair and address of accounts in a wallet
balance | b <mnemonic_file_path>
        Get the balance of all accounts in a wallet
create | c <mnemonic_file_path>
        create a new wallet and save the mnemonic file to <mnemonic_file_path>More instructions can be found herelibra command help.Client side Libra API for python programmerWalletYou can create a wallet usingWalletLibraryclass. A wallet is like your masterkey and you can create almost infinitely many Libra accounts from it. Note that LibraClient's mnemonic scheme is compatible with that ofLibra's CLI, so you can import mnemonic between the two libraries.fromlibra_clientimportWalletLibrary# Create a new random walletwallet=WalletLibrary.new()# Create a new wallet from mnemonic wordswallet=WalletLibrary.new_from_mnemonic(mnemonic,child_count)# Recover wallet from a offical Libra CLI backup filewallet=WalletLibrary.recover(filename)AccountAnAccountcan be created by callingnew_accountfunction on a wallet, each Account has an integer index in wallet, start from zero. AnAccountcontains itsaddress,public_key, andprivate_key.print(wallet.child_count)account1=wallet.new_account()print(wallet.child_count)print(account1.address)print(account1.public_key)print(account1.private_key)ClientAClientmust be created in order to send protobuf message to a Libra node. You can create a client with the following code.fromlibra_clientimportClientclient1=Client("testnet")# Default client connecting to the official testnetclient2=Client.new('localhost',8000,"validator_file_path")# Client connecting to a local nodeGet Account Data of an Address# An account stores its data in a directory structure, for example:
#   <Alice>/balance:   10
#   <Alice>/a/b/mymap: {"Bob" => "abcd", "Carol" => "efgh"}
#   <Alice>/a/myint:   20
#   <Alice>/c/mylist:  [3, 5, 7, 9]
#
# If someone needs to query the map above and find out what value associated with "Bob" is,
# `address` will be set to Alice and `path` will be set to "/a/b/mymap/Bob".
#
# On the other hand, if you want to query only <Alice>/a/*, `address` will be set to Alice and
# `path` will be set to "/a" and use the `get_prefix()` method from statedbGet Account State Blob of an AddressYou can query an account's raw blob by usingget_account_blobfunction onClient. The function returns a tuple of account state blob and latest ledger version. The blob is a binary LCS serialize format of account data. If an account has not been created yet (never received any funds), the blob will be empty.client=Client("testnet")blob,version=client.get_account_blob(address)Get Account State of an AddressIf the Account has been created, you can callget_account_statefunction which return aAccountStateobject with 'ordered_map' field; other wise, AccountError will be thrown.client=Client("testnet")amap=client.get_account_state(address)Get Account Resource of an AddressIf you want to get account balance / sequence / authentication_key etc from account state, you can callingget_account_resourcefunction, which will deserialize the account resource from account state map.client=Client("testnet")resource=client.get_account_resource(address)print(resource.sequence_number)print(resource.balance)print(resource.authentication_key)Get Balance of an AddressIf you just want to get the balance of an address, simply callget_balancefunction.client=Client("testnet")balance=client.get_balance(address)Get Sequence Number of an AddressIf you just want to get the sequence number of an address, simply callget_sequence_numberfunction.client=Client("testnet")balance=client.get_sequence_number(address)Mint Testnet Libra TokenYou can mint testnet libra withmint_with_faucetfunction, which sends a HTTP POST request tohttp://faucet.testnet.libra.org.c=Client("testnet")c.mint_coins_with_faucet_service(address,12345,is_blocking=True)Creating a Transfer Transaction Script and Sending the TransactionNote that in the official testnet, the Libra node ONLY allows sendingthe official transfer transaction script. In the future, this libra can be extended to support more transaction scripts as well!wallet=WalletLibrary.recover('test.wallet')a0=wallet.accounts[0]a1=wallet.accounts[1]ret=c.transfer_coin(a0,a1.address,1234,is_blocking=True)print(ret.ac_status.code)When is_blocking param is False, the call will return as the transaction is submit to the validator node. When is_blocking param is True, the call will not return until the tranfer is actually executed or transaction waiting timeout.Query TransactionsGet transaction by version:c=Client("testnet")signed_txn=c.get_transaction(1)print(signed_txn.raw_txn)above code get transaction no.1, the return type is a SignedTransaction.classSignedTransaction(Struct):_fields=[('raw_txn',RawTransaction),('public_key',[Uint8,ED25519_PUBLIC_KEY_LENGTH]),('signature',[Uint8,ED25519_SIGNATURE_LENGTH])]To get a list of transactions:c=Client("testnet")c.get_transactions(start_version,limit)Query EventsTo get the latest 2 events send by an address:c=Client("testnet")events=c.get_latest_events_sent(address,2)To get the latest 2 events received by an address:c=Client("testnet")events=c.get_latest_events_received(address,2)Query events sent from an address, start from start_sequence_number(count begin with 0), get limit number of events, direction is ascending/descending:get_events_sent(self,address,start_sequence_number,ascending=True,limit=1)Query events received from an address, start from start_sequence_number(count begin with 0), get limit number of events, direction is ascending/descending:get_events_received(self,address,start_sequence_number,ascending=True,limit=1)