blokstack

blockstack.js

Note: If you're looking for the Blockstack CLI repo it was merged with Blockstack Core.

• Installation
• About
• Documentation
• Compatibility
• Contributing
• Maintainer
• Testing
  • Testing in a browser
• Releasing

Installation

$ npm install blockstack

Using blockstack.js with a CDN

You can import blockstack.js as a script without using a package manager. To securely use the latest distribution of blockstack.js from a CDN, use the following script in your application:

<script src="https://unpkg.com/blockstack@21.1.1/dist/blockstack.js" integrity="sha384-QsRlJlLKvr/Vq4iv1MPwTqoMx5hd0StlnCBCTdwbb0ituqCGaTxjNIkdahGHlnwb" crossorigin="anonymous"></script>

Note: this is script is bundled as standalone (UMD) lib, targeting ES6 (ECMAScript 2015).

About

Blockstack JS is a library for profiles/identity, authentication, and storage.

The authentication portion of this library can be used to:

1. create an authentication request
2. create an authentication response

The profiles/identity portion of this library can be used to:

1. transform a JSON profile into cryptographically-signed tokens
2. recover a JSON profile from signed tokens
3. validate signed profile tokens

The storage portion of this library can be used to:

1. store and retrieve your app's data in storage that is controlled by the user

Note: this lib is written in Typescript and is compiled to ES6 (ECMAScript 2015) syntax and uses CommonJS modules. The NPM package works out of the box within the Node.js runtime, and within browsers when using a common bundler (e.g. Webpack, Browserify, Rollup, etc).

Documentation

Compatibility

Note: blockstack.js 0.14.0 and newer versions use a new on-disk format that is not backward compatible with prior versions.

Contributing

This repository uses the git flow branching mode.

The latest released code as deployed to npm is in master and the latest delivered development changes for the next release are in develop.

We use the git-flow-avh plugin.

Please send pull requests against develop. Pull requests should include tests, flow static type annotations and be lint free. Open your pull request using the template in PULL_REQUEST_TEMPLATE.md

Github issues marked help-wanted are great places to start. Please ask in a github issue or slack before embarking on larger issues that aren't labeled as help wanted or adding additional functionality so that we can make sure your contribution can be included!

Maintainer

This repository is maintained by yukan.id.

Testing

$ npm run test

We test on the "Active LTS" version of Node.

Testing in a browser

This test will only work with your browser's Cross-Origin Restrictions disabled.

Run npm run compile; npm run browserify before opening the file test.html in your browser.

Releasing

See release-checklist.md

Changelog

1.0.0-beta.1 (2020-09-28)

Bug Fixes

• add tsdx to packages (fbb4281)
• allow force option in putFile (0797a5d)
• ci config (3812c3f)
• ci config (9d5d3f1)
• ci config (77758cd)
• ci config (1eb00ec)
• cli build config (2959c20)
• cli global install (b088271)
• lint (269bff4)
• lookup profile args in storage (e60cf32)
• merge conflict mistake (3124e05)
• missing optional argument for input 'triplesecDecrypt' (3aaf773)
• more circular dependencies removed from auth package (3a1dfba)
• prettier formatting (0069bd7)
• profile package circular dependency (c749612)
• remove cache files from git (9fc294e)
• remove old tests and data from auth package (30e446f)
• remove transaction package prepare script (f62f500)
• remove unused auth.ts (9ce79f6)
• tests and ci (c05e353)
• update ci config (a63528e)
• update transactions package readme (ac9b3a5)

Features

• add cli bin.js (6781230)
• add cli src files (e3fbb0a)
• add keychain package (5fbe772)
• add network package (da8ec58)
• add profile package (d27a657)
• blockstack.js to stacks.js migration guide (3760bf2)
• clean up legacy code (faa3620)
• create random private key with optional entropy (dc192d4)
• create storage package (c99680b)
• create storage package (1867afe)
• move CLI package (1608d7c)
• move encryption functions out of storage package (cb7b293)
• move transactions package from @blockstack/stacks-transactions (d31cf3c)
• persist etags in UserSession (66ab8f1)
• refactor tests to use jest and move into respective packages (e35e57e)
• remove references to GaiaHubConfig in auth package (f0f97de)
• remove storage functions from user session (c27d948)
• setup monorepo structure and refactor auth (03c7c92)
• switch cli to @stacks/transactions (833b748)
• update common package (2132b08)
• update tsconfig and use tsdx (a82dd0c)
• update tsconfig and use tsdx (01c8f82)