ledger-signing

Sign Ethereum transactions, messages, and EIP-712 typed data via Ledger USB/HID.

2|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/terraleiloa/seren-skills --skill ledger-signing-terraleiloa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ledger-signing
Source: https://github.com/terraleiloa/seren-skills/tree/main/ledger/ledger-signing
Command: npx skills add https://github.com/terraleiloa/seren-skills --skill ledger-signing-terraleiloa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ledgerblue, hidapi, and includes scripts (resource) components.

What problem does it solve?

Signing Ethereum payloads with a Ledger device is error-prone and can lead to unsafe automation if the user is not guided through unlocking, review, and approval steps.

Core Features & Use Cases

  • Clear vs blind signing guidance: Orchestrates flows for clear signing and a blind-signing fallback when full clarity is not possible.
  • Supports multiple Ethereum payload types: Handles transaction, message, and typed_data (EIP-712) signing requests.
  • Runtime-ready direct USB/HID signing: Executes a local signing runtime that communicates with a connected Ledger over USB/HID, gated by dry_run and --execute.

Quick Start

Ask an AI agent to run the Ledger signing flow in execute mode by setting dry_run to false and providing the required inputs payload_kind, derivation_path, and payload_hex (plus EIP-712 domain_separator_hex and hash_struct_message_hex for typed_data).

Frequently Asked Questions about ledger-signing

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

FAQPage Schema
How do I securely sign Ethereum transactions with a Ledger device over USB?

Secure Ethereum transaction signing with a Ledger requires guiding the device through unlock, review, and approval steps over a direct USB/HID connection. This Skill orchestrates that flow, validating inputs and rendering signing guidance for safe user review.

What is the difference between clear signing and blind signing for Ethereum payloads?

Clear signing displays transaction details on the Ledger device for user verification, while blind signing signs hashes without full payload visibility. This Skill orchestrates clear signing flows with a blind-signing fallback when full clarity is not possible.

Can I sign EIP-712 typed data using a Ledger hardware wallet?

Yes, EIP-712 typed data can be signed by providing the domain_separator_hex and hash_struct_message_hex inputs. The Skill accepts these hashes alongside the payload_kind and derivation_path to produce signed outputs from the connected Ledger.

Do I need ledgerblue and hidapi to run Ledger transaction signing locally?

Yes, a local Ledger USB/HID runtime with ledgerblue and hidapi is required to execute direct signing. These dependencies enable the local runtime to communicate with a connected Ledger device over USB.

Why does the Ledger signing flow refuse to execute in dry run mode?

The signing flow enforces a dry_run safety refusal to prevent unsafe automation during testing. You must explicitly set dry_run to false and use the execute flag to trigger the actual USB/HID signing runtime.

What payload types are supported for Ethereum transaction signing guidance?

The signing guidance supports transaction, message, and typed_data payload types. It validates payload_hex inputs with strict sizes and orchestrates the appropriate signing flow for each Ethereum payload kind.