Documentação
docs.canton.network: conceitos, guias, Quickstart e referências de API.
AbrirSe 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.
Tudo o que você precisa está nesses três endereços oficiais. As outras seções levam você direto à página certa.
docs.canton.network: conceitos, guias, Quickstart e referências de API.
Abrirdev-hub.canton.foundation: ferramentas, SDKs e APIs, além de um assistente de IA que responde com base na documentação.
Abrirforum.canton.network: perguntas e discussões. Sua dúvida talvez já tenha resposta.
AbrirO modelo de privacidade, as partes (parties) e quem vê o quê. É isso que diferencia a Canton de outras redes.
Novo em blockchain ou vindo do Ethereum? A documentação oficial sugere uma trilha para você.
Instale o SDK do Daml com um comando e crie e teste seu primeiro projeto.
Suba no seu computador um aplicativo completo com modelo Daml, backend e frontend.
Siga a lista de verificação antes do envio: README, vídeo de demonstração e uma explicação de quem vê o quê.
Siga a ordem. Para escrever Daml bastam as duas primeiras etapas; para um aplicativo completo, instale também o Quickstart.
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 GB | 16 GB ou mais |
| Processador | 2 núcleos | 4 núcleos |
| Disco livre | 5 GB | 50 GB |
| Sistema operacional | macOS, Linux, Windows | macOS, Linux, WSL 2 no Windows |
| Software adicional | Nenhum | Docker 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.
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.
$ 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.
$ 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
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.
$ 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.
Você pode desenvolver e enviar seu projeto na LocalNet, no seu próprio computador; isso basta para o júri. A DevNet é opcional.
Produtos, documentação e vídeos de treinamento dos nossos patrocinadores principais ficam nesta seção.
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.
// 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
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.
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.
Os vídeos carregam do YouTube quando você clica neles. Estão em inglês.
Componentes Daml reutilizáveis: permissões temporárias e revogáveis e contratos pausáveis.
AbrirVerificação de identidade e gestão de credenciais com contratos inteligentes.
AbrirUma ferramenta da Canton Foundation para rodar seu projeto no LocalNet com poucos comandos.
AbrirLinha de comando e interface web local para gerenciar o LocalNet: gestão de DARs, inspeção do ledger e snapshots.
AbrirDaml Package Manager: a ferramenta oficial de linha de comando para instalar o SDK Daml, gerenciar versões e compilar e testar projetos.
AbrirKit inicial com ambiente Canton local, hooks de React, componentes de interface prontos, suporte a carteiras e uma dApp de demonstração.
AbrirCanton local no Windows e no Linux sem Docker: sandbox, LocalNet e uma bancada que mostra seus contratos.
AbrirFerramenta de linha de comando para enviar pacotes Daml a um validador, criar partes e rodar scripts.
AbrirSDK de navegador para dApps e SDK de integração para provedores de carteiras.
AbrirA rede que conecta carteiras compatíveis com a Canton aos dApps.
AbrirConecta todas as carteiras CIP-0103 à sua dApp por uma única camada de conexão; pacotes para React, Vue e React Native.
AbrirExplorador público e gratuito com dados da rede Canton.
AbrirExplorador que mostra a atividade da rede Canton em tempo real.
AbrirAPI de dados com transações, saldos e métricas da rede para aplicativos Canton.
AbrirFerramenta de análise estática que procura padrões inseguros em contratos Daml.
Abrir no GitHubUm guia focado em Canton sobre segurança no desenvolvimento Daml, em aplicações web e na operação.
AbrirUm plugin do dpm que visualiza transações e mostra por que um envio falhou.
Abrir no GitHubConecta a documentação oficial da Canton ao seu assistente de IA. Endereço: docs.canton.network/mcp. Não precisa de autenticação.
InstalaçãoO catálogo de ferramentas da Canton Foundation e um assistente de IA que responde com base na documentação.
AbrirO Claude Skill oficial da Canton Foundation: dá ao seu assistente conhecimento atualizado e correto sobre contratos Daml na Canton.
Abrir no GitHubUma base de conhecimento da Canton pronta para IA, com CIPs, fórum, GitHub, documentação e vídeos; também tem um servidor MCP.
AbrirIntegração MCP da comunidade que dá ao seu assistente conhecimento sobre desenvolvimento na Canton.
Abrir no GitHubSempre teste o código gerado por IA. Se usou, informe no formulário de envio.
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.
daml.yaml e templates Daml de verdade: signatories, observers e choices bem estruturados.dpm build gera o pacote, dpm test passa nos testes.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.
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.
Confira se você está rodando os comandos dentro da pasta cn-quickstart/quickstart.
O Docker Desktop 4.38.0 tem um bug conhecido. Atualize o Docker Desktop para a versão mais recente.
make install-daml-sdk baixa o SDK de novo. O primeiro download pode levar alguns minutos.
Isso acontece em redes corporativas e atrás de proxy. Se possível, tente em uma rede pessoal.
O Safari pode ter problemas com esses endereços locais; use Chrome ou Firefox.
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.
É 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.
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.
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.
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.