@1inch/solidity-utils

Utils library for contracts and tests

About

This repository contains frequently used smart contracts, libraries and interfaces. Also it contains utils which are used in tests.

Solidity

directory	.sol	description
contracts	EthReceiver
contracts	Permitable
contracts	GasChecker
contracts/interfaces	IDaiLikePermit	Interface of token which has permit method like DAI token
contracts/interfaces	IWETH	WETH token interface
contracts/libraries	AddressArray	library for work with array of addresses
contracts/libraries	AddressSet	library for work with set of addresses
contracts/libraries	RevertReasonParser	library parse the message from reverted method to readble format
contracts/libraries	StringUtil	optimized methods to convert data to hex
contracts/libraries	UniERC20

JS

module	function	descrption
asserts	assertThrowsAsync(action, msg)	checks the async function action() thrown with message msg
asserts	assertRoughlyEqualValues(expected, actual, relativeDiff)	checks the expected value is equal to actual value with relativeDiff precision
utils	timeIncreaseTo(seconds)	increases blockchain time to seconds sec
utils	trackReceivedToken(token, wallet, txPromise, ...args)	returns amount of token which recieved the wallet in async method txPromise with arguments args
utils	trackReceivedTokenAndTx(token, wallet, txPromise, ...args)	returns transaction info and amount of token which recieved the wallet in async method txPromise with arguments args
utils	fixSignature(signature)	patchs ganache's signature to geth's version
utils	signMessage(signer, messageHex)	signs messageHex with signer and patchs ganache's signature to geth's version
utils	countInstructions(txHash, instruction)	counts amount of instruction in transaction with txHash hash
profileEVM	profileEVM(txHash, instruction, optionalTraceFile)	the same as the countInstructions() with option of writing all trace to optionalTraceFile
profileEVM	gasspectEVM(txHash, options, optionalTraceFile)	returns all used operations in txHash transaction with options and their costs with option of writing all trace to optionalTraceFile

UTILS

Docify

Generates documentation in markdown format from natspec docs

Usage

Add to package.json file solidity compiler version and shortcut to run command

devDependencies section

"solc": "0.8.12",

scripts section

"docify": "npx solidity-utils-docify"

...