💻 CLI

Sentio provides a command line tool to easily create and upload processors for your project. To start using it, you need to have a Node.js environment. Then you can run

npx @sentio/cli@latest --help

to see all available commands.

sentio login

Login to Sentio from your command line. You first need to create your API key.

npx @sentio/cli@latest login

sentio create

Create a sentio processor

npx @sentio/cli@latest create -n <project name>

By default it creates an EVM-based project. If you want to create a project for other chains, you can do

npx @sentio/cli@latest create -c <evm|aptos|solana|raw> <project name>

If you are working in a mono-repo setup with many processors in repo and have your root package.json control all versions, you need to do the following or delete the sentio dependencies in your child package.json manually.

npx @sentio/cli@latest create --subproject -n <project name>

sentio add

Inside project directory, add contract ABI to your project and generate bindings for a contract in Ethereum mainnet.

yarn sentio add <contract address>

To use a different network, try --chain flag as follows

yarn sentio add --chain <chain_id> <contract address>

By default, the ABI will be downloaded with its address as the name, which will lead the generated binding to use the address for the name as well. To override the name, use -n <name> or --name <name>, e.g.

yarn sentio add --name MyToken --chain <chain_id> <contract address>

sentio upload

Inside project directory, build and upload your processor to your project.

yarn sentio upload

It's also possible to hot-swap a running processor version with new logic, without re-indexing old data.

yarn sentio upload --continue-from=<old version>

sentio gen

Inside project directory, generate type bindings into src/types according to ABIs that are in the abis folder.

yarn sentio gen

sentio build

Inside project directory, generate code and then build the processor into dist folder.

yarn sentio build