device-intent-executor

Guides migration of Ledger Wallet device flows to Device Intent Executor architecture.

615|491|Updated Jan 4, 2022
One-click install
npx skills add https://github.com/LedgerHQ/ledger-live --skill device-intent-executor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: device-intent-executor
Source: https://github.com/LedgerHQ/ledger-live/tree/main/.agents/skills/device-intent-executor
Command: npx skills add https://github.com/LedgerHQ/ledger-live --skill device-intent-executor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers working on Ledger Wallet apps need authoritative guidance when implementing or migrating device interaction flows, and this Skill points them to the canonical Device Intent Executor documentation instead of guessing at APIs.

Core Features & Use Cases

  • Device Intent Reference: Covers IntentDefinition, IntentPlatformDefinition, Job, and createIntent for defining device operations.
  • Executor Components: Explains DeviceIntentExecutor and DeviceIntentExecutorLWM components plus the DmkCompatTransport bridge.
  • Migration Guidance: Directs work on migrating device flows off legacy connectApp, DeviceAction, and withDevice patterns.
  • Use Case: When refactoring a Ledger Wallet feature that currently uses connectApp to communicate with a hardware device, use this Skill to locate the correct Device Intent Executor patterns and initialization inputs.

Quick Start

Read the device-intent-executor skill to understand how to migrate my Ledger Wallet device flow from connectApp to the Device Intent Executor.

Frequently Asked Questions about device-intent-executor

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

FAQPage Schema
How do I migrate a Ledger Wallet device flow off connectApp?

Migrate by adopting the Device Intent Executor pattern: define an Intent using IntentDefinition and createIntent, then run it through DeviceIntentExecutor or DeviceIntentExecutorLWM. The package README at features/platform/device-intent/README.md contains the canonical migration reference.

What is the Device Intent Executor in Ledger Live?

The Device Intent Executor is the architecture in the @features/platform-device-intent package for running device operations as Intents. It provides DeviceIntentExecutor components, Job definitions, and the DmkCompatTransport bridge for device communication.

What is DmkCompatTransport used for?

DmkCompatTransport is a bridge within the device-intent package that connects Device Intent flows to the Device Management Kit transport layer. It is referenced when wiring device communication during intent execution.

How do I build device initialization input for a Device Intent?

Use the deviceInitializationInput and buildDeviceInitializationInput helpers from the platform-device-intent package. The canonical README documents their signatures and usage within intent setup.

When should I use DeviceIntentExecutorLWM instead of DeviceIntentExecutor?

DeviceIntentExecutorLWM is the variant intended for Ledger Wallet Mobile contexts, while DeviceIntentExecutor serves the general platform case. Consult the package README's table of contents for platform-specific sections.