@iov/lisk


Getting started

The primary way to use @iov/lisk is together with @iov/multichain. Alternatively,
you can use @iov/lisk to create offline transactions which can be posted manually.

All examples are made for use in @iov/cli and you may need to include some
missing symbols if used in a different environment.

$3

You can use @iov/lisk as an extension of @iov/multichain to interact with the
Lisk blockchain as follows.

``ts
import { Ed25519Wallet } from "@iov/keycontrol";
import { passphraseToKeypair, liskCodec, createLiskConnector } from "@iov/lisk";

const wallet = new Ed25519Wallet();
const mainIdentity = await wallet.createIdentity(
await passphraseToKeypair(
"oxygen fall sure lava energy veteran enroll frown question detail include maximum",
),
);

const profile = new UserProfile();
profile.addWallet(wallet);

const signer = new MultiChainSigner(profile);
await signer.addChain(createLiskConnector("https://testnet.lisk.io"));
const chainId = signer.chainIds()[0];
const connection = signer.connection(chainId);

const mainAddress = signer.identityToAddress(mainIdentity);
console.log((await connection.getAccount({ address: mainAddress })).data[0].balance);

const recipientAddress = "6076671634347365051L" as Address;

const sendTx: SendTransaction = {
kind: "bcp/send",
chainId: chainId,
sender: mainAddress,
senderPubkey: mainIdentity.pubkey,
recipient: recipientAddress,
memo: "We ❤️ developers – iov.one",
amount: {
quantity: "144550000",
fractionalDigits: 8,
tokenTicker: "LSK" as TokenTicker,
},
};

console.log("Writing to blockchain. This may take a while …");
await signer.signAndPost(mainIdentity, sendTx);
console.log((await connection.getAccount({ address: recipientAddress })).data[0].balance);
`

$3

This is how you use liskCodec to generate send transactions
for Lisk manually, i.e. without the help of @iov/multichain.

`ts
import { Ed25519Wallet } from "@iov/keycontrol";
import { passphraseToKeypair, generateNonce, liskCodec } from "@iov/lisk";

const liskTestnet = "lisk-da3ed6a454" as ChainId;

const wallet = new Ed25519Wallet();
const mainIdentity = await wallet.createIdentity(
await passphraseToKeypair(
"oxygen fall sure lava energy veteran enroll frown question detail include maximum",
),
);
const mainAddress = signer.identityToAddress(mainIdentity);

const recipientAddress = "6076671634347365051L" as Address;

const sendTx: SendTransaction = {
kind: "bcp/send",
chainId: liskTestnet,
sender: mainAddress,
senderPubkey: mainIdentity.pubkey,
recipient: recipientAddress,
memo: "We ❤️ developers – iov.one",
amount: {
quantity: "144550000",
fractionalDigits: 8,
tokenTicker: "LSK" as TokenTicker,
},
};

const nonce = generateNonce();
const signingJob = liskCodec.bytesToSign(sendTx, nonce);
const signature = await wallet.createTransactionSignature(
mainIdentity,
signingJob.bytes,
signingJob.prehashType,
liskTestnet,
);

const signedTransaction = {
transaction: sendTx,
primarySignature: {
nonce: nonce,
publicKey: mainIdentity.pubkey,
signature: signature,
},
otherSignatures: [],
};

// Signed transacion you can POST to
// https://testnet.lisk.io/api/transactions
const bytesToPost = fromUtf8(liskCodec.bytesToPost(signedTransaction));
console.log(bytesToPost);
`

Lisk HD wallets

Lisk codec and Ed25519HdWallet combined allow you to create a pure
software implementation of the the Lisk wallet on Ledger or Trezor.

$3

The following code snippet shows how to implement address discovery.

`ts
import { Ed25519HdWallet } from "@iov/multichain";
import { Slip10RawIndex } from "@iov/crypto";
import { liskCodec, LiskConnection } from "@iov/lisk";

const liskTestnet = "lisk-da3ed6a454" as ChainId;

async function deriveAddress(wallet, a): Promise