LogoLogo
Open a Support Ticket!GridPlus.ioDiscordLattice Manager
  • Welcome!
  • Setup
    • Lattice1 First Time Setup
  • Lattice1
    • Lattice1 Introduction
    • Lattice1 Security Features
      • Lattice1 Random Number Generation
    • How the Lattice1 Makes Transactions Readable with ABI Decoding
      • Advanced ABI Decoding
    • How to Manage Your Seed Phrase
    • Lattice1 Power Supply
    • Supported Digital Assets
    • Lattice1 WiFi Troubleshooting
    • Lattice1 Firmware Reference
    • Lattice1 Guides 🛠️
      • Update the Firmware
      • Verify That Your Lattice1 Is Authentic
      • View the Seed Phrase on Your Lattice and SafeCard
      • Claim Your "Verified Lattice1 Owner" POAP and Discord Role
      • Establish a Connection With Your Lattice1 via SSH
      • Connect to WiFi Using SSH
      • Disable Wifi When Connected via Ethernet Using SSH
      • Managing ETH Validator Keys
  • SafeCards
    • Introduction to SafeCards
    • Setting up a New SafeCard
    • SafeCard Operations
    • Lattice1 Doesn't Recognize the Inserted SafeCard
    • SafeCard CLI
  • Apps & Integrations
    • Lattice Manager
      • Managing Your Bitcoin Wallet
      • Creating Custom Address Tags
      • Using the Wallet Explorer
      • Connecting Your Lattice to Your Own Private Endpoint
      • Lattice Manager Troubleshooting
      • How to View the XPUB of Your Bitcoin Wallet
    • MetaMask
      • Installing MetaMask
      • Connecting to MetaMask
      • Advanced MetaMask Setup
      • MetaMask Troubleshooting
    • NuFi
      • Connecting to NuFi
      • NuFi Troubleshooting
    • Frame
      • Installing Frame
      • Connecting to Frame
      • Advanced Frame Setup
      • Frame Troubleshooting
    • Rabby
      • Connecting to Rabby
      • Rabby Troubleshooting
    • MyCrypto
      • Connecting to MyCrypto
      • MyCrypto Troubleshooting
    • Ambire Wallet
      • Connecting to Ambire
      • Ambire Troubleshooting
  • Additional Resources
    • Payment, Shipping, Delivery
    • GridPlus Affiliate Program
    • Developer Resources
    • GridPlus Brand Assets
    • Bug Bounty & Responsible Disclosure Policy
  • Blockchain Basics
    • Introduction
    • Wallets
    • A Brief Introduction to Private Keys
    • Blocks & Consensus Mechanism
    • UTXO vs. Account Model
    • Bitcoin
    • Ethereum
      • Smart Contracts
      • ERC-20 tokens
      • NFTs
      • Layer 2s
Powered by GitBook
On this page
  • What You Can Do With the SafeCard CLI
  • What You Need to Manage Your SafeCards With the CLI
  1. SafeCards

SafeCard CLI

PreviousLattice1 Doesn't Recognize the Inserted SafeCardNextLattice Manager

Last updated 1 year ago

The SafeCard CLI is a free open-source application which ensures that you’ll always be able to recover critical backups stored on GridPlus SafeCards even if you no longer have access to a Lattice1.

What You Can Do With the SafeCard CLI

  1. Export Mnemonic (Seed Phrase) (only for cards with applet v2.4+, this means cards purchased in 2023 and on!) This allows you to export the 12/18/24-word mnemonic seed phrase for unlocking your wallet. Please note this is different from the option below - the seed hash itself. Most wallet providers only support importing the seed phrase, not the seed hash.

  2. Export Seed

    This function allows you to export your SafeCard wallet's binary seed (a hash of the more commonly used seed phrase). With the master seed, you have everything you need to derive any keys needed to gain access to your funds on another device.

  3. Export Private Keys

    This lets you export the individual private keys from your wallet directly. You will have to specify the starting export path.

  4. Delete Seed

    This completely erases your wallet seed from the SafeCard. Useful for both making sure no additional record of your wallet secrets exists and clearing the SafeCard before creating a new wallet. You can also delete the SafeCard seed directly on the Lattice1 by going to Manage Wallets and selecting Reset SafeCard Wallet when the SafeCard is inserted and unlocked.

  5. Change PIN You can also use the CLI to change your SafeCard's PIN if you don't have access to a Lattice device. If you do, it's way faster to do this via the Change SafeCard PIN option in the menu on the Lattice.

All SafeCard CLI operations are protected by your SafeCard's PIN. Just like with any other SafeCard operations, you always have only three attempts to unlock the card before the SafeCard bricks - once it bricks, it's gone forever and can't be reinstated.

NOTE: If you set up your SafeCard before Lattice1 HSM software version 0.12.1 (released late October 2021), you also had the possibility to select the SafeCard wallet to be non-exportable (this would make the SafeCard wallet impossible to copy in any way). If you have a non-exportable SafeCard wallet, please don't use it with STARK-based crypto!

If you're not sure if your SafeCard seed was set to exportable or non-exportable when created, you can go to and try creating an account. If the account creation fails, your seed is non-exportable.

You can make it exportable by resetting the SafeCard wallet and importing this seed on it again (from a seedphrase or by ).

What You Need to Manage Your SafeCards With the CLI

  1. One or more GridPlus SafeCards.

  2. A computer (MacOS or Windows, but you can also build from source on Linux).

  3. A generic card reader. We use and recommend .

  4. The SafeCard CLI binary. You can get it in the user guide!

  5. The SafeCard CLI user guide. You can find everything below:

Manage Wallets
zk.money
copying another Lattice/SafeCard wallet
this model
GitHub - GridPlus/safecard-cli: Golang based CLI for interacting with Safecards through an HID reader. Currently it's only function is to export the card's recovery seed.GitHub
Logo