Easy SPL

Making tokens on Solana easy!

Motivation

SPL tokens are difficult to get started with. They function differently from other common blockchain-based tokens. There is no single stateful contract (as in ERC-20 tokens). Tokens aren't even held in a user's root account! Instead a user creates a new account (that their root account has authority over) for each token they want to interact with. Each token contract stores the number of decimals for a mint, but tokens are sent around without reference to the number of decimals. So to send 1 token of a mint with 4 decimals, you need to send 1000 tokens.

All of this is prone to developer error and diffiult to keep straight when getting started!

We wanted to develop a library that papers over all of these difficulties. Using Easy SPL, you don't have to think about associated token accounts or decimals! We also include some stateful classes for repeated interactions with a mint or given user wallet.

Use

See the Documentation for full details

import * as spl from 'easy-spl'
const connection = new web3.Connection('https://api.devnet.solana.com', 'confirmed')

// create accounts and wallets
const keypairAlice = web3.Keypair.generate()
const alice = spl.Wallet.fromKeypair(connection, keypairAlice)
const keypairBob = web3.Keypair.generate()
const bob = spl.Wallet.fromKeypair(connection, keypairBob)

// create a new mint controlled by alice with 6 decimals
const mint = await spl.Mint.create(connection, 6, alice.publicKey, alice)

// mint 10 tokens to bob
await mint.mintTo(bob.publicKey, alice, 10)

// send 5 tokens to alice
await bob.transferToken(mint.key, alice.publicKey, 5)

// check bob's balance
const balance = await mint.getBalance(bob.publicKey)
// OR
const balance = await bob.getBalance(mint.key)

// get mint decimals
const decimals = await mint.getDecimals()

// get mint supply (total tokens in circulation
const supply = await mint.getSupply()

Connected wallets

Connected wallets can also be instantiated from any wallet that uses the common Solana wallet interface. For instance, from the solana labs browser wallet-adapter package. Or signers in anchor

import * as spl from 'easy-spl'
import { useConnection, useWallet } from "@solana/wallet-adapter-react"

export default function OurComponent () {
  const wallet = useWallet()
  const { connection } = useConnection()

  const user = spl.Wallet.fromWallet(connection, wallet)

  ...
}

Txs & Instructions

Sometimes you need to just format the instructions for something, without sending. In that case you can use the txs & instructions api.

Note: any function that has the word "raw" in it, refers to addresses in terms of associated token accounts and amounts in terms of integer amounts (multiplied out by the token decimals).

Each method includes 4-5 variations:

• instructions: get just the instruction for the operation
• rawInstructions: get just the instruction, but parameters are given as associated token accounts and integer amounts
• tx: get the tx for the operation, with recentBlockhash & feePayer filled out
• signed: get the formatted tx for the operation & sign with the given wallet
• send: get the signed tx for the operation, send to the network, and wait for confirmation

See the Documentation for more details.

Development

# install dependencies
yarn

# build
yarn build

# compiler with reloading
yarn dev

# test
yarn test

# test with reloading
yarn test:watch

# docs
yarn docs

# lint
yarn lint