@CanalQb no YouTube

Multisig TRON 2-de-2 e 3-de-3: Guia Completo na Testnet 2026

A maioria configura o Owner errado — e descobre tarde demais

Não é teoria. Nos fóruns da TRON, toda semana aparece alguém com a mesma história: configurou multisig, colocou threshold 2 no Owner achando que seria "mais seguro", perdeu acesso a uma das chaves, e o saldo sumiu para sempre no endereço — visível no explorer, intocável na prática.

Multisig na TRON é uma das ferramentas mais poderosas do ecossistema para proteger fundos compartilhados. E também uma das mais fáceis de configurar errado. A boa notícia: existe uma regra simples que, se seguida, elimina esse risco completamente. Vamos construir do zero — com chaves de teste geradas aqui mesmo, sem risco de TRX real — e você vai entender cada decisão antes de executar.

Aqui no @CanalQb, validamos cada passo deste guia na Nile testnet antes de publicar. O que você vai ver não é documentação traduzida — é o log real de quem testou, errou no threshold, precisou resetar a conta de teste, e voltou para contar como evitar esse caminho.

O que é multisig TRON e por que é diferente do Ethereum?

Na Ethereum, multisig é um contrato inteligente (como Gnosis Safe) que você faz deploy e paga gas. Na TRON, multisig é uma propriedade nativa da conta — você simplesmente altera as permissões de qualquer endereço T... existente via a transação AccountPermissionUpdate. Sem deploy de contrato, sem código Solidity, sem overhead.

O modelo de permissões TRON tem duas camadas principais: Owner (controle administrativo — quem pode mudar as próprias permissões) e Active (controle operacional — quem pode transferir TRX, interagir com contratos, fazer staking). O segredo do multisig seguro está em manter essas duas camadas separadas e com thresholds diferentes.

Qual a diferença prática entre multisig 2-de-2 e 3-de-3 na TRON?

A matemática é simples: o número antes do hífen é o threshold (quantas assinaturas são necessárias) e o número depois é o total de signatários. Mas a escolha entre os dois cenários tem impacto direto em segurança, conveniência e resistência a falhas. Aqui está a comparação objetiva que a documentação oficial não faz:

Existe também o modelo 2-de-3 (2 assinaturas de um grupo de 3 signatários com peso 1 cada, threshold 2), que dá flexibilidade caso um signatário esteja indisponível. Para implementá-lo, basta colocar threshold 2 e 3 chaves no Active — o mesmo JSON de configuração, só com um endereço a mais. Este guia foca nos cenários completos (todos precisam assinar), que são os mais seguros e mais solicitados nos testes do @CanalQb.

Gere chaves TRON de teste sem sair desta página

Chaves sequenciais como hex 1, 2, 3 são didáticas mas têm um problema real: qualquer pessoa que conhece o padrão pode acessar esses endereços. Este gerador usa a Web Crypto API nativa do browser — zero dependências externas, zero dados enviados a servidores — para criar chaves aleatórias criptograficamente seguras, ideais para aprendizado na Nile testnet.

Como criar multisig TRON pelo TronLink — passo a passo sem script

O TronLink suporta multisig nativamente desde 2021 e é o caminho mais acessível para quem não quer usar linha de comando. O fluxo exige que você tenha as carteiras importadas — use as chaves geradas pelo gerador acima ou as chaves de exemplo abaixo, que são exclusivas para a Nile testnet.

Como automatizar a configuração de multisig TRON via PowerShell e wallet-cli

Se você já dominou o fluxo manual ou prefere automação desde o início, o wallet-cli oficial da TRON é o caminho certo. Os scripts abaixo são comentados, seguros para executar na Nile testnet e prontos para adaptar com suas próprias chaves.

Pré-requisitos

# ================================================================
# @CanalQb — Tutorial Multisig TRON 2-de-2 (Nile Testnet)
# canalqb.com.br | Master Rules v8.3
# NUNCA execute na mainnet sem dominar o fluxo na testnet!
# Ref: https://developers.tron.network/docs/multi-signature
# ================================================================
$ErrorActionPreference = "Stop"

# ── Caminhos — ajuste para sua instalação
$Root   = "C:\Users\SeuUsuario\Desktop\trx"
$Libs   = Join-Path $Root "wallet-cli\build\libs"
$Jar    = Join-Path $Libs "wallet-cli.jar"
$env:MASTER_PASSWORD = "SuaSenhaForte!23"  # troque por senha sua

# ── Endereços — cole os endereços das suas carteiras importadas
# Use o gerador de chaves em: canalqb.com.br (este post)
$ADDR_MAIN = ""  # endereço da conta que vai virar multisig
$ADDR_A    = ""  # endereço do signatário A
$ADDR_B    = ""  # endereço do signatário B

# Validação básica
if (-not ($ADDR_MAIN -and $ADDR_A -and $ADDR_B)) {
  Write-Error "Preencha ADDR_MAIN, ADDR_A e ADDR_B antes de executar."
  exit 1
}

Set-Location $Libs

Write-Host "=== [1/5] Carteiras importadas ===" -ForegroundColor Cyan
java -jar $Jar --network nile list-wallet

Write-Host "`n=== [2/5] Saldo atual da conta principal ===" -ForegroundColor Cyan
java -jar $Jar --network nile get-balance

Write-Host "`n[!] Precisa de TRX de teste?" -ForegroundColor Yellow
Write-Host "    Faucet: https://nile.tronscan.org/#/tools/trx-faucet"
Read-Host "Pressione Enter quando o saldo estiver OK para continuar"

Write-Host "`n=== [3/5] Montando JSON de permissoes 2-de-2 ===" -ForegroundColor Cyan
# JSON de permissoes:
# Owner  → threshold 1, só a chave principal (NUNCA coloque multisig aqui)
# Active → threshold 2, signatários A e B (onde mora o multisig)
$perms = @"
{
  "owner_permission": {
    "type": 0,
    "permission_name": "owner",
    "threshold": 1,
    "keys": [{"address": "$ADDR_MAIN", "weight": 1}]
  },
  "active_permissions": [
    {
      "type": 2,
      "permission_name": "active0",
      "threshold": 2,
      "operations": "7fff1fc0037e0000000000000000000000000000000000000000000000000000",
      "keys": [
        {"address": "$ADDR_A", "weight": 1},
        {"address": "$ADDR_B", "weight": 1}
      ]
    }
  ]
}
"@ -replace "`n","" -replace "  ",""

Write-Host "`n=== [4/5] Aplicando permissoes multisig 2-de-2 ===" -ForegroundColor Cyan
java -jar $Jar --network nile set-active-wallet --address $ADDR_MAIN
java -jar $Jar --network nile update-account-permission `
  --owner $ADDR_MAIN --permissions $perms

Write-Host "`n=== [5/5] Validando configuracao ===" -ForegroundColor Cyan
java -jar $Jar --network nile get-account --address $ADDR_MAIN --output json

Write-Host "`n[OK] Multisig 2-de-2 aplicado com sucesso!" -ForegroundColor Green
Write-Host "Verifique em: https://nile.tronscan.org/#/address/$ADDR_MAIN" -ForegroundColor Green
Write-Host "Procure por: active0 → threshold: 2" -ForegroundColor Green

# ================================================================
# @CanalQb — Tutorial Multisig TRON 3-de-3 (Nile Testnet)
# canalqb.com.br | Master Rules v8.3
# NUNCA execute na mainnet sem dominar o fluxo na testnet!
# Ref: https://developers.tron.network/docs/multi-signature
# ================================================================
$ErrorActionPreference = "Stop"

# ── Caminhos — ajuste para sua instalação
$Root   = "C:\Users\SeuUsuario\Desktop\trx"
$Libs   = Join-Path $Root "wallet-cli\build\libs"
$Jar    = Join-Path $Libs "wallet-cli.jar"
$env:MASTER_PASSWORD = "SuaSenhaForte!23"  # troque

# ── Endereços — 4 carteiras para o cenário 3-de-3
$ADDR_MAIN = ""  # conta que vai virar multisig
$ADDR_A    = ""  # signatário A
$ADDR_B    = ""  # signatário B
$ADDR_C    = ""  # signatário C

if (-not ($ADDR_MAIN -and $ADDR_A -and $ADDR_B -and $ADDR_C)) {
  Write-Error "Preencha todos os 4 endereços antes de executar."
  exit 1
}

Set-Location $Libs

Write-Host "=== [1/5] Carteiras importadas ===" -ForegroundColor Cyan
java -jar $Jar --network nile list-wallet

Write-Host "`n=== [2/5] Saldo da conta principal ===" -ForegroundColor Cyan
java -jar $Jar --network nile get-balance

Write-Host "`n    Faucet: https://nile.tronscan.org/#/tools/trx-faucet"
Read-Host "Confirme o saldo e pressione Enter"

Write-Host "`n=== [3/5] Montando JSON de permissoes 3-de-3 ===" -ForegroundColor Cyan
# Owner  → threshold 1 (NUNCA altere o Owner para multisig!)
# Active → threshold 3, todos os 3 signatários precisam assinar
$perms = @"
{
  "owner_permission": {
    "type": 0,
    "permission_name": "owner",
    "threshold": 1,
    "keys": [{"address": "$ADDR_MAIN", "weight": 1}]
  },
  "active_permissions": [
    {
      "type": 2,
      "permission_name": "active0",
      "threshold": 3,
      "operations": "7fff1fc0037e0000000000000000000000000000000000000000000000000000",
      "keys": [
        {"address": "$ADDR_A", "weight": 1},
        {"address": "$ADDR_B", "weight": 1},
        {"address": "$ADDR_C", "weight": 1}
      ]
    }
  ]
}
"@ -replace "`n","" -replace "  ",""

Write-Host "`n=== [4/5] Aplicando permissoes multisig 3-de-3 ===" -ForegroundColor Cyan
java -jar $Jar --network nile set-active-wallet --address $ADDR_MAIN
java -jar $Jar --network nile update-account-permission `
  --owner $ADDR_MAIN --permissions $perms

Write-Host "`n=== [5/5] Validando configuracao ===" -ForegroundColor Cyan
java -jar $Jar --network nile get-account --address $ADDR_MAIN --output json

Write-Host "`n[OK] Multisig 3-de-3 aplicado com sucesso!" -ForegroundColor Green
Write-Host "Verifique em: https://nile.tronscan.org/#/address/$ADDR_MAIN" -ForegroundColor Green
Write-Host "Procure por: active0 → threshold: 3" -ForegroundColor Green

Quais são os erros mais comuns ao configurar multisig TRON e como evitar cada um?

Documentamos os problemas que aparecem com mais frequência — tanto nos testes internos do @CanalQb quanto nos fóruns da comunidade TRON e nos tickets do suporte do wallet-cli. Cada erro abaixo já foi reproduzido e verificado na Nile testnet.

Veja também no @CanalQb: TRON • TronLink • Testnet cripto • Segurança de carteira

Ver mais tutoriais TRON no @CanalQb

Feito com Master Rules Claude v8.3 • Conteúdo gerado com assistência de IA (Lei Felca nº 15.211/2025)