devd

README

devd

Install

go install -v github.com/bcdevtools/devd/v2/cmd/devd@latest

Query tools

Lazy RPC setting

export DEVD_EVM_RPC='https://evm.example.com:8545'

By setting this environment variable, you don't need to pass --rpc flag everytime for non-localhost EVM Json-RPC

---

Lazy TM-RPC setting

export DEVD_TM_RPC='https://rpc.example.com:26657'

By setting this environment variable, you don't need to pass --tm-rpc flag everytime for non-localhost Tendermint RPC

---

Lazy Rest API setting

export DEVD_COSMOS_REST='https://ethermint-rest.example.com:1317'

By setting this environment variable, you don't need to pass --rest flag everytime for non-localhost Rest API

---

Some queries will try to decode some fields in response data into human-readable format and inject back into the response data with _ prefix like EVM tx, receipt, block, trace.

Query account balance

devd query balance [account addr] [optional ERC20 addr..] [--erc20] [--rpc http://localhost:8545]
# devd q b 0xAccount
# devd q b ethm1account
# devd q b 0xAccount 0xErc20Contract
# devd q b ethm1account 0xErc20Contract1 0xErc20Contract2
# devd q b 0xAccount --erc20 [--rest http://localhost:1317]

--erc20 flag, if provided, will attempt to fetch user balance of contracts on x/erc20 module and virtual frontier bank contracts. This request additional Rest-API endpoint provided, or use default 1317.

Query block/tx events

devd query events [height/tx hash] [--filter one] [--filter of_] [--filter these] [--tm-rpc http://localhost:26657]
# devd q events COS...MOS -f sig -f seq_
# devd q events 0x...evm -f txHash
# devd q events 10000

--filter flags, if provided, will accept events those contain at least one provided criteria

Query ERC20 token information

devd query erc20 [ERC20 addr] [optional account] [--rpc http://localhost:8545]
# devd q erc20 0xErc20Contract
# devd q erc20 0xErc20Contract 0xAccount
# devd q erc20 0xErc20Contract ethm1account

Get EVM transaction information

devd query eth_getTransactionByHash [0xHash] [--rpc http://localhost:8545]
# devd q tx 0xHash

Get EVM transaction receipt

devd query eth_getTransactionReceipt [0xHash] [--rpc http://localhost:8545]
# devd q receipt 0xHash

Get EVM block by number

devd query eth_getBlockByNumber [hex or dec block no] [--full] [--rpc http://localhost:8545]
# devd q block 0xF
# devd q block 16 --full

Trace EVM transaction

devd query debug_traceTransaction [0xHash] [--tracer callTracer] [--rpc http://localhost:8545]
# devd q trace 0xHash
# devd q trace 0xHash --tracer callTracer

Tx tools

Send EVM transaction

# Transfer native coin
devd tx send [to] [amount]
# Transfer ERC-20 token
devd tx send [to] [amount] [--erc20 contract_address]

Support custom integer like 1e18, 2k, 3m, 4b, 5kb,...: devd tx send [to] [1e18/1bb]

Deploy EVM contract

# Deploy contract with deployment bytecode
devd tx deploy-contract [deployment bytecode] [--gas 4m] [--gas-prices 20b]
# Deploy ERC-20 contract with pre-defined bytecode
devd tx deploy-contract erc20

Convert tools

Convert address between different formats

devd convert address [address] [optional bech32 hrp]
# devd c a 0xAccount ethm
# devd c a ethm1account
# devd c a ethm1account xyz

WARN: DO NOT use this command to convert address across chains with different HD-Path! (eg: Ethermint 60 and Cosmos 118)

Encode string into ABI or decode ABI into string

Support pipe

devd convert abi_string [string or ABI encoded string]
# devd c abi_string 000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000045553444300000000000000000000000000000000000000000000000000000000
# devd c abi_string USDC Token
# echo 'USDC Token' | devd c abi_string

Convert hexadecimal to decimal and vice versa

Support pipe

devd convert hex_2_dec [hexadecimal]
# devd c h2d 0x16a
# devd c h2d 16a
# echo 16a | devd c h2d
devd convert dec_2_hex [decimal]
# devd c d2h 170
# echo 170 | devd c d2h
# Support custom integer like 1e18, 2k, 3m, 4b, 5kb,...:
#   devd c d2h 20bb

Convert Solidity event/method signature into hashed signature

devd convert solc_sig [event/method signature]
# devd c solc_sig 'transfer(address,uint256)'
# devd c solc_sig 'function transfer(address recipient, uint256 amount) external returns (bool);'
# devd c solc_sig 'event Transfer(address indexed from, address indexed to, uint256 value);'

Convert input into upper/lower case

Support pipe

devd convert to_lower_case [input]
# devd c lowercase AA
# echo AA | devd c lowercase
devd convert to_upper_case [input]
# devd c uppercase aa
# echo aa | devd c uppercase

Encode/Decode base64

Support pipe

devd convert encode_base64 [input]
# devd c base64 123
# echo 123 | devd c base64
devd convert decode_base64 [base64]
# devd c decode_base64 TVRJeg==
# echo TVRJeg== | devd c decode_base64

Convert raw balance into display balance and vice versa

devd convert display_balance [raw balance] [exponent]
# devd c dbal 10011100 6
# > 10.0111
# Support custom integer like 1e18, 2k, 3m, 4b, 5kb,...:
#  devd c dbal 20bb 18
#  > 20.0

devd convert raw_balance [display balance] [exponent] [--decimals-point , or .]
# devd c rbal 10.0111 6
# > 10011100
# devd c rbal 10,0111 6 -d ,
# > 10011100

Convert (decode) raw RLP-encoded EVM tx into tx object

devd convert decode_raw_tx [raw RLP-encoded EVM tx hex]
# view inner tx information, including sender address

Hashing tools

Support pipe

devd hash md5 [input]
# devd hash md5 123
# cat file.txt | devd hash md5
devd hash keccak256 [input]
# devd hash keccak256 123
# cat file.txt | devd hash keccak256
devd hash keccak512 [input]
# devd hash keccak512 123
# cat file.txt | devd hash keccak512

Check tools

Listing ports in use and check port holding by process

# listing
devd check port

# check specific port
devd check port [port]

Debug tools

Compute EVM transaction intrinsic gas

devd debug intrinsic_gas [0xCallData]
# devd d intrinsic_gas 0xCallData

Assumption: no access list, not contract creation, Homestead, EIP-2028 (Istanbul). If contract creation, plus 32,000 into the output.

Notes:

• Output messages are printed via stdout, while messages with prefixes INF: WARN: and ERR: are printed via stderr. So for integration with other tools, to omit stderr, forward stdout only.

  Eg: devd c a cosmos1... 1> /tmp/output.txt

• When passing arguments into command via both argument and pipe, the argument will be used.

  Eg: echo 123 | devd c d2h 456 will convert 456 to hexadecimal, not 123.

• For commands those marked support custom integer, you can pass number with format like 1e18, 1k (thousand), 2m (million), 3b (billion), 4kb (trillion), 5mb (million billion), 6bb,... Decimal point also supported for k, m, b suffixes like 1.5k, 2.5m, 3.5bb,...