> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plasma.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar Ambiente de Desenvolvimento

> Configure suas ferramentas e conecte-se à Plasma para o desenvolvimento de smart contracts.

A Plasma é totalmente compatível com EVM, permitindo que você use o ferramental Ethereum padrão, ao mesmo tempo em que se beneficia de recursos otimizados para aplicações nativas de stablecoins. Para saber mais sobre os detalhes da arquitetura da Plasma, consulte a seção [Visão Geral da Arquitetura](../../plasma-chain/architecture/system-overview.mdx).

## Verifique a Conectividade RPC

Endpoints públicos de RPC estão disponíveis para ambas as redes Plasma:

```shell theme={null}
# Mainnet (recommended)
curl --location https://rpc.plasma.to --header 'Content-Type: application/json' --data '{"method":"eth_blockNumber","params":[],"id":1,"jsonrpc":"2.0"}'

# Testnet (optional)
curl --location https://testnet-rpc.plasma.to --header 'Content-Type: application/json' --data '{"method":"eth_blockNumber","params":[],"id":1,"jsonrpc":"2.0"}'
```

As respostas da mainnet serão semelhantes a:

```output theme={null}
{"jsonrpc":"2.0","id":1,"result":"0x11180f"}
```

<Tip>
  Os endpoints públicos têm limite de taxa. Para uso em produção ou requisições de alta frequência, considere usar um [provedor de RPC parceiro](../../plasma-chain/tools/rpc-providers).
</Tip>

## Configurando Ferramentas de Desenvolvimento

Abaixo estão exemplos para [Hardhat](#hardhat) e [Truffle](#truffle-configuration):

### Hardhat

Crie ou modifique seu arquivo `hardhat.config.js` para incluir ambas as redes Plasma:

```javascript theme={null}
require("dotenv").config();

module.exports = {
  networks: {
    plasmaMainnet: {
      url: process.env.MAINNET_RPC_ENDPOINT || "https://rpc.plasma.to",
      chainId: 9745,
      accounts: process.env.PRIVATE_KEY ? [process.env.PRIVATE_KEY] : []
    },
    // Optional: enable the testnet for staging.
    plasmaTestnet: {
      url: process.env.TESTNET_RPC_ENDPOINT || "https://testnet-rpc.plasma.to",
      chainId: 9746,
      accounts: process.env.PRIVATE_KEY ? [process.env.PRIVATE_KEY] : []
    }
  },
  solidity: {
    version: "0.8.28",
    settings: {
      optimizer: {
        enabled: true,
        runs: 200
      }
    }
  }
};
```

### Configuração do Truffle

Se você está usando o Truffle, atualize seu `truffle-config.js`:

```javascript theme={null}
const HDWalletProvider = require('@truffle/hdwallet-provider');

module.exports = {
  networks: {
    plasmaMainnet: {
      provider: () => new HDWalletProvider(
        "<YOUR_MNEMONIC_HERE>",
        process.env.MAINNET_RPC_ENDPOINT || "https://rpc.plasma.to",
      ),
      network_id: 9745,
      gas: 5500000,
    },
    plasmaTestnet: {
      provider: () => new HDWalletProvider(
        "<YOUR_MNEMONIC_HERE>",
        process.env.TESTNET_RPC_ENDPOINT || "https://testnet-rpc.plasma.to",
      ),
      network_id: 9746,
      gas: 5500000,
    }
  },
  compilers: {
    solc: {
      version: "0.8.28",
      settings: {
        optimizer: {
          enabled: true,
          runs: 200
        }
      }
    }
  }
};
```

## Integração com Wallet

### Integração com Web3.js

```javascript theme={null}
const Web3 = require('web3');
const web3 = new Web3(process.env.MAINNET_RPC_ENDPOINT || 'https://rpc.plasma.to');

// Check connection
web3.eth.getBlockNumber()
  .then(blockNumber => console.log('Connected to Plasma node. Current block:', blockNumber))
  .catch(error => console.error('Connection error:', error));
```

### Integração com Ethers.js

```javascript theme={null}
const { ethers } = require('ethers');
const provider = new ethers.JsonRpcProvider('https://testnet-rpc.plasma.to');

// Check connection
provider.getBlockNumber()
  .then(blockNumber => console.log('Connected to Plasma node. Current block:', blockNumber))
  .catch(error => console.error('Connection error:', error));
```

## Valide a Configuração

Crie um script simples para verificar se o seu ambiente de desenvolvimento está configurado corretamente:

```javascript theme={null}
const { ethers } = require('ethers');
require('dotenv').config();

async function testSetup() {
  // Connect to the Plasma node.
  const provider = new ethers.JsonRpcProvider('https://testnet-rpc.plasma.to');
  
  // Get network information.
  const network = await provider.getNetwork();
  console.log('Connected to network:', network);
  
  // Get current block number.
  const blockNumber = await provider.getBlockNumber();
  console.log('Current block number:', blockNumber);
  
  // Optionally, print address and balance if PRIVATE_KEY is set.
  if (process.env.PRIVATE_KEY) {
    const wallet = new ethers.Wallet(process.env.PRIVATE_KEY, provider);
    const balance = await provider.getBalance(wallet.address);
    console.log('Account address:', wallet.address);
    console.log('Balance:', ethers.formatEther(balance), 'XPL');
  } else {
    console.log('Set PRIVATE_KEY to also print address and balance.');
  }
}

testSetup()
  .then(() => console.log('Setup test completed successfully'))
  .catch(error => console.error('Setup test failed:', error));
```

## Solução de Problemas

| Problema                       | Ação                                                                                   |
| :----------------------------- | :------------------------------------------------------------------------------------- |
| **Conexão recusada**           | Confirme se o endpoint do RPC está correto e acessível                                 |
| **Falha na estimativa de gas** | Garanta que a wallet tenha XPL suficiente                                              |
| **Erro de versão do Solidity** | Atualize a configuração para corresponder à versão do compilador suportada pela Plasma |
| **Transação falha**            | Verifique a URL do RPC e o chain ID correto                                            |