Ir para o conteúdo

Implemente sua appchain através do Tanssi DApp

Introdução

A Tanssi tem como objetivo reduzir a barreira de entrada para a construção de appchains descentralizadas, simplificando o processo de integração e abstraindo os detalhes técnicos do lançamento de uma appchain com tecnologia Tanssi. O Tanssi dApp permite que você inicie uma appchain em apenas alguns minutos. Este guia mostra as etapas necessárias para lançar uma appchain na Dancelight, a Tanssi TestNet, usando o Tanssi dApp.

Testes rápidos vs. appchains dedicadas

O Tanssi dApp suporta a criação de dois tipos de appchains:

  • Teste rápido: uma appchain temporária que se autodestrói após 48 horas
  • Dedicada: uma appchain de longa duração para builders do ecossistema Tanssi

Ambos os tipos se comportam de forma idêntica; a diferença é a natureza temporária do teste rápido. Em geral, o teste rápido é o melhor para quem quer experimentar uma appchain com tecnologia Tanssi. Se precisar de um ambiente de teste de longa duração, a equipe Tanssi pode ajudar a configurar uma appchain dedicada.

As capturas de tela e o conteúdo deste guia usam appchains de teste rápido, mas o processo é o mesmo para configurar uma appchain dedicada.

Painel inicial do apps.tanssi.network

Pré-requisitos

Carteiras suportadas

Como a Tanssi é construída com Substrate, você precisará de uma carteira compatível com Substrate para implantar e gerenciar sua appchain Tanssi. Carteiras suportadas:

Se você implantar uma appchain EVM com tecnologia Tanssi, os usuários poderão usar carteiras Ethereum, como MetaMask, sem precisar de carteira Substrate.

Tela de conexão para várias carteiras Substrate

Conecte sua carteira ao DApp

Para conectar sua carteira ao Tanssi dApp, clique em Connect Wallet no canto superior direito e escolha o tipo de carteira. Depois:

  1. Escolha sua conta no menu suspenso
  2. Assine a mensagem solicitada para fazer login no Tanssi dApp

Botão Connect Wallet no Tanssi dApp

Após conectar, seu endereço aparecerá no canto superior direito. Se tiver várias contas conectadas, clique no endereço para trocar.

Configure sua appchain

Na página inicial do dApp, clique em Start Building no bloco Launch Network para configurar sua appchain imediatamente. Escolha entre Quick Trial ou Dedicated. Veja as diferenças em Testes rápidos vs. appchains dedicadas.

Seção Launch Network do dApp

Em seguida, selecione o template que melhor atende ao seu caso de uso e configure as propriedades da appchain. Você pode escolher o template EVM ou Substrate ou enviar um arquivo de especificação bruta. Consulte Templates para detalhes.

Template EVM

O template EVM adiciona a camada de compatibilidade Ethereum à sua appchain Tanssi.

Você precisará de um ID de cadeia EVM exclusivo (EIP-155). Verifique se o ID está livre em Chainlist. Ao lançar em produção, abra um PR para reservar o ID no repositório ethereum-lists/chains assim que o endpoint RPC estiver ativo.

Nota

Um ID de cadeia EVM registrado é necessário apenas na MainNet. Para testes na TestNet, use qualquer ID disponível.

Para configurar:

  1. Em Network Details, informe o nome do projeto, o ID de cadeia EVM e a categoria
  2. Em Gas Token, informe o símbolo do token nativo (18 casas decimais fixas)
  3. Opcional: ajuste configurações EIP-1559 em Advanced (base fee e variação máxima)
  4. Em Accounts, forneça o endereço (estilo Ethereum) da conta sudo e o saldo inicial. Só existe uma conta sudo por vez; ela pode ser trocada depois e a rede pode migrar para um modelo descentralizado
  5. Opcional: em Advanced, clique em Add para adicionar contas e saldos de gênese
  6. Opcional: em Genesis Smart Contracts, clique em Add para incluir contratos gênese (remova 0x do bytecode)
  7. Ao finalizar o template, clique em Continue e siga para Checar saldos

Criar appchain EVM no Tanssi dApp

Template Substrate

O template Substrate traz as configurações básicas para integrar com a Tanssi e pode servir como base para uma appchain personalizada.

Para configurar:

  1. Em Network Details, informe o nome do projeto e a categoria
  2. Em Gas Token, informe decimais, símbolo e formato SS58
  3. Em Accounts, informe o endereço (estilo Substrate) da conta sudo e o saldo inicial. Só existe uma conta sudo por vez; pode ser trocada depois e a rede pode migrar para governança descentralizada
  4. Opcional: em Advanced, clique em Add para adicionar contas e saldos de gênese
  5. Clique em Continue para seguir para Checar saldos

Criar appchain Substrate no Tanssi dApp

Personalizado

Se você já possui um runtime Substrate e vai enviar um arquivo de especificação personalizado, garanta que ele possa evoluir para uma appchain Tanssi.

Seu runtime deve implementar o seguinte:

Outras exigências no runtime:

  • No módulo timestamp, defina OnTimestampSet conforme o snippet:

    type OnTimestampSet = tp_consensus::OnTimestampSet<
    <Self as pallet_author_inherent::Config>::SlotBeacon,
    ConstU64<{ SLOT_DURATION }>,
>;

  • Remova módulos de produção de blocos/consenso (Aura, Grandpa etc.), deixando a Tanssi assumir. Por exemplo, removendo:

    // Suporte a collators. A ordem destes 4 é importante e não deve mudar.
#[runtime::pallet_index(20)]
pub type Authorship = pallet_authorship;
#[runtime::pallet_index(21)]
pub type CollatorSelection = pallet_collator_selection;
#[runtime::pallet_index(22)]
pub type Session = pallet_session;
#[runtime::pallet_index(23)]
pub type Aura = pallet_aura;
#[runtime::pallet_index(24)]
pub type AuraExt = cumulus_pallet_aura_ext;

Por fim, gere e edite a especificação da cadeia, prestando atenção especial a:

  • para_id: você precisa de um ID pré-registrado; obtenha-o no passo Reserve your Network ID e retorne para prosseguir
  • is_ethereum: defina como true se precisar expor RPCs compatíveis com Ethereum

Ajuste também conforme o tipo de appchain:

{
    ...
    "relay_chain": "rococo_flashbox_relay_testnet",
    "chainType": "Live",
    "genesis": {
        "runtime": {
            ...
            "authoritiesNoting": {
                "orchestratorParaId": 1000
            },
            ...
        }
    }
    ...
}

{
    ...
    "relay_chain": "rococo-local",
    "chainType": "Live",
    "genesis": {
        "runtime": {
            ...
            "authoritiesNoting": {
                "orchestratorParaId": 0
            },
            ...
        }
    }
    ...
}

Depois, selecione o template Custom e envie o arquivo JSON de especificação bruta.

Enviar especificação customizada no Tanssi dApp

Nota

O arquivo de especificação bruta não deve exceder 2 MB.

Checar saldos

Verifique se você tem saldo suficiente. Caso não tenha, clique em Request Tokens e faça login com GitHub ou Google, responda às perguntas rápidas e solicite os tokens para a carteira conectada.

Solicitar tokens

Para appchains dedicadas, preencha o formulário de inscrição; a equipe enviará os tokens em até um dia útil.

Saldos mínimos para lançar:

Chain Balance Required
Orchestration layer 70 UNIT
Tanssi TestNet 100 SNAP
Chain Balance Required
Tanssi TestNet 100 STAR

Nota

Appchains de teste rápido usam uma camada adicional de orquestração e, portanto, requerem SNAP e UNIT. Para appchains dedicadas, apenas STAR é necessário.

Reserve seu ID de appchain

Se ainda não fez isso, você precisa reservar o seu ID de appchain Tanssi, que identificará sua cadeia dentro do ecossistema Tanssi.

Para reservar o seu ID de appchain Tanssi, será necessário enviar uma transação. Certifique-se de usar a conta com a qual pretende lançar sua appchain Tanssi ao enviar a transação.

  1. Clique em Reserve Network ID
  2. Assine a transação na sua carteira

Reservar ID da appchain no Tanssi dApp

Após a transação, o ID aparecerá no dApp; clique em Continue. Parte dos tokens UNIT (ou STAR, para appchain dedicada) ficará reservada.

ID reservado com sucesso

Gere seus arquivos de appchain

Antes de implantar, gere três arquivos:

  • A especificação da cadeia bruta - uma versão compacta do arquivo de especificação JSON, que define as configurações iniciais e o estado que todos os nós participantes da rede devem concordar para alcançar consenso e produzir blocos
  • O cabeçalho do estado gênese - define o estado inicial sobre o qual todas as transações e transições de estado são executadas
  • O Gênesis Wasm - um objeto WebAssembly (Wasm) que define a lógica de tempo de execução. Eles são gerados automaticamente com base no seu ID e configurações. Clique em Generate.

Gerar arquivos da appchain

Quando prontos, clique em Continue para o passo final.

Faça o deploy da sua appchain

No caso de teste rápido, são duas transações: registrar na camada de orquestração e na Tanssi TestNet.

Para registrar na camada de orquestração:

  1. Clique em Register em Register Network in Relay
  2. Confirme a transação na carteira

Registrar na camada de orquestração

Quando a transação for concluída com sucesso, o dApp será atualizado para mostrar que você registrou sua appchain Tanssi na seção Register Network in Relay.

Por fim, para registrar sua appchain na Tanssi, siga estas etapas:

  1. Clique em Register em Register Network in Tanssi
  2. Confirme a transação

Registrar na Tanssi

Quando a transação for concluída, o dApp exibirá o registro da appchain. No painel, você poderá acompanhar o status, blocos, endpoints RPC/WS e outras informações.

Dashboard da appchain no Tanssi dApp

E pronto! Você registrou sua appchain Tanssi. O processo de lançamento iniciará automaticamente após a verificação da equipe Tanssi. Depois de ativa, volte ao Dashboard para ver o RPC e demais dados da rede.

Última atualização: 9 de dezembro de 2025
| Criada: 9 de dezembro de 2025