Skip to content

v1.0.1

Choose a tag to compare

@github-actions github-actions released this 23 Oct 19:18
· 16 commits to master since this release
a72772a

Highlights

  • Adds the first public build of igloo / igloo-cli with an Ink-powered terminal UI for
    FROSTR share operators.
  • Guides users through end-to-end keyset creation, encrypted share storage, and signer
    lifecycle management directly from the CLI.
  • Bundles policy configuration, relay inspection, and diagnostics (status checks,
    signer logs) so operators can validate peers before going online.
  • Ships key conversion helpers (npub, nsec, hex) for quick interoperability with other
    FROSTR tooling.

What’s Included

  • Interactive and flag-driven flows for generating k-of-n keysets and persisting
    encrypted shares.
  • Share management namespace (share add/list/load/status/signer/policy) covering
    import, inspection, peer pings, and signer activation.
  • Relay configuration commands plus live signer diagnostics with toggleable logging.
  • keys convert utilities to translate between nostr key formats without leaving the
    CLI.
  • Optional Bun scripts alongside the default Node.js toolchain for faster local
    development.
  • Rollup native binaries now pinned for both macOS and Linux runners (fixes the missing
    @rollup/rollup-linux-x64-gnu dependency in CI).

Install

  • Requires Node.js ≥ 18 (npm ≥ 10). Bun ≥ 1.0 is supported but optional.
  • Run npm install && npm run build (or bun install && bun run build:bun) and npm link
    to expose the igloo binary globally.
  • Use igloo --help or igloo --version to confirm the install.

Getting Started

  1. igloo keyset create to mint a 2-of-3 (or custom) share set; copy the generated nsec
    to a secure location.
  2. igloo share list and igloo share load to review encrypted shares on disk.
  3. igloo signer --share or igloo share signer to bring a share online; press l for
    live logs, q to exit.
  4. igloo share status --share to run a peer/relay health check before activating
    the signer.
  5. igloo keys convert --nsec for quick key format conversions while coordinating
    handoffs.

Notes & Next Steps

  • Echo transfer helpers remain behind the --debug-echo flag; production-grade
    automation is slated for a future release.
  • Consider scripting non-interactive flows with --password-file, --relays, and other
    automation flags for repeatable operator onboarding.
  • Planned improvements include richer signer telemetry, exportable logs, and multi-
    signer orchestration once igloo-core surfaces additional events.