Skip to content
The Pact Smart Contract Language
Haskell Other
  1. Haskell 97.9%
  2. Other 2.1%
Branch: master
Clone or download

Latest commit

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/workflows Remove outdated megaparsec constraint from cabal.project (#794) May 3, 2020
dep/kpkgs Megaparsec 8 (#769) Apr 13, 2020
docs Update docs for 3.5.1 release (#803) Jun 6, 2020
examples Linear managed caps (#706) Oct 21, 2019
executables Benchmarks Pact native functions (#614) Oct 11, 2019
golden Adds golden tests for gas model (includes #760) (#762) Feb 5, 2020
log added pact serve to command line Feb 9, 2017
pact-lang-api.js Updated pact-lang-api to work with Pact 3.0 (#530) Jun 6, 2019
src-ghc/Pact Don't use Show for forcing bench results May 3, 2020
src add nfdata instances for Lars (#800) May 28, 2020
templates 3.3.0 release prep (#696) Oct 24, 2019
tests FV omnibus: "soft" unsupported, static cap tracing, fixes (#798) May 16, 2020
web Dep versions widened for both GHCJS and normal build; test passing Nov 5, 2017
.gitignore LTS 15 (#783) Mar 19, 2020
.gitlab-ci.yml Fix ghcjs build (#752) Jan 2, 2020
.travis.yml LTS 15 (#783) Mar 19, 2020
.weeder.yaml Some cleanup from Weeder run and weeder config file Mar 14, 2018
CHANGELOG.md Update Changelog for Pact 3.5.1 Release (#801) Jun 6, 2020
HLint.hs Completed with type-directed partial flagging Jan 27, 2019
LICENSE simple command construction finished Feb 9, 2017
README.md Updated README (#719) Nov 5, 2019
Setup.hs Pact open-source release Nov 13, 2016
appveyor.yml Finish sbv 8.6 upgrade (#797) May 4, 2020
cabal.project Remove outdated megaparsec constraint from cabal.project (#794) May 3, 2020
collectArtifacts.sh Pact swagger api, REST API refactor (#510) May 26, 2019
config.yaml No caching in SQLite layer, txid in beginTx, tx validation Feb 13, 2017
default.nix Clean up nix infrastructure for ease of use (#716) Oct 27, 2019
gas-model-raw-data.csv Finalize gas model (#734) Nov 25, 2019
gas-prices.csv Finalize gas model (#734) Nov 25, 2019
pact.cabal add nfdata instances for Lars (#800) May 28, 2020
project.nix Use kpkgs (#779) Mar 3, 2020
release.sh update release.sh for Cabal 3 (#802) Jun 6, 2020
repl.sh Pact open-source release Nov 13, 2016
shell.nix Clean up nix infrastructure for ease of use (#716) Oct 27, 2019
stack-ghcjs.yaml Upgrade thyme for #6, document formats, 2.3.6 release prep Dec 13, 2017
stack-nix.yaml Update to latest reflex-platform with GHC 8.4 Nov 6, 2018
stack.yaml Megaparsec 8 (#769) Apr 13, 2020
static.nix Finish sbv 8.6 upgrade (#797) May 4, 2020
zeus.nix Reflex platform ghc86 upgrade (#662) Oct 7, 2019

README.md

Kadena

 

The Pact Programming Language

Build Status

Pact is an open-source, Turing-incomplete smart contract language that has been purpose-built with blockchains first in mind. Pact focuses on facilitating transactional logic with the optimal mix of functionality in authorization, data management, and workflow.

Read the whitepaper:

For additional information, press, and development inquires, please refer to the Kadena website

Table Of Contents

Tutorials

Extensive tutorials on every facet of the Pact language may be found here. Additionally, users may find example scripts in Kadena's pact-examples repository, in the examples directory, and in production as part of the Kadena Public Blockchain.

Documentation

The Pact language specification, API documentation, features, motivations, and in-depth tutorial content may be found here.

Documentation is always in flux, and corrections to out of date documentation are always appreciated. Feel free to do so if you find such an error by opening an issue.

Quickstart

The easiest and quickest way to try Pact is in the browser, or via the Chainweaver wallet. Both environments support error and warning highlighting, as well as an in-app REPL environment for you to test out your code immediately.

Installing Pact

Binary Distributions

Pact can be installed via binary distribution for Linux or Mac by following the instructions below:

  • Install z3.
  • Download the prebuilt binaries for either Linux or Mac, depending on your OS.
  • Once you've downloaded the binary, make sure that it is marked as executable by running chmod +x <executable-file>.
  • Put the binary somewhere in your PATH.

Once you have Pact in your path, proceed to validating your installation by trying out the repl.

Instructions for Mac Users

Using Brew

On Mac, the easiest way to install pact is with Homebrew. Make sure that Homebrew has been installed in your machine. Instructions for how to install it can be found here. Once Homebrew is installed, run the following command to install pact:

brew update
brew install kadena-io/pact/pact

If you want to install from source, see building from source

Instructions for Linux Users

Linux is supported in terms of both the binary distributions (see below) and building from source. For installing pact on Linux distributions in the Arch family, refer to this package on the AUR. Otherwise, please refer to building from source.

Building from Source

Dependencies

  • (Mac only) Homebrew: brew install git
  • (Linux/Mac) Installer

To get the code, you can go here. Once you have the code, we can pick a build tool.

Building with Cabal

Cabal is the preferred way to manage packages by the Haskell community. You will need a version of GHC installed on your machine to use it.

Dependencies
  • ghc >= 8.4 (Haskell compiler) and cabal >= 2.2 (Haskell build-tool)
    • The easiest way to get this is to install it using (Linux/Mac) ghcup and issue ghcup install 8.6.5, followed by ghcup install-cabal.
    • ghc may also be installed via brew, issuing brew install ghc and brew install cabal-install.

(You may also need to install zlib, z3, and sqlite)

To build a Pact binary:

# Only necessary if you haven't done this recently.
cabal v2-update

# Build the project.
cabal v2-build

This will install a runnable version of Pact, which you can run via:

cabal v2-exec pact

Alternatively, cabal v2-install will install the binary to ~/.cabal/bin/, which you may need to add to your path. Then, you can call pact as-is.

Building with Stack

Stack is a Haskell build tool that manages compiler and dependency versions for you. It's easy to install and use.

Dependencies
  • stack >= 1.9
    • (Mac only) Homebrew: brew install haskell-stack
    • (Linux/Mac) Installer

(You may also need to install zlib, z3, and sqlite)

To build a Pact binary:

stack build

This will compile a runnable version of Pact, which you can run via:

stack exec pact

Alternatively, stack install will install the binary to ~/.local/bin/, which you may need to add to your path. Then, you can call pact as-is.

Building with Nix

The fastest way to build and run Pact is to use the Nix package manager which has binary caching capabilities that allow you to download pre-built binaries for everything needed by Pact. For detailed instructions see our wiki.

When the build is finished, you can run Pact with the following command:

./result/ghc/pact/bin/pact

Verifying Installation

Test by issuing pact in a terminal or by executing your binary. Try out some commands:

$ pact
pact> (+ 1 2)
3
pact> (+ "hello, " "world")
"hello, world"

Supported Editors

Pact is supported by a variety of editors ranging from full-fledged IDE environments to syntax highlighting.

Chainweaver

The Chainweaver wallet is the Kadena's wallet, offering a seamless IDE experience and wallet in one. It supports a full in-app REPL, code preview, error/warning highlighting, code deployment, key generation, and integration with existing Kadena blockchains.

In-Browser

An implementation of Chainweaver exists in the browser, if you do not wish to download the wallet.

Atom

For a full-fledged IDE experience, install the Atom editor along with language-pact using the atom package manager.

Emacs

Emacs has pact-mode support via MELPA, along with flycheck-pact for on-the-fly error highlighting. Download pact-mode and (optionally) flycheck-pact by opening Emacs and issuing M-x package-list-packages, syncing MELPA, and installing by name. Then, in your init.el or .emacs, include

(use-package pact-mode
  :ensure t
  :config
  ;; optionally
  (require 'flycheck-pact))

If you've chosen to include flycheck-pact, you can start the interactive buffer and trace by calling flycheck-pact-toggle-trace and flycheck-pact-interactive-buffer.

Vim

If you are a vim user, the vim-pact plugin provides support for the pact syntax.

The Pact REST Api

Api Documentation

The REST API is documented at http://pact-language.readthedocs.io/en/latest/pact-reference.html#rest-api.

Pact REST API Server

Pact features a full REST API HTTP server and SQLite database implementation, making blockchain application development painless and easy. The Pact server simulates a single-node blockchain environment, with the same API supported by the Kadena ScalableBFT blockchain.

To start the server, issue

pact --serve CONFIG

or

pact -s CONFIG

where CONFIG is a valid config.yaml.

Hosting static files.

The HTTP server will host any static files it finds in its working directory.

Config file format

The pact dev server (pact-serve) requires a configuration Yaml file (e.g. server.conf) to operate. The documentation for it is:

console> pact --serve --help
Config file is YAML format with the following properties:
port       - HTTP server port
persistDir - Directory for database files.
             If ommitted, runs in-memory only.
logDir     - Directory for HTTP logs
pragmas    - SQLite pragmas to use with persistence DBs
verbose    - [True|False] Provide extra logging information

Replay from disk.

When running pact-serve with persistence enabled, the server automatically replays from the database commands.sqlite in the persist dir. To prevent replay, simply delete this file before starting the server.

Related Projects

  • The pact-lang-api npm package provides a JavaScript library to aid interaction with the API.

  • The pact-todomvc is a working demonstration.

License

This code is distributed under the terms of the BSD3 license. See LICENSE for details.

You can’t perform that action at this time.