Warning
Upgrade to Stacks.js 7.7.0 or later. Public API nodes may soon stop supporting the v1 nonce endpoint used by older versions, which could prevent transactions from being built. Version 7.7.0 switches nonce lookups to the v3 endpoint.
Welcome to the Stacks.js repository, your one-stop solution for working with the Stacks blockchain using JavaScript/TypeScript. This repository nests a collection of packages designed to provide you with the essential building blocks to work with the Stacks blockchain from JavaScript/TypeScript.
For installation instructions and usage guidelines, refer to the respective README in each package directory.
@stacks/connectConnect web application to Stacks wallet browser extensions (separate repo).
@stacks/transactionsBuild, sign, and broadcast transactions. Construct and read Clarity values. Guard transfers with post conditions.@stacks/wallet-sdkCreate a Stacks wallet from a seed phrase and manage its accounts.@stacks/encryptionEncryption functions used by stacks.js packages.@stacks/networkNetwork configuration for Stacks.js.@stacks/commonShared low-level primitives for Stacks.js.
@stacks/bitcoin-stakingLibrary for Bitcoin Staking.
@stacks/cliCommand line interface for the Stacks blockchain.
Auto-generated library references for the stacks.js packages are located at stacks.js.org.
To migrate your app from blockstack.js to Stacks.js follow the steps in the migration guide.
If you encounter a bug or have a feature request, we encourage you to follow the steps below:
- Search for existing issues: Before submitting a new issue, please search existing and closed issues to check if a similar problem or feature request has already been reported.
- Open a new issue: If it hasn't been addressed, please open a new issue. Choose the appropriate issue template and provide as much detail as possible, including steps to reproduce the bug or a clear description of the requested feature.
- Evaluation SLA: Our team reads and evaluates all the issues and pull requests. We are available Monday to Friday and we make our best effort to respond within 7 business days.
Please do not use the issue tracker for personal support requests or to ask for the status of a transaction. You'll find help at the #support Discord channel.
Development of Stacks.js happens in the open on GitHub, and we are grateful to the community for contributing bug fixes and improvements. Read below to learn how you can take part in improving the Stacks.js.
Please read Stacks.js' Code of Conduct since we expect project participants to adhere to it.
Read our contributing guide to learn about our development process, how to propose bug fixes and improvements, and how to build and test your changes.
Join our community and stay connected with the latest updates and discussions:
- Join our Discord community chat to engage with other users, ask questions, and participate in discussions.
- Visit hiro.so for updates and subscribe to the mailing list.
- Follow Hiro on Twitter.
Stacks.js is open source and released under the MIT License.