This repository contains the Motoko base library.
If you are installing Motoko through the DFINITY SDK releases, then this base library is already included.
If you build your project using the vessel package manager then, add this entry to your package-set.json file:
{
"name": "base",
"repo": "https://github.com/dfinity/motoko-base",
"version": "dfx-0.5.10",
"dependencies": []
}
The package name "base" appears when importing its modules in Motoko (e.g., import "mo:base/Nat"). The repo may either be your local clone path, or this public repository url, as above. The version can be any git branch name (among other things). There are no dependencies. See vessel package manager docs for more details.
In test/, run
make
in test. This will expect dfx to be installed and in your $PATH, and call
moc via the wrapper in ./bin/moc. You can add that wrapper to your PATH, if
you want.
Running the tests also requires wasmtime and vessel to be installed.
If you installed moc some other way, you can instruct the Makefile to use
that compiler:
make MOC=moc
The documentation can be generated in doc/ by running
./make_docs.sh
which creates _out/html/index.html.
The next-moc branch contains changes that make base compatible with the
in-development version of moc. This repository's public CI does not run
on that branch.
External contributions are best made against master.
Please read the Interface Design Guide for Motoko Base Library before making a pull request.