Koinos One v1.0.3

[1.0.3] - 2026-07-02

Changed

• Started the next post-1.0.2 feature track on version 1.0.3 so assistant,
  wallet safety, documentation, and release-preparation changes are tracked
  together before the next release.
• Documented the release-branch policy in project memory: after a release,
  continue user-facing work on a feature branch with the next intended SemVer
  version, keep the changelog and docs current there, and merge/tag/package
  only when the user asks to release it.
• Documented that first-run assistant surfaces must stay compact and guided,
  without raw command output, JSON payloads, expert logs, or debug panels.
• Added an explicit assistant restore choice to skip public backup restore and
  sync from seed peers when the user prefers the slower, backup-free trust path.
• Added assistant detection for existing local node data in the selected data
  folder, with a keep-local-copy option and age comparison against the public
  backup before restore.
• Improved the assistant wallet step so returning after wallet creation asks
  whether to keep the current wallet, create a new one, or import an existing
  wallet.
• Improved Node preset reporting so the active preset reflects the running
  monolith feature flags and a selected-but-not-applied producer preset is shown
  as pending instead of active.
• Changed first-run setup detection so completed setup survives DMG reinstalls
  and app updates, with a Settings action to intentionally run the assistant
  again.
• Updated node startup so the selected monolith preset is applied before
  launch; selecting Mainnet Producer now attempts producer features instead of
  silently reusing stale observer feature flags.
• Updated the app and embedded manual visual style toward the first-run
  assistant palette, with lighter operational surfaces, calmer purple accents,
  and more consistent Documentation tab styling.
• Expanded the rendered MkDocs manual with Koinos protocol, monolith
  architecture, and service-coverage deeper reference pages.
• Removed the Authoring Prompts section from the public manual while keeping
  the internal prompt files excluded from the generated static site.
• Converted manual references to other manual pages into MkDocs links and
  converted repository source references to official GitHub links.
• Documented the one-click local node and agent strategy as backlog product
  planning material.

Fixed

• Fixed Wallet Send and Burn defaults so the receiver account always starts as
  the active wallet account, not a producer address or stale account from a
  previous operation.
• Hid raw wallet action output from the assistant wallet step after wallet
  creation so the setup flow remains simple.
• Added regression coverage for wallet action receiver defaults.
• Fixed failed preset apply attempts so they no longer persist the requested
  profile when the runtime preflight rejects the change.
• Fixed first-run assistant detection so replacing the packaged app no longer
  looks like a clean first install when local setup was already completed.
• Fixed the Node Start button so it is disabled while a node is already
  running and directs mode changes through Presets > Apply.
• Fixed running-node public restore failures caused by stale local Backup Admin
  tokens by showing a user-facing recovery message instead of leaking the raw
  unauthorized admin route.
• Hardened native libp2p stream, host, gossip, and disconnect callbacks so
  peer transport exceptions are converted into peer-level errors instead of
  aborting teleno_node.
• Added stable P2P identity key handling and regression coverage for generated
  and configured libp2p identities.

Koinos One v1.0.2

Added

• Added a Documentation tab in Koinos One with the initial manual structure for
  Koinos concepts, the Koinos One user guide, the teleno_node CLI guide,
  developer documentation, and reference material.
• Added MkDocs static documentation rendering inside the Documentation tab.
• Added the project changelog to the local rendered Documentation manual, with
  stable anchors for each released version.
• Added footer-version navigation so clicking the version badge opens the
  Documentation tab at the matching local changelog entry.
• Added macOS menu bar background mode, enabled by default on macOS and
  configurable from Settings.
• Added a macOS template Koinos cube tray icon, sanitized status menu, and
  menu actions to show Koinos One, stop the managed node, and quit safely.
• Added menu-bar-only hidden-window behavior on macOS: while backgrounded, the
  Dock icon is hidden and is restored when the app window is shown.
• Added first-run assistant refinements for the welcome, data-folder, public
  backup restore, progress, and previous-step flows.

Changed

• Updated Settings copy to explain that background mode hides both the window
  and Dock icon while managed node services can continue from the menu bar.
• Updated release documentation so creating a release requires a version bump,
  changelog update, and rendered manual changelog entry.
• Improved the first-run assistant by keeping testnet setup out of the default
  first-install path and making public backup restore terminology consistent.

Fixed

• Fixed MkDocs side-navigation links opening the Koinos One app recursively
  inside the Documentation tab.
• Improved the Documentation tab layout so rendered MkDocs pages use more of
  the app window and center better on wide screens.
• Fixed the macOS tray asset so it is a transparent template mark instead of a
  filled square in the upper-right menu bar.
• Fixed first-run restore visibility so the assistant can reuse the same
  restore progress surface as the main app.

Release verification:

• Commit: 914e37d
• DMG notarization: Accepted (submission c593396e-5f5b-48b3-9a26-f6961e806fdf)
• DMG Gatekeeper: accepted as Notarized Developer ID
• SHA256: 2af1cb200d7d048b4e86d13f10b2a7e1a7b6906ad2cc6dfefc0942c1dd00e47a

Koinos One 1.0.1

Koinos One 1.0.1

macOS arm64 DMG release for Koinos One.

This DMG is signed with Developer ID, notarized by Apple, and stapled. The packaged app and DMG both pass local Gatekeeper validation as Notarized Developer ID.

Highlights

• Native restore staging progress now reports live file and byte progress after public bootstrap download.
• In-progress restores can be stopped safely from the UI. Cancelled restores preserve staging data and do not activate a partial database.
• Stale restore-staging.partial failures now produce an actionable recovery path and retry cleanup only touches the stale restore staging folder.
• Node and Wallet controls explain disabled states through tooltips.
• Settings treats the selected Base Data Folder as the default root for local native backup paths.
• Release build metadata now reports clean source state correctly.

Build Identity

• Product version: 1.0.1
• Release channel: stable
• Git commit: 9b7beae
• Native node SHA256: 6f72a1d95bc38e20e01b439472041b4168db0a7835a645f35311bb0c84667892
• DMG SHA256: 699e4659f0dbf3cf0c1b8a6404dbf64a78d55e73a2892b50a4eadc2237daea53
• Apple notarization submission: 734b2ecd-ef65-4001-b741-47a60ae8e3c9

Validation

• APPLE_KEYCHAIN_PROFILE=KoinosOneNotary npm run package:mac
• Package staging verification passed.
• Packaged app verification passed.
• xcrun stapler validate passed for KoinosOne.app and KoinosOne-1.0.1-arm64.dmg.
• spctl accepted both the app and DMG as Notarized Developer ID.

Full Changelog: https://github.com/pgarciagon/koinos-one/commits/v1.0.1