@puttest.io/ppl-token

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 @puttest.io/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

Releasing

• (first-time only) Create your account on npmjs.com (with 2FA enabled!) and ask @mvines about granting the publish right and run npm login
• Bump version in package.json and npm install (to update package-lock.json)
• Create a PR for the version bump
• Merge the PR and push new git tag on master branch
• Create release on github.com from the pushed tag
• Run npm run build and npm publish