Authentication
To get started with the Demos sdk, you need to create master seed for your wallet. The master seed is a 12 or 24 word mnemonic that can be used to recover your keypairs.
import { Demos } from "@kynesyslabs/demosdk/websdk"
const demos = new Demos()
const mnemonic = demos.newMnemonic()
console.log("master seed:", mnemonic)
const publicKey = await demos.connectWallet(mnemonic, {
algorithm: "ed25519",
})
console.log("public key: ", publicKey)
The demos.connectWallet method accepts either a mnemonic or a 128 byte seed buffer.If you provide any other buffer or string, it will be hashed using SHA-512 to get a 128 byte seed buffer which will be used as the master seed.
demos.connectWallet method accepts two fields for the options parameter
-
algorithm: string - The algorithm to generate keypairs for, and use for signing transactions and transmissions. Available options are ["ed25519", "falcon", "ml-dsa"]. Defaults to ed25519.
-
dual_sign: boolean - Only applicable when using a PQC algorithm in the previous option. If true, includes both the PQC signature and ed25519 signature in signed transactions. Defaults to false.
To use only the PQC signature in transactions, please check out PQC identities.
You can connect to a PQC algorithm as shown.
const publicKey = await demos.connectWallet(mnemonic, {
algorithm: "falcon",
dual_sign: true
})
console.log("public key: ", publicKey)
getAddress method.
const publicKey = demos.getAddress()
console.log(`${demos.algorithm} public key: `, publicKey)
const ed25519PubKey = await demos.getEd25519Address()
console.log("ed25519 public key:", ed25519PubKey)
What is a master seed?
With the introduction of Quantum-safe algorithms with support for ed25519, a lot of key types need to be generated. To keep this organized, a master seed is used together with a key derivation function to generate deterministic seeds for the various key types. These seeds are then used to generate keypairs.
How a master seed is used to recover keypairs from a mnemonic
Accessing your keypairs
You can access the keypairs generated by your master seed by tapping into the demos.crypto object. For example, to retrieve your ed25519 keypair:
const keypair = await demos.crypto.getIdentity("ed25519")
console.log("falcon keypairs:", keypair)
const falconKeys = demos.crypto.generateIdentity("falcon")
console.log("falcon keypair:", falconKeys)
Signing and verifying messages
You can sign messages using your connected keypair as shown:
const msg = "Hello World!"
// signing message
const signature = await demos.signMessage(msg)
console.log("signature:", signature)
// verifying signatures
const publicKey = await demos.getAddress()
const verified = await demos.verifyMessage(msg, signature.data, publicKey, {
algorithm: signature.type
})
console.log("signature verified:", verified)
Connecting to a RPC node
You can connect to the DEMOS block chain via a RPC node. Here is a list of public DEMOS nodes.
- https://demosnode.discus.sh
You can connect to a demos RPC node using the sdk as follows:
import { Demos } from "@kynesyslabs/demosdk/websdk";
const demos = new Demos()
await demos.connect("https://demosnode.discus.sh")
console.log("connected to rpc:", demos.connected)
demos.connect method confirms that the RPC URL provided is online. If the method exits without throwing an error, you are now ready to query the blockchain via NodeCalls.
Logging out
Once you are done with your instance, you can remove your keypair.
API Reference
