@ledgerhq/device-contacts-kit 0.0.0-develop-20260827155839 → 0.0.0-develop-20260828024102

package/lib/types/internal/DefaultContactsManager.d.ts

@@ -1,6 +1,8 @@
 import { type DeviceManagementKit, type DeviceSessionId } from "@ledgerhq/device-management-kit";
 import { type Container } from "inversify";
+import { type RegisterExternalAddressDAReturnType } from "../api/app-binder/RegisterExternalAddressDeviceActionTypes";
 import { type ContactsManager } from "../api/ContactsManager";
+import { type RegisterExternalAddressInput } from "../api/model/RegisterExternalAddress";
 type DefaultContactsManagerConstructorArgs = {
     dmk: DeviceManagementKit;
     sessionId: DeviceSessionId;
@@ -9,9 +11,10 @@ type DefaultContactsManagerConstructorArgs = {
 export declare class DefaultContactsManager implements ContactsManager {
     private readonly _container;
     constructor({ dmk, sessionId, appName, }: DefaultContactsManagerConstructorArgs);
+    registerExternalAddress(input: RegisterExternalAddressInput): RegisterExternalAddressDAReturnType;
     /**
-     * Exposes the DI container so operation methods (added by their dedicated
-     * tickets) can resolve their `UseCase`. Not part of the public API.
+     * Exposes the DI container so future operation methods can resolve their
+     * `UseCase`. Not part of the public API.
      */
     protected get container(): Container;
 }

package/lib/types/internal/DefaultContactsManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultContactsManager.d.ts","sourceRoot":"","sources":["../../../src/internal/DefaultContactsManager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,KAAK,qCAAqC,GAAG;IAC3C,GAAG,EAAE,mBAAmB,CAAC;IACzB,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;gBAE3B,EACV,GAAG,EACH,SAAS,EACT,OAAO,GACR,EAAE,qCAAqC;IAIxC;;;OAGG;IACH,SAAS,KAAK,SAAS,IAAI,SAAS,CAEnC;CACF"}
+{"version":3,"file":"DefaultContactsManager.d.ts","sourceRoot":"","sources":["../../../src/internal/DefaultContactsManager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EAAE,KAAK,mCAAmC,EAAE,MAAM,0DAA0D,CAAC;AACpH,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,KAAK,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAKvF,KAAK,qCAAqC,GAAG;IAC3C,GAAG,EAAE,mBAAmB,CAAC;IACzB,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;gBAE3B,EACV,GAAG,EACH,SAAS,EACT,OAAO,GACR,EAAE,qCAAqC;IAIxC,uBAAuB,CACrB,KAAK,EAAE,4BAA4B,GAClC,mCAAmC;IAQtC;;;OAGG;IACH,SAAS,KAAK,SAAS,IAAI,SAAS,CAEnC;CACF"}

package/lib/types/internal/DefaultContactsManager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DefaultContactsManager.test.d.ts.map

package/lib/types/internal/DefaultContactsManager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultContactsManager.test.d.ts","sourceRoot":"","sources":["../../../src/internal/DefaultContactsManager.test.ts"],"names":[],"mappings":""}

package/lib/types/internal/app-binder/ContactsAppBinder.d.ts

@@ -1,14 +1,15 @@
 import { type DeviceManagementKit, type DeviceSessionId } from "@ledgerhq/device-management-kit";
+import { type RegisterExternalAddressDAReturnType } from "../../api/app-binder/RegisterExternalAddressDeviceActionTypes";
+import { type RegisterExternalAddressInput } from "../../api/model/RegisterExternalAddress";
 /**
  * Constructs and executes Contacts `DeviceAction`s using the injected `dmk`,
- * `sessionId`, and `appName`. Operation methods (one per Address Book
- * management command) are added by their dedicated implementation tickets and
- * consume these members.
+ * `sessionId`, and `appName`. Each Address Book operation gets one method here.
  */
 export declare class ContactsAppBinder {
     protected readonly dmk: DeviceManagementKit;
     protected readonly sessionId: DeviceSessionId;
     protected readonly appName: string;
     constructor(dmk: DeviceManagementKit, sessionId: DeviceSessionId, appName: string);
+    registerExternalAddress(input: RegisterExternalAddressInput): RegisterExternalAddressDAReturnType;
 }
 //# sourceMappingURL=ContactsAppBinder.d.ts.map

package/lib/types/internal/app-binder/ContactsAppBinder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContactsAppBinder.d.ts","sourceRoot":"","sources":["../../../../src/internal/app-binder/ContactsAppBinder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,iCAAiC,CAAC;AAKzC;;;;;GAKG;AACH,qBACa,iBAAiB;IAG1B,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,mBAAmB;IAE3C,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,eAAe;IAE7C,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM;gBAJf,GAAG,EAAE,mBAAmB,EAExB,SAAS,EAAE,eAAe,EAE1B,OAAO,EAAE,MAAM;CAErC"}
+{"version":3,"file":"ContactsAppBinder.d.ts","sourceRoot":"","sources":["../../../../src/internal/app-binder/ContactsAppBinder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAE,KAAK,mCAAmC,EAAE,MAAM,0DAA0D,CAAC;AACpH,OAAO,EAAE,KAAK,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAIvF;;;GAGG;AACH,qBACa,iBAAiB;IAG1B,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,mBAAmB;IAE3C,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,eAAe;IAE7C,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM;gBAJf,GAAG,EAAE,mBAAmB,EAExB,SAAS,EAAE,eAAe,EAE1B,OAAO,EAAE,MAAM;IAGpC,uBAAuB,CACrB,KAAK,EAAE,4BAA4B,GAClC,mCAAmC;CAQvC"}

package/lib/types/internal/app-binder/command/RegisterIdentityCommand.d.ts

@@ -0,0 +1,30 @@
+import { type Apdu, type ApduResponse, type Command, type CommandResult } from "@ledgerhq/device-management-kit";
+import { type ContactsErrorCodes } from "../../app-binder/model/contactsErrors";
+export type RegisterIdentityCommandArgs = {
+    /** One framed chunk built by sendFramedContactsPayload. */
+    readonly data: Uint8Array;
+    /** 0x00 for the first/only chunk, 0x80 for continuation chunks. */
+    readonly p2: number;
+};
+export type RegisterIdentityCommandResponse = {
+    /**
+     * Present only on the final chunk — the device returns struct_type(0x2d) +
+     * group_handle(64) + hmac_proof(32) + hmac_rest(32) there. Intermediate
+     * chunks return SW=0x9000 with no data.
+     *
+     * `hmacProof` is the device's HMAC_PROOF (binds the contact name);
+     * `hmacRest` is the HMAC_REST (binds scope + identifier + family).
+     */
+    readonly groupHandle?: Uint8Array;
+    readonly hmacProof?: Uint8Array;
+    readonly hmacRest?: Uint8Array;
+};
+export declare class RegisterIdentityCommand implements Command<RegisterIdentityCommandResponse, RegisterIdentityCommandArgs, ContactsErrorCodes> {
+    readonly name = "registerIdentity";
+    readonly args: RegisterIdentityCommandArgs;
+    private readonly errorHelper;
+    constructor(args: RegisterIdentityCommandArgs);
+    getApdu(): Apdu;
+    parseResponse(response: ApduResponse): CommandResult<RegisterIdentityCommandResponse, ContactsErrorCodes>;
+}
+//# sourceMappingURL=RegisterIdentityCommand.d.ts.map

package/lib/types/internal/app-binder/command/RegisterIdentityCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegisterIdentityCommand.d.ts","sourceRoot":"","sources":["../../../../../src/internal/app-binder/command/RegisterIdentityCommand.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,IAAI,EAGT,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,aAAa,EAGnB,MAAM,iCAAiC,CAAC;AAYzC,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,2CAA2C,CAAC;AAEnD,MAAM,MAAM,2BAA2B,GAAG;IACxC,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;CAChC,CAAC;AAkBF,qBAAa,uBACX,YACE,OAAO,CACL,+BAA+B,EAC/B,2BAA2B,EAC3B,kBAAkB,CACnB;IAEH,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAGwB;gBAExC,IAAI,EAAE,2BAA2B;IAI7C,OAAO,IAAI,IAAI;IAWf,aAAa,CACX,QAAQ,EAAE,YAAY,GACrB,aAAa,CAAC,+BAA+B,EAAE,kBAAkB,CAAC;CAoDtE"}

package/lib/types/internal/app-binder/command/RegisterIdentityCommand.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RegisterIdentityCommand.test.d.ts.map

package/lib/types/internal/app-binder/command/RegisterIdentityCommand.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegisterIdentityCommand.test.d.ts","sourceRoot":"","sources":["../../../../../src/internal/app-binder/command/RegisterIdentityCommand.test.ts"],"names":[],"mappings":""}

package/lib/types/internal/app-binder/device-action/RegisterExternalAddress/RegisterExternalAddressDeviceAction.d.ts

@@ -0,0 +1,14 @@
+import { type DeviceActionStateMachine, type InternalApi, XStateDeviceAction } from "@ledgerhq/device-management-kit";
+import { type RegisterExternalAddressDAError, type RegisterExternalAddressDAInput, type RegisterExternalAddressDAIntermediateValue, type RegisterExternalAddressDAInternalState, type RegisterExternalAddressDAOutput } from "../../../../api/app-binder/RegisterExternalAddressDeviceActionTypes";
+import { type RunningApp } from "../../../app-binder/isContactsSupportedForSession";
+import { type RegisterIdentityProofs, SendRegisterIdentityTask } from "../../../app-binder/task/SendRegisterIdentityTask";
+export type RegisterExternalAddressMachineDependencies = {
+    readonly isSupported: (app: RunningApp) => boolean;
+    readonly registerIdentity: (input: RegisterExternalAddressDAInput) => Promise<Awaited<ReturnType<SendRegisterIdentityTask["run"]>>>;
+};
+export declare class RegisterExternalAddressDeviceAction extends XStateDeviceAction<RegisterExternalAddressDAOutput, RegisterExternalAddressDAInput, RegisterExternalAddressDAError, RegisterExternalAddressDAIntermediateValue, RegisterExternalAddressDAInternalState> {
+    makeStateMachine(internalApi: InternalApi): DeviceActionStateMachine<RegisterExternalAddressDAOutput, RegisterExternalAddressDAInput, RegisterExternalAddressDAError, RegisterExternalAddressDAIntermediateValue, RegisterExternalAddressDAInternalState>;
+    extractDependencies(internalApi: InternalApi): RegisterExternalAddressMachineDependencies;
+}
+export type { RegisterIdentityProofs };
+//# sourceMappingURL=RegisterExternalAddressDeviceAction.d.ts.map

package/lib/types/internal/app-binder/device-action/RegisterExternalAddress/RegisterExternalAddressDeviceAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegisterExternalAddressDeviceAction.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/app-binder/device-action/RegisterExternalAddress/RegisterExternalAddressDeviceAction.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,WAAW,EAOhB,kBAAkB,EACnB,MAAM,iCAAiC,CAAC;AAIzC,OAAO,EACL,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,EACnC,KAAK,0CAA0C,EAC/C,KAAK,sCAAsC,EAC3C,KAAK,+BAA+B,EACrC,MAAM,0DAA0D,CAAC;AAClE,OAAO,EAEL,KAAK,UAAU,EAChB,MAAM,oDAAoD,CAAC;AAE5D,OAAO,EACL,KAAK,sBAAsB,EAC3B,wBAAwB,EACzB,MAAM,oDAAoD,CAAC;AAI5D,MAAM,MAAM,0CAA0C,GAAG;IACvD,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC;IACnD,QAAQ,CAAC,gBAAgB,EAAE,CACzB,KAAK,EAAE,8BAA8B,KAClC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;CACpE,CAAC;AAEF,qBAAa,mCAAoC,SAAQ,kBAAkB,CACzE,+BAA+B,EAC/B,8BAA8B,EAC9B,8BAA8B,EAC9B,0CAA0C,EAC1C,sCAAsC,CACvC;IACC,gBAAgB,CACd,WAAW,EAAE,WAAW,GACvB,wBAAwB,CACzB,+BAA+B,EAC/B,8BAA8B,EAC9B,8BAA8B,EAC9B,0CAA0C,EAC1C,sCAAsC,CACvC;IAwPD,mBAAmB,CACjB,WAAW,EAAE,WAAW,GACvB,0CAA0C;CAkB9C;AAED,YAAY,EAAE,sBAAsB,EAAE,CAAC"}

package/lib/types/internal/app-binder/device-action/RegisterExternalAddress/RegisterExternalAddressDeviceAction.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RegisterExternalAddressDeviceAction.test.d.ts.map

package/lib/types/internal/app-binder/device-action/RegisterExternalAddress/RegisterExternalAddressDeviceAction.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegisterExternalAddressDeviceAction.test.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/app-binder/device-action/RegisterExternalAddress/RegisterExternalAddressDeviceAction.test.ts"],"names":[],"mappings":""}

package/lib/types/internal/app-binder/device-action/RegisterExternalAddress/validateRegisterExternalAddressInput.d.ts

@@ -0,0 +1,12 @@
+import { type RegisterExternalAddressInput } from "../../../../api/model/RegisterExternalAddress";
+import { ContactsValidationError } from "../../../app-binder/model/contactsValidation";
+/**
+ * Validate the caller input for Register External Address. Returns the first
+ * `ContactsValidationError` found, or `null` when the input is valid.
+ *
+ * Non-throwing by design: the device action calls this so an invalid input is
+ * surfaced as a typed terminal error state on the observable, keeping the
+ * public `ContactsManager.registerExternalAddress` free of synchronous throws.
+ */
+export declare function validateRegisterExternalAddressInput(input: RegisterExternalAddressInput): ContactsValidationError | null;
+//# sourceMappingURL=validateRegisterExternalAddressInput.d.ts.map

package/lib/types/internal/app-binder/device-action/RegisterExternalAddress/validateRegisterExternalAddressInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateRegisterExternalAddressInput.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/app-binder/device-action/RegisterExternalAddress/validateRegisterExternalAddressInput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAEvF,OAAO,EAEL,uBAAuB,EAQxB,MAAM,+CAA+C,CAAC;AAEvD;;;;;;;GAOG;AACH,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,4BAA4B,GAClC,uBAAuB,GAAG,IAAI,CAuDhC"}

package/lib/types/internal/app-binder/device-action/RegisterExternalAddress/validateRegisterExternalAddressInput.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validateRegisterExternalAddressInput.test.d.ts.map

package/lib/types/internal/app-binder/device-action/RegisterExternalAddress/validateRegisterExternalAddressInput.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateRegisterExternalAddressInput.test.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/app-binder/device-action/RegisterExternalAddress/validateRegisterExternalAddressInput.test.ts"],"names":[],"mappings":""}

package/lib/types/internal/app-binder/device-action/__test-utils__/makeInternalApi.d.ts

@@ -0,0 +1,4 @@
+import { type InternalApi } from "@ledgerhq/device-management-kit";
+import { type Mocked } from "vitest";
+export declare function makeDeviceActionInternalApiMock(): Mocked<InternalApi>;
+//# sourceMappingURL=makeInternalApi.d.ts.map

package/lib/types/internal/app-binder/device-action/__test-utils__/makeInternalApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeInternalApi.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/app-binder/device-action/__test-utils__/makeInternalApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,wBAAgB,+BAA+B,IAAI,MAAM,CAAC,WAAW,CAAC,CAkBrE"}

package/lib/types/internal/app-binder/device-action/__test-utils__/setupOpenAppDAMock.d.ts

@@ -0,0 +1,2 @@
+export declare const setupOpenAppDAMock: (error?: unknown) => void;
+//# sourceMappingURL=setupOpenAppDAMock.d.ts.map

package/lib/types/internal/app-binder/device-action/__test-utils__/setupOpenAppDAMock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupOpenAppDAMock.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/app-binder/device-action/__test-utils__/setupOpenAppDAMock.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,kBAAkB,GAAI,QAAQ,OAAO,SAwBjD,CAAC"}

package/lib/types/internal/app-binder/device-action/__test-utils__/setupWaitForAppAndVersionDAMock.d.ts

@@ -0,0 +1,17 @@
+import { UserInteractionRequired } from "@ledgerhq/device-management-kit";
+/**
+ * Mock WaitForAppAndVersionDeviceAction to resolve immediately with either a
+ * fresh `{ name, version }` (default) or an error.
+ *
+ * The mock machine carries an `intermediateValue` in its context (matching the
+ * real DA) so the parent's onSnapshot propagation has a defined value to read.
+ * Pass `requiredUserInteraction` to have the child emit an interaction (e.g.
+ * UnlockDevice for a locked device) before completing.
+ */
+export declare const setupWaitForAppAndVersionDAMock: (result?: {
+    name: string;
+    version: string;
+} | {
+    error: unknown;
+}, requiredUserInteraction?: UserInteractionRequired) => void;
+//# sourceMappingURL=setupWaitForAppAndVersionDAMock.d.ts.map

package/lib/types/internal/app-binder/device-action/__test-utils__/setupWaitForAppAndVersionDAMock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupWaitForAppAndVersionDAMock.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/app-binder/device-action/__test-utils__/setupWaitForAppAndVersionDAMock.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EAExB,MAAM,iCAAiC,CAAC;AAKzC;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B,GAC1C,SAAQ;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,OAAO,CAAA;CAG3D,EACD,0BAAyB,uBAAsD,SAuBhF,CAAC"}

package/lib/types/internal/app-binder/device-action/__test-utils__/testDeviceActionStates.d.ts

@@ -0,0 +1,15 @@
+import { type DeviceAction, type DeviceActionIntermediateValue, type DeviceActionState, type DmkError, type InternalApi } from "@ledgerhq/device-management-kit";
+/**
+ * Test that the states emitted by a device action match the expected states.
+ * @param deviceAction The device action to test.
+ * @param expectedStates The expected states.
+ * @param callbacks { onDone, onError } The callbacks to call when the test is done or an error occurs.
+ */
+export declare function testDeviceActionStates<Output, Input, Error extends DmkError, IntermediateValue extends DeviceActionIntermediateValue>(deviceAction: DeviceAction<Output, Input, Error, IntermediateValue>, expectedStates: Array<DeviceActionState<Output, Error, IntermediateValue>>, internalApi: InternalApi, { onDone, onError, }: {
+    onDone: () => void;
+    onError: (error: Error) => void;
+}): {
+    observable: import("rxjs").Observable<DeviceActionState<Output, Error, IntermediateValue>>;
+    cancel: () => void;
+};
+//# sourceMappingURL=testDeviceActionStates.d.ts.map

package/lib/types/internal/app-binder/device-action/__test-utils__/testDeviceActionStates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testDeviceActionStates.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/app-binder/device-action/__test-utils__/testDeviceActionStates.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,6BAA6B,EAClC,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,WAAW,EACjB,MAAM,iCAAiC,CAAC;AAEzC;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EACN,KAAK,EACL,KAAK,SAAS,QAAQ,EACtB,iBAAiB,SAAS,6BAA6B,EAEvD,YAAY,EAAE,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,CAAC,EACnE,cAAc,EAAE,KAAK,CAAC,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAC1E,WAAW,EAAE,WAAW,EACxB,EACE,MAAM,EACN,OAAO,GACR,EAAE;IACD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC;;;EAwBF"}

package/lib/types/internal/app-binder/isContactsSupportedForSession.d.ts

@@ -1,17 +1,25 @@
-import { type AppConfig, type InternalApi } from "@ledgerhq/device-management-kit";
+import { type InternalApi } from "@ledgerhq/device-management-kit";
+/** The running app's identity, read freshly from the device. */
+export type RunningApp = {
+    readonly name: string;
+    readonly version: string;
+};
 /**
  * Session-aware Contacts support check, for internal consumption by Contacts
- * `DeviceAction`s. Reads the current device session and resolves it against the
- * static requirements table:
+ * `DeviceAction`s. Resolves the given running app against the static
+ * requirements table:
  * - the device model must be supported;
- * - the running app must be known to Contacts and meet its minimum version —
- *   validated with DMK's {@link ApplicationChecker} so the version comes from
- *   the authoritative `GetAppConfiguration` result;
+ * - the running app must be known to Contacts and meet its minimum version;
  * - the device OS must meet its minimum version (a dimension `ApplicationChecker`
  *   does not cover, so it is checked separately here).
  *
+ * The app `name` and `version` are supplied by the caller so they can come from
+ * a fresh `WaitForAppAndVersion` result rather than the (potentially stale)
+ * device session state; the model and OS come from the session state, which
+ * does not change under the caller's feet the way the running app can.
+ *
  * @param internalApi - the DeviceAction's internal API for the current session.
- * @param appConfig - the running app's configuration (must include its version).
+ * @param app - the running app's fresh name and version.
  */
-export declare function isContactsSupportedForSession(internalApi: InternalApi, appConfig: AppConfig): boolean;
+export declare function isContactsSupportedForSession(internalApi: InternalApi, app: RunningApp): boolean;
 //# sourceMappingURL=isContactsSupportedForSession.d.ts.map

package/lib/types/internal/app-binder/isContactsSupportedForSession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isContactsSupportedForSession.d.ts","sourceRoot":"","sources":["../../../../src/internal/app-binder/isContactsSupportedForSession.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,WAAW,EACjB,MAAM,iCAAiC,CAAC;AASzC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS,GACnB,OAAO,CA8BT"}
+{"version":3,"file":"isContactsSupportedForSession.d.ts","sourceRoot":"","sources":["../../../../src/internal/app-binder/isContactsSupportedForSession.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,iCAAiC,CAAC;AASzC,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,WAAW,EACxB,GAAG,EAAE,UAAU,GACd,OAAO,CA0BT"}

package/lib/types/internal/app-binder/model/contactsConstants.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Protocol constants shared by the Contacts (Address Book) operations.
+ *
+ * Wire format and values follow the BOLOS SDK Address Book specification
+ * (ledger-secure-sdk/app_features/address_book). Op-specific sub-command bytes
+ * and response field sizes live here; TLV tags and struct-type bytes live in
+ * {@link ./../services/contactsTlvSerializer}.
+ */
+/** APDU class/instruction shared by every Address Book sub-command. */
+export declare const CONTACTS_APDU_CLA = 176;
+export declare const CONTACTS_APDU_INS = 16;
+/** P1 sub-command selector for REGISTER IDENTITY (register external address). */
+export declare const SUB_CMD_REGISTER_IDENTITY = 1;
+/** Sizes (bytes) of the fields in the REGISTER IDENTITY final-chunk response. */
+export declare const GROUP_HANDLE_BYTES = 64;
+export declare const HMAC_PROOF_BYTES = 32;
+export declare const HMAC_REST_BYTES = 32;
+/**
+ * Blockchain-family byte encoded in the `BLOCKCHAIN_FAMILY` TLV, keyed by a
+ * lowercase family name. v1 ships Ethereum only; the remaining families are
+ * listed for completeness and will be enabled as their chains are supported.
+ */
+export declare const BLOCKCHAIN_FAMILY_BY_NAME: Readonly<Record<string, number>>;
+//# sourceMappingURL=contactsConstants.d.ts.map

package/lib/types/internal/app-binder/model/contactsConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contactsConstants.d.ts","sourceRoot":"","sources":["../../../../../src/internal/app-binder/model/contactsConstants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,uEAAuE;AACvE,eAAO,MAAM,iBAAiB,MAAO,CAAC;AACtC,eAAO,MAAM,iBAAiB,KAAO,CAAC;AAEtC,iFAAiF;AACjF,eAAO,MAAM,yBAAyB,IAAO,CAAC;AAE9C,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOtE,CAAC"}

package/lib/types/internal/app-binder/model/contactsErrors.d.ts

@@ -0,0 +1,30 @@
+import { type CommandErrorArgs, type CommandErrors, DeviceExchangeError, type DmkError } from "@ledgerhq/device-management-kit";
+/**
+ * Status word returned by the app's Address Book *edit* operations when the
+ * seed-bound HMAC / group-handle verification fails — i.e. the entry was
+ * registered with a different seed than the one currently on the device.
+ *
+ * The device runs this check *before* showing any UI and returns 0x6982 *only*
+ * for seed-binding failures (user rejection and TLV errors return 0x6a80,
+ * address validation returns 0x6af0), so 0x6982 is an unambiguous "wrong seed"
+ * signal that consumers (e.g. Ledger Wallet) can catch to guide the user.
+ */
+export declare const CONTACT_SEED_MISMATCH_ERROR_CODE: "6982";
+export type ContactsErrorCodes = "6982" | "6800" | "6983" | "6984" | "6985" | "6a80" | "6a84" | "6a88" | "6af0" | "6b00" | "6f00";
+export declare const CONTACTS_APP_ERRORS: CommandErrors<ContactsErrorCodes>;
+export declare class ContactsCommandError extends DeviceExchangeError<ContactsErrorCodes> {
+    constructor(args: CommandErrorArgs<ContactsErrorCodes>);
+}
+export declare const contactsCommandErrorFactory: (args: CommandErrorArgs<ContactsErrorCodes>) => ContactsCommandError;
+/**
+ * Raised by a Contacts `DeviceAction` when the connected device model, app
+ * version, or OS version does not meet the Contacts requirements — i.e. the
+ * DSDK-1376 support check fails before any APDU is sent.
+ */
+export declare class ContactsVersionRequirementError implements DmkError {
+    readonly message: string;
+    readonly _tag = "ContactsVersionRequirementError";
+    readonly originalError?: unknown;
+    constructor(message?: string);
+}
+//# sourceMappingURL=contactsErrors.d.ts.map

package/lib/types/internal/app-binder/model/contactsErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contactsErrors.d.ts","sourceRoot":"","sources":["../../../../../src/internal/app-binder/model/contactsErrors.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,mBAAmB,EACnB,KAAK,QAAQ,EACd,MAAM,iCAAiC,CAAC;AAEzC;;;;;;;;;GASG;AACH,eAAO,MAAM,gCAAgC,EAAG,MAAe,CAAC;AAEhE,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,MAAM,GACN,MAAM,GACN,MAAM,GACN,MAAM,GACN,MAAM,GACN,MAAM,GACN,MAAM,GACN,MAAM,GACN,MAAM,GACN,MAAM,CAAC;AAEX,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,kBAAkB,CAkBjE,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,mBAAmB,CAAC,kBAAkB,CAAC;gBACnE,IAAI,EAAE,gBAAgB,CAAC,kBAAkB,CAAC;CAGvD;AAED,eAAO,MAAM,2BAA2B,GACtC,MAAM,gBAAgB,CAAC,kBAAkB,CAAC,yBACT,CAAC;AAEpC;;;;GAIG;AACH,qBAAa,+BAAgC,YAAW,QAAQ;IAI5D,QAAQ,CAAC,OAAO;IAHlB,QAAQ,CAAC,IAAI,qCAAqC;IAClD,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;gBAEtB,OAAO,SAAiF;CAEpG"}

package/lib/types/internal/app-binder/model/contactsValidation.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Pre-APDU input validators for the Contacts operations.
+ *
+ * Buffer-length constants mirror the Ledger secure SDK `#define` values
+ * *including* the trailing NUL terminator (so a 32-printable-char name lives in
+ * a 33-byte buffer). Validators subtract 1 internally so the constants remain
+ * pure equality checks against the upstream `#define`s. The byte-level
+ * `0x20..0x7E` printable check exactly matches firmware `is_printable_string`.
+ */
+import { type DmkError } from "@ledgerhq/device-management-kit";
+export declare const CONTACT_NAME_BUFFER_LENGTH = 33;
+export declare const SCOPE_BUFFER_LENGTH = 33;
+export declare const GROUP_HANDLE_SIZE = 64;
+export declare const HMAC_PROOF_LENGTH = 32;
+export declare const MAX_BIP32_DEPTH = 10;
+export declare const ETH_ADDRESS_BYTES = 20;
+/**
+ * Raised when caller input fails a pre-APDU check. Implements `DmkError` (and
+ * stays an `Error` subclass) so a Contacts device action can surface it as a
+ * typed terminal error state on the observable rather than throwing out of the
+ * public, device-action-returning API.
+ */
+export declare class ContactsValidationError extends Error implements DmkError {
+    readonly _tag = "ContactsValidationError";
+    readonly originalError?: unknown;
+    constructor(message: string);
+}
+/**
+ * Mirror of firmware `is_printable_string` + length cap. `bufferLength` is the
+ * firmware's fixed buffer size *including* the trailing NUL, so the maximum
+ * payload byte length is `bufferLength - 1`.
+ */
+export declare function validatePrintableLabel(value: string, options: {
+    field: string;
+    bufferLength: number;
+}): void;
+/** Assert a byte buffer is exactly `expectedBytes` long and non-empty. */
+export declare function validateByteLength(value: Uint8Array, options: {
+    field: string;
+    expectedBytes: number;
+}): void;
+/**
+ * Sanity-check a BIP32 path before serialization. Firmware enforces depth <=
+ * MAX_BIP32_DEPTH and rejects malformed segments. Accepts `m/44'/60'/0'/0/0`
+ * style; segments may end in `'` (hardened).
+ */
+export declare function validateDerivationPath(path: string): void;
+/**
+ * Firmware encodes chain_id as uint64. JS `number` is fine up to 2^53; accept
+ * `bigint` for the high range so callers don't silently truncate.
+ */
+export declare function validateChainId(value: number | bigint): void;
+//# sourceMappingURL=contactsValidation.d.ts.map

package/lib/types/internal/app-binder/model/contactsValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contactsValidation.d.ts","sourceRoot":"","sources":["../../../../../src/internal/app-binder/model/contactsValidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAKhE,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAIpC;;;;;GAKG;AACH,qBAAa,uBAAwB,SAAQ,KAAM,YAAW,QAAQ;IACpE,QAAQ,CAAC,IAAI,6BAA6B;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;gBACrB,OAAO,EAAE,MAAM;CAI5B;AASD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC/C,IAAI,CAqCN;AAID,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAChD,IAAI,CAON;AAID;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAoCzD;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyB5D"}

package/lib/types/internal/app-binder/model/contactsValidation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contactsValidation.test.d.ts.map

package/lib/types/internal/app-binder/model/contactsValidation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contactsValidation.test.d.ts","sourceRoot":"","sources":["../../../../../src/internal/app-binder/model/contactsValidation.test.ts"],"names":[],"mappings":""}

package/lib/types/internal/app-binder/services/contactsTlvSerializer.d.ts

@@ -0,0 +1,33 @@
+import { ByteArrayBuilder } from "@ledgerhq/device-management-kit";
+export declare const CONTACTS_TLV_TAG: {
+    readonly STRUCT_TYPE: 1;
+    readonly STRUCT_VERSION: 2;
+    readonly DERIVATION_PATH: 105;
+    readonly CHAIN_ID: 35;
+    readonly HMAC_PROOF: 41;
+    readonly BLOCKCHAIN_FAMILY: 81;
+    readonly CONTACT_NAME: 240;
+    readonly SCOPE: 241;
+    readonly ACCOUNT_IDENTIFIER: 242;
+    readonly PREVIOUS_CONTACT_NAME: 243;
+    readonly PREVIOUS_IDENTIFIER: 244;
+    readonly PREVIOUS_SCOPE: 245;
+    readonly GROUP_HANDLE: 246;
+    readonly HMAC_REST: 247;
+};
+export declare const STRUCT_TYPE_REGISTER_IDENTITY = 45;
+export declare const STRUCT_TYPE_EDIT_CONTACT_NAME = 46;
+export declare const STRUCT_TYPE_REGISTER_LEDGER_ACCOUNT = 47;
+export declare const STRUCT_TYPE_EDIT_LEDGER_ACCOUNT = 48;
+export declare const STRUCT_TYPE_EDIT_IDENTIFIER = 49;
+export declare const STRUCT_TYPE_EDIT_SCOPE = 50;
+export declare const STRUCT_TYPE_PROVIDE_CONTACT = 51;
+export declare const STRUCT_TYPE_PROVIDE_LEDGER_ACCOUNT_CONTACT = 52;
+export declare const STRUCT_VERSION_VALUE = 1;
+export declare function encodeTlvUInt8(builder: ByteArrayBuilder, tag: number, value: number): void;
+export declare function encodeTlvAscii(builder: ByteArrayBuilder, tag: number, value: string): void;
+export declare function encodeTlvBuffer(builder: ByteArrayBuilder, tag: number, value: Uint8Array): void;
+export declare function encodeTlvChainId(builder: ByteArrayBuilder, tag: number, chainId: number | bigint): void;
+/** Pack BIP32 segments as `count(1) || segment(4 BE)*count`. */
+export declare function packDerivationPath(segments: number[]): Uint8Array;
+//# sourceMappingURL=contactsTlvSerializer.d.ts.map

package/lib/types/internal/app-binder/services/contactsTlvSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contactsTlvSerializer.d.ts","sourceRoot":"","sources":["../../../../../src/internal/app-binder/services/contactsTlvSerializer.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAInE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;CAkBnB,CAAC;AAEX,eAAO,MAAM,6BAA6B,KAAO,CAAC;AAClD,eAAO,MAAM,6BAA6B,KAAO,CAAC;AAClD,eAAO,MAAM,mCAAmC,KAAO,CAAC;AACxD,eAAO,MAAM,+BAA+B,KAAO,CAAC;AACpD,eAAO,MAAM,2BAA2B,KAAO,CAAC;AAChD,eAAO,MAAM,sBAAsB,KAAO,CAAC;AAC3C,eAAO,MAAM,2BAA2B,KAAO,CAAC;AAChD,eAAO,MAAM,0CAA0C,KAAO,CAAC;AAC/D,eAAO,MAAM,oBAAoB,IAAO,CAAC;AA4CzC,wBAAgB,cAAc,CAC5B,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,IAAI,CAIN;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,IAAI,CAKN;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,UAAU,GAChB,IAAI,CAIN;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GAAG,MAAM,GACvB,IAAI,CAEN;AAED,gEAAgE;AAChE,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,UAAU,CAKjE"}

package/lib/types/internal/app-binder/services/contactsTlvSerializer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contactsTlvSerializer.test.d.ts.map

package/lib/types/internal/app-binder/services/contactsTlvSerializer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contactsTlvSerializer.test.d.ts","sourceRoot":"","sources":["../../../../../src/internal/app-binder/services/contactsTlvSerializer.test.ts"],"names":[],"mappings":""}

package/lib/types/internal/app-binder/services/sendFramedContactsPayload.d.ts

@@ -0,0 +1,14 @@
+import { type Command, type CommandResult, type InternalApi, type LoggerPublisherService } from "@ledgerhq/device-management-kit";
+export type SendFramedContactsPayloadArgs<Response> = {
+    /** TLV payload bytes (without any header or length framing). */
+    readonly payload: Uint8Array;
+    /** Sub-command byte (e.g. 0x01 for REGISTER IDENTITY). */
+    readonly p1: number;
+    /** Per-chunk Command factory. The helper passes the chunk bytes and the P2 byte. */
+    readonly makeCommand: (chunk: Uint8Array, p2: number) => Command<Response, unknown, unknown>;
+    /** Optional per-chunk diagnostic logging (one `debug` entry per outgoing chunk). */
+    readonly logger?: LoggerPublisherService;
+    readonly commandTag?: string;
+};
+export declare function sendFramedContactsPayload<Response>(api: InternalApi, { payload, makeCommand, logger, commandTag, }: SendFramedContactsPayloadArgs<Response>): Promise<CommandResult<Response>>;
+//# sourceMappingURL=sendFramedContactsPayload.d.ts.map

package/lib/types/internal/app-binder/services/sendFramedContactsPayload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendFramedContactsPayload.d.ts","sourceRoot":"","sources":["../../../../../src/internal/app-binder/services/sendFramedContactsPayload.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,WAAW,EAEhB,KAAK,sBAAsB,EAC5B,MAAM,iCAAiC,CAAC;AAMzC,MAAM,MAAM,6BAA6B,CAAC,QAAQ,IAAI;IACpD,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,QAAQ,CAAC,WAAW,EAAE,CACpB,KAAK,EAAE,UAAU,EACjB,EAAE,EAAE,MAAM,KACP,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACzC,oFAAoF;IACpF,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,wBAAsB,yBAAyB,CAAC,QAAQ,EACtD,GAAG,EAAE,WAAW,EAChB,EACE,OAAO,EACP,WAAW,EACX,MAAM,EACN,UAAU,GACX,EAAE,6BAA6B,CAAC,QAAQ,CAAC,GACzC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAiClC"}

package/lib/types/internal/app-binder/services/sendFramedContactsPayload.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sendFramedContactsPayload.test.d.ts.map

package/lib/types/internal/app-binder/services/sendFramedContactsPayload.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendFramedContactsPayload.test.d.ts","sourceRoot":"","sources":["../../../../../src/internal/app-binder/services/sendFramedContactsPayload.test.ts"],"names":[],"mappings":""}

package/lib/types/internal/app-binder/task/SendRegisterIdentityTask.d.ts

@@ -0,0 +1,25 @@
+import { type CommandResult, type InternalApi, type LoggerPublisherService } from "@ledgerhq/device-management-kit";
+import { type ExistingContactGroup } from "../../../api/model/RegisterExternalAddress";
+import { type ContactsErrorCodes } from "../../app-binder/model/contactsErrors";
+export type RegisterIdentityProofs = {
+    readonly groupHandle: Uint8Array;
+    readonly hmacProof: Uint8Array;
+    readonly hmacRest: Uint8Array;
+};
+export type SendRegisterIdentityTaskArgs = {
+    readonly contactName: string;
+    readonly scope: string;
+    readonly identifier: Uint8Array;
+    readonly blockchainFamily: string;
+    readonly chainId?: bigint;
+    readonly existingContactGroup?: ExistingContactGroup;
+    readonly logger?: LoggerPublisherService;
+};
+export declare class SendRegisterIdentityTask {
+    private readonly api;
+    private readonly args;
+    constructor(api: InternalApi, args: SendRegisterIdentityTaskArgs);
+    run(): Promise<CommandResult<RegisterIdentityProofs, ContactsErrorCodes>>;
+    private buildPayload;
+}
+//# sourceMappingURL=SendRegisterIdentityTask.d.ts.map

package/lib/types/internal/app-binder/task/SendRegisterIdentityTask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SendRegisterIdentityTask.d.ts","sourceRoot":"","sources":["../../../../../src/internal/app-binder/task/SendRegisterIdentityTask.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,KAAK,aAAa,EAElB,KAAK,WAAW,EAGhB,KAAK,sBAAsB,EAC5B,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAM/E,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAapF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC;CAC1C,CAAC;AAEF,qBAAa,wBAAwB;IAEjC,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBADJ,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,4BAA4B;IAG/C,GAAG,IAAI,OAAO,CAClB,aAAa,CAAC,sBAAsB,EAAE,kBAAkB,CAAC,CAC1D;IAkCD,OAAO,CAAC,YAAY;CAsDrB"}

package/lib/types/internal/app-binder/task/SendRegisterIdentityTask.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SendRegisterIdentityTask.test.d.ts.map

package/lib/types/internal/app-binder/task/SendRegisterIdentityTask.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SendRegisterIdentityTask.test.d.ts","sourceRoot":"","sources":["../../../../../src/internal/app-binder/task/SendRegisterIdentityTask.test.ts"],"names":[],"mappings":""}

package/lib/types/internal/di.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"di.d.ts","sourceRoot":"","sources":["../../../src/internal/di.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAKtC,KAAK,kBAAkB,GAAG;IACxB,GAAG,EAAE,mBAAmB,CAAC;IACzB,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,8BAI3B,kBAAkB,cAYpB,CAAC"}
+{"version":3,"file":"di.d.ts","sourceRoot":"","sources":["../../../src/internal/di.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAMtC,KAAK,kBAAkB,GAAG;IACxB,GAAG,EAAE,mBAAmB,CAAC;IACzB,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,8BAI3B,kBAAkB,cAapB,CAAC"}

package/lib/types/internal/use-cases/RegisterExternalAddressUseCase.d.ts

@@ -0,0 +1,17 @@
+import { type RegisterExternalAddressDAReturnType } from "../../api/app-binder/RegisterExternalAddressDeviceActionTypes";
+import { type RegisterExternalAddressInput } from "../../api/model/RegisterExternalAddress";
+import { ContactsAppBinder } from "../app-binder/ContactsAppBinder";
+/**
+ * Delegates to `ContactsAppBinder`, which uses its injected `dmk`, `sessionId`,
+ * and `appName` to construct and execute the `RegisterExternalAddressDeviceAction`.
+ *
+ * Caller-input validation is intentionally NOT done here: the public API returns
+ * a device action, so validation lives inside the device action and surfaces as
+ * a typed terminal error state on the observable rather than a synchronous throw.
+ */
+export declare class RegisterExternalAddressUseCase {
+    private readonly appBinder;
+    constructor(appBinder: ContactsAppBinder);
+    execute(input: RegisterExternalAddressInput): RegisterExternalAddressDAReturnType;
+}
+//# sourceMappingURL=RegisterExternalAddressUseCase.d.ts.map

package/lib/types/internal/use-cases/RegisterExternalAddressUseCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegisterExternalAddressUseCase.d.ts","sourceRoot":"","sources":["../../../../src/internal/use-cases/RegisterExternalAddressUseCase.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,mCAAmC,EAAE,MAAM,0DAA0D,CAAC;AACpH,OAAO,EAAE,KAAK,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAG3E;;;;;;;GAOG;AACH,qBACa,8BAA8B;IAGvC,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,iBAAiB;IAG/C,OAAO,CACL,KAAK,EAAE,4BAA4B,GAClC,mCAAmC;CAGvC"}

package/lib/types/internal/use-cases/RegisterExternalAddressUseCase.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RegisterExternalAddressUseCase.test.d.ts.map

package/lib/types/internal/use-cases/RegisterExternalAddressUseCase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegisterExternalAddressUseCase.test.d.ts","sourceRoot":"","sources":["../../../../src/internal/use-cases/RegisterExternalAddressUseCase.test.ts"],"names":[],"mappings":""}

package/lib/types/internal/use-cases/di/useCaseModule.d.ts

@@ -0,0 +1,3 @@
+import { ContainerModule } from "inversify";
+export declare const useCaseModuleFactory: () => ContainerModule;
+//# sourceMappingURL=useCaseModule.d.ts.map

package/lib/types/internal/use-cases/di/useCaseModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCaseModule.d.ts","sourceRoot":"","sources":["../../../../../src/internal/use-cases/di/useCaseModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAM5C,eAAO,MAAM,oBAAoB,uBAK7B,CAAC"}

package/lib/types/internal/use-cases/di/useCaseTypes.d.ts

@@ -0,0 +1,4 @@
+export declare const useCaseTypes: {
+    readonly RegisterExternalAddressUseCase: symbol;
+};
+//# sourceMappingURL=useCaseTypes.d.ts.map

package/lib/types/internal/use-cases/di/useCaseTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCaseTypes.d.ts","sourceRoot":"","sources":["../../../../../src/internal/use-cases/di/useCaseTypes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY;;CAEf,CAAC"}