• Top
  • Documentation
  • Books
  • Recursion-and-induction
  • Boolean-reasoning
  • Debugging
  • Projects
  • Std
  • Proof-automation
  • Macro-libraries
  • ACL2
  • Interfacing-tools
  • Hardware-verification
  • Software-verification
    • Kestrel-books
      • Crypto-hdwallet
        • Command-error
        • Sign
        • Init-from-mnemonic
        • Command-error-message
        • Stat
        • Next-key
        • Init-from-entropy
        • Process-command
        • Transaction-message
        • Maybe-command-error
        • Maybe-stat
        • Check-stat-file-present
        • Valid-key-path-p
        • String-to-byte-list
        • Load-stat
        • Mnemonic-message
        • All-valid-key-paths-p
        • Process-sign
        • Process-init-from-entropy
        • String-to-word
        • String-to-nat
        • Process-next-key
        • Wallet
        • Process-init-from-mnemonic
        • Check-stat-file-absent
        • Stat-wfp
        • Save-stat
        • Stat-addresses-bounded-p
        • Stat-all-valid-key-paths-p
        • Stat-priv-keys-p
        • Stat-root-depth-zero-p
        • Stat-path-prefix-in-tree-p
        • Crypto-hdwallet-executable
        • *stat-filepath*
        • *key-path-prefix*
        • *coin-type-index*
        • *purpose-index*
        • *external-chain-index*
        • *command-name-init-from-mnemonic*
        • *command-name-init-from-entropy*
        • *account-index*
        • *command-name-sign*
        • *command-name-next-key*
      • Error-checking
      • Apt
      • Abnf
      • Fty-extensions
      • Isar
      • Kestrel-utilities
      • Prime-field-constraint-systems
      • Soft
      • Bv
      • Imp-language
      • Event-macros
      • Bitcoin
      • Ethereum
      • Yul
      • Zcash
      • ACL2-programming-language
      • Prime-fields
      • Java
      • C
      • Syntheto
      • Number-theory
      • Cryptography
      • Lists-light
      • File-io-light
      • Json
      • Built-ins
      • Solidity
      • Axe
      • Std-extensions
      • Htclient
      • Typed-lists-light
      • Arithmetic-light
    • X86isa
    • Execloader
    • Axe
  • Testing-utilities
  • Math

• Crypto-hdwallet

Load-stat

Load the state of the wallet from a file.

Signature

(load-stat state) → (mv error? stat? state)

Returns

error? — Type (maybe-command-error-p error?).

stat? — Type (maybe-statp stat?).

The name suffix -stat of this function is consistent with the type name stat. It emphasizes the wallet state, as opposed to the ACL2 state.

serialize-read throws a hard error upon failure. This may acceptable if the shell script that calls the wallet can catch that and turn into a more user-oriented error message.

Definitions and Theorems

Function: load-stat

(defun load-stat (state)
       (declare (xargs :stobjs (state)))
       (declare (xargs :guard t))
       (b* (((mv stat? state)
             (serialize-read *stat-filepath*))
            ((unless (and (statp stat?) (stat-wfp stat?)))
             (mv (command-error-state-file-malformed)
                 nil state)))
           (mv nil stat? state)))

Theorem: maybe-command-error-p-of-load-stat.error?

(defthm maybe-command-error-p-of-load-stat.error?
        (b* (((mv ?error? ?stat? acl2::?state)
              (load-stat state)))
            (maybe-command-error-p error?))
        :rule-classes :rewrite)

Theorem: maybe-statp-of-load-stat.stat?

(defthm maybe-statp-of-load-stat.stat?
        (b* (((mv ?error? ?stat? acl2::?state)
              (load-stat state)))
            (maybe-statp stat?))
        :rule-classes :rewrite)

Theorem: statp-of-load-stat-when-no-error

(defthm statp-of-load-stat-when-no-error
        (b* (((mv error? stat? &) (load-stat state)))
            (implies (not error?) (statp stat?))))

Theorem: stat-wfp-of-load-stat-when-no-error

(defthm stat-wfp-of-load-stat-when-no-error
        (b* (((mv error? stat? &) (load-stat state)))
            (implies (not error?)
                     (stat-wfp stat?))))