Como posso configurar a libertação da carteira para a minha carteira de trading DEX?

Publicado a 24/09/2025Atualizado a 10/10/2025Leitura de 9 minutos

O que é a libertação da carteira?

A libertação da carteira é uma funcionalidade de proteção para carteiras de trading da OKX DEX. Estas carteiras são contratos inteligentes que não podem ser importadas para outras aplicações de carteira utilizando uma expressão mnemónica ou chave privada.
A libertação da carteira permite-te:

  • Transferir o controlo da tua carteira de trading DEX para a tua própria carteira de auto-custódia.

  • Certifica-te de que tens sempre acesso total ao teu ativo.

  • Utiliza uma ferramenta baseada na Web para transferires fundos para a tua carteira quando for necessário.

Como funciona a libertação da carteira?

Resumindo, aqui está como funciona:

  1. Na aplicação da OKX, desencadeie a Libertação da Carteira para transferires o controlo da tua carteira de trading DEX para o teu endereço de carteira preferido.

  2. É crucial que revejas cuidadosamente o teu endereço de carteira preferido e o endereço de carteira original de trading DEX na aplicação.

  3. Configura e executa um script que prepare um navegador de transferência de tokens no teu navegador web.

  4. Utiliza o navegador para transferires ativos de forma segura a partir da tua carteira de trading DEX para a tua própria carteira.

Como posso configurar a libertação da carteira?

  1. Verifica em que cadeias está a tua carteira de trading DEX.

  2. Cria uma carteira de auto-custódia, se necessário:

    • Se ainda não tens um endereço de carteira, cria um com a OKX Wallet, MetaMask ou outra carteira. Aprende a criar uma carteira OKX aqui.

    • Para cadeias EVM (BNB Chain, Base, etc.): Podes utilizar um endereço de carteira entre cadeias. Depositar ~5 USD em tokens de gás.

    • Para Solana (SOL): utilize uma carteira Solana e deposite cerca de 5 USD em SOL como gás.

  3. Na aplicação, seleciona Trading > Libertação da carteira e segue as instruções no ecrã.

    • Isto transfere o controlo da sua carteira de trading DEX para o endereço de carteira que escolheste.

      Escolhe a libertação da carteira para continuares

  4. Em algum momento da configuração, ser-te-á pedido que introduzas e revejas o teu novo endereço antes de continuar:

    • Introduz o novo endereço para cada cadeia suportada (por exemplo, SOL, BASE, BNB Chain).

    • Para BASE e BNB Chain, ambos usam o mesmo endereço EVM.

      Revê o teu endereço

      • Nota: Não utilize um endereço de uma exchange centralizada. Fazê-lo pode resultar na perda permanente de ativos.

    • Sabe como fazer uma cópia de segurança da chave privada da tua carteira aqui.

  5. Assim que a libertação da carteira estiver concluída, continua no site para transferires os teus fundos.

Como posso configurar a ferramenta de transferência no meu navegador web?

Antes de começar

Para transferires os teus fundos, tens de configurar primeiro a ferramenta de transferência no teu navegador web. Isto requer a instalação das últimas versões de Node.js e gestor de pacotes npm:

  • Node.js: versão 22.19.0 ou posterior

  • npm: versão 10.9.3 ou posterior

Seleciona o teu sistema operativo antes de transferires

Transferir os ficheiros de instalação

  1. Transfere o arquivo do projeto aqui para a tua pasta preferida.

  2. Assim que os ficheiros do projeto forem transferidos e descomprimidos, abre a pasta com o nome Libertação da carteira-principal.

Iniciar o script de instalação

i) Utilizadores Mac

  1. Clique duas vezes em offBoarding_Mac_script.command na pasta Libertação da carteira-principal.

  2. Se vires um aviso, acede às Definições do sistema > Segurança e Privacidade > Segurança, seleciona Abrir mesmo assim > Abrir mesmo assim novamente e, depois, introduz a palavra-passe do teu Mac.

  3. Se vires um erro de acesso:

    • Clica com o botão direito na pasta Libertação da carteira-principal e seleciona Novo terminal na pasta.

    • Escreve chmod 755 offBoarding_Mac_script.command e clica em Introduzir.

    • Clica novamente duas vezes em offBoarding_Mac_script.command.

  4. Após a configuração, verás uma pasta node_modules e um ficheiro .env .

    1. No Mac, os ficheiros .env podem estar ocultos. Clica em Comando + Shift +. (ponto) para mostrar ficheiros ocultos.

  5. Atualiza o ficheiro .env na pasta Libertação da carteira-principal:

    1. Introduz a chave privada da tua carteira e o endereço (AA) da carteira de trading DEX. Se estiveres a utilizar a OKX Wallet, segue este guia para veres a chave privada da tua carteira.

    2. Para a cadeia Solana, certifica-te de que copias o endereço de controlo (existem dois endereços de trading na DEX).

    3. A chave privada da Solana deve ser fornecida no formato base58.

    4. Se estiveres a utilizar apenas EVM, podes deixar os campos Solana em branco (e vice-versa).

  6. Inicia novamente a ferramenta clicando duas vezes em offBoarding_Mac_script.command.

  7. Abre o teu navegador e acede a http://localhost:3000.

Nota: após esta configuração inicial, basta repetires o Passo 4 para voltares a executar o projeto.

ii) Utilizadores do Windows

  1. Clica duas vezes em offBoarding_Windows_script.bat na pasta Libertação da carteira-principal.

  2. Se o Windows Defender SmartScreen mostrar um aviso, seleciona Mais info > Executar mesmo assim.

  3. Se vires um erro de permissão, clica no ficheiro com o botão direito e seleciona Executar como administrador.

  4. Após a configuração, verás uma pasta node_modules e um ficheiro .env .

  5. Atualiza o ficheiro .env na pasta Libertação da carteira-principal:

    1. Introduz a chave privada da tua carteira e o endereço de carteira de trading DEX.

    2. Para a Solana: utiliza um formato de 64 bytes ou base58 válido para a chave privada.

    3. Se estiveres a utilizar apenas EVM, podes deixar os campos Solana em branco (e vice-versa).

    4. É incluído para referência um ficheiro .env.example.

  6. Inicia novamente a ferramenta clicando duas vezes em offBoarding_Windows_script.bat.

  7. Abre o teu navegador e acede a http://localhost:3000.

Nota: após esta configuração inicial, basta repetires o Passo 4 para voltares a executar o projeto.

Como posso transferir os meus tokens com a ferramenta de transferência?

  1. Vai a OKLink e seleciona a blockchain a partir da qual pretendes transferir tokens.

    Encontra a tua blockchain no separador Explorer

  2. Para a cadeia Solana, existem 2 endereços de trading DEX; copie o Endereço de armazenamento.

    Copia o endereço de armazenamento

  3. Cola o endereço no OKLink e pesquisa pelo mesmo.

    • Podes ver os saldos de tokens nativos (SOL, BNB, ETH).

      Ver saldo de tokens nativos aqui

    • Também podes ver o teu saldo de tokens fungíveis (USDT, USDC, etc.).

      Vê o saldo de tokens fungíveis aqui

  4. Se precisares de transferir tokens fungíveis, clica no token listado para encontrares o respetivo endereço do contrato e, depois, copia-o.

    Copiar endereço de contrato

  5. Na ferramenta de libertação da carteira, cola o endereço de contrato do token no campo Endereço do destinatário e introduz o montante de transferência (não deve exceder o teu saldo de tokens).

    Cola o contrato endereço do token no campo Endereço do destinatário

  6. Para transferir um token nativo, seleciona Token nativo em Tipo de ativo.

    Seleciona o Token nativo como o teu tipo de ativo

  7. Se o montante introduzido for superior ao teu saldo, a transação será imediatamente parada.

  8. Revê a taxa de gás estimada e outros detalhes da transação e, em seguida, clica em Confirmar para enviar a transação.

  9. Se for bem-sucedida, verás uma mensagem de confirmação com o hash da transação.

  10. Abre o Blockchain Explorer e introduz o hash da transação para verificares a transação.

  11. Para terminar o programa, fecha a janela do terminal aberta pelo script.

Problemas e soluções comuns

  • Chave privada inválida: certifica-te de que a chave Solana usa o formato correto (base58).

  • DEXTRADING_ADDRESS/EOA_PRIVATE_KEY não definido: verifica se o teu ficheiro .env inclui todas as variáveis necessárias.

  • Saldo insuficiente: verifica se a tua carteira tem tokens suficientes para cobrir a transferência.

  • Demasiados decimais: verifica se a precisão decimal do token corresponde à tua introdução.

  • A porta já está a ser utilizada: outro programa poderá estar a utilizar a porta 3000. Fecha outros terminais em execução ou elimina o processo.

  • Pop-up de ferramentas de programador (Mac): fecha quaisquer pop-ups a pedir para instalar ferramentas de programador. Não são obrigatórias.

  • Pop-up de instalação de software (Windows): fecha quaisquer pop-ups que te estejam a pedir para instalar software adicional.