Solana Dev 101 — Crie tokens SPL na Solana

Visão geral do projeto

Os tokens são os elementos fundamentais de uma economia digital. Entender o que são e como trabalhar com eles é essencial para compreender plenamente o poder das blockchains. Neste post, mostramos como fazer isso.

Neste tutorial, vamos orientar você pelo processo de criação de tokens personalizados da Solana usando a interface de linha de comando da Solana (CLI). Você aprenderá as três etapas principais para criar um token personalizado na Solana: criar o token, criar a conta do token e emitir um suprimento do token. Ao final deste tutorial, você terá o conhecimento e as habilidades necessários para criar seus próprios tokens da Solana e começar a experimentar com a blockchain Solana.

Além da experiência com a CLI, também apresentaremos três métodos alternativos para criar tokens personalizados da Solana de forma rápida e fácil. Assim, você terá várias opções para escolher de acordo com suas preferências e necessidades.

*Para saber mais sobre a criação personalizada usando uma configuração JavaScript ou TS, consulte a documentação da Solana aqui: https://spl.solana.com/token

Pré-requisitos

Primeiro, precisamos instalar alguns programas em nossa estação de trabalho para começar a criar os tokens. Você pode abrir o terminal em sua estação de trabalho para executar estes comandos. Se já tiver esses programas, pode pular esta etapa.

1. Instale o Rust:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

2. Instale a Solana CLI:

cargo install solana-cli

Após a instalação, você pode verificar se a Solana CLI foi instalada executando o seguinte comando:

solana --version

O comando deve retornar um resultado semelhante ao mostrado abaixo:

solana-cli 1.15.2 (src:dea65f48; feat:1211687720, client:SolanaLabs)

Com tudo configurado, podemos continuar!

Configuração do ambiente

Primeiro, precisamos configurar três itens em nosso ambiente.

1. A rede padrão que usaremos (Mainnet ou Devnet).
2. A carteira padrão que usaremos para criar os tokens.
3. Solana da Devnet para financiar este teste.

1. Rede

Nesta etapa, podemos usar os RPCs padrão da Solana. Você pode obter um gratuitamente no portal para desenvolvedores da Helius aqui.

As duas opções disponíveis são:

1. Mainnet - https://rpc.helius.xyz/?api-key=<api_key>
2. Devnet - https://rpc-devnet.helius.xyz/?api-key=<api_key> 

Depois de obter nosso RPC, podemos defini-lo no ambiente usando o seguinte comando:

solana config set --url https://api.devnet.solana.com

Isso definirá nossa rede padrão como Devnet na CLI para o teste. Você deverá ver o seguinte no console:

Config File: /Users/user/.config/solana/cli/config.yml
RPC URL: https://api.devnet.solana.com
WebSocket URL: wss://api.devnet.solana.com/ (computed)
Keypair Path: ./RwUUVWjmSycerjAFep7v9d1R1sioF45cYAUpeJtcQbZ.json
Commitment: confirmed

Ao ver essa confirmação, podemos seguir para a próxima etapa.

2. Carteira

Nesta etapa, podemos configurar a carteira padrão usada no teste. Para isso, criaremos uma nova carteira para o teste e a definiremos como padrão para a Solana CLI.

Para criar uma nova carteira, execute o seguinte comando:

solana-keygen new -o ${HOME}/token-wallet.json

Isso criará um novo arquivo wallet-name.json fora do seu diretório inicial.

Agora você verá o seguinte no console:

Wrote new keypair to /Users/user/token-wallet.json
====================================================================================
pubkey: EbcgsUzSEgiZm61Ch66hKUWhoUg3DGvDaqwQBMLaBgTg
====================================================================================
Save this seed phrase and your BIP39 passphrase to recover your new keypair:
switch anchor code opera purpose easy squeeze enough steal pelican enroll switch
====================================================================================

Agora podemos definir essa carteira como nosso endereço padrão executando o seguinte comando:

solana config set --keypair ${HOME}/token-wallet.json

Agora você pode executar o seguinte comando para confirmar que a chave pública foi configurada corretamente.

solana address

Em nosso caso, o resultado é:

EbcgsUzSEgiZm61Ch66hKUWhoUg3DGvDaqwQBMLaBgTg

Agora que configuramos nossa carteira padrão, podemos solicitar fundos para o teste.

3. Fundos para o teste

Aqui, faremos um airdrop da quantidade de Solana da Devnet necessária para a criação usando a Solana CLI.

Podemos executar o seguinte comando no terminal para obter a quantidade necessária:

solana airdrop 2

Agora podemos verificar o saldo da carteira executando o seguinte comando:

solana balance

O console deve retornar 2 SOL.

Se não funcionar, tente mais algumas vezes, pois a solicitação pode ter falhado inicialmente. Se ainda não funcionar, tente novamente.

Assim que você tiver SOL em sua carteira da Devnet, poderemos continuar com a criação dos tokens.

Etapas para criar tokens pela CLI

Agora que nosso ambiente está configurado, podemos começar a criar tokens! Depois dessas configurações, o processo é bastante rápido.

Estas são as etapas necessárias:

1. Criar o token.
2. Criar a conta do token.
3. Emitir o token.

Veja abaixo uma representação visual da configuração:

Vamos entender isso melhor:

1. O Programa de Tokens é usado para criar, transferir e emitir tokens adicionais.
2. O usuário interage com o Programa de Tokens para criar um token. Esse programa também é usado para emitir suprimento adicional e transferir tokens.
3. Depois que o token é criado, também é possível criar uma conta para armazená-lo.

‍‍Agora vamos para a primeira etapa: criar o token.

1. Criar o token

Execute o seguinte comando para criar o token:

spl-token create-token

Em nosso caso, o resultado é o seguinte:

Creating token Ax3nE7fAEuZsbN9HHEpuBpoYeYy7NZ3dgjRG8GXdFqto under program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA

Address:  Ax3nE7fAEuZsbN9HHEpuBpoYeYy7NZ3dgjRG8GXdFqto
Decimals:  9

Signature: 56pRzvMBxJQqti4Fh5wPsa5Hb7KzJaWzEFNcAFYPaH7vN7a2CBmM1wbYxTvNVZr9Cvupy25X2oHtrGhhEhww9ug5

2. Criar a conta do token

Agora podemos criar a conta que armazenará o suprimento do token.

Podemos configurar a conta do token Ax3nE7fAEuZsbN9HHEpuBpoYeYy7NZ3dgjRG8GXdFqto executando o seguinte comando no terminal e informando o endereço do token:

spl-token create-account Ax3nE7fAEuZsbN9HHEpuBpoYeYy7NZ3dgjRG8GXdFqto

Isso cria uma conta para armazenar o token Ax3nE7fAEuZsbN9HHEpuBpoYeYy7NZ3dgjRG8GXdFqto e deve gerar o seguinte resultado: 

Creating account 7jZDrZqRkVzu5ADtKvNGsTyPcCpcMVkxorMRJvCaUAD

Signature: EkR353vt9ST3ktyRsCRtYFqVvARaUBmUpWLfgFtsojBRbW66dK1yaCpW1NtphCQTkcGqzVQZg4Ld2abZ3bhsjA3

Agora temos uma conta de token e podemos começar a emissão!

3. Emitir tokens

Agora estamos prontos para emitir e definir um suprimento para nosso token. Como estamos fazendo isso na Devnet, vamos demonstrar o verdadeiro poder da Solana emitindo 1 milhão de tokens.

Podemos fazer isso executando o seguinte comando, com o endereço do token após o comando spl-token mint:

spl-token mint Ax3nE7fAEuZsbN9HHEpuBpoYeYy7NZ3dgjRG8GXdFqto 1000000

Isso produzirá o seguinte resultado no terminal:

Minting 1000000 tokens
  Token: Ax3nE7fAEuZsbN9HHEpuBpoYeYy7NZ3dgjRG8GXdFqto
  Recipient: 7jZDrZqRkVzu5ADtKvNGsTyPcCpcMVkxorMRJvCaUAD

Signature: 4EjB9bDC18Cut66frGWVHAxVQ3YrddaUCQcFZZsXbKXLziCAUtdh5r41tVhvP7yH1dZ5TBUaFXHpm2upaNCw3sMe

Agora podemos executar o seguinte comando para confirmar que os tokens foram emitidos:

spl-token supply Ax3nE7fAEuZsbN9HHEpuBpoYeYy7NZ3dgjRG8GXdFqto

O comando retornará:

1000000

Agora emitimos 1 milhão de tokens na Solana usando a Solana CLI.

Resultados

Recapitulando: acabamos de emitir 1 milhão de tokens usando a ferramenta spl-token da Solana CLI. Fizemos isso com três comandos na Solana CLI.

1. Criar o token.
2. Criar a conta do token.
3. Emitir o token.

Se quiser verificar o saldo de sua carteira Solana após emitir 1.000.000 de tokens, execute:

solana balance

Se você começou com o airdrop inicial de 2 SOL, o comando retornará:

1.99647912 SOL

E pronto!

A Solana permite escalar o suprimento de tokens por uma fração do custo.

Se você seguiu estas etapas, agora pode criar um token com eficiência usando a ferramenta spl-token da Solana CLI.

Ferramentas disponíveis para criar tokens

Como prometido, aqui estão algumas ferramentas que você pode usar AGORA MESMO para criar um token com metadados por uma fração do custo. Em cada exemplo, usarei Monopoly Money para criar o token e mostrarei as opções de distribuição disponíveis em seguida.

1. Famous Fox Federation

Essa ferramenta está disponível há cerca de seis meses e custa 0,03 SOL por uso. É um custo muito baixo quando comparado ao valor necessário para criar alguns milhões de tokens em outra blockchain.

Veja uma análise detalhada da FFF:

1. Verifique se o token SPL está selecionado aqui.
2. Definir as casas decimais como 0 criará um token no padrão WL.
3. Você pode desativar a emissão futura de suprimento aqui. Caso contrário, ela permanecerá disponível.
4. Depois, você pode usar uma ferramenta como o Foxy Share para distribuir seus tokens por um custo baixo. Neste exemplo, criei um token de teste e usarei a seção de tokens para enviá-lo a:

2. Squads

Squads é outra interface fácil de acessar e disponível por uma fração do custo. Veja as etapas para criar um token depois de entrar em uma conta do Squads:

1. Acesse a aba Developers —> e depois vá para o Token Manager.

     2. Nessa tela, selecione Add Token, depois Create Token e insira os detalhes do token (o suprimento será adicionado posteriormente).

    3. Agora podemos informar as casas decimais do token. Neste teste, usaremos 9:

    4. Depois de aprovar e executar a transação no Squads, você verá uma configuração semelhante a esta:

    5. Depois de selecionar Mint, informe a quantidade que deseja criar para esse suprimento, como demonstrado abaixo:

    6. Agora você deverá ver outra transação para aprovar no Squads. Depois da aprovação, você verá o suprimento de tokens que definimos, conforme mostrado abaixo:

Agora você criou um token com um suprimento de 1 milhão usando o Squads!

Depois, você pode configurar uma transação personalizada na seção “TX Builder” para transferir tokens. Porém, não abordarei isso aqui, pois a explicação detalhada pode ser extensa.

Essa opção custou cerca de 0,00561672 SOL para a emissão, o mesmo que a opção com a Solana CLI.

3. Strata Protocol

Esta é outra alternativa para criar tokens na Solana.

1. Comece selecionando a opção “Create New Token” e clique em Next:

     2. Selecione “Self Managed” como opção de gerenciamento:‍

      3. Agora você pode conectar sua carteira Solana para financiar a transação e inserir abaixo os detalhes do token:

Essa transação custa apenas 0,00458 SOL para criar 1 milhão de tokens, o que ainda representa uma fração do valor da Solana e está no mesmo nível dos concorrentes. Se você ainda não tiver nenhum token SHDW Storage, a ferramenta tentará fazer um swap para obtê-lo.

Recursos extras da Strata:

A Strata também oferece outras ferramentas muito interessantes na página principal, como:

1. Token Manager - Você pode aumentar o suprimento e atualizar as autoridades de emissão e congelamento de cada token.
2. Sell Existing Token - Você pode definir um preço ou mecanismo de descoberta para o token que deseja vender.
3. Fundraise - Arrecade fundos para uma causa e use o token para representar as contribuições.

Conclusão

Agora você tem algumas opções para criar um token na Solana que são escaláveis tanto em custo quanto na quantidade necessária de tokens. É possível escalar esses exemplos sem que o custo para colocar esses ativos on-chain e deixá-los prontos para distribuição mude muito.

Todos os exemplos apresentados demonstram o verdadeiro poder da Solana e podem ser usados por criadores que não têm tanto conhecimento técnico quanto imaginavam ser necessário.

Qualquer pessoa pode criar tokens na Solana com uma CLI simples em três etapas ou usar diferentes soluções concorrentes com custo igualmente baixo e recursos adicionais que facilitam a interação.

Se tiver dúvidas ou encontrar algum problema, fique à vontade para entrar no Discord da Helius!

‍