midnight-wallet:wallet-sdk

Construct and operate WalletFacade-based Midnight wallets with HD key derivation.

37|9|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/devrelaicom/midnight-expert --skill midnight-wallet-wallet-sdk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: midnight-wallet:wallet-sdk
Source: https://github.com/devrelaicom/midnight-expert/tree/main/plugins/midnight-wallet/skills/wallet-sdk
Command: npx skills add https://github.com/devrelaicom/midnight-expert --skill midnight-wallet-wallet-sdk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Developers integrating the Midnight Wallet SDK need a clear, authoritative reference to construct wallets, derive keys securely, observe sync state, and drive end-to-end transaction flows without misconfiguring services or mishandling secrets. This Skill centralizes patterns, examples, and configuration guidance to reduce integration errors and speed development.

Core Features & Use Cases

  • Wallet construction: step-by-step guidance for deriving HD keys, converting to shielded/unshielded/dust keys, and initializing WalletFacade with proper configuration.
  • Sync and state observation: how to monitor SyncProgress, use waitForSyncedState, and safely read balances across shielded, unshielded, and dust wallets.
  • Transaction lifecycle: create, balance, sign, prove, submit, revert, and estimate fees; includes dust registration workflows and synchronous signing callbacks.
  • Infrastructure clients & encoding: connecting indexer/node/prover clients and Bech32m address encoding/decoding practices.
  • Use Case: implement a local devnet wallet that derives keys from a mnemonic, waits for sync, registers UTXOs for dust generation, and performs shielded and unshielded transfers.

Quick Start

Construct a WalletFacade from a seed, start it with the derived secret keys, and wait for a fully synced state before reading balances or submitting transactions.

Frequently Asked Questions about midnight-wallet:wallet-sdk

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I construct a Midnight wallet and derive HD keys from a mnemonic?

To construct a Midnight wallet, you derive HD keys from a seed or mnemonic, convert them to shielded, unshielded, and dust keys, and initialize the WalletFacade with proper configuration parameters for subsequent operations.

How does sync state observation work for shielded and unshielded balances?

Sync state observation works by monitoring SyncProgress and using waitForSyncedState to ensure the wallet is fully synchronized. You can safely read shielded, unshielded, and dust balances only after reaching a fully synced state.

What is the transaction lifecycle for creating and submitting Midnight transfers?

The Midnight transaction lifecycle involves creating, balancing, signing, proving, and submitting transactions. It includes fee estimation, dust registration workflows, synchronous signing callbacks, and handling transaction reverts for shielded and unshielded transfers.

Do I need indexer, node, and prover clients to operate a Midnight wallet?

Yes, you need indexer, node, and prover clients for Midnight wallet infrastructure. These clients enable connecting to the network, retrieving sync data, and generating zero-knowledge proofs required for transaction submission and development testing scenarios.

How do I encode and decode Midnight wallet addresses using Bech32m?

You encode and decode Midnight wallet addresses using Bech32m address encoding practices. This ensures proper formatting for shielded, unshielded, and dust wallet addresses during transaction creation and infrastructure client interactions.

Can I register UTXOs for dust generation in a local devnet wallet?

Yes, you can register UTXOs for dust generation in a local devnet wallet. The workflow involves deriving keys from a mnemonic, waiting for sync, registering UTXOs, and performing shielded and unshielded transfers with proper dust handling.