Layerswap Docs

These fixes apply only to the self-bundled @layerswap/widget. The recommended React and JavaScript loaders do not put these dependencies in your bundle.

Vite: `process is not defined`

Install the Node polyfill plugin:

npm install --save-dev vite-plugin-node-polyfills @vitejs/plugin-react

vite.config.ts

import react from '@vitejs/plugin-react';
import { defineConfig } from 'vite';
import { nodePolyfills } from 'vite-plugin-node-polyfills';

export default defineConfig({
  plugins: [react(), nodePolyfills()],
  esbuild: { target: 'esnext' },
});

Next.js: Node-only module errors

For webpack builds, disable browser resolution for Node-only modules and externalize optional server packages:

next.config.ts

import type { NextConfig } from 'next';

const nextConfig: NextConfig = {
  webpack: (config) => {
    config.resolve.fallback = { fs: false, net: false, tls: false };
    config.externals.push('pino-pretty', 'lokijs', 'encoding');
    return config;
  },
};

export default nextConfig;

Next.js: ESM package resolution

The published next builds contain extensionless ESM imports. Without transpilation, Node’s SSR loader can reject an internal import with ERR_MODULE_NOT_FOUND, commonly for a path ending in /knownIds. Add the Widget’s shared packages and every installed @layerswap/wallet-* package to transpilePackages:

next.config.ts

const nextConfig = {
  transpilePackages: [
    '@layerswap/widget',
    '@layerswap/widget-types',
    '@layerswap/utils',
    '@layerswap/ui-kit',
    '@layerswap/wallet-core',
    '@layerswap/wallet-evm',
    '@layerswap/wallet-starknet',
    '@layerswap/wallet-imtbl-passport',
  ],
};

export default nextConfig;

Replace the wallet-package entries with every chain package your host installs; include @layerswap/wallets too if you use the lazy descriptor package. The package names use the published wallet-imtbl-* and wallet-module-* forms. Re-check the module packages against the 2.0.0 release.

Start here

Configuration

Production

Guides & tools

Self-bundled Widget

Build troubleshooting

Vite: `process is not defined`

Next.js: Node-only module errors

Next.js: ESM package resolution

​Vite: process is not defined

​Next.js: Node-only module errors

​Next.js: ESM package resolution

Vite: `process is not defined`

Next.js: Node-only module errors

Next.js: ESM package resolution