Opt Out from Tanssi¶
Introduction¶
The ability to manage node operators' participation within the Tanssi ecosystem is crucial. This guide addresses the initial step in the offboarding process: opting out of the Tanssi network. This action signals your intent to withdraw and allows the Tanssi protocol to verify your identity as the legitimate operator.
During the onboarding process, one step was opting in to the Tanssi network to become an operator. This guide will walk you through the process of opting out. There are several ways to interact with the smart contracts involved. Refer to the prerequisites article to evaluate which alternative suits you best.
Identity Validation
When opting out, you sign the transaction using the private key or Ledger device associated with your operator account. This signature serves as cryptographic proof that you are the legitimate owner of the operator account, ensuring that only authorized operators can initiate the offboarding process.
Methods for Opting Out from a Tanssi Network¶
To opt out of the Tanssi network, you must interact with a smart contract. Below are the different methods available to perform this action. Choose the one that best fits your setup and security preferences.
Using the Symbiotic CLI¶
The Symbiotic CLI provides a straightforward way to opt out of the network. Choose the appropriate command based on your network and signing method.
Using a Ledger device:
python3 symb.py opt-out-network INSERT_NETWORK_ADDRESS --ledger --ledger-account INSERT_OPERATOR_ADDRESS
python3 symb.py --chain sepolia opt-out-network 0xdaD051447C4452e15B35B7F831ceE8DEb890f1a4 --ledger --ledger-account INSERT_OPERATOR_ADDRESS
For signing with a private key:
python3 symb.py opt-out-network INSERT_NETWORK_ADDRESS --private-key INSERT_PRIVATE_KEY
python3 symb.py --chain sepolia opt-out-network 0xdaD051447C4452e15B35B7F831ceE8DEb890f1a4 --private-key INSERT_PRIVATE_KEY
Warning
Note that this method requires you to expose your private key; therefore, it is not recommended.
Using Etherscan¶
You can interact directly with the smart contract through Etherscan using a browser wallet like MetaMask.
Make sure to select Contract and Write Contract, then click on Connect to Web3, and select your preferred wallet (e.g., MetaMask):
- Expand the optOut function
- Insert the
TANSSI_NETWORK_ADDRESS
in the where field (e.g.,0xdaD051447C4452e15B35B7F831ceE8DEb890f1a4
on Sepolia TestNet) - Click Write and sign the transaction
Warning
After submitting your opt out transaction, save the transaction hash. You'll need this hash later for verification in the operation offboarding form.
Using Safe for Multisig Setups¶
For Safe accounts, use the Transaction Builder with these addresses:
0x7133415b33B438843D581013f98A08704316633c
0x58973d16FFA900D11fC22e5e2B6840d9f7e13401
Finally, pick the optOut function, insert the TANSSI_NETWORK_ADDRESS
to which your node is currently registered (e.g., 0xdaD051447C4452e15B35B7F831ceE8DEb890f1a4
on Sepolia TestNet), and sign the transaction.
Verifying Your Opt-Out Status¶
After submitting the opt-out transaction, it's important to confirm that the action was successful and your operator is no longer opted into the network. You can verify this status using the methods outlined below.
Using Etherscan to Verify¶
You can check your opt-out status on Etherscan by querying the smart contract:
On the contract's page:
- Make sure to select the Read Contract tab
- Locate and expand the isOptedIn function
- Paste your operator's account address in the who field.
- Insert the
TANSSI_NETWORK_ADDRESS
in the where field (e.g.,0xdaD051447C4452e15B35B7F831ceE8DEb890f1a4
on Sepolia TestNet) - Click on Query
You'll get a false
result if your operator has successfully opted out, and true
if they are still opted in.
Using the Symbiotic CLI to Verify¶
You can also verify your opt-out status using the Symbiotic CLI:
python3 symb.py check-opt-in-network INSERT_OPERATOR_ADDRESS INSERT_TANSSI_NETWORK_ADDRESS
python3 symb.py --chain sepolia check-opt-in-network INSERT_OPERATOR_ADDRESS 0xdaD051447C4452e15B35B7F831ceE8DEb890f1a4
The output will show false
if you have successfully opted out and true
if you are still opted in.
Contact Tanssi Team¶
Following the network opt-out, the next stage of offboarding your Tanssi operator involves formally notifying the Tanssi team. This page guides you through submitting the required offboarding form and explaining what to expect during the final removal process.
After opting out from the network, notify the Tanssi team of your intention to stop running an operator. To do so, complete the operator offboarding form and wait for confirmation of request completion from the Tanssi team.
Upon receiving your request, your operator's removal will be scheduled. This step is semi-automated and may take time to complete. You will be notified by email when it is safe to decommission the node. Please do not decommission your node until you receive this notification.
Provide feedback
Consider providing feedback in the offboarding form about your experience to help improve the Tanssi network.
Pause Operations (Optional)¶
Once you receive confirmation of your operator's removal from the Tanssi team, you can safely stop any running services related to your operator. If needed, back up important configuration files, logs, or any relevant data before deleting them. Afterward, you may repurpose, terminate, or shut down your infrastructure entirely.
Next Steps (Optional)¶
After you have opted out of the network and informed the Tanssi team by submitting the offboarding form, you can take an additional optional step and opt out of any specific vaults your operator might be associated with.
| Created: May 9, 2025