Hackathon oficial aprobado por la Canton FoundationPatrocinadoresTempleDigital AssetWalletAlpendCashen
Ver el calendario
HackTrail
Centro para desarrolladores

Todo lo que necesitas para desarrollar en Canton

Si empiezas desde cero, sigue los pasos en orden; si ya tienes experiencia, ve directo a la sección que necesites. Todos los enlaces llevan a recursos oficiales de Canton. Si te atascas, pregunta al asistente de HackTrail.

Primeros pasos

Tres fuentes oficiales

Todo lo que necesitas está en estas tres direcciones oficiales. Las demás secciones te llevan directo a la página correcta.

Documentación

docs.canton.network: conceptos, guías, Quickstart y referencias de API.

Abrir

Developer Hub

dev-hub.canton.foundation: herramientas, SDK y API, además de un asistente de IA que responde a partir de la documentación.

Abrir

Forum

forum.canton.network: preguntas y debates. Puede que tu pregunta ya tenga respuesta.

Abrir

Un proyecto de Canton que funciona en cinco pasos

  1. Conoce Canton

    El modelo de privacidad, las partes (parties) y quién ve qué. Esto es lo que distingue a Canton de otras cadenas.

  2. Elige tu ruta de aprendizaje

    ¿Nuevo en blockchain o vienes de Ethereum? La documentación oficial te propone una ruta a tu medida.

  3. Instala dpm

    Instala el SDK de Daml con un solo comando y crea y prueba tu primer proyecto.

  4. Ejecuta LocalNet con Quickstart

    Levanta en tu propio equipo una aplicación completa con modelo Daml, backend y frontend.

  5. Prepárate para la entrega

    Sigue la lista de verificación previa a la entrega: README, video demo y una explicación de quién ve qué.

Primera semana recomendada

Si te atascas

Canton Forum

Canal oficial de soporte: preguntas técnicas, respuestas y anuncios.

Abrir

HackTrail Telegram

Preguntas del hackathon, anuncios y búsqueda de compañeros de equipo.

Abrir
Instalación

Instalación en cuatro pasos

Avanza en orden. Para escribir Daml bastan los dos primeros pasos; para una aplicación completa, instala también Quickstart.

1. ¿Tu equipo está listo?

Para escribir y probar Daml basta un ordenador normal. Si vas a ejecutar un LocalNet completo con Quickstart, te recomendamos los valores de abajo.

Solo Daml (dpm)Quickstart y LocalNet
Memoria (RAM)8 GB16 GB o más
Procesador2 núcleos4 núcleos
Disco libre5 GB50 GB
Sistema operativomacOS, Linux, WindowsmacOS, Linux, WSL 2 en Windows
Software adicionalNingunoDocker Desktop (Compose 2.27 o posterior), direnv, Nix, curl

Asigna a Docker Desktop al menos 8 GB de memoria, idealmente 16 GB. La falta de memoria es el problema de instalación más común.

¿No quieres complicarte con la instalación? Con Seaport puedes escribir y compilar contratos Daml en el navegador y desplegarlos en DevNet. Para una prueba rápida sin Docker, basta con dpm sandbox; para un entorno local completo sin Docker en Windows y Linux, usa Raposza Tools.

2. Tu primer proyecto Daml con dpm

dpm es la herramienta oficial de línea de comandos para desarrollar en Canton: instalación del SDK, creación de proyectos, compilación, pruebas y entorno local. Sustituye a los antiguos comandos daml.

macOS y Linux
$ curl https://get.digitalasset.com/install/install.sh | sh
$ export PATH="$HOME/.dpm/bin:$PATH"   # añádelo a la configuración de tu shell para que se mantenga
$ dpm install latest
$ dpm version --all

En Windows, usa el instalador oficial. Como versión del SDK, elige la que funciona en DevNet; la tabla de compatibilidad está en el enlace de abajo.

primer proyecto
$ dpm new my-project --template daml-intro-contracts
$ cd my-project
$ dpm build     # crea el paquete DAR
$ dpm test      # ejecuta las pruebas de Daml Script
$ dpm sandbox   # ledger local de un solo participante
$ dpm studio    # Daml Studio en VS Code

3. LocalNet con Quickstart

CN Quickstart ejecuta en Docker una aplicación de ejemplo completa con modelo Daml, backend en Java, frontend en React y pagos en Canton Coin. Primero abre Docker Desktop y ejecuta docker login.

cn-quickstart
$ git clone https://github.com/digital-asset/cn-quickstart.git
$ cd cn-quickstart
$ direnv allow
$ cd quickstart          # los comandos make se ejecutan en esta carpeta
$ make setup             # elige OAuth2 activado y Observability desactivado
$ make build
$ make start
$ make capture-logs      # opcional, en otra terminal
$ make stop && make clean-all   # para apagar

La primera instalación puede tardar 30-90 minutos por la descarga del SDK. Interfaces locales: app-provider.localhost:3000, wallet.localhost:2000, scan.localhost:4000.

4. Elegir la red: LocalNet es suficiente

Puedes desarrollar y entregar tu proyecto en LocalNet, en tu propio equipo; para el jurado es suficiente. DevNet es opcional.

Herramientas de patrocinadores

Herramientas de nuestros patrocinadores

En esta sección están los productos, la documentación y los videos de formación de nuestros patrocinadores principales.

Five North

Loop Wallet y Loop SDK

Loop SDK conecta tu dApp con una billetera Loop. Los usuarios firman las transacciones en Loop Wallet en el móvil o en el navegador; toda la interacción se queda dentro de tu 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 la ventana de conexión con código QR
Five North

Seaport

Seaport es una plataforma en la nube para escribir, compilar, desplegar y gestionar contratos Daml. Trabajas en el navegador sin instalar nada; es una alternativa alojada a montar LocalNet.

Canton Coin

Herramientas

Herramientas del ecosistema

Del catálogo Developer Hub de la Canton Foundation elegimos las herramientas más útiles para el hackathon. Las descripciones son resúmenes breves; los detalles están en la página de cada herramienta. Revisa tú mismo las herramientas «Community» y de socios antes de usarlas.

Vídeos de formación de la Canton Foundation

Los vídeos se cargan desde YouTube al hacer clic. Están en inglés.

Plantillas y contratos listos

OpenZeppelin Canton Contracts

Componentes Daml reutilizables: permisos temporales y revocables y contratos pausables.

Abrir

Five North ID SDK

Verificación de identidad y gestión de credenciales con contratos inteligentes.

Abrir

Desarrollo local

Canton Builder Tool

Una herramienta de la Canton Foundation para ejecutar tu proyecto en LocalNet con pocos comandos.

Abrir

Canton DevKit

Línea de comandos e interfaz web local para gestionar LocalNet: gestión de DAR, inspección del ledger e instantáneas.

Abrir

dpm

Daml Package Manager: la herramienta oficial de línea de comandos para instalar el SDK de Daml, gestionar versiones y compilar y probar proyectos.

Abrir

Canton dAppBooster

Kit de inicio con un entorno Canton local, hooks de React, componentes de interfaz listos, soporte de billeteras y una dApp de demostración.

Abrir

Raposza Tools

Canton local en Windows y Linux sin Docker: sandbox, LocalNet y un banco de trabajo que muestra tus contratos.

Abrir

canton-deploy

Herramienta de línea de comandos para subir paquetes Daml a un validador, crear partes y ejecutar scripts.

Abrir

Conexión de billeteras

dApp SDK y Wallet SDK

SDK de navegador para dApps y SDK de integración para proveedores de billeteras.

Abrir

WalletConnect

La red que conecta billeteras compatibles con Canton con las dApps.

Abrir

PartyLayer

Conecta todas las billeteras CIP-0103 a tu dApp con una sola capa de conexión; paquetes para React, Vue y React Native.

Abrir

Datos y exploradores

Loop Data

Explorador público y gratuito con datos de la red Canton.

Abrir

CCView Explorer

Explorador que muestra la actividad de la red Canton en tiempo real.

Abrir

Noves

API de datos con transacciones, saldos y métricas de red para aplicaciones de Canton.

Abrir

Seguridad, pruebas y depuración

daml-lint

Herramienta de análisis estático que detecta patrones inseguros en contratos Daml.

Abrir en GitHub

Canton Security 101

Una guía centrada en Canton sobre seguridad en el desarrollo Daml, las aplicaciones web y la operación.

Abrir

dpm trace

Un plugin de dpm que visualiza transacciones y muestra por qué falló un envío.

Abrir en GitHub

Escribe Daml con IA

Servidor MCP de la documentación de Canton

Conecta la documentación oficial de Canton con tu asistente de IA. Dirección: docs.canton.network/mcp. No requiere autenticación.

Instalación

Canton Developer Hub

El catálogo de herramientas de la Canton Foundation y un asistente de IA que responde a partir de la documentación.

Abrir

Claude Code Daml Skill

El Claude Skill oficial de la Canton Foundation: da a tu asistente conocimiento actualizado y correcto sobre los contratos Daml en Canton.

Abrir en GitHub

CCPedia

Una base de conocimiento de Canton preparada para IA, con CIP, foro, GitHub, documentación y vídeos; también tiene un servidor MCP.

Abrir

Build-on-Canton MCP

Integración MCP de la comunidad que da a tu asistente conocimientos para desarrollar en Canton.

Abrir en GitHub

Prueba siempre el código generado por IA. Si la usaste, indícalo en el formulario de entrega.

Antes de entregar

¿En qué se fijará el jurado en tu proyecto?

Revisa esta lista antes de entregar. El jurado no tiene que instalar tu proyecto; mira el video, el repositorio y el README. La organización comprueba en la revisión previa que el proyecto funciona.

Las transacciones privadas de Daml no aparecen en los exploradores; no es un error, es el modelo de privacidad de Canton. Los exploradores solo muestran Canton Coin y transacciones de la red.

Solución de problemas

Problemas frecuentes

Instalación

Los contenedores se quedan en "unhealthy".

Casi siempre es falta de memoria. Sube la memoria de Docker Desktop a 16 GB, ejecuta make clean-all y en make setup, desactiva Observability.

Los comandos make no funcionan.

Asegúrate de ejecutar los comandos dentro de la carpeta cn-quickstart/quickstart.

Tengo errores después de actualizar Docker Desktop.

Docker Desktop 4.38.0 tiene un error conocido. Actualiza Docker Desktop a la última versión.

La descarga del SDK se cortó o está dañada.

make install-daml-sdk vuelve a descargar el SDK. La primera descarga puede tardar unos minutos.

Nix da un error de SSL.

Ocurre en redes corporativas y detrás de proxies. Si puedes, prueba en una red personal.

Las direcciones locales no se abren en el navegador.

Safari puede dar problemas con estas direcciones locales; usa Chrome o Firefox.

Desarrollo

¿Qué versión del SDK debo usar?

La que funciona en DevNet. Usa dpm version --all para ver las versiones instaladas y comprueba la versión de DevNet en la tabla de compatibilidad.

Mi transacción no aparece en el explorador.

Es normal. En Canton, las transacciones de las aplicaciones son privadas y solo las ven las partes. Los exploradores solo muestran Canton Coin y transacciones de la red.

¿Puedo usar la documentación antigua de Daml 2.x?

No. docs.daml.com describe la antigua versión 2.x. Para Canton Network, usa la documentación actual de docs.canton.network.

No puedo acceder a DevNet.

DevNet es opcional; también puedes entregar con LocalNet. Para DevNet, sigue los pasos de la guía oficial; si tienes problemas, escríbenos con "Informar de un problema" desde tu panel.

Grant

Después de HackTrail: el grant de la Canton Foundation

El Protocol Development Fund de la Canton Foundation apoya trabajos que aportan valor a largo plazo a toda la red. Los proyectos sólidos de HackTrail pueden presentarse a este programa.

¿Necesitas ayuda?
El asistente de HackTrail responde tus preguntas sobre la inscripción, el calendario y Daml.