JavaScript/ TypeScript SDK

# Initialize a project if you don't have one yet
npm init -y
 
# Install the SDK along with dependencies for transaction signing and blockchain queries
npm install @lumera-protocol/sdk-js @cosmjs/proto-signing @cosmjs/stargate

import { createLumeraClient } from "@lumera-protocol/sdk-js";
 
const client = await createLumeraClient({
  preset: "testnet",
  signer: signer as any,          // Keplr, Leap, or DirectSecp256k1HdWallet
  address: account.address,
  gasPrice: "0.025ulume",
});

const file = new TextEncoder().encode("Hello, Lumera!");
const expirationTime = String(Math.floor(Date.now() / 1000) + 25 * 60 * 60); // 25 hours from now 
 
const task = await client.Cascade.uploader.uploadFile(file, {
  fileName: "hello.txt",
  isPublic: true,
  expirationTime,
});
 
console.log("Upload task:", task.taskId, "status:", task.status);

const stream = await client.Cascade.downloader.download(actionId);
const reader = stream.getReader();
const chunks: Uint8Array[] = [];
 
while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  if (value) chunks.push(value);
}

// Action parameters and fees (getActionFee takes size in KB, rounded up)
const params = await client.Blockchain.Action.getParams();
const fee = await client.Blockchain.Action.getActionFee(Math.ceil(file.length / 1024));
 
// Look up a specific action
const action = await client.Blockchain.Action.getAction(actionId);
 
// List supernodes
const nodes = await client.Blockchain.Supernode.listSupernodes();

import { getKeplrSigner, isKeplrAvailable } from "@lumera-protocol/sdk-js";
 
if (!isKeplrAvailable()) {
  throw new Error("Please install the Keplr extension");
}
 
const keplrSigner = await getKeplrSigner("lumera-testnet-2");

import {
  createLumeraClient,
  type LumeraClient,
  CHAIN_PRESETS,
 
  // Cascade
  CascadeUploader,
  CascadeDownloader,
  SNApiClient,
  TaskManager,
 
  // Blockchain utilities
  buildBatchMessages,
  estimateGas,
  calculateCascadeFee,
  BlockchainActionAdapter,
 
  // LEP-1 (internally used by CascadeUploader)
  createSingleBlockLayout,
  generateIds,
  buildIndexFile,
 
  // Wallet
  getKeplrSigner,
  isKeplrAvailable,
} from "@lumera-protocol/sdk-js";