Skip to content

Repository files navigation

Snowside

Snowside — Interactive Tour

CI Suite Codecov License: MIT Built with Astro Deployed on Cloudflare Pages

What is Snowside?

Snowside is a dedicated Avalanche Layer-1 blockchain built for the eCash hard-fork. It runs as a clean EVM sidechain where the native gas token is ECX — no new tokens, no pre-mine, just eCash security via Blind Merged Mining (BIP-301) on a Drivechain.

▶ Take a Tour → — a guided, visual walkthrough of how Snowside works end to end.

Key Features

  • Native ECX gas — transaction fees paid in ECX via Blind Merged Mining (BIP-301)
  • Drivechain-native — BIP-300/301 hash-rate escrows are first-class, not bolted on
  • Sub-second finality — Avalanche Snowman consensus
  • USDC bridging — native Interchain Messaging (ICM) from C-Chain
  • Full EVM compatibility — Remix, Hardhat, Foundry work out-of-the-box
  • Operational automationNodΞRunr handles deployment & monitoring
  • No token. No ICO. — infrastructure, not an investment vehicle

Deployed Endpoints

All packages are deployed to Cloudflare Pages / Workers by the Guardian CI Suite on every push to master.

Package URL Description
packages/web snowside.network Main website (Astro)
packages/pitch pitch.snowside.network Grant pitch page (Astro, noindex)
packages/canvas canvas.snowside.network Lean Canvas viewer (Astro)
packages/docs docs.snowside.network Technical documentation (Astro + Starlight)
packages/explorer explorer.snowside.network EVM block explorer (Astro + Pages Functions)
packages/bridge bridge.snowside.network BIP-300/301 bridge UI (Astro)
packages/tour tour.snowside.network Interactive tour slideshow (Slidev)
packages/api snowside.network/v1 OpenAPI + Esplora proxy (Cloudflare Worker, Hono + Chanfana)

Network RPC Endpoints (Avalanche L1)

Network Chain ID RPC URL
Mainnet 32904 (0x8088) https://rpc.snowside.network/mainnet
Testnet 33160 (0x8188) https://rpc.snowside.network/testnet
Signet 33416 (0x8288) https://rpc.snowside.network/signet

Documentation

Repository Structure

The Snowside monorepo uses language-specific top-level directories:

packages/          — JavaScript/TypeScript (pnpm workspace)
  web/             — Main website (Astro)
  pitch/           — Grant pitch page (Astro, noindex)
  canvas/          — Lean Canvas viewer (Astro static)
  docs/            — Documentation site (Astro + Starlight)
  explorer/        — EVM block explorer (Astro + CF Pages Functions)
  bridge/          — Bridge UI (Astro + Tailwind v4)
  api/             — Cloudflare Worker (Hono + Chanfana OpenAPI)
  tour/            — Interactive slideshow (Slidev + UnoCSS)
  federation/      — Custodial federation service (Node.js + viem)

go/                — Go packages
  subnet-evm/      — Subnet-EVM fork with BMM coordination precompile

rust/              — Rust packages
  bmm-bidder/      — BMM bidder and settlement monitor

contracts/         — Solidity smart contracts (Foundry)
  src/interfaces/  — Solidity interfaces for precompiles
  src/peg/          — ECX peg contract (deposits/withdrawals)
  src/fees/         — Contract fee distribution
  test/             — Foundry tests
  script/           — Deployment scripts

genesis/           — L1 genesis JSON files (patched per network)

docs/              — Documentation and handoff notes (HANDOFF.md)

CI/CD

The Guardian CI Suite runs on every push/PR to master. Each package has its own labeled build job (quality gate) and a deploy job that gates on the build — deploys run only on merged master commits (PRs build but never deploy). All 7 Cloudflare Pages packages are disconnected from CF Pages git integration, so this workflow is the sole deploy path.

Coverage reporting is configured via Codecov with informational: true status (never fails CI on coverage drops). Test suites are being added incrementally — the API Worker has the first suite (packages/api/test/); coverage uploads will slot into the existing build jobs as each package gains tests.

Required GitHub Secrets

Secret Used by
CLOUDFLARE_API_TOKEN All 8 deploy jobs (Pages:Edit + Workers Scripts:Edit)
CLOUDFLARE_ACCOUNT_ID All 8 deploy jobs
CODECOV_TOKEN Coverage upload steps (active once tests exist per package)

Build

Package Build Command
web cd packages/web && pnpm build
pitch cd packages/pitch && pnpm build
canvas cd packages/canvas && pnpm build
docs cd packages/docs && pnpm build
explorer cd packages/explorer && pnpm build
bridge cd packages/bridge && pnpm build
tour cd packages/tour && pnpm build
api cd packages/api && pnpm run deploy --dry-run
subnet-evm cd go/subnet-evm && ./scripts/build.sh
bmm-bidder cd rust/bmm-bidder && cargo build
contracts cd contracts && forge build
root (web→pitch→canvas) pnpm run build

Status

Active development. Mainnet L1 infrastructure in progress; ICTT (USDC bridging) is the next milestone.

Links

License

Released under the MIT License. Snowside is open source — free to use, modify, and distribute. No token, no ICO, no warranty.

Snowside

About

Snowside — A dedicated Avalanche EVM L1/Subnet for eCash.com. Native BTC gas, blind merged mining, USDC bridging via ICM.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages