Left Curve

This is a monorepo containing a number of Left Curve Software products:

Name	Language	Description
book	Markdown	documentation, created with mdBook
dango	Rust	a suite of DeFi application smart contracts
grug	Rust	an execution environment for blockchains
hyperlane	Rust	implementation of the Hyperlane cross-chain messaging protocol in Grug
indexer	Rust	indexer and server infrastructure
sdk	TypeScript	an SDK for interacting with Grug chains
ui	TypeScript	a web interface for accessing Dango

How to use

Prerequisites:

• Rust 1.80+
• Node.js 23.0+
• pnpm
• Just
• Docker

We use VS Code as text editor with the following plugins:

• Biomejs
• Code Spell Checker
• Dependi
• EditorConfig
• Error Lens
• Even Better TOML
• GraphQL: Language Feature Support
• LaTeX Workshop
• Markdown All in One
• markdownlint
• rust-analyzer
• solidity
• Todo Tree
• Trailing Spaces

Rust

Install the grug command line software:

just install

Run tests:

just test

Lint the code:

just lint

Compile and optimize smart contracts:

just optimize

TypeScript

Before running any command is necessary to run:

pnpm install

Start the development mode for dango and grug sdk:

pnpm dev:sdk

Start the development mode for the app located in the ui/portal/web directory:

pnpm dev:portal-web

Build Grug and Dango SDK:

pnpm build:sdk

Build Portal Website:

pnpm build:portal-web

Run tests:

pnpm test

Run linter:

pnpm lint

Generate documentation:

pnpm doc

Generate translations:

pnpm machine-translate

Storybook:

pnpm storybook

Agent Guide

• Contributor handoff: see AGENTS.md for a generic, evergreen guide.
• Telemetry playbook (OTLP + Sentry): see telemetry.md.

Book

Install dependencies:

cargo install mdbook@0.5.2
cargo install mdbook-katex@0.10.0-alpha

Generate book:

mdbook build

Copyright

© 2024-2025 Left Curve Software. All rights reserved.

This repository and all its contents, including but not limited to source code, documentation, specifications, and associated materials (collectively, the "Software") are proprietary to Left Curve Software Limited (the "Company") and are provided for informational purposes only. No license, express or implied, is granted. No part of the Software may be modified, forked, distributed, sublicensed, or used in any manner, for commercial or non-commercial purpose, without express written permission of the Company.