Stashcore Library

A pure and powerful JavaScript Stash library.

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

Table of Contents

• Install
• Usage
• Documentation
• Contributing
• License

Install

NodeJS

npm install @stashcore/stashcore-lib

Browser

See the section below to generate your own bundle, or download the pre-generated minified file

Building the Browser Bundle

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

npm run build

This will generate files named stashcore-lib.js and stashcore-lib.min.js in the dist/ folder.

Usage

Browser

<script src='./dist/stashcore-lib.min.js' type="text/javascript"></script>
<script>
  const PrivateKey = stashcore.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
• Stash Core JSON-RPC
• Payment Channels
• Mnemonics
• Elliptical Curve Integrated Encryption Scheme
• Signed Messages

Development & Tests

git clone https://github.com/stashpayio/stashcore-lib
cd stashcore-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

• 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

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 Stash message
• Verify a Stash 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 Stash Foundation, Inc.
Copyright 2017-2018 Stash Core Group, Inc.