@nimiq/core-web
v1.6.4
Published
**[Nimiq](https://nimiq.com/)** is a frictionless payment protocol for the web.
Downloads
2,041
Keywords
Readme
Nimiq Blockchain
Nimiq is a frictionless payment protocol for the web.
Resources
- Nimiq White Paper: High-level introduction of the Nimiq payment protocol.
- Nimiq Developer Reference: Details of the protocol architecture.
- Core API Documentation: Documentation of the Nimiq Core library API.
- Node.js Client Documentation: Usage and configuration documentation for the Nimiq Node.js Client.
- JSON-RPC Client Documentation: Usage instructions for the Nimiq JSON-RPC Client.
- Docker Documentation: Instuctions on setting up a Nimiq Node using Docker.
Demo
Check out our Testnet.
Packages
Prebuilt binary packages
For users looking to run a standalone Nimiq node (which is also capable of mining), see our Downloads page for installable Linux and Windows binary packages.
NPM Packages
For developers looking to include Nimiq support on their applications, there are two npm packages available:
@nimiq/core
: Module for use in node.js applications.@nimiq/core-web
: Module for use in client-side (browser) applications.
Web Developers
Simple Web Application on top of Nimiq
A good way to get started is to have a look at the most simple web application on top of the Nimiq Blockchain.
Getting Started
Import Nimiq
as an ES6 module:
// With a package.json-aware module loader:
import Nimiq from '@nimiq/core-web';
// Otherwise:
import Nimiq from 'node_modules/@nimiq/core-web/web.esm.js';
To use Nimiq's cryptographic functions (for hashing, signing, derivation),
you have to make the following files from this package available to the browser
(for e.g. Vue, this means copying them into the public
folder, or getting them
otherwise into the output directory):
worker.js
worker-js.js
worker-wasm.js
worker-wasm.wasm
You can then load the Nimiq worker by calling Nimiq.load()
with the URL of the folder containing the files:
// Important: must be a full URL, a trailing slash is required.
const workerURL = location.origin + '/assets/nimiq/';
Nimiq.load(workerURL).then(async function() {
// All Nimiq functionality is available here.
});
Using a regular <script> tag
Include the nimiq.js
file from this package into your project:
<script src="node_modules/@nimiq/core-web/nimiq.js"></script>
If you do not need networking support, you can also use the smaller offline build:
Nimiq.loadOffline().then(...);
Contribute
If you'd like to contribute to the development of Nimiq please follow our Code of Conduct and Contributing Guidelines.
License
This project is under the Apache License 2.0.