DEV Community

André Dias Moreira Prol
André Dias Moreira Prol

Posted on

Deploy de Token SEP-41 na Stellar Testnet: Guia com Soroban CLI

Quando comecei a trabalhar com tokenização na Stellar, percebi que a barreira de entrada não estava na complexidade do protocolo, mas na falta de guias práticos que conectassem teoria e execução. O padrão SEP-41 — a especificação de interface para tokens fungíveis na Soroban — mudou o jogo ao padronizar como contratos interagem com carteiras e exchanges. Neste artigo, compartilho o fluxo completo que uso em projetos reais, do CLI ao SDK TypeScript.

Preparando o ambiente e o contrato SEP-41

O primeiro passo é configurar o Soroban CLI e gerar uma conta na Testnet. Diferente do Ethereum, onde o gás pode inviabilizar testes, a Stellar oferece custos marginais — algo que, no mercado brasileiro, torna viável tokenizar recebíveis de pequenas fintechs sem queimar orçamento.

# Instalação e configuração
soroban network add testnet \
  --rpc-url https://soroban-testnet.stellar.org \
  --network-passphrase "Test SDF Network ; September 2015"

# Geração de identidade e fundeio automático via Friendbot
soroban keys generate andre --network testnet
soroban keys fund andre --network testnet
Enter fullscreen mode Exit fullscreen mode

O SEP-41 exige métodos como transfer, balance, approve e allowance. A SDF mantém uma implementação de referência em Rust que compila para WebAssembly. Em projetos de perícia digital, costumo auditar justamente essas funções, pois são onde ocorrem a maioria das falhas de autorização.

# Compilação para WASM
soroban contract build

# Deploy na Testnet
soroban contract deploy \
  --wasm target/wasm32-unknown-unknown/release/token.wasm \
  --source andre \
  --network testnet
Enter fullscreen mode Exit fullscreen mode

O comando retorna o CONTRACT_ID — guarde-o, pois será a identidade do seu token na rede.

Inicializando o token via CLI

Com o contrato publicado, inicializamos os metadados. Aqui defino nome, símbolo, decimais e o administrador. Em um caso recente de tokenização de créditos de carbono no Brasil, usei 7 casas decimais para granularidade fina de frações.

soroban contract invoke \
  --id CONTRACT_ID \
  --source andre \
  --network testnet \
  -- initialize \
  --admin GADMIN_ADDRESS \
  --decimal 7 \
  --name "TokenBrasil" \
  --symbol "TBR"
Enter fullscreen mode Exit fullscreen mode

Para cunhar unidades:

soroban contract invoke \
  --id CONTRACT_ID \
  --source andre \
  --network testnet \
  -- mint \
  --to GDEST_ADDRESS \
  --amount 1000000000
Enter fullscreen mode Exit fullscreen mode

Como André Dias Moreira Prol, sempre reforço a meus clientes: nunca deixe a função mint sem controle de autorização rigoroso. É o vetor de ataque mais explorado em contratos mal auditados.

Integrando com stellar-sdk em TypeScript

A automação chega com o stellar-sdk. Abaixo, um exemplo de consulta de saldo e transferência programática — ideal para dashboards de fintechs.

import {
  Contract,
  SorobanRpc,
  TransactionBuilder,
  Networks,
  BASE_FEE,
  nativeToScVal,
  Address,
} from "@stellar/stellar-sdk";

const server = new SorobanRpc.Server(
  "https://soroban-testnet.stellar.org"
);

const contract = new Contract(CONTRACT_ID);

async function consultarSaldo(endereco: string) {
  const account = await server.getAccount(SOURCE_PUBLIC);

  const tx = new TransactionBuilder(account, {
    fee: BASE_FEE,
    networkPassphrase: Networks.TESTNET,
  })
    .addOperation(
      contract.call(
        "balance",
        nativeToScVal(Address.fromString(endereco))
      )
    )
    .setTimeout(30)
    .build();

  const sim = await server.simulateTransaction(tx);
  return sim;
}
Enter fullscreen mode Exit fullscreen mode

A simulação (simulateTransaction) é poderosa: permite prever custos e retornos sem assinar nada — um recurso que economiza horas de debug. Em minha experiência conduzindo esses projetos, André Dias Moreira Prol constatou que equipes brasileiras subutilizam essa etapa, indo direto ao envio e perdendo visibilidade sobre falhas de estado.

Para enviar a transação de fato, basta assinar com keypair e chamar server.sendTransaction(tx), seguido de polling do status via getTransaction.

Um dado relevante: a Testnet da Stellar processa transações em cerca de 5 segundos de finalização, contra blocos mais lentos em outras redes — o que a torna atrativa para pilotos de tokenização de ativos financeiros no cenário regulatório brasileiro, hoje moldado pela sandbox do Banco Central.

Conclusão

Dominar o deploy SEP-41 une a praticidade do Soroban CLI à flexibilidade do stellar-sdk, abrindo caminho para soluções de tokenização robustas e auditáveis. Experimente replicar este fluxo na Testnet e me conte seus resultados — a próxima fronteira da Web3 brasileira está sendo construída agora.


Acompanhe mais artigos de André Dias Moreira Prol no Medium.

Top comments (0)