Início Rápido

Este guia cobre a configuração do ambiente, a implantação de contratos e a interação com a testnet compatível com EVM da Plasma usando o Hardhat. Assume familiaridade básica com o ferramental Ethereum e o desenvolvimento de smart contracts.

​

Pré-requisitos

• Node.js 20+
• Conhecimento básico de desenvolvimento Ethereum
• Wallet de navegador

​

Configuração do Ambiente

Use o Hardhat para construir e implantar contratos.

​

Configuração do Hardhat

1. Crie um novo diretório de projeto e inicialize:
   mkdir my-plasma-project
   cd my-plasma-project
   npm init -y
   npm install --save-dev hardhat @nomicfoundation/hardhat-toolbox
   npm install dotenv
   npx hardhat init
   
2. Siga as etapas para criar um projeto JavaScript. Salve o projeto onde desejar. Provavelmente não precisará de um arquivo .gitignore para este início rápido.
3. Configure hardhat.config.js para a Plasma testnet:
   require("@nomicfoundation/hardhat-toolbox");
   require("dotenv").config();
   
   /** @type import('hardhat/config').HardhatUserConfig */
   module.exports = {
     solidity: "0.8.28",
     networks: {
       plasmaTestnet: {
         url: process.env.RPC_ENDPOINT,
         chainId: 9746,
         accounts: [process.env.PRIVATE_KEY] // We'll set this up next.
       }
     }
   };
   

​

Configuração da Wallet e Testnet

​

Adicione a Plasma Testnet à Sua Wallet de Navegador

1. Abra sua wallet de navegador (MetaMask, Trust Wallet ou Rabby) e clique no seletor de rede.
2. Selecione a opção para adicionar uma rede personalizada (por exemplo, Add Network, Add manually ou Add custom network).
3. Insira estes detalhes:
   • Network Name: Plasma Testnet
   • New RPC URL: https://testnet-rpc.plasma.to
   • Chain ID: 9746
   • Currency Symbol: XPL
   • Block Explorer URL: https://testnet.plasmascan.to
4. Salve a rede e mude para a Plasma Testnet em sua wallet.

​

Obtenha Tokens da Testnet

1. Copie o endereço da sua wallet a partir da wallet de navegador.
2. Visite openfaucet.org.
3. Insira seu endereço e solicite tokens da testnet.
4. Aguarde a transação ser concluída (deverá aparecer em sua wallet em alguns segundos).

​

Configure Variáveis de Ambiente

1. Exporte a chave privada da sua conta usando as configurações de conta da sua wallet de navegador.
2. Crie um arquivo .env na raiz do projeto:
   PRIVATE_KEY=your_private_key_here
   RPC_ENDPOINT=https://testnet-rpc.plasma.to
   

​

Escreva um Smart Contract Simples

1. Crie um contrato básico de armazenamento contracts/SimpleStorage.sol:
   // SPDX-License-Identifier: MIT
   pragma solidity ^0.8.28;
   
   contract SimpleStorage {
       string private storedData;
       
       event DataStored(string data);
       
       constructor() {
           storedData = "Hello, Plasma!";
       }
       
       function setData(string memory data) public {
           storedData = data;
           emit DataStored(data);
       }
       
       function getData() public view returns (string memory) {
           return storedData;
       }
   }
   
2. Compile o contrato:
   npx hardhat compile
   
   Isso deverá gerar uma saída semelhante a:
   Downloading compiler 0.8.28
   Downloading compiler 0.8.28
   Compiled 2 Solidity files successfully (evm target: paris).
   

​

Testes

1. Crie um script de teste test/SimpleStorage.js:
   const { expect } = require("chai");
   
   describe("SimpleStorage", function () {
     let simpleStorage;
   
     beforeEach(async function () {
       const SimpleStorage = await ethers.getContractFactory("SimpleStorage");
       simpleStorage = await SimpleStorage.deploy();
       await simpleStorage.waitForDeployment();
     });
   
     it("Should return the initial greeting", async function () {
       expect(await simpleStorage.getData()).to.equal("Hello, Plasma!");
     });
   
     it("Should update the stored data", async function () {
       await simpleStorage.setData("Updated data");
       expect(await simpleStorage.getData()).to.equal("Updated data");
     });
   });
   
2. Execute os testes:
   npx hardhat test
   
   Isso deverá gerar uma saída semelhante a:
   Lock
     Deployment
       ✔ Should set the right unlockTime (454ms)
       ✔ Should set the right owner
       ✔ Should receive and store the funds to lock
       ✔ Should fail if the unlockTime is not in the future
     Withdrawals
       Validations
         ✔ Should revert with the right error if called too soon
         ✔ Should revert with the right error if called from another account
         ✔ Shouldn't fail if the unlockTime has arrived and the owner calls it
       Events
         ✔ Should emit an event on withdrawals
       Transfers
         ✔ Should transfer the funds to the owner
   
   SimpleStorage
     ✔ Should return the initial greeting
     ✔ Should update the stored data
   
   
   11 passing (541ms)
   

​

Implante na Plasma Testnet

1. Primeiro, crie um diretório scripts:
   mkdir scripts
   
2. Em seguida, crie um script para implantar o contrato scripts/deploy.js:
   async function main() {
     const SimpleStorage = await ethers.getContractFactory("SimpleStorage");
     
     console.log("Deploying SimpleStorage...");
     const simpleStorage = await SimpleStorage.deploy();
     await simpleStorage.waitForDeployment();
     
     const address = await simpleStorage.getAddress();
     console.log("SimpleStorage deployed to:", address);
   }
   
   main()
     .then(() => process.exit(0))
     .catch((error) => {
       console.error(error);
       process.exit(1);
     });
   
3. Implante o contrato:
   npx hardhat run scripts/deploy.js --network plasmaTestnet
   
   Isso deverá gerar uma saída semelhante a:
   Deploying SimpleStorage...
   SimpleStorage deployed to: 0xaa4FB2A8eD6953A4e57b8097BAf048d7919e6262
   
4. Anote o endereço deployed to:. Este é o endereço do seu contrato na Plasma testnet.

​

Verifique a Implantação

1. Copie o endereço do contrato.
2. Visite o Plasma testnet explorer.
3. Pesquise pelo endereço do seu contrato para visualizar a transação de implantação.

​

Solução de Problemas