NEO•ONE was designed to get your dapp up and running quickly.
This page describes how to setup NEO•ONE using
If you’re just getting started, try out one of the following toolchains for setting up your project:
Once you have a project setup, the next step is to add NEO•ONE to it. NEO•ONE is organized into multiple individual packages. Use as much or as little as you like. Each package may be installed using either yarn (
yarn add <package name>) or npm (
npm install <package name>). Each package has the form
@neo-one/<name>, for example,
Not sure which packages to use from NEO•ONE? Go ahead and install everything using
yarn add @neo-one/suite
If you are already comfortable with neo-one packages, install everything individually with yarn by running:
yarn add @neo-one/client @neo-one/cli @neo-one/smart-contract @neo-one/smart-contract-test @neo-one/smart-contract-lib @neo-one/smart-contract-typescript-plugin
Install everything individually with npm by running:
npm install @neo-one/client @neo-one/cli @neo-one/smart-contract @neo-one/smart-contract-test @neo-one/smart-contract-lib @neo-one/smart-contract-typescript-plugin
Know what you want to use from NEO•ONE? Read on to see which packages to install for specific functionality.
For interacting with smart contracts, you should install
@neo-one/client- Main entrypoint to the most common NEO•ONE client APIs.
For local network and smart contract management, you should install
@neo-one/cli- Provides the
neo-onecli command which manages common tasks like building and deploying smart contracts and spinning up local networks.
In addition to the above, if you’re developing TypeScript smart contracts using NEO•ONE, you should install
@neo-one/smart-contract- TypeScript smart contract standard library.
@neo-one/smart-contract-test- TypeScript smart contract testing utilitiees.
@neo-one/smart-contract-lib- Template library for common smart contract patterns.
@neo-one/smart-contract-typescript-plugin- TypeScript language server plugin for inline compiler diagnostics in your favorite IDE.
#npm update @neo-one/cli yarn upgrade @neo-one/cli
Configure your IDE to use your local TypeScript installation and the
@neo-one/smart-contract-typescript-plugin in order to take advantage of inline compiler diagnostics. These instructions are for VSCode, but they should be similar for any editor that supports TypeScript IntelliSense.
yarn neo-one initor
npx neo-one init. This will create a
tsconfig.jsonfile in the configured smart contract directory (by default,
That’s it! Enjoy inline smart contract compiler diagnostics.
NEO•ONE depends on several types which older browser may not support. NEO•ONE requires the collection types Map and Set as well as Symbol.asyncIterator. If you support older browsers and devices which may not yet provide these natively, consider including a global polyfill in your bundled application, such as core-js or babel-polyfill.
To polyfill an environment for NEO•ONE using core-js, include the following lines at the top of your entry point.
import 'core-js/es/map'; import 'core-js/es/set'; import 'core-js/es/symbol/async-iterator';