@wandevs/bytecode-verifier
v0.4.3
Published
The purpose of this tool is to verify that the Contract Source on wanchain matches the bytecode that's actually on the blockchain. If the code does not match the blockchain, the tool will display a warning message.
Downloads
11
Readme
Bytecode Verifier
Bytecode Verifier is a handy commandline tool for verifying locally compiled bytecode of a target Solidity contract against its actual bytecode stored in Wanchain Blockchain provided its contract address. This tool:
- integrity/correctness of bytecode: what's actually being stored on chain is correctly compiled from particular contract, which might be helpful in case of non-trivial potential high-value holder contract deployment(e.g. MultiSig Wallet), especially the contract is deployed through a third party platform.
- Minimimal effort, simple to use: solidity compiler envolves overtime with minor and some major changes, which complicates the verification of bytecode. (as recurring "bytecode doesn't match" questions being asked on Wanchain Stack Exchange). Bytecode Verifier has been tested against latest version all the way back to some of the oldest deployed contracts.
- Testnet friendly: most projects launch on testnet before deploying the contract system to mainnet, this tool supports Rinkeby, Kovan and Ropsten Testnet, which constitute three active, well-maintained testnets that most ethereum developers use.
Installation
Prefer global install:
npm install @wandevs/bytecode-verifier -g
If successfully installed, try the -h
or --help
to read a brief info about this tool.
wanv --help
Quick Usage
wanv verify <chainChoice>
! Currently this tool can verify contracts on: mainnet, kovan, ropsten and rinkeby (NOTE: for contracts on Rinkeby, only compiler version no earlier than 0.4.9)!
Save the contract code into a file with name
*YourContractName*.sol
. If your contract imports other contract in a separate file or it consists of multiple contracts, please do name the file as the main contract since that's what's the bytecode we tend to verify.(e.g.contract StandardToken is Token {}
, thenStandardToken.sol
should be the file name.)The
wanv
verifier will prompt 4 questions. Among which, be careful about the format of compiler version specification. If you are not sure, try runwanv compiler
first, and copy the legitimate version string from the output.If bytecode of your local file checks out with what's actually on the blockchain address, then terminal will return positive feedback, otherwise red bold alert feedback will be returned.
Example1: Golem_MultiSigWallet (mainnet)
Example2: Oraclize (kovan)
For more example: please go to example subfolder
wanv --list
To quickly get a list of formal major release version of solidity compiler.
wanv compiler
To look up for an intermediate "nightly" version of solidity compiler
Contributing
This bytecode verifier is entirely open sourced, anyone in the community is free to use in any purpose. (see MIT License for details) More importantly, any issues or pull request are more than welcomed. According npm package
can be found here.
Acknowledgement
Big thanks and great gratitude to ConsenSys Diligence for making this project possible.