qubic-js v0.0.0

qubic-js

Qubic client library. This is work in progress.

Installation

With pnpm:

pnpm add qubic-js

With yarn:

yarn add qubic-js

With npm:

npm i qubic-js

qubic

• qubic
  • .exports.crypto : Promise.<Crypto>
  • .createClient(options) ⇒ Client
  • .createConnection(params) ⇒ Connection
  • .privateKey(seed, index, K12) ⇒ Uint8Array
  • .createIdentity(seed, index) ⇒ Promise.<string>
  • .verifyChecksum(identity) ⇒ Promise.<boolean>
  • .seedChecksum(seed) ⇒ Promise.<string>
  • .createTransfer(params) ⇒ Promise.<object>

qubic.exports.crypto : Promise.<Crypto>

A promise which always resolves to object with crypto functions.

qubic.createClient(options) ⇒ Client

Emits: info, open, close, error, inclusion, rejection

Example

import { createClient } from 'qubic-js';

const client = createClient({
  seed: 'vmscmtbcqjbqyqcckegsfdsrcgjpeejobolmimgorsqwgupzhkevreu',
  computors: [
    { url: 'wss://AA.computor.com' },
    { url: 'wss://AB.computor.com' },
    { url: 'wss://AC.computor.com' },
  ],
  synchronizationInterval: 60 * 1000,
  adminPublicKey: '97CC65D1E59351EEFC776BCFF197533F148A8105DA84129C051F70DD9CA0FF82',
});

client.addListener('error', function (error) {
  console.log(error.message);
});
client.addListener('info', console.log);

qubic.createConnection(params) ⇒ Connection

Emits: info, open, close, error

Example

import { createConnection } from 'qubic-js';

const connection = createConnection({
  computors: [
    { url: 'wss://AA.computor.com' },
    { url: 'wss://AB.computor.com' },
    { url: 'wss://AC.computor.com' },
  ],
  synchronizationInterval: 60 * 1000,
  adminPublicKey: '97CC65D1E59351EEFC776BCFF197533F148A8105DA84129C051F70DD9CA0FF82',
});

connection.addListener('error', function (error) {
  console.log(error.message);
});
connection.addListener('info', console.log);

qubic.privateKey(seed, index, K12) ⇒ Uint8Array

Generates a private key from seed.

Returns: Uint8Array - Private key bytes.

qubic.createIdentity(seed, index) ⇒ Promise.<string>

Creates an identity with checksum.

Returns: Promise.<string> - Identity with checksum in uppercase hex.

qubic.verifyChecksum(identity) ⇒ Promise.<boolean>

Validates integrity of identity with checksum.

qubic.seedChecksum(seed) ⇒ Promise.<string>

Returns: Promise.<string> - Seed checksum in uppercase hex.

qubic.createTransfer(params) ⇒ Promise.<object>

Creates a transfer of energy between 2 entities.

Example

import { createTransfer } from 'qubic-js';

createTransfer({
  seed: 'vmscmtbcqjbqyqcckegsfdsrcgjpeejobolmimgorsqwgupzhkevreu',
  from: {
    identity: '9F6ADD0C591DBB8C0CE1EDF6F63A9E1C7BD22CFBD20DE1469ADAA76A9C0023707BE416',
    index: 1337,
    identityNonce: 0,
    energy: bigInt(2),
  },
  to: {
    identity: 'CD5B4A78521A9F9428F442E60E25DA63247817AB6BBF406CC91393F6664E38CBFE68DC',
    energy: bigInt(1),
  },
})
  .then(function (transfer) {
    console.log(transfer);
  })
  .catch(function (error) {
    console.log(error.message);
  });

Client

Mixes: Connection

• Client
  • instance
    • "inclusion"
    • "rejection"
  • static
    • .identity : string
    • .createTransfer(to) ⇒ object
    • .terminate([options])
    • .launch()
    • .close()
    • .sendCommand(command, payload) ⇒ Promise.<(object|void)>
    • .setComputorUrl(index, url)
    • .open()
    • .computors() ⇒ Array.<string>

"inclusion"

Inclusion event.

Properties

"rejection"

Rejection event.

Properties

Client.identity : string

Client identity in uppercase hex.

Client.createTransfer(to) ⇒ object

Returns: object - Transfer object.

Client.terminate(options)

Closes database and connections to computors.

Client.launch()

Launches client by opening database and connections to computors.

Emits: info, open, close, error, inclusion, rejection

Client.close()

Terminates all 3 WebSocket connections.

Mixes: close

Client.sendCommand(command, payload) ⇒ Promise.<(object|void)>

Sends a client command to each connected computor, and compares responses before resolving. Available client commands:

Command	Payload	Response	Description
1	{ identity }	{ identity, identityNonce }	Fetches identityNonce.
2	{ identity }	{ identity, energy }	Fetches energy.
3	{ message, signature }	void	Sends a transfer with base64-encoded message & signature fields.
4	{ hash }	{ hash, inclusionState, tick, epoch } or { hash, reason }	Fetches status of a transfer. Rejects with reason in case account nonce has been overwritten.

Mixes: sendCommand

Client.setComputorUrl(index, url)

Sets one of the 3 computors url each time.

Mixes: setComputorUrl

Client.open()

Opens all 3 WebSocket connections.

Mixes: open
Emits: info, open, close, error

Client.computors() ⇒ Array.<string>

Mixes: computors
Returns: Array.<string> - Array of computor urls.

Connection

• Connection
  • instance
    • "info"
    • "open" (event)
    • "error" (event)
    • "close" (event)
  • static
    • .close()
    • .sendCommand(command, payload) ⇒ Promise.<(object|void)>
    • .setComputorUrl(index, url)
    • .open()
    • .computors() ⇒ Array.<string>

"info"

Info event.

Properties

"open" (event)

Open event. Emitted when a WebSocket connection opens.

"error" (event)

Error event. Emitted when a WebSocket connection errors.

"close" (event)

Close event. Emitted when a WebSocket connection closes.

Connection.close()

Terminates all 3 WebSocket connections.

Connection.sendCommand(command, payload) ⇒ Promise.<(object|void)>

Sends a client command to each connected computor, and compares responses before resolving. Available client commands:

Command	Payload	Response	Description
1	{ identity }	{ identity, identityNonce }	Fetches identityNonce.
2	{ identity }	{ identity, energy }	Fetches energy.
3	{ message, signature }	void	Sends a transfer with base64-encoded message & signature fields.
4	{ hash }	{ hash, inclusionState, tick, epoch } or { hash, reason }	Fetches status of a transfer. Rejects with reason in case account nonce has been overwritten.

Connection.setComputorUrl(index, url)

Sets one of the 3 computors url each time.

Connection.open()

Opens all 3 WebSocket connections.

Emits: info, open, close, error

Connection.computors() ⇒ Array.<string>

Returns: Array.<string> - Array of computor urls.

Crypto : object

• Crypto : object
  • .schnorrq : object
    • .generatePublicKey(secretKey) ⇒ Uint8Array
    • .sign(secretKey, publicKey, message) ⇒ Uint8Array
    • .verify(publicKey, message, signature) ⇒ number
  • .K12(input, output, outputLength, outputOffset)

Crypto.schnorrq : object

• .schnorrq : object
  • .generatePublicKey(secretKey) ⇒ Uint8Array
  • .sign(secretKey, publicKey, message) ⇒ Uint8Array
  • .verify(publicKey, message, signature) ⇒ number

schnorrq.generatePublicKey(secretKey) ⇒ Uint8Array

schnorrq.sign(secretKey, publicKey, message) ⇒ Uint8Array

schnorrq.verify(publicKey, message, signature) ⇒ number

Returns: number - 1 if valid, 0 if invalid

Crypto.K12(input, output, outputLength, outputOffset)