polkadot-utilities

Polkadot Utility Packages

Five leaf packages provide foundational utilities across the monorepo. All are pure TypeScript, framework-agnostic, and published under the @polkadot-apps/ scope.

Decision Guide

Quick Start: Address

import {
  isValidSs58,
  ss58Decode,
  ss58Encode,
  normalizeSs58,
  ss58ToH160,
  h160ToSs58,
  truncateAddress,
} from "@polkadot-apps/address";

// Validate
isValidSs58("5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY"); // true

// Decode to raw bytes + network prefix
const { publicKey, prefix } = ss58Decode("5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY");

// Re-encode with Polkadot prefix (0)
const polkadotAddr = normalizeSs58("5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY", 0);

// SS58 <-> H160 EVM address conversion
const evmAddr = ss58ToH160("5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY");
const ss58Addr = h160ToSs58("0x9621dde636de098b43efb0fa9b61facfe328f99d");

// Display
truncateAddress("5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY"); // "5Grwva...utQY"

Quick Start: Crypto

import {
  xchachaEncrypt,
  xchachaDecrypt,
  deriveKey,
  randomBytes,
  sealedBoxEncrypt,
  sealedBoxDecrypt,
} from "@polkadot-apps/crypto";

// Symmetric encryption (XChaCha20-Poly1305 recommended for random nonces)
const key = randomBytes(32);
const { ciphertext, nonce } = xchachaEncrypt(data, key);
const plaintext = xchachaDecrypt(ciphertext, key, nonce);

// Key derivation
const encKey = deriveKey(masterSecret, "myapp-v1", "encryption");

// Asymmetric sealed box (anonymous sender)
import nacl from "tweetnacl";
const recipient = nacl.box.keyPair();
const sealed = sealedBoxEncrypt(message, recipient.publicKey);
const opened = sealedBoxDecrypt(sealed, recipient.secretKey);