Registrar no Symbiotic¶
Introdução¶
Como apresentado na seção de integração, registrar no Symbiotic é o segundo passo do processo. Você já deve ter o nó sincronizado e em execução, seja usando Docker ou Systemd.
O protocolo Tanssi fornece às suas appchains segurança de nível Ethereum desde o início, confiando em provedores externos como o Symbiotic. Para participar como operador no ecossistema Tanssi, você deve primeiro registrar seu nó no protocolo Symbiotic. O processo de registro estabelece seu nó como operador reconhecido.
Este guia mostra as etapas para registrar seu nó como operador Symbiotic, permitindo escolher entre vários métodos: CLI Symbiotic, interação direta via Etherscan ou uso do Safe para configurações multisig.
Verificando Pré-requisitos¶
Antes de se registrar, certifique-se de já ter configurado o nó e que ele esteja em execução.
Para seguir este guia, você deverá interagir com contratos inteligentes. Existem várias formas de interagir com os contratos inteligentes:
- Usando o Symbiotic CLI
- Usando o Etherscan
- Usando o Safe para configurações multisig
Em todos os casos, você precisará assinar a transação com a conta que pretende usar para o nó. Você pode fazer isso de diferentes maneiras:
- Usando a chave privada da conta diretamente (não recomendado)
- Usando uma hot wallet, como o MetaMask
- Usando uma cold wallet, como o Ledger
A seção a seguir descreve os passos para instalar o Symbiotic CLI, caso essa seja sua opção.
Configurar o Symbiotic CLI¶
O Symbiotic CLI é uma ferramenta para interagir com os contratos principais do Symbiotic. Ele é escrito em Python, portanto você precisará instalar o interpretador Python e o pip, o instalador de pacotes do Python:
sudo apt-get install python3 && \
sudo apt install python3-pip
brew install python3
Agora, com o Python instalado, baixe o Symbiotic CLI e suas dependências:
git clone https://github.com/symbioticfi/cli.git && \
cd cli && \
pip3 install -r requirements.txt
Execute o comando abaixo para verificar se a instalação foi bem-sucedida:
python3 symb.py --help
O terminal deve mostrar uma lista grande dos comandos disponíveis do CLI:
Options: --chain CHAIN Chain ID to use. [default: mainnet] --provider TEXT Ethereum provider URL [http(s)]. --help Show this message and exit.
Commands: active-balance-of Get an active balance of a given account... check-opt-in-network Check if operator is opted in to a network. check-opt-in-vault Check if operator is opted in to a vault. claim Claim a withdrawal for some epoch at the... deposit Deposit to the vault. ....... ..........
Registrar como Operador¶
O protocolo Symbiotic mantém um registro de todos os operadores. Antes de proteger redes Tanssi, registre-se usando um dos métodos abaixo.
Registrar usando a CLI Symbiotic¶
Se você instalou a CLI Symbiotic e quer assinar com um dispositivo Ledger, execute o comando abaixo, substituindo INSERT_OPERATOR_ADDRESS pela sua conta:
python3 symb.py register-operator --ledger --ledger-account INSERT_OPERATOR_ADDRESS
python3 symb.py --chain sepolia register-operator --ledger --ledger-account INSERT_OPERATOR_ADDRESS
Se preferir assinar diretamente com a chave privada da conta, execute (substitua INSERT_PRIVATE_KEY):
python3 symb.py register-operator --private-key INSERT_PRIVATE_KEY
python3 symb.py --chain sepolia register-operator --private-key INSERT_PRIVATE_KEY
Atenção
Este método exige expor sua chave privada; não é recomendado.
Registrar usando o Etherscan¶
Você pode interagir com os contratos do Symbiotic pelo Etherscan e assinar com uma carteira de navegador (MetaMask, por exemplo).
Abra a página do contrato:
Clique em Conectar ao Web3 e selecione sua carteira preferida (por exemplo, MetaMask):
Nota
Você pode configurar o MetaMask para usar uma carteira fria.
Depois de conectado:
- Expanda a função
registerOperator - Clique em Write e assine a transação
Registrar usando o Safe para Multisig¶
Se você tiver uma conta Safe, abra o Transaction builder e insira o seguinte endereço do contrato:
0xAd817a6Bc954F678451A71363f04150FDD81Af9F
0x6F75a4ffF97326A00e52662d82EA4FdE86a2C548
Por fim, escolha a função registerOperator e assine a transação.
Verificar o status do registro¶
Você pode verificar rapidamente seu status de registro no Etherscan. Abra:
Na página do contrato:
- Selecione a função
isEntity - Cole a conta do seu operador
- Clique em Query
Se o operador foi registrado corretamente, o resultado será true; caso contrário, false.
Você também pode verificar o status via CLI Symbiotic, executando:
python3 symb.py isop INSERT_OPERATOR_ADDRESS
python3 symb.py --chain sepolia isop INSERT_OPERATOR_ADDRESS
E a saída se parece com:
Enviar metadados¶
Após o registro, você pode adicionar metadados (por exemplo, logotipo) para melhorar a visibilidade no site Symbiotic.
Para enviar os metadados do operador, acesse o repositório de metadados Symbiotic:
Crie um fork do repositório e, no diretório operators, crie uma pasta com o endereço do seu operador. Dentro dela, adicione logo.png e um arquivo info.json com os campos abaixo (substitua pelos seus valores):
{
"name": "INSERIR_SEU_NOME_DO_OPERADOR",
"description": "INSERIR_SUA_DESCRIÇÃO_DO_OPERADOR",
"tags": [
"operador"
],
"links": [
{
"type": "website",
"name": "Website",
"url": "https://INSERIR_SEU_URL_DO_SITE"
},
{
"type": "website",
"name": "X",
"url": "https://INSERIR_SEU_URL_X"
}
]
}
Nota
O parâmetro links é um array. Adicione quantos links forem necessários.
Por fim, abra um pull request. A equipe Symbiotic revisará e fará o merge.
| Criada: 9 de dezembro de 2025