solana/web3.js
dependabot[bot] aa78fa0647
chore: bump prettier from 2.2.0 to 2.2.1 in /web3.js (#13857)
Bumps [prettier](https://github.com/prettier/prettier) from 2.2.0 to 2.2.1.
- [Release notes](https://github.com/prettier/prettier/releases)
- [Changelog](https://github.com/prettier/prettier/blob/master/CHANGELOG.md)
- [Commits](https://github.com/prettier/prettier/compare/2.2.0...2.2.1)

Signed-off-by: dependabot[bot] <[email protected]>

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2020-11-30 09:20:43 +00:00
..
.github Add warning to PR template for mirrored repos (#13344) 2020-11-02 14:34:14 +08:00
.travis
bin Add stable program logging for BPF and native programs 2020-11-14 08:26:01 -08:00
css
examples
flow-typed feat: add Secp256k1 support to solana-web3.js (#12958) 2020-10-22 13:15:24 -07:00
src fix: default preflight commitment to confirmation commitment 2020-11-16 21:54:02 -08:00
test test: update expected program log messages 2020-11-14 20:49:30 -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: add feePayer type in TransactionCtorFields (#13343) 2020-11-02 21:34:24 +08:00
module.flow.js fix: add feePayer type in TransactionCtorFields (#13343) 2020-11-02 21:34:24 +08:00
package-lock.json chore: bump prettier from 2.2.0 to 2.2.1 in /web3.js (#13857) 2020-11-30 09:20:43 +00:00
package.json chore: bump rollup from 2.33.3 to 2.34.0 in /web3.js (#13856) 2020-11-30 09:19:15 +00:00
rollup.config.js feat: add Secp256k1 support to solana-web3.js (#12958) 2020-10-22 13:15:24 -07:00

README.md

Build status codecov esdoc
npm npm-downloads
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)