History

dependabot[bot] 4013447c08 chore: bump @typescript-eslint/eslint-plugin in /web3.js (#12090 ) Bumps [@typescript-eslint/eslint-plugin](https://github.com/typescript-eslint/typescript-eslint/tree/HEAD/packages/eslint-plugin) from 3.10.1 to 4.0.0. - [Release notes](https://github.com/typescript-eslint/typescript-eslint/releases) - [Changelog](https://github.com/typescript-eslint/typescript-eslint/blob/master/packages/eslint-plugin/CHANGELOG.md) - [Commits](https://github.com/typescript-eslint/typescript-eslint/commits/v4.0.0/packages/eslint-plugin) Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>		2020-09-08 04:08:51 +00:00
..
.travis	…
bin	Add quotes to new argument	2020-08-28 16:49:28 -07:00
css	…
examples	…
flow-typed	…
src	feat: add idle timeout and fix subscription race (#12093 )	2020-09-07 23:12:22 +08:00
test	feat: add idle timeout and fix subscription race (#12093 )	2020-09-07 23:12:22 +08: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-environment.js	…
jest.json	…
module.d.ts	fix: update Pubkey typescript bindings (#11971 )	2020-09-01 11:14:41 -07:00
module.flow.js	fix: use bpf-loader-deprecated explicitly (#11818 )	2020-08-25 09:05:33 -07:00
package-lock.json	chore: bump @typescript-eslint/eslint-plugin in /web3.js (#12090 )	2020-09-08 04:08:51 +00:00
package.json	chore: bump @typescript-eslint/eslint-plugin in /web3.js (#12090 )	2020-09-08 04:08:51 +00:00
rollup.config.js	…

README.md

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:

Message feed (BPF Rust and C): https://github.com/solana-labs/example-messagefeed
Tic-tac-toe (BPF C): https://github.com/solana-labs/example-tictactoe
Web wallet: https://github.com/solana-labs/example-webwallet

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)