Repository navigation
Releases
v0.5.0-preview.1 — Experimental macOS preview
Initial experimental preview for recovering historical Bitte and Mintbase NEAR passkey wallets on the user's Mac. This is a prerelease, not a stable or independently audited release.
Included
- Recovery for the captured historical implementations at
wallet.bitte.aiandwallet.mintbase.xyzusing the original passkey. - Public NEAR account/access-key lookup, standard WebAuthn authentication, and on-device reconstruction with matching-only private-key export.
- Setup modes for Apple Passwords, Google Password Manager, extension managers, hardware security keys, and passkeys on another device.
- Synthetic tests, publication checks, and macOS preview build tooling.
Download the macOS app
Download bitte-local-recovery-0.5.0-macos-universal-preview.zip from Assets below. Requires macOS 13+ and Google Chrome installed in Applications. Node is bundled; no Terminal setup is needed.
Experimental, ad-hoc signed and not notarized. Apple has not verified this app's publisher or scanned this build through notarization. macOS may block first launch.
- Extract the ZIP and move Bitte Local Recovery.app to Applications.
- Double-click the app. If macOS says the developer cannot be verified or Apple cannot check it, close the alert.
- If you trust this release, open System Settings → Privacy & Security, find the blocked-app message, select Open Anyway, and confirm Open. Follow Apple's per-app opening guidance.
- Choose your passkey provider and follow the recovery page instructions. Quit Recovery when finished.
Keep Gatekeeper enabled. Do not remove quarantine, bypass Chrome certificate warnings, or install certificates into Keychain. If macOS says the app is damaged or will harm your computer, stop and report it instead of overriding that alert.
The .sha256 file contains the ZIP checksum. To check it from Terminal, put the ZIP and checksum in the same folder and run shasum -a 256 -c bitte-local-recovery-0.5.0-macos-universal-preview.zip.sha256. The .manifest.json lists bundled file hashes and pinned runtimes. A checksum detects changed bytes; it does not establish publisher identity or replace a security audit.
Run from source
Download Source code (zip) below and extract it. Install Node.js 22 or newer and Google Chrome on macOS, then open Terminal in the extracted folder and run:
npm ci --ignore-scripts --no-audit --no-fund
npm run build
npm startThe default is Apple Passwords. For Google Password Manager, use npm start -- --provider=google. Keep Terminal open and press Control+C when finished. See the README at this release for recovery instructions and other provider IDs.
Validation and limits
- Published from commit
47d0c1af3fa6c46c0e8ddecd3fdf01c2abd8c86bafter its Linux and macOS CI checks passed, including the universal macOS preview build. - Provider integration has synthetic test coverage; genuine provider/device compatibility and Intel execution remain unverified.
- The attached macOS app is an owner-authorized experimental preview built from a clean copy of the release commit. Stable app releases still require Developer ID signing, notarization, and recorded provider/device validation.
- Windows and Safari launchers and password-based wallets are not supported.
- The original passkey is required; a new passkey cannot replace it. No on-chain transaction is performed.
- Recovered key files are unencrypted. Save them outside synced folders and never share them or attach them to issues.
- The historical wallet derives its NEAR key from the credential public point. A provider knowing that point could independently derive the same wallet key. This tool cannot change that historical trust boundary.
This community project is not affiliated with Bitte, Mintbase, NEAR, or any password manager. Use at your own risk.