Quick Start
Last updated
Last updated
Get a local Sunrise DA node, a minimal Rollkitβbased sovereign rollup, and a sample dApp running in β€ 20 minutes.
Note: For a comprehensive guide covering all aspects of building on Sunrise, including detailed module references, and advanced integration patterns, check out the .
This guide will walk you through setting up a complete development environment for building on Sunrise Layer. You'll learn how to:
Set up a local Sunrise Data Availability (DA) node
Create a minimal sovereign rollup using Rollkit
Interact with the network using the Sunrise client
Run a sample dApp that demonstrates key features
For a more comprehensive guide covering all aspects of building on Sunrise, check out the .
Before you begin, ensure you have the following tools installed:
Go
>=1.22
Build Sunrise binaries and core components
Rust + Cargo
stable
Build Rollkit demo chain and smart contracts
Node.js
>=20
Run JS client, scripts, and web applications
Docker + Docker Compose
latest
Run containerized services and development stack
(Optional) direnv
any
Automatically load environment variables in your shell
We'll create a development playground with three main components:
sunrise-da
: The core Sunrise network implementation
rollkit
: A framework for building sovereign rollups
examples
: Sample applications and integration examples
The Sunrise DA node is the foundation of the network, providing data availability services for rollups:
Tip: want it in Docker instead?
Tendermint RPC
26657
Main RPC endpoint for transactions and queries
gRPC
9090
Protocol buffer interface for advanced operations
Create and fund a test account to interact with the network:
This creates a new account named "alice" and mints 1 billion micro-RISE tokens (urise
) for testing.
Rollkit is a framework for building sovereign rollups that can use Sunrise for data availability:
The rollup automatically publishes its block data to Sunrise and retrieves DA proofs.
The Sunrise client is a JavaScript/TypeScript library for interacting with the Sunrise network. Here's how to use it:
This example demonstrates:
Connecting to a Sunrise node
Submitting a data blob
Retrieving a Merkle proof of inclusion
The example dApp demonstrates a token swap using Sunrise's liquidity pool module:
The demo UI:
connects to @sunriselayer/client
swaps testβtokens via the rollup's x/swap module
shows live balances pulled from Sunrise DA
Full client reference
Complete API documentation for @sunriselayer/client
Build a production Rollkit chain
Guide to deploying a production rollup
Validators & DA proofs
Learn about validator setup and DA proof generation
Conceptual deep dives
Understanding Sunrise's core concepts
ECONNREFUSED on port 26657
sunrised start not running or wrong RPC URL
Ensure the Sunrise node is running and accessible
Rollkit cannot post blobs
Check ~/.sunrise/config/app.toml for min-gas-prices
Verify gas price settings match network requirements
Blob tx stuck in mempool
Low gas price β use --gas-prices 0.025urise
Increase gas price to ensure transaction processing
Happy hacking! π