Packages

@onmax/nimiq-mini-app-simulator

Local host-shell and injected-provider simulator for Nimiq mini-app development.

@onmax/nimiq-mini-app-simulator

This package gives you a local window.nimiq simulator plus helpers for a mock host shell and a Nuxt dev sidecar.

Exports

  • @onmax/nimiq-mini-app-simulator
  • @onmax/nimiq-mini-app-simulator/nuxt

Root helpers

  • createSimulatedNimiqProvider()
  • createSimulatedNimiqProviderController()
  • installSimulatedNimiqProvider()
  • createSimulatedHostRuntime()
  • waitForInjectedNimiqProvider()
  • createBridgeNimiqProvider()
  • serializeSimulatedHostLaunchPayload()
  • consumeSimulatedHostLaunchPayload()

Nuxt module

nuxt.config.ts
export default defineNuxtConfig({
  modules: ['@onmax/nimiq-mini-app-simulator/nuxt'],
})

The module can be configured through nimiqMiniAppSimulator with:

  • enabled
  • host
  • port
  • appName
  • appUrl
  • playerAddress
  • playerPrivateKey
  • initialBalanceLuna

Use cases

  • Inject deterministic account and signature responses in local mini-app development.
  • Start a separate mock host window during Nuxt dev.
  • Simulate claim payouts and host-side wallet state before you integrate a real host app.
Copyright © 2026