Artigo escrito por: @guilhermeboaventurarodrigues
Nesse artigo iremos abordar o Azle, o Azle é um Typescript CDK (Canister Development Kit) criado pela "demergent-labs", que nos permite desenvolver Canisters na ICP utilizando o Typescript.
Canisters é a forma que é denominado os "smarts contracts" na ICP, quando nós desenvolvemos um contrato ele é compilado em WebAssembly, e a partir daí ele é executado dentro de uma unidade computacional especial, chamada Canisters.
Pré-Requisitos:
Levando em consideração que você tenha os pré-requisitos instalados, vamo pro código!
1 - Abra seu VSCode e inicie um novo projeto.
Após iniciar um novo projeto, abra seu terminal integrado.
2 - Criando as pastas, instalando as dependencias e desenvolvendo o código.
Para começar, iremos criar uma pasta com o nome backend
mkdir backend && cd backend
Digitando esse comando, nós iremos criar uma pasta e entrar dentro dela. Você também pode fazer esses passos manualmente.
Após ter criado a pasta e entrado dentro dela, iremos criar nosso arquivo package.json, para fazer isso digite no seu terminal:
npm init -y
Nosso projeto atualmente está assim:
Pronto, package.json criado, agora é hora de instalar as dependências.
Abra seu terminal e digite:
npm install azle
Agora iremos criar o arquivo dfx.json, que vai ser responsável pelos diretórios do pŕojeto.
Para cria-ló, abra seu terminal e digite:
touch dfx.json
Dentro do arquivo dfx.json, iremos colocar o seguinte código:
{
"canisters": {
"backend": {
"type": "custom",
"build": "npx azle backend",
"root": "src",
"ts": "src/index.ts",
"candid": "src/index.did",
"wasm": "target/wasm32-unknown-unknown/release/backend.wasm"
}
}
}
Nesse código, estamos instanciando o caminho onde nós iremos desenvolver nosso Canister (ts), caminho onde nosso código compilado em wasm vai ficar (wasm), e etc.
Após terminar o nosso dfx.json, iremos criar nosso arquivo ts, onde nós iremos desenvolver nosso canister.
Abra seu terminal e digite:
mkdir src && cd src && touch index.ts
Nesse comando, estamos criando uma nova pasta chamada src, entrando dentro dela, e criando um arquivo chamado index.ts.
Nesse artigo iremos desenvolver um canister muito simples, uma função que vai retornar "Hello World".
Dentro do arquivo index.ts, digite o seguinte código:
import { Query } from 'azle';
export function hello_world(): Query<string> {
return 'Hello world!';
}
E assim ficou nosso projeto, vamos testa-lo?
3 - Executando o código
Para executar o código, iremos precisar de dois terminais.
No TERMINAL A digite:
dfx start
No terminal TERMINAL B digite:
dfx canister create backend
dfx build backend
dfx canister install backend --wasm target/wasm32-unknown-unknown/release/backend.wasm.gz
(Caso seu código estiver dado algum erro, instale o "cmake" - sudo apt install cmake)
PRONTO! Criamos e instalamos nosso canister!
Agora vamos interagir com o nosso canister, para chamar uma função, digite no TERMINAL B:
dfx canister call <nome_do_canister> <nome_da_função> <parametrôs>
No nosso caso, vai ser o seguinte comando:
dfx canister call backend hello_world
Caso estiver dado tudo certo, ele deve retornar isso pra gente:
PRONTO! Nesse artigo nós conseguimos entender o que é o Azle, criamos um Canister bem simples em Typescript, instalamos esse Canister e ainda conseguimos interagir com ele, olha que legal!
Oldest comments (0)