solana-program-library/token/js
Ryo Onodera 68b8da2996
Support associated token for JS (Also, make the program testable) (#1364)
* Implement some js helpers for associated tokens

* Create integration test and fix hard-coding in spl-associated-token

* Run lint:fix and pretty:fix

* Run flow as well...

* More robust test fixture setup

* Revert api breaking part

* Fix tests...

* Populate ts/flow type definitions

* Improve test a bit

* More consistent arg order; docs; more tests

* lints and pretty

* type definition updates and test tweaks

* More simplification...

* More cleanup

* Address review comments and small cleanings

* Bump the version
2021-03-03 20:56:22 +09:00
..
cli Support associated token for JS (Also, make the program testable) (#1364) 2021-03-03 20:56:22 +09:00
client Support associated token for JS (Also, make the program testable) (#1364) 2021-03-03 20:56:22 +09:00
flow-typed/npm fix: add support for browser modules to @solana/spl-token (#1337) 2021-02-25 14:56:09 +08:00
test Support associated token for JS (Also, make the program testable) (#1364) 2021-03-03 20:56:22 +09:00
.eslintignore fix: add support for browser modules to @solana/spl-token (#1337) 2021-02-25 14:56:09 +08:00
.eslintrc.js fix: add support for browser modules to @solana/spl-token (#1337) 2021-02-25 14:56:09 +08:00
.flowconfig Relocate js 2020-08-08 15:25:47 -07:00
.gitignore Port token js tests from solana-localnet to solana-test-validator 2020-12-17 21:24:30 -08:00
.mocharc.js fix: add support for browser modules to @solana/spl-token (#1337) 2021-02-25 14:56:09 +08:00
.prettierrc.yaml Relocate js 2020-08-08 15:25:47 -07:00
README.md Port token js tests from solana-localnet to solana-test-validator 2020-12-17 21:24:30 -08:00
babel.config.json fix: add support for browser modules to @solana/spl-token (#1337) 2021-02-25 14:56:09 +08:00
babel.rollup.config.json Relocate js 2020-08-08 15:25:47 -07:00
cluster-devnet.env Relocate js 2020-08-08 15:25:47 -07:00
cluster-mainnet-beta.env Relocate js 2020-08-08 15:25:47 -07:00
cluster-testnet.env Relocate js 2020-08-08 15:25:47 -07:00
mocha.html fix: add support for browser modules to @solana/spl-token (#1337) 2021-02-25 14:56:09 +08:00
module.d.ts Support associated token for JS (Also, make the program testable) (#1364) 2021-03-03 20:56:22 +09:00
module.flow.js Support associated token for JS (Also, make the program testable) (#1364) 2021-03-03 20:56:22 +09:00
package-lock.json build(deps-dev): bump chai from 4.3.0 to 4.3.1 in /token/js (#1369) 2021-03-03 09:38:10 +00:00
package.json Support associated token for JS (Also, make the program testable) (#1364) 2021-03-03 20:56:22 +09:00
rollup.config.js fix: add support for browser modules to @solana/spl-token (#1337) 2021-02-25 14:56:09 +08:00
url.js Relocate js 2020-08-08 15:25:47 -07:00

README.md

Token JavaScript API

The Token JavaScript library comprises:

  • A library to interact with the on-chain program
  • A test client that exercises the program
  • Scripts to facilitate building the program

Getting Started

First fetch the npm dependencies, including @solana/web3.js, by running:

$ npm install

Select a Network

The client connects to a local Solana cluster by default.

To enable on-chain program logs, set the RUST_LOG environment variable:

$ export RUST_LOG=solana_runtime::native_loader=trace,solana_runtime::system_instruction_processor=trace,solana_runtime::bank=debug,solana_bpf_loader=debug,solana_rbpf=debug

To start a local Solana cluster run:

$ solana-test-validator

Solana cluster logs are available with:

$ solana --url http://127.0.0.1:8899/ logs

Build the on-chain program

$ npm run build:program

Run the test client

$ npm run start

Pointing to a public Solana cluster

Solana maintains three public clusters:

  • devnet - Development cluster with airdrops enabled
  • testnet - Tour De Sol test cluster without airdrops enabled
  • mainnet-beta - Main cluster

Use npm scripts to configure which cluster.

To point to devnet:

$ npm run cluster:devnet

To point back to the local cluster:

$ npm run cluster:localnet