1
1
mirror of https://github.com/anoma/juvix.git synced 2024-12-14 17:32:00 +03:00
Juvix empowers developers to write code in a high-level, functional language, compile it to gas-efficient output VM instructions, and formally verify the safety of their contracts prior to deployment and execution.
Go to file
Jonathan Cubides a7e34a124e
Improve handling of location information for different objs (#263)
* Add loc for literal and refactor a bit

* w.i.p making symbol a synonym for WithLoc Text

* Finish with symbol

* Update standard library
2022-07-11 17:00:38 +02:00
.github Add issues and PR templates (#261) 2022-07-08 15:19:07 +02:00
app Rename MiniJuvix to Juvix (#259) 2022-07-08 13:59:45 +02:00
assets Restore mascot images to the minijuvix book (#250) 2022-07-06 14:23:13 +02:00
docs/org Rename MiniJuvix to Juvix (#259) 2022-07-08 13:59:45 +02:00
examples/milestone Rename MiniJuvix to Juvix (#259) 2022-07-08 13:59:45 +02:00
juvix-mode Rename MiniJuvix to Juvix (#259) 2022-07-08 13:59:45 +02:00
juvix-stdlib@dd73f5d783 Improve handling of location information for different objs (#263) 2022-07-11 17:00:38 +02:00
minic-runtime Rename MiniJuvix to Juvix (#259) 2022-07-08 13:59:45 +02:00
src/Juvix Improve handling of location information for different objs (#263) 2022-07-11 17:00:38 +02:00
test Rename MiniJuvix to Juvix (#259) 2022-07-08 13:59:45 +02:00
tests Rename MiniJuvix to Juvix (#259) 2022-07-08 13:59:45 +02:00
.github_changelog_generator Rename MiniJuvix to Juvix (#259) 2022-07-08 13:59:45 +02:00
.gitignore Rename MiniJuvix to Juvix (#259) 2022-07-08 13:59:45 +02:00
.gitmodules Rename MiniJuvix to Juvix (#259) 2022-07-08 13:59:45 +02:00
.hlint.yaml Monomorphization (#70) 2022-05-04 10:50:03 +02:00
.pre-commit-config.yaml Rename MiniJuvix to Juvix (#259) 2022-07-08 13:59:45 +02:00
.pre-commit-hooks.yaml Add initial documentation (#119) (#120) 2022-05-23 16:20:02 +02:00
book.toml Rename MiniJuvix to Juvix (#259) 2022-07-08 13:59:45 +02:00
hie.yaml Rename MiniJuvix to Juvix (#259) 2022-07-08 13:59:45 +02:00
LICENSE First commit, initial project template. 2021-09-26 18:59:51 +02:00
Makefile Rename MiniJuvix to Juvix (#259) 2022-07-08 13:59:45 +02:00
package.yaml Rename MiniJuvix to Juvix (#259) 2022-07-08 13:59:45 +02:00
README.org Rename MiniJuvix to Juvix (#259) 2022-07-08 13:59:45 +02:00
stack.yaml Upgrade to ghc-9.2.3 (#178) 2022-06-20 12:53:31 +02:00

Juvix

<a href="https://github.com/anoma/juvix/actions/workflows/ci.yml"> <img alt="CI status" src="https://github.com/anoma/juvix/actions/workflows/ci.yml/badge.svg" /> </a>

<a href="https://github.com/anoma/juvix/blob/main/LICENSE"> <img alt="LICENSE" src="https://img.shields.io/badge/license-GPL--3.0--only-blue.svg" /> </a>

<a href="https://github.com/anoma/juvix/actions/workflows/pages/pages-build-deployment"><img src="https://github.com/anoma/juvix/actions/workflows/pages/pages-build-deployment/badge.svg" alt="pages-build-deployment" /></a>

<a href="https://github.com/anoma/juvix"> <img align="right" width="300" height="300" alt="Juvix Mascot" src="assets/seating-mascot.051c86a.svg" /> </a>

Description

Juvix is a research programming language created by Heliax as a first step toward creating more robust and reliable alternatives for formally verified smart contracts than existing languages. The Juvix language is constantly evolving, open-source, functional, and statically typed with special support for compiling validity predicates to the C language, which can be deployed to various distributed ledgers including Anoma.

The Juvix programming language allows developers to write programs with a high degree of assurance that they will meet specific standards. This is due to the fact that several static analyses are performed during compilation, including, for example, scope, termination, arity, and type checking. As a result, functional programs, especially validity predicates, can be written with greater confidence that they will be free of runtime errors. Here are some examples of Juvix programs.

The language features:

  • unicode syntax
  • parametric polymorphism
  • inductive and parametric data types
  • higher-order functions
  • implicit arguments
  • holes in programs
  • axioms for non-computable terms

Additionally, the foreign and compile blocks syntax enable developers to compile a program to different backends including the C language. The Juvix module system further permits splitting programs into several modules to build libraries which can be later documented by generating HTML files based on the codebase, see for example, the Juvix standard library's website. For futher details, please refer to the Juvix book which icludes our latest updates.

Quick Start

To install Juvix, you can download its sources using Git from the Github repository. Then, the program can be downloaded and installed with the following commands. You will need to have Stack installed.

git clone --recursive https://github.com/anoma/juvix.git
cd juvix
stack install

If the installation succeeds, you must be able to run the juvix command from any location. To get the complete list of commands, please run juvix --help.

Usage Example

In the following example a Juvix file is compiled using the C backend. The result is compiled to WASM using Clang and then executed using wasmer.

NB: Set the WASI_SYSROOT_PATH environment variable to the root of the WASI sysroot. See Installing dependencies for instructions on how to install the sysroot.

cd tests/positive/MiniC/HelloWorld
juvix compile Input.juvix
wasmer Input.wasm

You should see the output: hello world!

The Juvix Book

The Juvix language and related tools are documented in the Juvix book.

Community

We would love to hear what you think of Juvix! Join us on Discord