1
1
mirror of https://github.com/anoma/juvix.git synced 2024-12-13 19:49:20 +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
2023-01-19 12:52:51 +01:00
.devcontainer Add initial setup for codespaces (#1713) 2023-01-18 11:25:18 +01:00
.github Use Smoke instead of shelltestrunner (#1710) 2023-01-10 12:49:56 +01:00
app Refactor html command with extra options (#1725) 2023-01-17 18:11:59 +01:00
assets Refactor html command with extra options (#1725) 2023-01-17 18:11:59 +01:00
bench Automatized benchmarks (#1673) 2023-01-05 17:48:26 +01:00
c-runtime Fix Nat builtins (#1733) 2023-01-17 17:11:31 +01:00
docker Upgrade stack snapshot to use ghc-9.2.5 (#1621) 2022-12-02 10:04:56 +01:00
docs/org Refactor html command with extra options (#1725) 2023-01-17 18:11:59 +01:00
examples Add missing juvix.yaml to Demo 2023-01-18 11:53:27 +01:00
gnuplot Automatized benchmarks (#1673) 2023-01-05 17:48:26 +01:00
juvix-mode Add an emacs function to restart the REPL (#1618) 2022-11-14 09:38:07 +00:00
juvix-stdlib@19d957eb8f Fix Nat builtins (#1733) 2023-01-17 17:11:31 +01:00
licenses Add Haddock and Agda licenses (#1506) 2022-09-06 09:30:01 +01:00
runtime JuvixCore to JuvixAsm translation (#1665) 2023-01-09 18:21:30 +01:00
src/Juvix Refactor html command with extra options (#1725) 2023-01-17 18:11:59 +01:00
test Add test for div and mod (#1741) 2023-01-19 12:52:51 +01:00
tests Add test for div and mod (#1741) 2023-01-19 12:52:51 +01:00
.clang-format Juvix C runtime (#1580) 2022-11-03 09:38:09 +01:00
.github_changelog_generator Update Changelog v0.2.3 🎉 2022-08-15 12:24:42 +02:00
.gitignore Automatized benchmarks (#1673) 2023-01-05 17:48:26 +01: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 Fix Changelog links and minors (#1371) 2022-07-14 11:41:58 +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
cabal.hie.yaml Automatized benchmarks (#1673) 2023-01-05 17:48:26 +01:00
cabal.project Update stack.yaml (#1734) 2023-01-18 10:23:14 +01:00
changelog.org Refactor html command with extra options (#1725) 2023-01-17 18:11:59 +01:00
cntlines.sh Script to count LOC (#1732) 2023-01-17 15:32:05 +01:00
LICENSE First commit, initial project template. 2021-09-26 18:59:51 +02:00
Makefile Refactor html command with extra options (#1725) 2023-01-17 18:11:59 +01:00
package.yaml Refactor html command with extra options (#1725) 2023-01-17 18:11:59 +01:00
README.org Add initial setup for codespaces (#1713) 2023-01-18 11:25:18 +01:00
stack.hie.yaml Refactor hie.yaml and add entry in the readme (#1672) 2022-12-20 16:45:48 +01:00
stack.yaml Update stack.yaml (#1734) 2023-01-18 10:23:14 +01: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/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/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/codespaces/new?hide_repo_select=true&ref=main&repo=455254004"> <img height="20pt" alt="Open the Juvix Standard Lib in Github Codespace" src="https://github.com/codespaces/badge.svg" /> </a>

<a href="https://github.com/anoma/juvix"> <img align="right" width="300" height="300" alt="Juvix Mascot" src="assets/images/tara-seating.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 language and related tools are documented in the Juvix book. To write and test Juvix programs, you can use your favorite text editor, the juvix command line tool, the Juvix Github Codespace, and the Juvix Standard Lib Codespace. However, we recommend using the juvix-mode in Emacs or the plugin in VSCode.

First examples of programs written in Juvix

The following links are clickable versions of their corresponding Juvix programs. The HTML output is generated by running juvix html --recursive FileName.juvix.

The Juvix standard library contains common functions that can be used in Juvix programs.

Installation

MacOS

The easiest way to install Juvix on MacOS is by using Homebrew.

To install the homebrew-juvix tap, run:

brew tap anoma/juvix

To install Juvix, run:

brew install juvix

Helpful information on the shell can also be obtained by running:

brew info juvix

Linux x86_64

A Juvix compiler binary executable for Linux x86_64 is available on the Juvix release page.

To install this executable, downlaod and unzip the linked file and add move it to a directory on your shell's PATH.

For example if ~/.local/bin is on your shell's PATH you can install Juvix as follows:

cd /tmp
curl -OL https://github.com/anoma/juvix/releases/download/v0.2.8/juvix-linux_x86_64-v0.2.8.zip
unzip juvix-linux_x86_64-v0.2.8.zip
mv juvix-linux_x86_64-v0.2.8 ~/.local/bin/juvix

Building Juvix from source

To install Juvix from source you must clone the Github repository. Then Juvix can be installed with the following commands. We assume you have Stack installed.

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

On MacOS you can alternatively run the following command for Homebrew. The flag --HEAD used below is optional, use it to build the latest version of Juvix in the main branch on Github.

brew install --build-from-source --HEAD juvix --verbose

Quick Start

After installation run juvix --help to see the list of commands available. See CLI usage examples for descriptions of common tasks.

Run Juvix doctor to check your system setup:

juvix doctor

The Hello World example

This is the Juvix source code of the traditional Hello World program.

-- HelloWorld.juvix
module HelloWorld;

open import Stdlib.Prelude;

main : IO;
main := putStrLn "hello world!";

end;

To compile and run a binary generated by Juvix, save the source code to a file called HelloWorld.juvix and run the following command from the directory containing it:

juvix compile HelloWorld.juvix
./HelloWorld

You should see the output: hello world!

The source code can also be compiled to a WebAssembly binary. This requires some additional setup. See Installing dependencies in the documentation for more information. You can also run juvix doctor to check your setup.

juvix compile --target wasm HelloWorld.juvix
wasmer HelloWorld.wasm

LSP support

We provide a sammple hie.yaml configuration file for both cabal and stack.

If you prefer stack, run:

cp stack.hie.yaml hie.yaml

If you prefer cabal, run:

cp cabal.hie.yaml hie.yaml

Building the project with cabal

We recommend that contributors use the stack build tool with this project.

If you would prefer to use the cabal build tool instead then you must generate the juvix.cabal file using hpack before running cabal build.

The Juvix programming language

Juvix allows us to write programs with a high degree of assurance. The Juvix compiler runs several static analyses during the compilation phase to guarantee no runtime errors. Analyses permormed during this phase include scope, termination, arity, and type checkiqng. As a result, functional programs, especially validity predicates, can be written with greater confidence that they will be free of runtime errors.

Some of the language features in Juvix include:

  • unicode syntax
  • parametric polymorphism
  • inductive and parametric data types
  • higher-order functions
  • implicit arguments
  • holes in expressions
  • 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 includes our latest updates.

Community

Join us on our Discord server

This project is part of a bigger effort called Anoma. Anoma is a suite of protocols and mechanisms for self-contained, self-sovereign coordination. Join the Anoma project.