Esse é o primeiro post da série Meu primeiro smart contract, que tem a intenção de ensinar ao longo de sete semanas alguns conceitos do solidity até construirmos um token baseado no ERC-20 com alguns testes unitários.
Nesse post vamos criar o nosso primeiro smart contract, onde você vai conseguir salvar um número no contrato e consultar esse número.
Ferramentas
Nesse começo vamos utilizar o Remix IDE para criarmos os nossos primeiros contratos.
Criando um novo arquivo
Quando abrimos o Remix já vão ter algumas pastas e arquivos criados.
Por enquanto, vamos ignorar esses arquivos e criar um novo arquivo dentro da pasta contracts chamado 00-storage.sol
Dentro do arquivo 00-storage.sol vamos definir as licenças do nosso contrato e sua versão.
A Partir da versão 0.6.8 do solidity precisamos definir uma licença para nossos contratos.
Você pode entender um pouco mais sobre licenças clicando aqui.
// SPDX-License-Identifier: GPL-3.0 // {1}
pragma solidity >=0.7.0 <0.9.0; // {2}
Na linha {1} vamos definir qual é a licença do nosso contrato.
Na linha {2} vamos definir em qual versão do solidity nosso contrato vai ser desenvolvido.
Para começarmos a criar o nosso contrato precisamos dar um nome para ele, para fazer isso dentro do solidity é da seguinte forma:
contract Storage {...}
Dentro das {} é onde vamos definir as regras do contrato.
Organização do código
Não existe uma forma certa de estruturar o código dos nossos contratos, mas para facilitar o entendimento vamos utilizar o seguinte padrão:
- Properties: Onde vamos definir as nossas variáveis;
- Constructor: Onde vamos definir nosso construtor, (nesse post vamos entender para que serve);
- Public Functions: Onde vamos definir nossas funções públicas;
O solidity é uma linguagem fortemente tipada, isso quer dizer que temos que informar qual é o tipo (type) dos nossos objetos e variáveis no momento de sua declaração.
Caso queira entender um pouco mais sobre tipagem no solidity clique aqui
Variáveis
Vamos começar criando uma variável para armazenar um número inteiro dentro do nosso contrato, para criar uma uma variável no solidity precisamos passar o tipo (type) da variável, definir se ela é pública ou privada e o nome da variável.
Então vamos criar uma variável privada chamada numeroDev que vai ser do tipo (type) int.
contract Storage {
// Properties
int private numeroDev;
}
Por padrão as variáveis no solidity são públicas, então se você só informar o tipo (type) da variável e seu nome, ela vai ser pública.
Construtor
Vamos agora criar o nosso constructor, que basicamente é uma função especial usada para inicializar variáveis de estado em um contrato.
O construtor é chamado quando o nosso contrato é criado pela primeira vez e podemos utilizá-los para definir seus valores iniciais.
Então vamos definir que numeroDev vai ser igual a 5 inicialmente.
// Constructor
constructor() {
numeroDev = 5;
}
Funções
As funções são blocos de códigos reutilizáveis que podem ser chamadas em qualquer lugar do seu contrato. Isso elimina a necessidade de escrevermos o mesmo código repetidas vezes.
No solidity existe três tipos de funções as funções puras, as de visualização e as de modificação.
Funções puras: São funções que não lê ou modifica algum dado da blockchain. Todos os dados com os quais as funções puras estão relacionadas são passadas ou definidas no escopo da função.
Quando temos uma função pura temos que declarar isso, para fazer isso basta colocarmos pure na frente do nome da função.
Funções de visualização: São funções que servem somente para leitura e não modificam nenhum dado da blockchain.
Quando temos uma função de visualização temos que declarar isso, para fazer isso basta colocarmos view na frente do nome da função.
Funções de modificação: São funções que servem para mudar algum dado dentro da blockchain.
Igual as variáveis precisamos definir se nossas funções são públicas ou privadas. Se nossa função retornar alguma coisa precisamos informar qual é o tipo (type) desse retorno.
Para fazer isso basta colocarmos returns (type) na frente do nome da função.
Vamos criar duas funções:
-
get()que vai ser uma função pública do tipoviewe vai retornar o valor da variávelnumeroDevque é do tipo inteiro. -
storeque vai ser uma função pública do modificação, que recebe como parâmetro um número inteiro, e dentro dele vamos fazer a soma denumeroDev+num.
// Public Functions
function get() public view returns (int) {
return numeroDev;
}
function store(int num) public {
numeroDev = numeroDev + num;
}
Nosso código até agora
Se você você chegou até aqui seu contrato vai estar mais ou menos assim:
// SPDX-License-Identifier: GPL-3.0 // {1}
pragma solidity >=0.7.0 <0.9.0; // {2}
contract Storage {
// Properties
int private numeroDev;
// Constructor
constructor() {
numeroDev = 5;
}
// Public Functions
function get() public view returns (int) {
return numeroDev;
}
function store(int num) public {
numeroDev = numeroDev + num;
}
}
Executando nosso contrato
Agora no Remix IDE vamos compilar e realizar o deploy do nosso contrato 00-storage.sol.
No menu lateral esquerdo clique em "Solidity compiler".
Clique no botão "Compile 00-storage.sol".
No menu lateral esquerdo clique em "Deploy & run transactions".
Clique no botão "Deploy".
Clique na seta para vermos as funções do nosso contrato.
Clique em "get" para executar a função.
Passe um número no input e clique em "store" para executar a função.
Clique em "get" para executar a função para conferirmos se o valor que passamos foi somado com o valor inicial.
Conclusão
Esse foi o primeiro post da série de posts "Meu primeiro smart contract".
Se você realizou todas as etapas acima, agora você tem um smart contract simples que é possível salvar um dado e consultar esse dado.
Se você gostou do conteúdo e te ajudou de alguma forma, deixe um like para ajudar o conteúdo a chegar para mais pessoas.
Link do repositório
https://github.com/viniblack/meu-primeiro-smart-contract
Vamos trocar uma ideia ?
Fique a vontade para me chamar para trocarmos uma ideia, aqui embaixo está meu contato.
Latest comments (0)