Update torii doc

src/toolchain/torii/reference.md

@@ -0,0 +1,53 @@
+## torii reference
+
+### Name
+
+torii - An automatic indexer and networking layer for a world contract.
+
+### USAGE
+
+```sh
+torii [OPTIONS]
+```
+
+### DESCRIPTION
+
+Starts the indexer and graphql/gRPC API endpoints. The indexer queries the provided Starknet RPC endpoint for transaction blocks and listens for transactions belonging to the world contract. Transactions may consist of component/system registrations, entity state updates, system calls, and events. The data is then parsed and stored in a local sqlite database.
+
+The graphql and gRPC API endpoints run in tandem with the indexer. The endpoints can be consumed by client applications and provides custom queries unique to your world contract.
+
+#### Database URL
+
+Torii uses a sqlite database to store indexed data. The database can be stored either in-memory or persistently on the filesystem. The in-memory database is ephermal and only lasts as long as the indexer is running. This is a fast and simple way to start the indexer for development/testing. Presistent storage should be used in production, it uses the local filesystem for storage.
+
+Note: If using in-memory db, after a period of inactivity the memory will be garbage collected and queries will result in errors. Workaround is starting `katana` with `--block-time` or use persistent database.
+
+```sh
+# Persistent database storage using file indexer.db
+torii --database-url sqlite:indexer.db
+```
+
+### OPTIONS
+
+#### General Options
+
+`-w, --world`
+     Address of the world contract to index
+
+`--rpc`
+     Starknet RPC endpoing to use [default: http//localhost:5050]
+
+`-m, --manifest <MANIFEST>`
+&nbsp;&nbsp;&nbsp;&nbsp; Specify a local manifest to initialize from
+
+`-d, --database-url <DATABASE_URL>`
+&nbsp;&nbsp;&nbsp;&nbsp; Database URL (read more above) [default: sqlite::memory:]
+
+`-s, --start-block <START_BLOCK>`
+&nbsp;&nbsp;&nbsp;&nbsp; Specify a block to start indexing from, ignored if stored head exists [default: 0]
+
+`-h, --help`
+&nbsp;&nbsp;&nbsp;&nbsp; Print help
+
+`-V, --version`
+&nbsp;&nbsp;&nbsp;&nbsp; Print version