Skip to content

Neotys-Connect/WhiteblockBlockChain

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

whiteblock Logo

BlockChain support for for NeoLoad

Overview

These Advanced Actions allows you to generate Blockchain traffic on a blockchain network handled by Whiteblock with NeoLoad .

This bundle provides custom actions to manage your Whiteblock Network and generate transactions

Whiteblock Management

  • BuildWhiteblockNetwork: This action will create a blockchain network on your Whiteblock Environement. You will specify the number of Nodes, the type of blockchain network to build your environement.

  • ApplyNetworkConstraints: This action configure the network constraints on your blockChain Network. you will be able to apply the following constraints on a specific node number:

    • delay
    • loss
    • bandwidth limitation
  • ActivateNetworkConstraints: This action will enable/disable the network constraints on your whiteblock environment.

  • Miner: This action is enable /disble the mining on your whiteblock environment.

  • GetAccountList: This action will list the accounts available in the network. This action is required to generate the dataset for your load test. Each Virtual user will need it's own account ( account address, private key, public key) This Action will also be required to select randomly an available account to send a blockChain transaction

  • GetNodesList: This action will list the number of nodes available in the whiteblock environement. This action is required to generate a dataset for you test. Each Virtual user will have to select a node to generate RPC calls.

  • GetContractList: This action will list the number of contracts deployed on your whiteblock environement. This action is required to generate the dataset for you test. THis action is required for all test generating transaction with a smart contract ( Send ContractTransction, TransfertERC20Token, SafeTransfertERC721Token)

  • GetMonitoringData: This action will is reporting the monitoring information available in Whiteblock in your NeoLoad Web Dashboard. THis action will need to be used with one Virtual User iterating on the action during the duration of you test.

Actions Generation RPC calls on your blockChain network

  • GetBalance: This action will get the balance of a specific account. It's generate a RPC call "GetBalance" on you BlockChain Network.

  • SendTransaction: This action is send a RAW transaction on your blockChain Network.

  • SendSignedTransaction: This action is send a signed Ether transaction on your blockChain Network.

  • SendFunds: This action is sending Wei from one account to another.

  • SendContractTransaction: This action is sending Wei to a smart contract.

  • TransfertERC20Token: This action is sending a ERC20 Token to an account through a ERC20 contract.

  • SafeTransfertERC721Token: This action is sending a ERC721 Token to an account through a ERC721 contract.

Installation

  1. Download the latest release for NeoLoad from version 6.7 or this release for previous NeoLoad versions.
  2. Read the NeoLoad documentation to see How to install a custom Advanced Action.

Whiteblock BlockChain Advanced Actions

NeoLoad Template Project

  1. Download the entire folder [NeoLoad Template Project](https://github.com/Neotyslab/WhiteblockBlockChain/NeoLoad Template Project) This project will have 2 preconfigured UserPath :
  • Management : User that creates the Network and generate the dataset for your test
  • Monitoring : The monitoring userpath will be required to report blockchain metrics in NeoLoad WEB.
  • Transaction : The transaction userpath is an example on how to the required dataset for your test and send transactions on your blockchain Network.

Parameters for BuildWhiteblockNetwork

Name Description
WhiteBlocMasterHost Ip or Hostname of your Whiteblock master Host
TypeofBlochacin Type of blockchain network : Ethereum, Syscoin, Rchain, EOS, Monero, NEM, Fabric, Quorum, or Custom
NumberOfNodes number of nodes to create on the blockchain network
TraceMode optionnal value to enable logs ( debug mode of the custom action)

Parameters for ApplyNetworkConstraints

Name Description
WhiteBlocMasterHost Ip or Hostname of your Whiteblock master Host
NodeNumber Node numbner to apply the network constraints( 0-n)
TypeOfConstraint Type of network constraints to apply on the node .Value Possible :
  • delay
  • loss
  • bandwidth
ConstraintsValue Value of the network Constraint
ConstraintsValue (optionnal) unit of the bandwidth limitation , default value :mbps. Value Possible :
  • kbps
  • mbps
  • gbps
TraceMode (optionnal)value to enable logs ( debug mode of the custom action)

Parameters for ActivateNetworkConstraints

Name Description
WhiteBlocMasterHost Ip or Hostname of your Whiteblock master Host
NetworkMode Enable or disable the network emulation. Value possible :
  • ON : to enable
  • OFF : to disable
TraceMode (optionnal)value to enable logs ( debug mode of the custom action)

Parameters for GetAccountList,GetNodeList, GetMonitoring and GetContractList

Name Description
WhiteBlocMasterHost Ip or Hostname of your Whiteblock master Host
TraceMode (optionnal)value to enable logs ( debug mode of the custom action)

Parameters for Miner

Name Description
WhiteBlocMasterHost Ip or Hostname of your Whiteblock master Host
MinerMode Enable or disable the mining. Value possible :
  • ON : to enable
  • OFF : to disable
TraceMode (optionnal)value to enable logs ( debug mode of the custom action)

Parameters for GetBalance

Name Description
ipOfTheWhiteblockNode private ip of the node used to send the RPC call
from account adress to send to use to send the traction from
privatekey private key of the account
publickey public key of the account
TraceMode (optionnal)value to enable logs ( debug mode of the custom action)

Parameters for GetTransactionByHash

Name Description
ipOfTheWhiteblockNode private ip of the node used to send the RPC call
transactionHash Transaction Hash to retrieve
TraceMode (optionnal)value to enable logs ( debug mode of the custom action)

Parameters for SendTransaction

Name Description
ipOfTheWhiteblockNode private ip of the node used to send the RPC call
from account adress to send to use to send the traction from
to account adress to send the transaction to
amount value to send
TraceMode (optionnal)value to enable logs ( debug mode of the custom action)

Parameters for SendSignedTransaction and SendFunds

Name Description
ipOfTheWhiteblockNode private ip of the node used to send the RPC call
from account adress to send to use to send the traction from
privatekey private key of the account used to send the transaction
publickey public key of the account used to send the transaction
to account adress to send the transaction to
amount value to send
TraceMode (optionnal)value to enable logs ( debug mode of the custom action)

Parameters for SendContractTransaction

Name Description
ipOfTheWhiteblockNode private ip of the node used to send the RPC call
from account adress to send to use to send the traction from
contractadress adress of the smart contract
amount value to send
TraceMode (optionnal)value to enable logs ( debug mode of the custom action)

Parameters for TransferERC20Token

Name Description
ipOfTheWhiteblockNode private ip of the node used to send the RPC call
from account adress to send to use to send the traction from
to account adress to send the transaction to
contractadress adress of the smart contract
amount value to send
TraceMode (optionnal)value to enable logs ( debug mode of the custom action)

Parameters for SafeTransfertERC721Token

Name Description
ipOfTheWhiteblockNode private ip of the node used to send the RPC call
from account adress to send to use to send the traction from
to account adress to send the transaction to
contractadress adress of the smart contract
tokenid id of the ERC721 token
amount value to send
TraceMode (optionnal)value to enable logs ( debug mode of the custom action)

Status Codes

  • BuildWhiteblockNetwork actions :
    • NL-WB_BUILD_ACTION-01: Invalid parameter
    • NL-WB_BUILD_ACTION-02: Technical Error
    • NL-WB_BUILD_ACTION-03 : Bad Context
  • ApplyNetworkConstraintsAction actions :
    • NL-WB_NETWORKCONSTRAINT_ACTION-01: Invalid parameter
    • NL-WB_NETWORKCONSTRAINT_ACTION-02: Technical Error
    • NL-WB_NETWORKCONSTRAINT_ACTION-03 : Bad Context
  • ActivateNetworkConstraints actions :
    • NL-WB_NETWORKACTIVATION_ACTION-01: Invalid parameter
    • NL-WB_NETWORKACTIVATION_ACTION-02: Technical Error
    • NL-WB_NETWORKACTIVATION_ACTION-03 : Bad Context
  • Miner actions :
    • NL-WB_MINER_ACTION-01: Invalid parameter
    • NL-WB_MINER_ACTION-02: Technical Error
    • NL-WB_MINER_ACTION-03 : Bad Context
  • GetAccountList actions :
    • NL-WB_ACCOUNT_ACTION-01: Invalid parameter
    • NL-WB_ACCOUNT_ACTION-02: Technical Error
    • NL-WB_ACCOUNT_ACTION-03 : Bad Context
  • GetContractsList actions :
    • NL-WB_CONTRACTS_ACTION-01: Invalid parameter
    • NL-WB_CONTRACTS_ACTION-02: Technical Error
    • NL-WB_CONTRACTS_ACTION-03 : Bad Context
  • GetNodeList actions :
    • NL-WB_NODE_ACTION-01: Invalid parameter
    • NL-WB_NODE_ACTION-02: Technical Error
    • NL-WB_NODE_ACTION-03 : Bad Context
  • GetMonitoringData actions :
    • NL-WB_MONITORING_ACTION-01: Invalid parameter
    • NL-WB_MONITORING_ACTION-02: Technical Error
    • NL-WB_MONITORING_ACTION-03 : Bad Context
  • GetBalance actions :
    • NL-WB_GETBALANCEACTION_ACTION-01: Invalid parameter
    • NL-WB_GETBALANCEACTION_ACTION-02: Technical Error
    • NL-WB_GETBALANCEACTION_ACTION-03 : Bad Context
  • GetTransactionByHash actions :
    • NL-WB_GETTRANSACTIONBYHASH_ACTION-01: Invalid parameter
    • NL-WB_GETTRANSACTIONBYHASH_ACTION-02: Technical Error
    • NL-WB_GETTRANSACTIONBYHASH_ACTION-03 : Bad Context
  • SafeTransfertERC721Token actions :
    • NL-WB_ERC721TOKEN_ACTION-01: Invalid parameter
    • NL-WB_ERC721TOKEN_ACTION-02: Technical Error
    • NL-WB_ERC721TOKEN_ACTION-03 : Bad Context
  • SendContractTransaction actions :
    • NL-WB_CONTRACTTRANSACTION_ACTION-01: Invalid parameter
    • NL-WB_CONTRACTTRANSACTION_ACTION-02: Technical Error
    • NL-WB_CONTRACTTRANSACTION_ACTION-03 : Bad Context
  • SendFunds actions :
    • NL-WB_SENDFUNDS_ACTION-01: Invalid parameter
    • NL-WB_SENDFUNDS_ACTION-02: Technical Error
    • NL-WB_SENDFUNDS_ACTION-03 : Bad Context
  • SendSignedTransaction actions :
    • NL-WB_SIGNEDTRANSACTION_ACTION-01: Invalid parameter
    • NL-WB_SIGNEDTRANSACTION_ACTION-02: Technical Error
    • NL-WB_SIGNEDTRANSACTION_ACTION-03 : Bad Context
  • SendTransaction actions :
    • NL-WB_TRANSACTION_ACTION-01: Invalid parameter
    • NL-WB_TRANSACTION_ACTION-02: Technical Error
    • NL-WB_TRANSACTION_ACTION-03 : Bad Context
  • TransferERC20Token actions :
    • NL-WB_ERC20TOKEN_ACTION-01: Invalid parameter
    • NL-WB_ERC20TOKEN_ACTION-02: Technical Error
    • NL-WB_ERC20TOKEN_ACTION-03 : Bad Context
Property Value
Maturity Experimental
Author Neotys Partner Team
License BSD Simplified
NeoLoad 6.7+ (Enterprise or Professional Edition w/ Integration & Advanced Usage and NeoLoad Web option required)
Requirements NeoLoad Web, Whiteblock Account
Bundled in NeoLoad No
Download Binaries
  • latest release is only compatible with NeoLoad from version 6.7
  • Use this release for previous NeoLoad versions

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published