Solana JavaScript SDK

Unit tests

To run the full suite of unit tests, execute the following in the root directory:

$ npm test

Integration tests

Integration tests require a validator client running on your machine.

1. Install a test validator:

$ npm run test:live-with-test-validator:setup

2. Start the validator and run integration tests:

$ cd packages/library-legacy
$ npm run test:live-with-test-validator

To use the Solana JavaScript SDK (v1.x) in a Node.js environment or within a modern web application build system (like Webpack, Vite, or Rollup), install the package via npm.

$ npm install --save @solana/web3.js

If you are not using a build system and want to include the SDK directly in an HTML file via a <script> tag, use the unpkg CDN. Use the .min.js version for production environments.

<!-- Development (un-minified) -->
<script src="https://unpkg.com/@solana/web3.js@latest/lib/index.iife.js"></script>

<!-- Production (minified) -->
<script src="https://unpkg.com/@solana/web3.js@latest/lib/index.iife.min.js"></script>

The library requires a JavaScript runtime that supports BigInt and the exponentiation operator (**).

Supported Runtimes:

• Browsers: Chrome (May 2018+), Firefox (July 2019+), Safari/Mobile Safari (Sept 2020+), Edge (Jan 2020+), Opera (June 2018+), Samsung Internet (April 2019+).
• Deno: >=1.0
• Node.js: >=10.4.0
• React Native: >=0.7.0 using the Hermes engine.

Use VoteProgram.authorize to change the authority for voting or withdrawing. You must specify the voteAuthorizationType using the VoteAuthorizationLayout constants.

Authorization Types:

• Voter: index 0
• Withdrawer: index 1

Use createWithSeed to derive a new public key from an existing key, a string seed, and a program ID. The program ID acts as the owner of the resulting key.

Note: This is an asynchronous method.