Hackathon oficial aprovado pela Canton FoundationPatrocinadoresTempleDigital AssetWalletAlpendCashen
Ver o cronograma
HackTrail
Central do Desenvolvedor

Tudo o que você precisa para desenvolver na Canton

Se você está começando do zero, siga as etapas em ordem; se já tem experiência, vá direto à seção que precisa. Todos os links levam a recursos oficiais da Canton. Se travar, pergunte ao Assistente HackTrail.

Primeiros passos

Três fontes oficiais

Tudo o que você precisa está nesses três endereços oficiais. As outras seções levam você direto à página certa.

Documentação

docs.canton.network: conceitos, guias, Quickstart e referências de API.

Abrir

Developer Hub

dev-hub.canton.foundation: ferramentas, SDKs e APIs, além de um assistente de IA que responde com base na documentação.

Abrir

Forum

forum.canton.network: perguntas e discussões. Sua dúvida talvez já tenha resposta.

Abrir

Um projeto Canton funcionando em cinco etapas

  1. Conheça a Canton

    O modelo de privacidade, as partes (parties) e quem vê o quê. É isso que diferencia a Canton de outras redes.

  2. Escolha sua trilha de aprendizado

    Novo em blockchain ou vindo do Ethereum? A documentação oficial sugere uma trilha para você.

  3. Instale o dpm

    Instale o SDK do Daml com um comando e crie e teste seu primeiro projeto.

  4. Rode a LocalNet com o Quickstart

    Suba no seu computador um aplicativo completo com modelo Daml, backend e frontend.

  5. Prepare o envio

    Siga a lista de verificação antes do envio: README, vídeo de demonstração e uma explicação de quem vê o quê.

Primeira semana sugerida

Se você travar

Canton Forum

Canal oficial de suporte: perguntas técnicas, respostas e anúncios.

Abrir

HackTrail Telegram

Dúvidas sobre o hackathon, avisos e busca de parceiros de equipe.

Abrir
Instalação

Instalação em quatro etapas

Siga a ordem. Para escrever Daml bastam as duas primeiras etapas; para um aplicativo completo, instale também o Quickstart.

1. Seu computador está pronto?

Para escrever e testar Daml, um computador comum basta. Se você for rodar uma LocalNet completa com o Quickstart, recomendamos os valores abaixo.

Só Daml (dpm)Quickstart e LocalNet
Memória (RAM)8 GB16 GB ou mais
Processador2 núcleos4 núcleos
Disco livre5 GB50 GB
Sistema operacionalmacOS, Linux, WindowsmacOS, Linux, WSL 2 no Windows
Software adicionalNenhumDocker Desktop (Compose 2.27 ou mais recente), direnv, Nix, curl

Configure o Docker Desktop com pelo menos 8 GB de memória, de preferência 16 GB. Pouca memória é o problema de instalação mais comum.

Não quer lidar com a instalação? Com o Seaport você escreve e compila contratos Daml no navegador e os publica na DevNet. Para um teste rápido sem Docker, basta dpm sandbox; para um ambiente local completo sem Docker no Windows e no Linux, use o Raposza Tools.

2. Seu primeiro projeto Daml com o dpm

O dpm é a ferramenta oficial de linha de comando para desenvolver na Canton: instalação do SDK, criação de projeto, compilação, testes e ambiente local. Ele substitui os antigos comandos daml.

macOS e Linux
$ curl https://get.digitalasset.com/install/install.sh | sh
$ export PATH="$HOME/.dpm/bin:$PATH"   # adicione à configuração do seu shell para manter
$ dpm install latest
$ dpm version --all

No Windows, use o instalador oficial. Como versão do SDK, escolha a que roda na DevNet; a tabela de compatibilidade está no link abaixo.

primeiro projeto
$ dpm new my-project --template daml-intro-contracts
$ cd my-project
$ dpm build     # cria o pacote DAR
$ dpm test      # roda os testes de Daml Script
$ dpm sandbox   # ledger local com um participante
$ dpm studio    # Daml Studio no VS Code

3. LocalNet com o Quickstart

O CN Quickstart roda no Docker um aplicativo de exemplo completo com modelo Daml, backend em Java, frontend em React e pagamentos em Canton Coin. Primeiro abra o Docker Desktop e rode docker login.

cn-quickstart
$ git clone https://github.com/digital-asset/cn-quickstart.git
$ cd cn-quickstart
$ direnv allow
$ cd quickstart          # os comandos make rodam nesta pasta
$ make setup             # escolha OAuth2 ligado e Observability desligado
$ make build
$ make start
$ make capture-logs      # opcional, em outro terminal
$ make stop && make clean-all   # para desligar

A primeira instalação pode levar de 30 a 90 minutos por causa do download do SDK. Interfaces locais: app-provider.localhost:3000, wallet.localhost:2000, scan.localhost:4000.

4. Escolha da rede: a LocalNet basta

Você pode desenvolver e enviar seu projeto na LocalNet, no seu próprio computador; isso basta para o júri. A DevNet é opcional.

Ferramentas dos patrocinadores

Ferramentas dos nossos patrocinadores

Produtos, documentação e vídeos de treinamento dos nossos patrocinadores principais ficam nesta seção.

Five North

Loop Wallet e Loop SDK

O Loop SDK conecta seu dApp a uma carteira Loop. Os usuários assinam as transações na Loop Wallet no celular ou no navegador; toda a interação fica dentro do seu dApp.

app.js
// npm install @fivenorth/loop-sdk
import { loop } from '@fivenorth/loop-sdk';

loop.init({
  appName: 'HackTrail dApp',
  network: 'devnet',            // 'local' | 'devnet' | 'mainnet'
  onAccept: (provider) => console.log(provider.party_id),
  onReject: () => console.log('rejected'),
});

loop.connect();                     // abre a janela de conexão com QR code
Five North

Seaport

O Seaport é uma plataforma em nuvem para escrever, compilar, publicar e gerenciar contratos Daml. Você trabalha no navegador sem instalar nada; é uma alternativa hospedada à instalação do LocalNet.

Canton Coin

Ferramentas

Ferramentas do ecossistema

Do catálogo do Developer Hub da Canton Foundation, escolhemos as ferramentas mais úteis para o hackathon. As descrições são resumos curtos; os detalhes estão na página de cada ferramenta. Revise você mesmo as ferramentas "Community" e de parceiros antes de usá-las.

Vídeos de treinamento da Canton Foundation

Os vídeos carregam do YouTube quando você clica neles. Estão em inglês.

Modelos e contratos prontos

OpenZeppelin Canton Contracts

Componentes Daml reutilizáveis: permissões temporárias e revogáveis e contratos pausáveis.

Abrir

Five North ID SDK

Verificação de identidade e gestão de credenciais com contratos inteligentes.

Abrir

Desenvolvimento local

Canton Builder Tool

Uma ferramenta da Canton Foundation para rodar seu projeto no LocalNet com poucos comandos.

Abrir

Canton DevKit

Linha de comando e interface web local para gerenciar o LocalNet: gestão de DARs, inspeção do ledger e snapshots.

Abrir

dpm

Daml Package Manager: a ferramenta oficial de linha de comando para instalar o SDK Daml, gerenciar versões e compilar e testar projetos.

Abrir

Canton dAppBooster

Kit inicial com ambiente Canton local, hooks de React, componentes de interface prontos, suporte a carteiras e uma dApp de demonstração.

Abrir

Raposza Tools

Canton local no Windows e no Linux sem Docker: sandbox, LocalNet e uma bancada que mostra seus contratos.

Abrir

canton-deploy

Ferramenta de linha de comando para enviar pacotes Daml a um validador, criar partes e rodar scripts.

Abrir

Conexão de carteira

dApp SDK e Wallet SDK

SDK de navegador para dApps e SDK de integração para provedores de carteiras.

Abrir

WalletConnect

A rede que conecta carteiras compatíveis com a Canton aos dApps.

Abrir

PartyLayer

Conecta todas as carteiras CIP-0103 à sua dApp por uma única camada de conexão; pacotes para React, Vue e React Native.

Abrir

Dados e exploradores

Loop Data

Explorador público e gratuito com dados da rede Canton.

Abrir

CCView Explorer

Explorador que mostra a atividade da rede Canton em tempo real.

Abrir

Noves

API de dados com transações, saldos e métricas da rede para aplicativos Canton.

Abrir

Segurança, testes e depuração

daml-lint

Ferramenta de análise estática que procura padrões inseguros em contratos Daml.

Abrir no GitHub

Canton Security 101

Um guia focado em Canton sobre segurança no desenvolvimento Daml, em aplicações web e na operação.

Abrir

dpm trace

Um plugin do dpm que visualiza transações e mostra por que um envio falhou.

Abrir no GitHub

Escreva Daml com IA

Servidor MCP da documentação da Canton

Conecta a documentação oficial da Canton ao seu assistente de IA. Endereço: docs.canton.network/mcp. Não precisa de autenticação.

Instalação

Canton Developer Hub

O catálogo de ferramentas da Canton Foundation e um assistente de IA que responde com base na documentação.

Abrir

Claude Code Daml Skill

O Claude Skill oficial da Canton Foundation: dá ao seu assistente conhecimento atualizado e correto sobre contratos Daml na Canton.

Abrir no GitHub

CCPedia

Uma base de conhecimento da Canton pronta para IA, com CIPs, fórum, GitHub, documentação e vídeos; também tem um servidor MCP.

Abrir

Build-on-Canton MCP

Integração MCP da comunidade que dá ao seu assistente conhecimento sobre desenvolvimento na Canton.

Abrir no GitHub

Sempre teste o código gerado por IA. Se usou, informe no formulário de envio.

Antes de enviar

O que o júri vai olhar no seu projeto?

Confira esta lista antes de enviar. O júri não precisa instalar seu projeto; ele assiste ao vídeo e olha o repositório e o README. A organização confirma na verificação prévia que o projeto funciona.

Transações privadas de Daml não aparecem nos exploradores; não é um erro, é o modelo de privacidade da Canton. Os exploradores só mostram Canton Coin e transações da rede.

Solução de problemas

Problemas comuns

Instalação

Os contêineres ficam "unhealthy".

Quase sempre é falta de memória. Aumente a memória do Docker Desktop para 16 GB, rode make clean-all e, no make setup, desligue o Observability.

Os comandos make não funcionam.

Confira se você está rodando os comandos dentro da pasta cn-quickstart/quickstart.

Recebo erros depois de atualizar o Docker Desktop.

O Docker Desktop 4.38.0 tem um bug conhecido. Atualize o Docker Desktop para a versão mais recente.

O download do SDK parou no meio ou está corrompido.

make install-daml-sdk baixa o SDK de novo. O primeiro download pode levar alguns minutos.

O Nix dá erro de SSL.

Isso acontece em redes corporativas e atrás de proxy. Se possível, tente em uma rede pessoal.

Os endereços locais não abrem no navegador.

O Safari pode ter problemas com esses endereços locais; use Chrome ou Firefox.

Desenvolvimento

Qual versão do SDK devo usar?

A que roda na DevNet. Use dpm version --all para ver as versões instaladas e confira a versão da DevNet na tabela de compatibilidade.

Minha transação não aparece no explorador.

É normal. Na Canton, as transações dos aplicativos são privadas e só as partes as veem. Os exploradores só mostram Canton Coin e transações da rede.

Posso usar a documentação antiga do Daml 2.x?

Não. O docs.daml.com trata da versão antiga 2.x. Para a Canton Network, use a documentação atual em docs.canton.network.

Não consigo acessar a DevNet.

A DevNet é opcional; você também pode enviar com a LocalNet. Para a DevNet, siga as etapas do guia oficial; se tiver problemas, escreva para nós com "Relatar problema" no seu painel.

Grant

Depois do HackTrail: o grant da Canton Foundation

O Protocol Development Fund da Canton Foundation apoia trabalhos que geram valor de longo prazo para toda a rede. Projetos fortes do HackTrail podem se candidatar a este programa.

Precisa de ajuda?
O Assistente HackTrail responde suas perguntas sobre inscrição, cronograma e Daml.