Register

To participate in the Shinzo Network, you must register your IndexerIndexer A node that reads blockchain data from a source chain, parses it into structured documents, and writes them to defraDB. Indexers are write-only: they push data out over P2P and reject all incoming replication.. Registration identifies and authenticates your node so it can replicate data and earn rewards. Without this step, your IndexerIndexer A node that reads blockchain data from a source chain, parses it into structured documents, and writes them to defraDB. Indexers are write-only: they push data out over P2P and reject all incoming replication. will not be recognized by the network. To register in ShinzoHubShinzoHub Shinzo's coordination chain: a Cosmos SDK chain (v0.53.4) with an integrated EVM, running CometBFT consensus. It holds the view, host, and indexer registries and the economic layer (staking, pricing, payments). It does not store or serve indexed blockchain data., follow the steps below.

info

If you are a validatorValidator An entity that participates in a chain's consensus. On Ethereum, a validator's withdrawal key signs an EIP-712 message on the outpost to authorize an operator key as its indexer. on a source chainSource chain Any external blockchain that Shinzo indexes — Ethereum, an L2, a Cosmos chain, etc. A source chain hosts an outpost contract and is read by indexers., registration may also prompt you to submit an assertion. AssertionsAssertion A cryptographic proof, produced on a source chain, that a validator is who they claim to be. It ties the validator's consensus identity to an operator key. Without a valid assertion, a validator cannot register as an indexer on ShinzoHub. require your consensus public keyConsensus Public Key Also called the consensus key. The public key a validator uses to sign blocks and participate in chain consensus, and the field that identifies which validator is asserting on the outpost. The key type is chain-specific: on Ethereum it is a 48-byte BLS12-381 pubkey used on the beacon chain; on Cosmos SDK chains it is typically an Ed25519 CometBFT pubkey. It is distinct from the withdrawal key, which controls stake withdrawals on the execution layer. During an assertion, this key is bound to an operator key so the indexer can act on the validator's behalf on ShinzoHub. for the chain you validate on. See Consensus public key for what that is and how to retrieve it.

1. Start your IndexerIndexer A node that reads blockchain data from a source chain, parses it into structured documents, and writes them to defraDB. Indexers are write-only: they push data out over P2P and reject all incoming replication..

2. Add the Shinzo Devnet to your browser wallet with the following values:

   • Network name: Shinzo
   • Default RPC URL: http://rpc.devnet.shinzo.network:8545
   • Chain ID: 91273002
   • Currency symbol: SHNZ

3. Go to localhost:8080 and select Connect to connect your wallet.

   info

   If your IndexerIndexer A node that reads blockchain data from a source chain, parses it into structured documents, and writes them to defraDB. Indexers are write-only: they push data out over P2P and reject all incoming replication. is running on a remote server (like Hetzner, DigialOcean, GCP, AWS, etc), you can use SSH local port forwarding to access the registration page.

   1. On your local machine, run ssh -L 8080:localhost:8080 user@your-hetzner-ip.
   2. Open http://localhost:8080/registration-app in your browser.

4. Share your wallet address in the Shinzo Discord channel to request allowlisting as an IndexerIndexer A node that reads blockchain data from a source chain, parses it into structured documents, and writes them to defraDB. Indexers are write-only: they push data out over P2P and reject all incoming replication..

It may take ~24 hours for your address to be added to the allowlist. Once your address has been added:

1. Return to the registration page, click Register, and select IndexerIndexer A node that reads blockchain data from a source chain, parses it into structured documents, and writes them to defraDB. Indexers are write-only: they push data out over P2P and reject all incoming replication. as your role.
2. Submit your registration and then confirm the transaction in your browser wallet. You should see a successful registration notification.

Your IndexerIndexer A node that reads blockchain data from a source chain, parses it into structured documents, and writes them to defraDB. Indexers are write-only: they push data out over P2P and reject all incoming replication. is now registered and authorized to participate in the Shinzo Network.

Backup your node identity key

This key defines your IndexerIndexer A node that reads blockchain data from a source chain, parses it into structured documents, and writes them to defraDB. Indexers are write-only: they push data out over P2P and reject all incoming replication.’s identity on the network. Persisting it ensures your node can be restored without losing identity.

• Store a secure backup of the key.
• In a recovery scenario, place it back into the same path (e.g. /defra/keys).
• Use the same keyring/secret configuration.

warning

If this key is lost, and there is no backup available, you will be unable to restore your IndexerIndexer A node that reads blockchain data from a source chain, parses it into structured documents, and writes them to defraDB. Indexers are write-only: they push data out over P2P and reject all incoming replication. with the same identity.