@polymathnetwork/polymesh-sdk

@polymathnetwork/polymesh-sdk

## Polymesh version This release is compatible with Polymesh v4.1.0 ## Getting Started ### Purpose The Polymesh SDK's main goal is to provide external developers with a set of tools that will allow them to build powerful applications that interact with the Polymesh protocol. It focuses on abstracting away all the complexities of the Polymesh blockchain and expose a simple but complete interface. The result is a feature-rich, user-friendly node.js library. ### Before moving on This document assumes you are already familiar with [Security Tokens](https://thesecuritytokenstandard.org/) in general and [Polymath](https://www.polymath.network/) as well as [Polymesh](https://polymath.network/polymesh) in particular. ### Technical Pre-requisites In order to use the Polymath SDK, you must install [node](https://nodejs.org/) \(version 10\) and [npm](https://www.npmjs.com/). The library is written in [typescript](https://www.typescriptlang.org/), but can also be used in plain javascript. This document will assume you are using typescript, but the translation to javascript is very simple. ### Documentation Token Studio SDK Walkthrough: https://developers.polymath.network/token-studio-api-walkthrough/ Polymesh SDK API Reference: https://developers.polymath.network/polymesh-sdk-api-reference/ ### How to use #### Installation `npm i @polymathnetwork/polymesh-sdk --save` Or, if you're using yarn `yarn add @polymathnetwork/polymesh-sdk` **NOTE** if using TypeScript the compiler option "skipLibCheck" should be set to true in your tsconfig.json file #### Initializing the client Before you can start registering Tickers and creating Assets, you have to connect the Polymesh SDK client to a Polymesh node. This is a pretty straightforward process: ```typescript import { Polymesh } from '@polymathnetwork/polymesh-sdk'; import { LocalSigningManager } from '@polymathnetwork/local-signing-manager'; async function run() { const signingManager = await LocalSigningManager.create({ accounts: [ { seed: 'YOU_WISH', }, ], }); const polyClient = await Polymesh.connect({ nodeUrl: 'wss://some-node-url.com', signingManager, }); // do stuff with the client } ``` Here is an overview of the parameters passed to the `connect` function: - `nodeUrl` is a URL that points to a running Polymesh node - `signingManager` is an object that complies with the `SigningManager` interface. It holds the Accounts capable of signing transactions, and the signing logic itself. In this example, `LocalSigningManager` is a simple signing manager that holds private keys in memory and signs with them **NOTE:** if using the SDK on a browser environment \(i.e. with the Polymesh wallet browser extension\), you would use the `BrowserExtensionSigningManager` provided by `@polymathnetwork/browser-extension-signing-manager` ```typescript import { Polymesh } from '@polymathnetwork/polymesh-sdk'; import { BrowserExtensionSigningManager } from '@polymathnetwork/browser-extension-signing-manager'; async function run() { const signingManager = await BrowserExtensionSigningManager.create('MY_APP_NAME'); // The Polymesh wallet extension will ask the user to authorize MY_APP_NAME for access const polyClient = await Polymesh.connect({ nodeUrl: 'wss://some-node-url.com', signingManager, }); // do stuff with the client } ```