@zipevo/zipcore-lib

Zipcore Library

A pure and powerful JavaScript Zip library.

Zip is a powerful new peer-to-peer platform for the next generation of financial technology. The decentralized nature of the Zip network allows for highly resilient Zip infrastructure, and the developer community needs reliable, open-source tools to implement Zip apps and services.

Table of Contents

• Install
• Usage
• Documentation
• Contributing
• License

Install

NodeJS

npm install @zipevo/zipcore-lib

Browser

CDN Standalone

<script src="https://unpkg.com/@zipevo/zipcore-lib"></script>
<script>
  const { PrivateKey } = zipcore;
  const privateKey = new PrivateKey();
  const address = privateKey.toAddress().toString();
  ...
</script>

Building the Browser Bundle

To build a zipcore-lib full bundle for the browser:

npm run build

This will generate a file named zipcore-lib.min.js in the dist/ folder.

Usage

Browser

<script src='./dist/zipcore-lib.min.js' type="text/javascript"></script>
<script>
  const PrivateKey = zipcore.PrivateKey;
  const privateKey = new PrivateKey();
  const address = privateKey.toAddress().toString();
</script>

Modules

Some functionality is implemented as a module that can be installed separately:

• Payment Protocol Support
• Peer to Peer Networking
• Zip Core JSON-RPC
• Mnemonics
• Elliptical Curve Integrated Encryption Scheme
• Signed Messages

Development & Tests

git clone https://github.com/zipevo/zipcore-lib
cd zipcore-lib
npm install

Run all the tests:

npm test

You can also run just the Node.js tests with npm run test:node, just the browser tests with npm run test:browser or run a test coverage report with npm run coverage.

Documentation

Concepts

• Addresses
• Block
• Crypto
• Encoding
• Hierarchically-derived Private and Public Keys
• Mnemonic
• Networks
• PrivateKey
• PublicKey
• Script
• Transaction
• Using Different Units
• Unspent Output
• URI
• Governance Object / Proposal

How To Use

• Addresses
• Block
• BlockHeader
• Hierarchically-derived Private Key
• Hierarchically-derived Public Key
• Message
• Mnemonic
• Opcode
• PrivateKey
• PublicKey
• Script
• Transaction
• Transaction Input
• Transaction Output
• URI

Use Case Examples

Some examples can be found here, below is a list of direct links for some of them.

• Generate a random address
• Generate an address from a SHA256 hash
• Import an address via WIF
• Create a Transaction
• Sign a Zip message
• Verify a Zip message
• Create an OP RETURN transaction
• Create a 2-of-3 multisig P2SH address
• Spend from a 2-of-2 multisig P2SH address

Contributing

Please send pull requests for bug fixes, code optimization, and ideas for improvement. For more information on how to contribute, please refer to our CONTRIBUTING file.

License

Code released under the MIT license.

Copyright 2013-2017 BitPay, Inc. Bitcore is a trademark maintained by BitPay, Inc.
Copyright 2016-2017 The Zip Foundation, Inc.
Copyright 2017-2020 Zip Core Group, Inc.