Warning: this library is in a pre-release state; contracts are not sufficiently tested for production use, documentation may be missing or inaccurate, and the API may change at any time.
SolidState is an upgradeable-first Solidity smart contract development library.
It consists of the following packages:
package | description | 📕 |
---|---|---|
@solidstate/abi |
contract ABIs | 📖 |
@solidstate/contracts |
core contracts | 📖 |
@solidstate/library |
functions for interacting with and validating contracts | 📖 |
@solidstate/spec |
portable tests which may be run against third-party implementations of core contracts | 📖 |
All contracts are designed to either be deployed through the standard constructor
method, or referenced by a proxy. To this end, the diamond storage pattern is employed exclusively.
Where possible, automated tests are designed to be imported by repositories which make use of the SolidState contracts and run against any derived contracts. This is to help prevent unintended changes to to the base contract behavior.
For example, consider a custom ERC20Base
implementation:
import '@solidstate/contracts/token/ERC20/ERC20Base.sol';
contract CustomToken is ERC20Base {
// custom code...
}
Rather than rewrite the ERC20Base
tests or assume that all core behavior remains untouched, one can import the included tests and run them against the custom implementation:
describe('CustomToken', function () {
let instance;
beforeEach(async function () {
const factory = await ethers.getContractFactory('CustomToken');
instance = await factory.deploy();
await instance.deployed();
});
describeBehaviorOfERC20Base(
{
deploy: () => instance,
},
[],
);
// custom tests...
});
If parts of the base implementation are changed intentionally, tests can be selectively skipped:
describeBehaviorOfERC20Base(
{
deploy: () => instance,
},
['#balanceOf'],
);
describe('#balanceOf', function () {
// custom tests
});
Install dependencies via Yarn:
yarn install
Link local packages and install remaining dependencies via Lerna:
yarn run lerna bootstrap
Compile contracts via Hardhat:
yarn run hardhat compile
By default, Hardhat uses the Hardhat Network in-process.
To use an external network via URL, set the URL
environment variable and append commands with --network generic
:
URL="[NODE_URL]" yarn run hardhat test --network generic
Publish packages via Lerna:
yarn lerna-publish
Test contracts via Hardhat:
yarn run hardhat test
Activate gas usage reporting by setting the REPORT_GAS
environment variable to "true"
:
REPORT_GAS=true yarn run hardhat test
Generate a code coverage report using solidity-coverage
:
yarn run hardhat coverage