signum-network@signumjs/core
Core module to build cool apps for the Signum blockchain platform
Installation
SignumJS is an isomorphic SDK and can be used with NodeJS, Web Browser, and even React Native. For non-pure Javascript Apps, e.g. PHP, .Net, it is possible to use a bundled/minified version.
Using with NodeJS and/or modern web frameworks
Install using npm:
npm install @signumjs/coreor using yarn:
yarn add @signumjs/coreExample
import {LedgerClientFactory} from '@signumjs/core'
import {Amount} from '@signumjs/util'
const ledger = LedgerClientFactory.createClient({
nodeHost: "https://europe3.testnet.network"
});
// this self-executing file makes turns this file into a starting point of your app
(async () => {
try {
const {balanceNQT} = await ledger.account.getAccountBalance('13036514135565182944')
console.log(`Account Balance: ${Amount.fromPlanck(balanceNQT).toString()}`)
} catch (e) { // e is of type HttpError (as part of @signumjs/http)
console.error(`Whooops, something went wrong: ${e.message}`)
}
})()Using in classic <script>
This is useful for plain html, js, css and also for PHP, .Net etc
Each package is available as bundled standalone library using IIFE.
This way SignumJS can be used also within <script>-Tags.
This might be useful for Wordpress and/or other PHP applications.
Just import the package using the HTML <script> tag.
<script src='https://cdn.jsdelivr.net/npm/@signumjs/core/dist/signumjs.min.js'></script>
Example
(() => {
const ledger = sig$.LedgerClientFactory.createClient( {nodeHost: "https://europe3.testnet.network"});
ledger.network.getBlockchainStatus().then(console.log).catch(console.error);
})()Initialize Crypto Module
The above examples don't need any specific cryptographic features. But when it comes up to signing/creating transactions, deciphering P2P messages you may encounter the following error:
No Crypto Adapter provided - Use [Crypto.init()] firstYou have to initialize the Crypto Module according to your platform somewhere in your apps entry point
NodeJS
import {Crypto} from "@signumjs/crypto"
import {NodeJSCryptoAdapter} from "@signumjs/crypto/adapters"
Crypto.init(new NodeJSCryptoAdapter());Web/Browser
import {Crypto} from "@signumjs/crypto"
import {WebCryptoAdapter} from "@signumjs/crypto/adapters"
Crypto.init(new WebCryptoAdapter());For React Native/Expo see here
See more here: @signumjs/core Online Documentation