Skip to main content
Version: 4.0

OpenBrush

OpenBrush is a library for smart contract development on ink! maintained by the Brushfam team.

It provides standard contracts based on Polkadot Standard Proposals (PSPs), as well as higher-level contracts and Rust macros that generate ink! code.

Using OpenBrush is simple, you only add the dependency to your Cargo.toml file. You can find an example here.

Which standards and contract components does it contain?​

  • PSP22: Fungible Token (ERC20 equivalent) with extensions.
  • PSP34: Non-Fungible Token (ERC721 equivalent) with extensions.
  • PSP37: ERC1155 equivalent with extensions.
  • Ownable Restrict access to action for non-owners.
  • Access Control: Define a set of roles and restrict access to an action by roles.
  • Reentrancy Guard: Prevent reentrant calls to a function.
  • Pausable: Pause/Unpause the contract to disable/enable some operations.
  • Timelock Controller: Execute transactions with some delay.
  • Payment Splitter: Split the amount of native tokens between participants.

Generic Trait Implementation​

OpenBrush adds support for generic Trait implementations, so that you can split a Trait and its implementation into different files. This can increase the readability and maintainability of your smart-contract code base (detailed description).

Wrapper around Traits​

OpenBrush simplifies cross-contract calls, a contract that implements a particular Trait is not needed to call it. A wrapper enables calling methods of that Trait from some contract in the network (do a cross contract call).

Documentation​

Typechain-Polkadot​

Another tool helpful for ink! smart contracts development is Typechain-Polkadot.

Typechain-Polkadot is used to generate Typescript wrappers around your smart contract. This can be used for UI development or in integration tests of your ink! smart contracts. The library uses polkadot-js/api under the hood, but is especially useful because all calls and queries are typed, therefore the chance of getting some error during a call is mitigated.

Sol2Ink​

Sol2Ink is a tool which can support migrations from Solidity to ink!. Solidity code is passed to Sol2Ink and converted to an ink! contract. The tool can also be used to learn the differences between Solidity and ink! code.

Questions?​

If you have any questions about how to use any of these tools, or just about the ink! smart contracts in general, you can join the Brushfam element channel or ask a question on the Substrate Stack Exchange.