{"id":16063086,"url":"https://github.com/left-curve/left-curve","last_synced_at":"2026-05-02T23:06:27.211Z","repository":{"id":215193913,"uuid":"736464611","full_name":"left-curve/left-curve","owner":"left-curve","description":"The Left Curve Stack","archived":false,"fork":false,"pushed_at":"2025-02-05T02:14:30.000Z","size":31440,"stargazers_count":97,"open_issues_count":25,"forks_count":15,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-02-05T09:13:33.647Z","etag":null,"topics":["blockchain","cryptocurrency","defi","smart-contracts","web3"],"latest_commit_sha":null,"homepage":"https://grug.build","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/left-curve.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-12-28T01:37:54.000Z","updated_at":"2025-02-05T02:14:33.000Z","dependencies_parsed_at":"2024-03-21T16:27:26.283Z","dependency_job_id":"0d29252c-36f9-44e1-9f1c-b5e390b33329","html_url":"https://github.com/left-curve/left-curve","commit_stats":null,"previous_names":["cwsoftware123/cwd","left-curve/grug","left-curve/left-curve"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/left-curve%2Fleft-curve","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/left-curve%2Fleft-curve/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/left-curve%2Fleft-curve/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/left-curve%2Fleft-curve/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/left-curve","download_url":"https://codeload.github.com/left-curve/left-curve/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237689171,"owners_count":19350904,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blockchain","cryptocurrency","defi","smart-contracts","web3"],"created_at":"2024-10-09T05:01:08.930Z","updated_at":"2026-05-02T23:06:27.205Z","avatar_url":"https://github.com/left-curve.png","language":"TypeScript","funding_links":[],"categories":["Rust"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"book/left-curve.svg\" width=\"150\" styles=\"\"\u003e\n\u003c/div\u003e\n\n# Left Curve\n\nThis is a [monorepo](https://en.wikipedia.org/wiki/Monorepo) containing a number of [Left Curve Software](https://x.com/leftCurveSoft) products:\n\n| Name                      | Language   | Description                                                                                      |\n| ------------------------- | ---------- | ------------------------------------------------------------------------------------------------ |\n| [book](./book/)           | Markdown   | documentation, created with [mdBook](https://rust-lang.github.io/mdBook/)                        |\n| [dango](./dango/)         | Rust       | a suite of DeFi application smart contracts                                                      |\n| [grug](./grug/)           | Rust       | an execution environment for blockchains                                                         |\n| [hyperlane](./hyperlane/) | Rust       | implementation of the [Hyperlane](https://hyperlane.xyz/) cross-chain messaging protocol in Grug |\n| [indexer](./indexer/)     | Rust       | indexer and server infrastructure                                                                |\n| [sdk](./sdk/typescript/)  | TypeScript | an SDK for interacting with Grug chains                                                          |\n| [ui](./ui/)               | TypeScript | a web interface for accessing Dango                                                              |\n\n## How to use\n\nPrerequisites:\n\n- [Rust](https://rustup.rs/) 1.80+\n- [Node.js](https://nodejs.org/en/download/) 23.0+\n- [pnpm](https://pnpm.io/)\n- [Just](https://just.systems/man/en/)\n- [Docker](https://docs.docker.com/engine/install/)\n\nWe use [VS Code](https://code.visualstudio.com/) as text editor with the following plugins:\n\n- [Biomejs](https://marketplace.visualstudio.com/items?itemName=biomejs.biome)\n- [Code Spell Checker](https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker)\n- [Dependi](https://marketplace.visualstudio.com/items?itemName=fill-labs.dependi)\n- [EditorConfig](https://marketplace.visualstudio.com/items?itemName=EditorConfig.EditorConfig)\n- [Error Lens](https://marketplace.visualstudio.com/items?itemName=usernamehw.errorlens)\n- [Even Better TOML](https://marketplace.visualstudio.com/items?itemName=tamasfe.even-better-toml)\n- [GraphQL: Language Feature Support](https://marketplace.visualstudio.com/items?itemName=GraphQL.vscode-graphql)\n- [LaTeX Workshop](https://marketplace.visualstudio.com/items?itemName=James-Yu.latex-workshop)\n- [Markdown All in One](https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one)\n- [markdownlint](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint)\n- [rust-analyzer](https://marketplace.visualstudio.com/items?itemName=rust-lang.rust-analyzer)\n- [solidity](https://marketplace.visualstudio.com/items?itemName=JuanBlanco.solidity)\n- [Todo Tree](https://marketplace.visualstudio.com/items?itemName=Gruntfuggly.todo-tree)\n- [Trailing Spaces](https://marketplace.visualstudio.com/items?itemName=shardulm94.trailing-spaces)\n\n### Rust\n\nInstall the `grug` command line software:\n\n```shell\njust install\n```\n\nRun tests:\n\n```shell\njust test\n```\n\nLint the code:\n\n```shell\njust lint\n```\n\nCompile and optimize smart contracts:\n\n```shell\njust optimize\n```\n\n### TypeScript\n\nBefore running any command is necessary to run:\n\n```shell\npnpm install\n```\n\nStart the development mode for dango and grug sdk:\n\n```shell\npnpm dev:sdk\n```\n\nStart the development mode for the app located in the `ui/portal/web` directory:\n\n```shell\npnpm dev:portal-web\n```\n\nBuild Grug and Dango SDK:\n\n```shell\npnpm build:sdk\n```\n\nBuild Portal Website:\n\n```shell\npnpm build:portal-web\n```\n\nRun tests:\n\n```shell\npnpm test\n```\n\nRun linter:\n\n```shell\npnpm lint\n```\n\nGenerate documentation:\n\n```shell\npnpm doc\n```\n\nGenerate translations:\n\n```shell\npnpm machine-translate\n```\n\nStorybook:\n\n```shell\npnpm storybook\n```\n\n## Agent Guide\n\n- Contributor handoff: see `AGENTS.md` for a generic, evergreen guide.\n- Telemetry playbook (OTLP + Sentry): see `telemetry.md`.\n\n## Book\n\nInstall dependencies:\n\n```shell\ncargo install mdbook@0.5.2\ncargo install mdbook-katex@0.10.0-alpha\n```\n\nGenerate book:\n\n```shell\nmdbook build\n```\n\n## Copyright\n\n© 2024-2025 Left Curve Software. All rights reserved.\n\nThis 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleft-curve%2Fleft-curve","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleft-curve%2Fleft-curve","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleft-curve%2Fleft-curve/lists"}