This is a squid template for indexing Ink!-based contracts, supported e..g by the Astar and Shibuya network. This template indexes a sample ERC-20 Ink!-based smart contract token transfers over the Shibuya network and serves them via graphql API.
For more details, inspect the Squid SDK docs and an Ink! indexing tutorial.
# 1. Update Squid SDK and install dependencies
npm run update
npm ci
# 2. Compile typescript files
make build
# 3. Start target Postgres database and detach
make up
# 4. Start the processor
make process
# 5. The command above will block the terminal
# being busy with fetching the chain data,
# transforming and storing it in the target database.
#
# To start the graphql server open the separate terminal
# and run
make serve
Start development by defining the schema of the target database via schema.graphql
.
Schema definition consists of regular graphql type declarations annotated with custom directives.
Full description of schema.graphql
dialect is available here.
Mapping developers use TypeORM EntityManager
to interact with the target database. All the necessary entity classes are
generated from schema.graphql
. This is done by running
npx sqd codegen
All database changes are applied through migration files located at db/migrations
.
squid-typeorm-migration(1)
tool provides several commands to drive the process.
It is all TypeORM under the hood.
# Connect to database, analyze its state and generate migration to match the target schema.
# The target schema is derived from entity classes generated earlier.
# Don't forget to compile your entity classes beforehand!
npx squid-typeorm-migration generate
# Create template file for custom database changes
npx squid-typeorm-migration create
# Apply database migrations from `db/migrations`
npx squid-typeorm-migration apply
# Revert the last performed migration
npx squid-typeorm-migration revert
It is necessary to import the respective ABI definition to decode WASM logs. For this template we used standard ERC20 interface, see assets/erc20.json
.
To generate a type-safe facade class to decode EVM logs, use squid-ink-typegen(1)
:
npx squid-ink-typegen --abi assets/erc20.json --output src/abi/erc20.ts
Squid tools assume a certain project layout.
- All compiled js files must reside in
lib
and all TypeScript sources insrc
. The layout oflib
must reflectsrc
. - All TypeORM classes must be exported by
src/model/index.ts
(lib/model
module). - Database schema must be defined in
schema.graphql
. - Database migrations must reside in
db/migrations
and must be plain js files. sqd(1)
andsquid-*(1)
executables consult.env
file for a number of environment variables.
It is possible to extend squid-graphql-server(1)
with custom
type-graphql resolvers and to add request validation.
More details will be added later.
The following hacks are used to make the template work:
In your ABI replace storage with this
{
"storage": {
"cell": {
"key": "0x0000000000000000000000000000000000000000000000000000000000000000",
"ty": 0
}
}
}
abXaTso17JvAekJoBYy3Aam92FQWxPsfxjag1fhncz2oraY
->0xce18fa994c9c20b8892ba6dd8c19b108df272f6ac196944b95e664560f94a554