Guia de Instalação

Este guia cobre os métodos disponíveis para instalar e executar a Cloud Service em seu sistema.

Métodos de Instalação

1. Binários Pré-compilados — Rápido e fácil para a maioria dos usuários
2. Compilar do Código-fonte — Para desenvolvedores e usuários avançados

---

Método 1: Binários Pré-compilados

Linux

# Baixar a versão mais recente
wget https://github.com/MauricioSpagnol/cloudservice/releases/latest/download/cs-linux-amd64.tar.gz

# Extrair o arquivo
tar -xzf cs-linux-amd64.tar.gz

# Mover binários para /usr/local/bin
sudo mv cs-linux-amd64/csd /usr/local/bin/
sudo mv cs-linux-amd64/cs-cli /usr/local/bin/
sudo mv cs-linux-amd64/cs-tx /usr/local/bin/

# Verificar instalação
csd --version
cs-cli --version

macOS

# Baixar manualmente
curl -LO https://github.com/MauricioSpagnol/cloudservice/releases/latest/download/cs-macos-amd64.tar.gz
tar -xzf cs-macos-amd64.tar.gz
sudo mv cs-macos-amd64/csd /usr/local/bin/
sudo mv cs-macos-amd64/cs-cli /usr/local/bin/

---

Método 2: Compilar do Código-fonte

Pré-requisitos

Instale as dependências de build do sistema (Ubuntu/Debian):

sudo apt-get update
sudo apt-get install -y \
  build-essential libtool autotools-dev automake pkg-config \
  libssl-dev libevent-dev bsdmainutils \
  libboost-system-dev libboost-filesystem-dev \
  libboost-chrono-dev libboost-program-options-dev \
  libboost-test-dev libboost-thread-dev \
  libminiupnpc-dev libzmq3-dev \
  curl wget git python3

Passos de Compilação

# Clonar o repositório
git clone https://github.com/MauricioSpagnol/cloudservice.git
cd cloudservice

# Compilar dependências (inclui Berkeley DB 6.2) — leva 10–30 min na primeira vez
DEPENDS_HOST=$(./depends/config.guess)
make -C depends -j$(nproc) HOST=$DEPENDS_HOST NO_PROTON=1

# Configurar e compilar
./autogen.sh
./configure \
  --prefix=$(pwd)/depends/$DEPENDS_HOST \
  --with-incompatible-bdb \
  --disable-tests --disable-bench --disable-gui-tests \
  --without-gui --without-miniupnpc \
  --disable-proton
make -j$(nproc)

# Instalar binários
sudo cp src/csd src/cs-cli src/cs-tx /usr/local/bin/

Baixar Parâmetros zkSNARK

O daemon requer os arquivos de parâmetros zkSNARK do Zcash (~800 MB) em ~/.zcash-params. Execute o script de download uma vez antes de iniciar o daemon pela primeira vez:

./zcutil/fetch-params.sh

Os arquivos serão salvos automaticamente em ~/.zcash-params. No macOS ficam em ~/Library/Application Support/ZcashParams.

Verificar Compilação

csd --version
cs-cli --version

---

Configuração Inicial

Após a instalação, crie um arquivo de configuração:

# Criar diretório de configuração
mkdir -p ~/.cs

# Criar arquivo de configuração
cat > ~/.cs/cs.conf << EOF
# Rede
server=1
listen=1
port=16178

# RPC
server=1
rpcuser=seu_usuario_rpc
rpcpassword=sua_senha_segura
rpcport=16180
rpcallowip=127.0.0.1

# Nó
maxconnections=128
txindex=1
EOF

# Definir permissões corretas
chmod 600 ~/.cs/cs.conf

---

Iniciando a Cloud Service

Iniciar o Daemon

# Iniciar em segundo plano
csd -daemon

# Ou iniciar em primeiro plano (para depuração)
csd

# Com configuração personalizada
csd -conf=/caminho/para/cs.conf

Verificar se está Funcionando

# Verificar conexão
cs-cli getblockchaininfo

# Obter informações da rede
cs-cli getnetworkinfo

# Verificar conexões com peers
cs-cli getpeerinfo

---

Testnet

Para executar na testnet para desenvolvimento/testes:

# Iniciar nó testnet
csd -testnet -daemon

# Comandos CLI na testnet
cs-cli -testnet getblockchaininfo

Configuração testnet:

# cs.conf para testnet
testnet=1
port=16179
rpcport=16180

---

Solução de Problemas

Problemas Comuns

Erro "Address already in use":

# Verificar se outra instância está em execução
ps aux | grep csd

# Encerrar processo existente
killall csd

Erro "Cannot connect to daemon":

# Verificar se o daemon está em execução
cs-cli getblockchaininfo

# Iniciar daemon se não estiver executando
csd -daemon

Sincronização inicial lenta:

• A sincronização inicial da blockchain pode levar várias horas
• Certifique-se de ter espaço em disco suficiente
• Considere usar um SSD para sincronização mais rápida

Logs

# Visualizar log de depuração
tail -f ~/.cs/debug.log

---

Próximos Passos

• Saiba sobre Executando um Nó
• Explore os Tipos de Nó
• Comece a Minerar CS