solana/web3.js
dependabot-preview[bot] 7f045c63ea chore(deps): bump ws from 7.1.0 to 7.1.1
Bumps [ws](https://github.com/websockets/ws) from 7.1.0 to 7.1.1.
- [Release notes](https://github.com/websockets/ws/releases)
- [Commits](https://github.com/websockets/ws/compare/7.1.0...7.1.1)

Signed-off-by: dependabot-preview[bot] <[email protected]>
2020-06-14 21:57:04 -07:00
..
bin
css
examples fix: accommodate cluster fees in budget-two-approvers 2020-06-14 21:57:04 -07:00
flow-typed
src fix: update keybaseId to keybaseUsername 2020-06-14 21:57:04 -07:00
test fix: update keybaseId to keybaseUsername 2020-06-14 21:57:04 -07:00
.babelrc
.esdoc.json
.eslintignore
.eslintrc.js
.flowconfig
.gitignore
.mergify.yml
.prettierrc.yaml
.sgcrc
.travis.yml
CONTRIBUTING.md
LICENSE
README.md
commitlint.config.js
jest.json
module.flow.js fix: update keybaseId to keybaseUsername 2020-06-14 21:57:04 -07:00
package-lock.json chore(deps): bump ws from 7.1.0 to 7.1.1 2020-06-14 21:57:04 -07:00
package.json chore(deps-dev): bump eslint-plugin-import from 2.18.0 to 2.18.1 2020-06-14 21:57:04 -07:00
rollup.config.js

README.md

Build status codecov esdoc
npm npm-downloads david david
semantic-release code-style-prettier

Solana JavaScript API

This is the Solana Javascript API built on the Solana JSON RPC API

Latest API Documentation

Installation

Yarn

$ yarn add @solana/web3.js

npm

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

Browser bundle

<script src="https://github.com/solana-labs/solana-web3.js/releases/download/v0.0.6/solanaWeb3.min.js"></script>

BPF program development

The Solana BPF SDK is located in the bpf-sdk/ subdirectory if you installed solana-web3.js from npmjs.com.

From a git clone, run npm run bpf-sdk:install to fetch the latest BPF SDK.

Additionally Rust must be installed to build Rust BPF programs such as examples/bpf-rust-noop/. See https://www.rust-lang.org/install.html for installation details.

Usage

Javascript

const solanaWeb3 = require('@solana/web3.js');
console.log(solanaWeb3);

ES6

import solanaWeb3 from '@solana/web3.js';
console.log(solanaWeb3);

Browser bundle

// `solanaWeb3` is provided in the global namespace by the `solanaWeb3.min.js` script bundle.
console.log(solanaWeb3);

Local Network

The solana-localnet program is provided to easily start a test Solana cluster locally on your machine. Docker must be installed. The JSON RPC endpoint of the local cluster is http://localhost:8899.

To start, first fetch the latest Docker image by running:

$ npx solana-localnet update

Then run the following command to start the cluster

$ npx solana-localnet up

While the cluster is running logs are available with:

$ npx solana-localnet logs -f

Stop the cluster with:

$ npx solana-localnet down

Flow

A Flow library definition is provided at module.flow.js. Add the following line under the [libs] section of your project's .flowconfig to activate it:

[libs]
node_modules/@solana/web3.js/module.flow.js

Examples

See the examples/ directory for small snippets.

Standalone examples:

Releases

Releases are available on Github and npmjs.com

Each Github release features a tarball containing API documentation and a minified version of the module suitable for direct use in a browser environment (<script> tag)