@andreivcodes/spacemeshlib NPM

spacemeshlib

spacemeshlib is a typescript library for the Spacemesh network.

Installation

npm install @andreivcodes/spacemeshlib

yarn add @andreivcodes/spacemeshlib

Features

Imports Spacemesh API, builds it to typescript using ts-proto
Imports a modified fork of ed25519-WASM, and builds a .wasm file
Exports grpc clients using nice-grpc
Exports functions of ed25519.wasm through a TypeScript version of wasm_exex.js
Abstracts away a lot of the boilerplate of grpc and wasm.
Exports easy to work with functions as createClients(NETWORK_URL, 443, true) or derivePublicKey(SEED, 0)

Usage

import {
  toHexString,
  derivePrivateKey,
  derivePublicKey,
  getAccountBalance,
  getAccountNonce,
  submitTransaction,
  createClients,
  SubmitTransactionResponse,
} from '@andreivcodes/spacemeshlib'

const NETWORK_URL = 'https://api-devnet226.spacemesh.io/'

const SEED: string = process.env.SEEDPHRASE!

const RECIPIENT: string = '0x38DB093Ce43Fe3dB88D89568bAAeB68A6b5E74a6'.slice(2)

//loads public key from seed
const pk = (await derivePublicKey(SEED, 0)) as Uint8Array

//connects to network and returns nice-grpc clients
createClients(NETWORK_URL, 443, true)

//gets account nonce and balance
const accountNonce = await getAccountNonce(pk)
const accountBalance = await getAccountBalance(pk)

if (accountBalance < amount) {
  console.log('I am out of funds :(')
  return
}

//changing state of the mesh requires a private key, so we load that
//same as we did with public key, but using derivePrivateKey
const pk = (await derivePrivateKey(SEED, 0)) as Uint8Array

//submit a transaction
submitTransaction({
  accountNonce: accountNonce,
  receiver: RECIPIENT
  gasLimit: 1,
  fee: 1,
  amount: 100,
  secretKey: sk,
})
  //and get a response back
  .then((response: SubmitTransactionResponse) => {
    console.log(`💸 just transferred funds to ${RECIPIENT}.`)
    console.log(`Tx ID: 0x${toHexString(response.txstate?.id?.id!)}`)
  })
  .catch((err: any) => {
    console.log(`could not transfer :( submitTransaction failed`)
    console.log(err)
  })