Skip to content

o1-labs/eslint-plugin-o1js

Repository files navigation

eslint-plugin-o1js

o1js rules for ESLint to detect bugs and invalid patterns in your Smart Contract code.

Rules

  • The maximum allowed state variables in a Smart Contract is 8
  • Throw statements should not be used in a Circuit method
  • If statements should not be used in a Circuit method
  • Ternary statements should not be used in a Circuit method
  • JavaScript JSON functions should not be used in a Circuit method
  • JavaScript random functions should not be used in a Circuit method
  • Overriding the constructor in a SmartContract is disallowed

Installation

# npm
npm install eslint-plugin-o1js --save-dev

# yarn
yarn add eslint-plugin-o1js --dev

Add eslint-plugin-o1js to the plugins option in your eslint config:

{
  "plugins": ["o1js"]
}
  • Then extend the recommended eslint config:
{
  extends: ['plugin:o1js/recommended'],
}
  • You can enable specific rules manually:
{
  "rules": {
    "o1js/no-greater-storage-limit-in-circuit": "error",
    "o1js/no-throw-in-circuit": "error"
    ...
  }
}
  • An example ESLint configuration looks like:
module.exports = {
  parser: '@typescript-eslint/parser',
  plugins: ['o1js'],
  extends: ['plugin:o1js/recommended'],
};

Valid and Invalid Examples

Please refer to the project tests to learn more about the usage of the rules.