Install the Cascade SDKs

Lumera Protocol ships official SDKs for JavaScript and Go. This page installs both, explains the peer dependencies, and covers the bundler configuration that browser apps sometimes need.

Requirements

SDK	Requirement
JavaScript	Node.js 18 or later
Go	Go 1.26

You also need two things before you upload.

A Lumera wallet. Use a mnemonic for programmatic signing, or Keplr or Leap in the browser.
Testnet ulume from the faucet.

Install the JavaScript SDK

The JavaScript and TypeScript SDK is the main way to use Cascade from web and Node.js applications.

npm install @lumera-protocol/sdk-js @cosmjs/proto-signing @cosmjs/stargate

yarn add @lumera-protocol/sdk-js @cosmjs/proto-signing @cosmjs/stargate

pnpm add @lumera-protocol/sdk-js @cosmjs/proto-signing @cosmjs/stargate

@cosmjs/proto-signing and @cosmjs/stargate are peer dependencies. The SDK uses them for wallet and transaction handling. For a full walkthrough, see JavaScript SDK.

Browser bundler configuration

If you use Vite, you may need polyfills for Node.js globals.

npm install vite-plugin-node-polyfills vite-plugin-wasm vite-plugin-top-level-await

yarn add vite-plugin-node-polyfills vite-plugin-wasm vite-plugin-top-level-await

pnpm add vite-plugin-node-polyfills vite-plugin-wasm vite-plugin-top-level-await

vite.config.ts

import { defineConfig } from "vite";
import { nodePolyfills } from "vite-plugin-node-polyfills";
import wasm from "vite-plugin-wasm";
import topLevelAwait from "vite-plugin-top-level-await";

export default defineConfig({
  plugins: [
    wasm(),
    topLevelAwait(),
    nodePolyfills({
      include: ["buffer", "process"],
      globals: { Buffer: true, global: true, process: true },
    }),
  ],
  optimizeDeps: {
    exclude: ["undici", "@bokuweb/zstd-wasm"],
  },
  define: {
    "process.env": "{}",
  },
});

For webpack in Next.js, add fallbacks in next.config.js.

next.config.js

/** @type {import('next').NextConfig} */
module.exports = {
  webpack: (config) => {
    config.resolve.fallback = {
      ...config.resolve.fallback,
      fs: false,
      path: false,
      crypto: false,
    };
    return config;
  },
};

Install the Go SDK

The Go SDK targets server-side applications, CLI tools, and backend services. It queries the chain over gRPC and connects to SuperNodes directly. Add it inside a Go module.

# Initialize a module if you don't have one yet
go mod init your-project

# Add the SDK
go get github.com/LumeraProtocol/sdk-go@latest

For a full walkthrough, see Go SDK.

Verify the installation

Follow the Quickstart to confirm everything works. It creates a client, connects to testnet, and uploads a file in under 50 lines.

Next steps

Client setup

Create a client with presets, custom endpoints, and a signer.

JavaScript SDK

Walk through the JavaScript SDK from setup to upload.

Go SDK

Build server-side uploads with the Go SDK.

Overview

Get started

The Intelligence Layer

SDKs

Smart contracts

Operate the Network

Interoperability

Applications

Protocol Reference

Requirements

Install the JavaScript SDK

Browser bundler configuration

Install the Go SDK

Verify the installation

Next steps

Client setup

JavaScript SDK

Go SDK

​Requirements

​Install the JavaScript SDK

​Browser bundler configuration

​Install the Go SDK

​Verify the installation

​Next steps

Client setup

JavaScript SDK

Go SDK

Requirements

Install the JavaScript SDK

Browser bundler configuration

Install the Go SDK

Verify the installation

Next steps