Opt In to Tanssi¶

Introduction¶

One of Tanssi's core propositions for builders is that it provides Ethereum-grade economic security to every Tanssi-powered network, regardless of its TVL, userbase, or the specifics of the use case. Tanssi's design offers developers a shared security model, alleviating them from having to source enough economic security or negotiate with operators to run nodes opting in for their networks.

The Tanssi protocol achieves this by integrating with external security providers, such as Symbiotic. In this model, different vaults associated with Tanssi provide economic security, and reliable operators provide validation services to the Tanssi network.

In every session, the Tanssi protocol determines how many validators are required to support the entire ecosystem. With the number of validators, the protocol picks those with the higher delegated stake from the allow-listed ones.

This guide will walk through the steps to successfully opt into a Tanssi-enabled vault and the Tanssi network.

Checking Prerequisites¶

Before opting into a Tanssi-enabled vault and the Tanssi network, make sure that:

• You have a node correctly set up and running
• You have registered as an operator in the Symbiotic registry

To follow this guide, you must interact with smart contracts, one from Symbiotic's core protocol and the other from Tanssi's integration with Symbiotic.

There are several ways to interact with the smart contracts:

• Using the Symbiotic CLI
• Using Etherscan
• Using Safe for multisig setups

In any case, you'll need to sign the transaction using the account you intend to use for the node. You can choose between different options to do so:

• Using the account's private key directly (although this method is not recommended)
• Using a hot wallet, such as MetaMask
• Using a cold wallet, such as Ledger

The following section outlines the steps for installing the Symbiotic CLI, if that's your method of preference.

Set Up the Symbiotic CLI¶

The Symbiotic CLI is a tool for interacting with Symbiotic's core smart contracts. It is written in Python, so you'll need to install the Python interpreter and pip, Python's package installer:

 sudo apt-get install python3 && \
 sudo apt install python3-pip

brew install python3

Now, with Python installed, download the Symbiotic CLI and its dependencies:

git clone https://github.com/symbioticfi/cli.git && \
cd cli && \
pip3 install -r requirements.txt

Run the following command to check if the installation was successful:

python3 symb.py --help

The terminal should show a long list of the CLI available commands:

Opt In to Tanssi-Enabled Vaults¶

Before enabling your operator to be an active Tanssi network validator, you must opt in to at least one of the Tanssi-enabled vaults. The following sections describe several ways to opt into the vaults.

Opt In Using the Symbiotic CLI¶

If you have correctly installed the Symbiotic CLI and you want to sign the transaction using a Ledger device, then run the following command, replacing INSERT_VAULT_ADDRESS with the specific one you want to join and INSERT_OPERATOR_ADDRESS with your account:

python3 symb.py opt-in-vault INSERT_VAULT_ADDRESS --ledger --ledger-account INSERT_OPERATOR_ADDRESS

python3 symb.py opt-in-vault 0xB94f8852443FB4faB18363D22a45cA64a8CF4482 --ledger --ledger-account INSERT_OPERATOR_ADDRESS --chain sepolia

If you want to sign the transaction directly using the operator's account private key, then run the following command, replacing the INSERT_PRIVATE_KEY parameter:

python3 symb.py opt-in-vault INSERT_VAULT_ADDRESS --private-key INSERT_PRIVATE_KEY

python3 symb.py opt-in-vault 0xB94f8852443FB4faB18363D22a45cA64a8CF4482 --private-key INSERT_PRIVATE_KEY --chain sepolia

Opt In Using Etherscan¶

You can interact with Symbiotic's smart contracts using Etherscan, and sign the transaction using a browser wallet (MetaMask, for example).

To open the contract's page, open the link:

Click on Connect to Web3, and select your preferred wallet (e.g. MetaMask):

Once connected:

1. Expand the optin function
2. Insert the VAULT_ADDRESS (0xB94f8852443FB4faB18363D22a45cA64a8CF4482 on Sepolia TestNet)
3. Click on Write, and sign the transaction

Opt In Using Safe for Multisig Setups¶

If you have a Safe account, then open the Transaction builder and insert the following contract address:

Finally, pick the optin function, insert the VAULT_ADDRESS (0xB94f8852443FB4faB18363D22a45cA64a8CF4482 on Sepolia TestNet), and sign the transaction.

Check the Registration Status¶

You can quickly check your registration status on Etherscan. Open the following link:

In the contract's page:

1. Select the isOptedIn function
2. Paste your operator's account in the who field
3. Insert the VAULT_ADDRESS in the where field
4. Click on Query

You'll get a true result if your operator was registered correctly and false otherwise.

You can also verify your registration status using the Symbiotic CLI running the following command, which prints true or false for any given operator address in a Tanssi-enabled vault:

python3 symb.py check-opt-in-vault INSERT_OPERATOR_ADDRESS INSERT_VAULT_ADDRESS

python3 symb.py check-opt-in-vault INSERT_OPERATOR_ADDRESS 0xB94f8852443FB4faB18363D22a45cA64a8CF4482 --chain sepolia

And the output looks like:

Opt In to the Tanssi Network¶

Before enabling your operator to be an active Tanssi network validator, you must opt into the network and be approved by the Tanssi team. The following sections describe several ways to opt into the network.

Opt In Using the Symbiotic CLI¶

If you have correctly installed the Symbiotic CLI and you want to sign the transaction using a Ledger device, then run the following command, replacing INSERT_OPERATOR_ADDRESS:

python3 symb.py opt-in-network INSERT_TANSSI_NETWORK_ADDRESS --ledger --ledger-account INSERT_OPERATOR_ADDRESS

python3 symb.py opt-in-network 0xdaD051447C4452e15B35B7F831ceE8DEb890f1a4 --ledger --ledger-account INSERT_OPERATOR_ADDRESS --chain sepolia

If you want to sign the transaction directly using the operator's account private key, then run the following command, replacing the INSERT_PRIVATE_KEY parameter:

python3 symb.py opt-in-network INSERT_TANSSI_NETWORK_ADDRESS --private-key INSERT_PRIVATE_KEY

python3 symb.py opt-in-network 0xdaD051447C4452e15B35B7F831ceE8DEb890f1a4 --private-key INSERT_PRIVATE_KEY --chain sepolia

Opt In Using Etherscan¶

You can interact with Symbiotic's smart contracts using Etherscan and sign the transaction using a browser wallet (MetaMask, for example).

Go to the contract's page by opening the link:

Click on Connect to Web3, and select your preferred wallet (e.g. MetaMask):

Once connected:

1. Expand the optin function
2. Insert the TANSSI_NETWORK_ADDRESS (0xdaD051447C4452e15B35B7F831ceE8DEb890f1a4 on Sepolia TestNet)
3. Click on Write, and sign the transaction

Opt In Using Safe for Multisig Setups¶

If you have a Safe account, then open the Transaction builder and insert the following contract address:

Finally, pick the optin function, insert the (0xdaD051447C4452e15B35B7F831ceE8DEb890f1a4 on Sepolia TestNet), and sign the transaction.

Check the Registration Status¶

You can quickly check your registration status on Etherscan. Open the following link:

On the contract's page:

1. Select the isOptedIn function
2. Paste your operator's account in the who field
3. Insert the TANSSI_NETWORK_ADDRESS in the where field (0xdaD051447C4452e15B35B7F831ceE8DEb890f1a4 on Sepolia TestNet)
4. Click on Query

You'll get a true result if your operator was registered correctly and false otherwise.

You can also verify your registration status using the Symbiotic CLI running the following command, which prints true or false for any given operator address in the Tanssi Network:

python3 symb.py check-opt-in-network INSERT_OPERATOR_ADDRESS INSERT_TANSSI_NETWORK_ADDRESS

python3 symb.py check-opt-in-network INSERT_OPERATOR_ADDRESS 0xdaD051447C4452e15B35B7F831ceE8DEb890f1a4 --chain sepolia

And the output looks like: