npm - @ledgerhq/device-contacts-kit - Versions diffs - 0.3.1 → 0.4.1 - Mend

@ledgerhq/device-contacts-kit 0.3.1 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (128) hide show

package/lib/esm/internal/app-binder/device-action/RenameContact/RenameContactDeviceAction.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../src/internal/app-binder/device-action/RenameContact/RenameContactDeviceAction.ts"],
-  "sourcesContent": ["import {\n  type DeviceActionStateMachine,\n  GoToDashboardDeviceAction,\n  type InternalApi,\n  isSuccessCommandResult,\n  type StateMachineTypes,\n  UnknownDAError,\n  UserInteractionRequired,\n  XStateDeviceAction,\n} from \"@ledgerhq/device-management-kit\";\nimport { Left, Right } from \"purify-ts\";\nimport { assign, fromPromise, setup } from \"xstate\";\n\nimport {\n  type RenameContactDAError,\n  type RenameContactDAInput,\n  type RenameContactDAIntermediateValue,\n  type RenameContactDAInternalState,\n  type RenameContactDAOutput,\n} from \"@api/app-binder/RenameContactDeviceActionTypes\";\nimport { isContactsOsSupportedForSession } from \"@internal/app-binder/contactsVersionGuards\";\nimport { ContactsVersionRequirementError } from \"@internal/app-binder/model/contactsErrors\";\nimport {\n  type RenameContactProof,\n  SendRenameContactTask,\n} from \"@internal/app-binder/task/SendRenameContactTask\";\n\nimport { validateRenameContactInput } from \"./validateRenameContactInput\";\n\nexport type RenameContactMachineDependencies = {\n  readonly isOsSupported: () => boolean;\n  readonly renameContact: (\n    input: RenameContactDAInput,\n  ) => Promise<Awaited<ReturnType<SendRenameContactTask[\"run\"]>>>;\n};\n\nexport class RenameContactDeviceAction extends XStateDeviceAction<\n  RenameContactDAOutput,\n  RenameContactDAInput,\n  RenameContactDAError,\n  RenameContactDAIntermediateValue,\n  RenameContactDAInternalState\n> {\n  makeStateMachine(\n    internalApi: InternalApi,\n  ): DeviceActionStateMachine<\n    RenameContactDAOutput,\n    RenameContactDAInput,\n    RenameContactDAError,\n    RenameContactDAIntermediateValue,\n    RenameContactDAInternalState\n  > {\n    type types = StateMachineTypes<\n      RenameContactDAOutput,\n      RenameContactDAInput,\n      RenameContactDAError,\n      RenameContactDAIntermediateValue,\n      RenameContactDAInternalState\n    >;\n\n    const { isOsSupported, renameContact } =\n      this.extractDependencies(internalApi);\n\n    return setup({\n      types: {\n        input: {} as types[\"input\"],\n        context: {} as types[\"context\"],\n        output: {} as types[\"output\"],\n      },\n      actors: {\n        // Rename is an OS/dashboard command: navigate to the dashboard (which\n        // closes any running app) instead of opening an embedded app. There is\n        // no OpenAppDeviceAction here by design.\n        goToDashboardStateMachine: new GoToDashboardDeviceAction({\n          input: {},\n        }).makeStateMachine(internalApi),\n        renameContact: fromPromise(\n          ({ input }: { input: RenameContactDAInput }) => renameContact(input),\n        ),\n      },\n      guards: {\n        noInternalError: ({ context }) => context._internalState.error === null,\n        contactsOsSupported: () => isOsSupported(),\n      },\n      actions: {\n        assignValidationError: assign({\n          _internalState: ({ context }) => {\n            const error = validateRenameContactInput(context.input);\n            return error\n              ? { ...context._internalState, error }\n              : context._internalState;\n          },\n        }),\n        assignVersionError: assign({\n          _internalState: ({ context }) => ({\n            ...context._internalState,\n            error: new ContactsVersionRequirementError(),\n          }),\n        }),\n        assignErrorFromEvent: assign({\n          _internalState: ({ context, event }) => ({\n            ...context._internalState,\n            error: new UnknownDAError(\n              event[\"error\"] instanceof Error\n                ? event[\"error\"].message\n                : String(event[\"error\"]),\n            ),\n          }),\n        }),\n      },\n    }).createMachine({\n      id: \"RenameContactDeviceAction\",\n      initial: \"InitialState\",\n      context: ({ input }) => ({\n        input,\n        intermediateValue: {\n          requiredUserInteraction: UserInteractionRequired.None,\n        },\n        _internalState: {\n          error: null,\n          proof: null,\n        },\n      }),\n      states: {\n        InitialState: {\n          always: { target: \"GoToDashboard\" },\n        },\n        // Always navigate to the dashboard first \u2014 rename is an OS command and\n        // must not run inside an app. Closing any running app happens here.\n        GoToDashboard: {\n          invoke: {\n            id: \"goToDashboard\",\n            src: \"goToDashboardStateMachine\",\n            input: () => ({}),\n            onSnapshot: {\n              actions: assign({\n                // The child surfaces both requiredUserInteraction and a step;\n                // only the interaction is part of this action's contract.\n                intermediateValue: ({ event }) => ({\n                  requiredUserInteraction:\n                    event.snapshot.context.intermediateValue\n                      .requiredUserInteraction,\n                }),\n              }),\n            },\n            onDone: {\n              target: \"GoToDashboardCheck\",\n              actions: assign({\n                _internalState: ({ event, context }) =>\n                  event.output.caseOf<RenameContactDAInternalState>({\n                    Right: () => context._internalState,\n                    Left: (error) => ({ ...context._internalState, error }),\n                  }),\n              }),\n            },\n            onError: {\n              target: \"Error\",\n              actions: \"assignErrorFromEvent\",\n            },\n          },\n        },\n        GoToDashboardCheck: {\n          always: [\n            { target: \"ValidateInput\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        // Input validation runs inside the device action so invalid caller input\n        // surfaces as a typed terminal error state on the observable instead of\n        // a synchronous throw.\n        ValidateInput: {\n          entry: \"assignValidationError\",\n          always: [\n            { target: \"VersionGuard\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        // OS-only version guard: rename is served by the device OS, so only the\n        // device model and OS version are checked (no embedded-app version).\n        VersionGuard: {\n          always: [\n            { target: \"RenameContact\", guard: \"contactsOsSupported\" },\n            { target: \"Error\", actions: \"assignVersionError\" },\n          ],\n        },\n        RenameContact: {\n          entry: assign({\n            intermediateValue: {\n              requiredUserInteraction: UserInteractionRequired.RegisterWallet,\n            },\n          }),\n          exit: assign({\n            intermediateValue: {\n              requiredUserInteraction: UserInteractionRequired.None,\n            },\n          }),\n          invoke: {\n            id: \"renameContact\",\n            src: \"renameContact\",\n            input: ({ context }) => context.input,\n            onDone: {\n              target: \"RenameContactResultCheck\",\n              actions: assign({\n                _internalState: ({ event, context }) =>\n                  isSuccessCommandResult(event.output)\n                    ? { ...context._internalState, proof: event.output.data }\n                    : {\n                        ...context._internalState,\n                        error: event.output.error,\n                      },\n              }),\n            },\n            onError: {\n              target: \"Error\",\n              actions: \"assignErrorFromEvent\",\n            },\n          },\n        },\n        RenameContactResultCheck: {\n          always: [\n            { target: \"Success\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        Success: { type: \"final\" },\n        Error: { type: \"final\" },\n      },\n      output: ({ context }) => {\n        const { proof, error } = context._internalState;\n        if (proof) {\n          const { input } = context;\n          return Right({\n            previousContactName: input.previousContactName,\n            contactName: input.newContactName,\n            groupHandle: input.groupHandle,\n            hmacProof: proof.hmacProof,\n          });\n        }\n        return Left(error ?? new UnknownDAError(\"No error in final state\"));\n      },\n    });\n  }\n\n  extractDependencies(\n    internalApi: InternalApi,\n  ): RenameContactMachineDependencies {\n    const isOsSupported = () => isContactsOsSupportedForSession(internalApi);\n\n    const renameContact = (\n      input: RenameContactDAInput,\n    ): Promise<Awaited<ReturnType<SendRenameContactTask[\"run\"]>>> =>\n      new SendRenameContactTask(internalApi, {\n        previousContactName: input.previousContactName,\n        newContactName: input.newContactName,\n        groupHandle: input.groupHandle,\n        hmacProof: input.hmacProof,\n      }).run();\n\n    return { isOsSupported, renameContact };\n  }\n}\n\nexport type { RenameContactProof };\n"],
-  "mappings": "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",
-  "names": ["GoToDashboardDeviceAction", "isSuccessCommandResult", "UnknownDAError", "UserInteractionRequired", "XStateDeviceAction", "Left", "Right", "assign", "fromPromise", "setup", "isContactsOsSupportedForSession", "ContactsVersionRequirementError", "SendRenameContactTask", "validateRenameContactInput", "RenameContactDeviceAction", "internalApi", "isOsSupported", "renameContact", "input", "context", "error", "event", "proof"]
+  "sourcesContent": ["import {\n  type DeviceActionStateMachine,\n  GetOsVersionCommand,\n  type GetOsVersionCommandResult,\n  GoToDashboardDeviceAction,\n  type InternalApi,\n  isSuccessCommandResult,\n  type StateMachineTypes,\n  UnknownDAError,\n  UserInteractionRequired,\n  XStateDeviceAction,\n} from \"@ledgerhq/device-management-kit\";\nimport { Left, Right } from \"purify-ts\";\nimport { assign, fromPromise, setup } from \"xstate\";\n\nimport {\n  type RenameContactDAError,\n  type RenameContactDAInput,\n  type RenameContactDAIntermediateValue,\n  type RenameContactDAInternalState,\n  type RenameContactDAOutput,\n} from \"@api/app-binder/RenameContactDeviceActionTypes\";\nimport { renameRequiresDerivationPath } from \"@api/model/ContactsVersionRequirements\";\nimport { isContactsOsVersionSupportedForSession } from \"@internal/app-binder/contactsVersionGuards\";\nimport { ContactsVersionRequirementError } from \"@internal/app-binder/model/contactsErrors\";\nimport {\n  type RenameContactProof,\n  SendRenameContactTask,\n} from \"@internal/app-binder/task/SendRenameContactTask\";\n\nimport { validateRenameContactInput } from \"./validateRenameContactInput\";\n\nexport type RenameContactMachineDependencies = {\n  readonly getOsVersion: () => Promise<GetOsVersionCommandResult>;\n  readonly isOsVersionSupported: (osVersion: string) => boolean;\n  readonly renameContact: (\n    input: RenameContactDAInput,\n    includeDerivationPath: boolean,\n  ) => Promise<Awaited<ReturnType<SendRenameContactTask[\"run\"]>>>;\n};\n\nexport class RenameContactDeviceAction extends XStateDeviceAction<\n  RenameContactDAOutput,\n  RenameContactDAInput,\n  RenameContactDAError,\n  RenameContactDAIntermediateValue,\n  RenameContactDAInternalState\n> {\n  makeStateMachine(\n    internalApi: InternalApi,\n  ): DeviceActionStateMachine<\n    RenameContactDAOutput,\n    RenameContactDAInput,\n    RenameContactDAError,\n    RenameContactDAIntermediateValue,\n    RenameContactDAInternalState\n  > {\n    type types = StateMachineTypes<\n      RenameContactDAOutput,\n      RenameContactDAInput,\n      RenameContactDAError,\n      RenameContactDAIntermediateValue,\n      RenameContactDAInternalState\n    >;\n\n    const { getOsVersion, isOsVersionSupported, renameContact } =\n      this.extractDependencies(internalApi);\n    // Device model is stable for the session; the fresh OS version comes from\n    // the GetOsVersion step. Together they decide whether the rename payload\n    // must still carry the DERIVATION_PATH (DSDK-1481).\n    const { deviceModelId } = internalApi.getDeviceSessionState();\n\n    return setup({\n      types: {\n        input: {} as types[\"input\"],\n        context: {} as types[\"context\"],\n        output: {} as types[\"output\"],\n      },\n      actors: {\n        // Rename is an OS/dashboard command: navigate to the dashboard (which\n        // closes any running app) instead of opening an embedded app. There is\n        // no OpenAppDeviceAction here by design.\n        goToDashboardStateMachine: new GoToDashboardDeviceAction({\n          input: {},\n        }).makeStateMachine(internalApi),\n        getOsVersion: fromPromise(getOsVersion),\n        renameContact: fromPromise(\n          ({\n            input,\n          }: {\n            input: {\n              args: RenameContactDAInput;\n              includeDerivationPath: boolean;\n            };\n          }) => renameContact(input.args, input.includeDerivationPath),\n        ),\n      },\n      guards: {\n        noInternalError: ({ context }) => context._internalState.error === null,\n        // Gate on the OS version read freshly via `GetOsVersion`, never the\n        // session state. `osVersion` is populated by the GetOsVersion step\n        // that precedes this guard; a command failure short-circuits to Error\n        // before we get here, so a null here would be a machine-wiring bug.\n        contactsOsSupported: ({ context }) => {\n          const { osVersion } = context._internalState;\n          return osVersion !== null && isOsVersionSupported(osVersion);\n        },\n      },\n      actions: {\n        assignValidationError: assign({\n          _internalState: ({ context }) => {\n            const error = validateRenameContactInput(context.input);\n            return error\n              ? { ...context._internalState, error }\n              : context._internalState;\n          },\n        }),\n        assignVersionError: assign({\n          _internalState: ({ context }) => ({\n            ...context._internalState,\n            error: new ContactsVersionRequirementError(),\n          }),\n        }),\n        assignErrorFromEvent: assign({\n          _internalState: ({ context, event }) => ({\n            ...context._internalState,\n            error: new UnknownDAError(\n              event[\"error\"] instanceof Error\n                ? event[\"error\"].message\n                : String(event[\"error\"]),\n            ),\n          }),\n        }),\n      },\n    }).createMachine({\n      id: \"RenameContactDeviceAction\",\n      initial: \"InitialState\",\n      context: ({ input }) => ({\n        input,\n        intermediateValue: {\n          requiredUserInteraction: UserInteractionRequired.None,\n        },\n        _internalState: {\n          error: null,\n          osVersion: null,\n          proof: null,\n        },\n      }),\n      states: {\n        InitialState: {\n          always: { target: \"GoToDashboard\" },\n        },\n        // Always navigate to the dashboard first \u2014 rename is an OS command and\n        // must not run inside an app. Closing any running app happens here.\n        GoToDashboard: {\n          invoke: {\n            id: \"goToDashboard\",\n            src: \"goToDashboardStateMachine\",\n            input: () => ({}),\n            onSnapshot: {\n              actions: assign({\n                // The child surfaces both requiredUserInteraction and a step;\n                // only the interaction is part of this action's contract.\n                intermediateValue: ({ event }) => ({\n                  requiredUserInteraction:\n                    event.snapshot.context.intermediateValue\n                      .requiredUserInteraction,\n                }),\n              }),\n            },\n            onDone: {\n              target: \"GoToDashboardCheck\",\n              actions: assign({\n                _internalState: ({ event, context }) =>\n                  event.output.caseOf<RenameContactDAInternalState>({\n                    Right: () => context._internalState,\n                    Left: (error) => ({ ...context._internalState, error }),\n                  }),\n              }),\n            },\n            onError: {\n              target: \"Error\",\n              actions: \"assignErrorFromEvent\",\n            },\n          },\n        },\n        GoToDashboardCheck: {\n          always: [\n            { target: \"ValidateInput\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        // Input validation runs inside the device action so invalid caller input\n        // surfaces as a typed terminal error state on the observable instead of\n        // a synchronous throw.\n        ValidateInput: {\n          entry: \"assignValidationError\",\n          always: [\n            { target: \"GetOsVersion\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        // Read the OS version freshly from the device now that the dashboard\n        // (BOLOS) is reached, so the version guard evaluates real firmware\n        // rather than the session state \u2014 whose `firmwareVersion` is often\n        // absent on this path (GoToDashboard re-reads only the running app).\n        GetOsVersion: {\n          // Clear the stale interaction GoToDashboard leaves behind (e.g.\n          // UnlockDevice) so this internal command step asks the user for\n          // nothing. This is the one `pending / none` step of the phase.\n          entry: assign({\n            intermediateValue: {\n              requiredUserInteraction: UserInteractionRequired.None,\n            },\n          }),\n          invoke: {\n            id: \"getOsVersion\",\n            src: \"getOsVersion\",\n            onDone: {\n              target: \"GetOsVersionResultCheck\",\n              actions: assign({\n                _internalState: ({ event, context }) =>\n                  isSuccessCommandResult(event.output)\n                    ? {\n                        ...context._internalState,\n                        osVersion: event.output.data.seVersion,\n                      }\n                    : // A command failure surfaces as itself, never as a\n                      // ContactsVersionRequirementError.\n                      { ...context._internalState, error: event.output.error },\n              }),\n            },\n            onError: {\n              target: \"Error\",\n              actions: \"assignErrorFromEvent\",\n            },\n          },\n        },\n        GetOsVersionResultCheck: {\n          always: [\n            { target: \"VersionGuard\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        // OS-only version guard: rename is served by the device OS, so only the\n        // device model and OS version are checked (no embedded-app version).\n        // The OS version comes from the fresh GetOsVersion result above.\n        VersionGuard: {\n          always: [\n            { target: \"RenameContact\", guard: \"contactsOsSupported\" },\n            { target: \"Error\", actions: \"assignVersionError\" },\n          ],\n        },\n        RenameContact: {\n          entry: assign({\n            intermediateValue: {\n              requiredUserInteraction: UserInteractionRequired.RegisterWallet,\n            },\n          }),\n          exit: assign({\n            intermediateValue: {\n              requiredUserInteraction: UserInteractionRequired.None,\n            },\n          }),\n          invoke: {\n            id: \"renameContact\",\n            src: \"renameContact\",\n            input: ({ context }) => ({\n              args: context.input,\n              // Fresh OS version (from GetOsVersion) is guaranteed set here: a\n              // null would have failed the VersionGuard before this state. The\n              // ?? \"\" is a defensive no-path fallback that can never trigger.\n              includeDerivationPath: renameRequiresDerivationPath(\n                deviceModelId,\n                context._internalState.osVersion ?? \"\",\n              ),\n            }),\n            onDone: {\n              target: \"RenameContactResultCheck\",\n              actions: assign({\n                _internalState: ({ event, context }) =>\n                  isSuccessCommandResult(event.output)\n                    ? { ...context._internalState, proof: event.output.data }\n                    : {\n                        ...context._internalState,\n                        error: event.output.error,\n                      },\n              }),\n            },\n            onError: {\n              target: \"Error\",\n              actions: \"assignErrorFromEvent\",\n            },\n          },\n        },\n        RenameContactResultCheck: {\n          always: [\n            { target: \"Success\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        Success: { type: \"final\" },\n        Error: { type: \"final\" },\n      },\n      output: ({ context }) => {\n        const { proof, error } = context._internalState;\n        if (proof) {\n          const { input } = context;\n          return Right({\n            previousContactName: input.previousContactName,\n            contactName: input.newContactName,\n            groupHandle: input.groupHandle,\n            hmacProof: proof.hmacProof,\n          });\n        }\n        return Left(error ?? new UnknownDAError(\"No error in final state\"));\n      },\n    });\n  }\n\n  extractDependencies(\n    internalApi: InternalApi,\n  ): RenameContactMachineDependencies {\n    const getOsVersion = (): Promise<GetOsVersionCommandResult> =>\n      internalApi.sendCommand(new GetOsVersionCommand());\n\n    const isOsVersionSupported = (osVersion: string) =>\n      isContactsOsVersionSupportedForSession(internalApi, osVersion);\n\n    const renameContact = (\n      input: RenameContactDAInput,\n      includeDerivationPath: boolean,\n    ): Promise<Awaited<ReturnType<SendRenameContactTask[\"run\"]>>> =>\n      new SendRenameContactTask(internalApi, {\n        previousContactName: input.previousContactName,\n        newContactName: input.newContactName,\n        groupHandle: input.groupHandle,\n        hmacProof: input.hmacProof,\n        includeDerivationPath,\n      }).run();\n\n    return { getOsVersion, isOsVersionSupported, renameContact };\n  }\n}\n\nexport type { RenameContactProof };\n"],
+  "mappings": "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",
+  "names": ["GetOsVersionCommand", "GoToDashboardDeviceAction", "isSuccessCommandResult", "UnknownDAError", "UserInteractionRequired", "XStateDeviceAction", "Left", "Right", "assign", "fromPromise", "setup", "renameRequiresDerivationPath", "isContactsOsVersionSupportedForSession", "ContactsVersionRequirementError", "SendRenameContactTask", "validateRenameContactInput", "RenameContactDeviceAction", "internalApi", "getOsVersion", "isOsVersionSupported", "renameContact", "deviceModelId", "input", "context", "osVersion", "error", "event", "proof", "includeDerivationPath"]
 }

package/lib/esm/internal/app-binder/device-action/RenameContact/RenameContactDeviceAction.test.js CHANGED Viewed

@@ -1,2 +1,2 @@
-import{CommandResultFactory as C,DeviceActionStatus as e,DeviceModelId as k,DeviceSessionStateType as g,DeviceStatus as E,GoToDashboardDeviceAction as h,OpenAppDeviceAction as R,UnknownDAError as P,UserInteractionRequired as t}from"@ledgerhq/device-management-kit";import{beforeEach as S,describe as V,expect as s,it as D,vi as c}from"vitest";import{makeDeviceActionInternalApiMock as y}from"../../../app-binder/device-action/__test-utils__/makeInternalApi";import{setupGoToDashboardDAMock as v}from"../../../app-binder/device-action/__test-utils__/setupGoToDashboardDAMock";import{testDeviceActionStates as A}from"../../../app-binder/device-action/__test-utils__/testDeviceActionStates";import{ContactsCommandError as q,ContactsVersionRequirementError as O}from"../../../app-binder/model/contactsErrors";import{RenameContactDeviceAction as w}from"./RenameContactDeviceAction";import{validateRenameContactInput as N}from"./validateRenameContactInput";c.mock("@ledgerhq/device-management-kit",async a=>({...await a(),GoToDashboardDeviceAction:c.fn(()=>({makeStateMachine:c.fn()})),OpenAppDeviceAction:c.fn(()=>({makeStateMachine:c.fn()}))}));const f={hmacProof:new Uint8Array(32).fill(238)},m={previousContactName:"Alice",newContactName:"Bob",groupHandle:new Uint8Array(64).fill(204),hmacProof:new Uint8Array(32).fill(221)},T={previousContactName:"Alice",contactName:"Bob",groupHandle:m.groupHandle,hmacProof:f.hmacProof};V("RenameContactDeviceAction",()=>{let a,d,u;function U(){return{isOsSupported:d,renameContact:u}}S(()=>{c.clearAllMocks(),a=y(),d=c.fn().mockReturnValue(!0),u=c.fn().mockResolvedValue(C({data:f})),a.getDeviceSessionState.mockReturnValue({sessionStateType:g.ReadyWithoutSecureChannel,deviceStatus:E.CONNECTED,installedApps:[],currentApp:{name:"BOLOS",version:"1.7.0"},deviceModelId:k.FLEX,isSecureConnectionAllowed:!0})});function l(r){const n=new w({input:r});return c.spyOn(n,"extractDependencies").mockReturnValue(U()),n}D("navigates to the dashboard, checks the OS, renames, and completes",()=>new Promise((r,n)=>{v({requiredUserInteraction:t.UnlockDevice});const o=l(m),i=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.UnlockDevice},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.RegisterWallet},status:e.Pending},{output:T,status:e.Completed}];A(o,i,a,{onDone:()=>{s(h).toHaveBeenCalled(),s(R).not.toHaveBeenCalled(),r()},onError:n})})),D("rejects on an unsupported OS version without sending the APDU",()=>new Promise((r,n)=>{v({requiredUserInteraction:t.UnlockDevice}),d.mockReturnValue(!1);const o=l(m),i=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.UnlockDevice},status:e.Pending},{error:new O,status:e.Error}];A(o,i,a,{onDone:()=>{s(u).not.toHaveBeenCalled(),s(R).not.toHaveBeenCalled(),r()},onError:n})})),D("surfaces a go-to-dashboard failure as the device action error",()=>new Promise((r,n)=>{const o=new P("go to dashboard failed");v({error:o,requiredUserInteraction:t.UnlockDevice});const i=l(m),p=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.UnlockDevice},status:e.Pending},{error:o,status:e.Error}];A(i,p,a,{onDone:()=>{s(d).not.toHaveBeenCalled(),s(u).not.toHaveBeenCalled(),r()},onError:n})})),D("surfaces a rename command error (e.g. seed mismatch)",()=>new Promise((r,n)=>{v({requiredUserInteraction:t.UnlockDevice});const o=new q({errorCode:"6982",message:"wrong seed"});u.mockResolvedValue(C({error:o}));const i=l(m),p=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.UnlockDevice},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.RegisterWallet},status:e.Pending},{error:o,status:e.Error}];A(i,p,a,{onDone:r,onError:n})})),D("surfaces invalid input as a typed error after reaching the dashboard",()=>new Promise((r,n)=>{v({requiredUserInteraction:t.UnlockDevice});const o={...m,newContactName:""},i=N(o),p=l(o),I=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.UnlockDevice},status:e.Pending},{error:i,status:e.Error}];A(p,I,a,{onDone:()=>{s(d).not.toHaveBeenCalled(),s(u).not.toHaveBeenCalled(),r()},onError:n})}))});
+import{CommandResultFactory as U,DeviceActionStatus as t,DeviceModelId as f,DeviceSessionStateType as g,DeviceStatus as h,GoToDashboardDeviceAction as O,OpenAppDeviceAction as E,UnknownDAError as w,UserInteractionRequired as e}from"@ledgerhq/device-management-kit";import{beforeEach as y,describe as N,expect as o,it as p,vi as u}from"vitest";import{makeDeviceActionInternalApiMock as B}from"../../../app-binder/device-action/__test-utils__/makeInternalApi";import{setupGoToDashboardDAMock as D}from"../../../app-binder/device-action/__test-utils__/setupGoToDashboardDAMock";import{testDeviceActionStates as C}from"../../../app-binder/device-action/__test-utils__/testDeviceActionStates";import{ContactsCommandError as k,ContactsVersionRequirementError as H}from"../../../app-binder/model/contactsErrors";import{RenameContactDeviceAction as T}from"./RenameContactDeviceAction";import{validateRenameContactInput as b}from"./validateRenameContactInput";u.mock("@ledgerhq/device-management-kit",async i=>({...await i(),GoToDashboardDeviceAction:u.fn(()=>({makeStateMachine:u.fn()})),OpenAppDeviceAction:u.fn(()=>({makeStateMachine:u.fn()}))}));const S={hmacProof:new Uint8Array(32).fill(238)},R="1.7.0",s={previousContactName:"Alice",newContactName:"Bob",groupHandle:new Uint8Array(64).fill(204),hmacProof:new Uint8Array(32).fill(221)},V={previousContactName:"Alice",contactName:"Bob",groupHandle:s.groupHandle,hmacProof:S.hmacProof};N("RenameContactDeviceAction",()=>{let i,d,l,m;function P(){return{getOsVersion:d,isOsVersionSupported:l,renameContact:m}}y(()=>{u.clearAllMocks(),i=B(),d=u.fn().mockResolvedValue(U({data:{seVersion:R}})),l=u.fn().mockReturnValue(!0),m=u.fn().mockResolvedValue(U({data:S})),i.getDeviceSessionState.mockReturnValue({sessionStateType:g.ReadyWithoutSecureChannel,deviceStatus:h.CONNECTED,installedApps:[],currentApp:{name:"BOLOS",version:"1.7.0"},deviceModelId:f.FLEX,isSecureConnectionAllowed:!0})});function v(a){const r=new T({input:a});return u.spyOn(r,"extractDependencies").mockReturnValue(P()),r}p("navigates to the dashboard, reads the OS freshly, renames, and completes",()=>new Promise((a,r)=>{D({requiredUserInteraction:e.UnlockDevice});const n=v(s),c=[{intermediateValue:{requiredUserInteraction:e.None},status:t.Pending},{intermediateValue:{requiredUserInteraction:e.UnlockDevice},status:t.Pending},{intermediateValue:{requiredUserInteraction:e.None},status:t.Pending},{intermediateValue:{requiredUserInteraction:e.RegisterWallet},status:t.Pending},{output:V,status:t.Completed}];C(n,c,i,{onDone:()=>{o(O).toHaveBeenCalled(),o(E).not.toHaveBeenCalled(),o(d).toHaveBeenCalled(),o(l).toHaveBeenCalledWith(R),a()},onError:r})})),p("succeeds when an app was open at start, gating on the freshly-read OS",()=>new Promise((a,r)=>{i.getDeviceSessionState.mockReturnValue({sessionStateType:g.ReadyWithoutSecureChannel,deviceStatus:h.CONNECTED,installedApps:[],currentApp:{name:"Ethereum",version:"1.23.0"},deviceModelId:f.FLEX,isSecureConnectionAllowed:!0}),D({requiredUserInteraction:e.UnlockDevice});const n=v(s),c=[{intermediateValue:{requiredUserInteraction:e.None},status:t.Pending},{intermediateValue:{requiredUserInteraction:e.UnlockDevice},status:t.Pending},{intermediateValue:{requiredUserInteraction:e.None},status:t.Pending},{intermediateValue:{requiredUserInteraction:e.RegisterWallet},status:t.Pending},{output:V,status:t.Completed}];C(n,c,i,{onDone:()=>{o(d).toHaveBeenCalled(),o(l).toHaveBeenCalledWith(R),a()},onError:r})})),p("rejects on an unsupported OS version without sending the APDU",()=>new Promise((a,r)=>{D({requiredUserInteraction:e.UnlockDevice}),l.mockReturnValue(!1);const n=v(s),c=[{intermediateValue:{requiredUserInteraction:e.None},status:t.Pending},{intermediateValue:{requiredUserInteraction:e.UnlockDevice},status:t.Pending},{intermediateValue:{requiredUserInteraction:e.None},status:t.Pending},{error:new H,status:t.Error}];C(n,c,i,{onDone:()=>{o(d).toHaveBeenCalled(),o(l).toHaveBeenCalledWith(R),o(m).not.toHaveBeenCalled(),o(E).not.toHaveBeenCalled(),a()},onError:r})})),p("surfaces a go-to-dashboard failure as the device action error",()=>new Promise((a,r)=>{const n=new w("go to dashboard failed");D({error:n,requiredUserInteraction:e.UnlockDevice});const c=v(s),A=[{intermediateValue:{requiredUserInteraction:e.None},status:t.Pending},{intermediateValue:{requiredUserInteraction:e.UnlockDevice},status:t.Pending},{error:n,status:t.Error}];C(c,A,i,{onDone:()=>{o(d).not.toHaveBeenCalled(),o(l).not.toHaveBeenCalled(),o(m).not.toHaveBeenCalled(),a()},onError:r})})),p("surfaces a rename command error (e.g. seed mismatch)",()=>new Promise((a,r)=>{D({requiredUserInteraction:e.UnlockDevice});const n=new k({errorCode:"6982",message:"wrong seed"});m.mockResolvedValue(U({error:n}));const c=v(s),A=[{intermediateValue:{requiredUserInteraction:e.None},status:t.Pending},{intermediateValue:{requiredUserInteraction:e.UnlockDevice},status:t.Pending},{intermediateValue:{requiredUserInteraction:e.None},status:t.Pending},{intermediateValue:{requiredUserInteraction:e.RegisterWallet},status:t.Pending},{error:n,status:t.Error}];C(c,A,i,{onDone:a,onError:r})})),p("surfaces invalid input as a typed error after reaching the dashboard",()=>new Promise((a,r)=>{D({requiredUserInteraction:e.UnlockDevice});const n={...s,newContactName:""},c=b(n),A=v(n),q=[{intermediateValue:{requiredUserInteraction:e.None},status:t.Pending},{intermediateValue:{requiredUserInteraction:e.UnlockDevice},status:t.Pending},{error:c,status:t.Error}];C(A,q,i,{onDone:()=>{o(d).not.toHaveBeenCalled(),o(l).not.toHaveBeenCalled(),o(m).not.toHaveBeenCalled(),a()},onError:r})})),p("surfaces a GetOsVersion failure as the command error, not a version error",()=>new Promise((a,r)=>{D({requiredUserInteraction:e.UnlockDevice});const n=new k({errorCode:"6f00",message:"GetOsVersion failed"});d.mockResolvedValue(U({error:n}));const c=v(s),A=[{intermediateValue:{requiredUserInteraction:e.None},status:t.Pending},{intermediateValue:{requiredUserInteraction:e.UnlockDevice},status:t.Pending},{intermediateValue:{requiredUserInteraction:e.None},status:t.Pending},{error:n,status:t.Error}];C(c,A,i,{onDone:()=>{o(l).not.toHaveBeenCalled(),o(m).not.toHaveBeenCalled(),a()},onError:r})}));const I=[{intermediateValue:{requiredUserInteraction:e.None},status:t.Pending},{intermediateValue:{requiredUserInteraction:e.UnlockDevice},status:t.Pending},{intermediateValue:{requiredUserInteraction:e.None},status:t.Pending},{intermediateValue:{requiredUserInteraction:e.RegisterWallet},status:t.Pending},{output:V,status:t.Completed}];p("sends the derivation path when the fresh OS is below the model cutoff (rc2)",()=>new Promise((a,r)=>{D({requiredUserInteraction:e.UnlockDevice}),d.mockResolvedValue(U({data:{seVersion:"1.7.0-rc2"}}));const n=v(s);C(n,I,i,{onDone:()=>{o(m).toHaveBeenCalledWith(s,!0),a()},onError:r})})),p("omits the derivation path when the fresh OS is at/after the cutoff (rc3/GA)",()=>new Promise((a,r)=>{D({requiredUserInteraction:e.UnlockDevice}),d.mockResolvedValue(U({data:{seVersion:"1.7.0-rc3"}}));const n=v(s);C(n,I,i,{onDone:()=>{o(m).toHaveBeenCalledWith(s,!1),a()},onError:r})}))});
 //# sourceMappingURL=RenameContactDeviceAction.test.js.map

package/lib/esm/internal/app-binder/device-action/RenameContact/RenameContactDeviceAction.test.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../src/internal/app-binder/device-action/RenameContact/RenameContactDeviceAction.test.ts"],
-  "sourcesContent": ["import {\n  CommandResultFactory,\n  type DeviceActionState,\n  DeviceActionStatus,\n  DeviceModelId,\n  DeviceSessionStateType,\n  DeviceStatus,\n  GoToDashboardDeviceAction,\n  OpenAppDeviceAction,\n  UnknownDAError,\n  UserInteractionRequired,\n} from \"@ledgerhq/device-management-kit\";\nimport { beforeEach, describe, expect, it, vi } from \"vitest\";\n\nimport {\n  type RenameContactDAError,\n  type RenameContactDAInput,\n  type RenameContactDAIntermediateValue,\n  type RenameContactDAOutput,\n} from \"@api/app-binder/RenameContactDeviceActionTypes\";\nimport { makeDeviceActionInternalApiMock } from \"@internal/app-binder/device-action/__test-utils__/makeInternalApi\";\nimport { setupGoToDashboardDAMock } from \"@internal/app-binder/device-action/__test-utils__/setupGoToDashboardDAMock\";\nimport { testDeviceActionStates } from \"@internal/app-binder/device-action/__test-utils__/testDeviceActionStates\";\nimport {\n  ContactsCommandError,\n  ContactsVersionRequirementError,\n} from \"@internal/app-binder/model/contactsErrors\";\n\nimport { RenameContactDeviceAction } from \"./RenameContactDeviceAction\";\nimport { validateRenameContactInput } from \"./validateRenameContactInput\";\n\nvi.mock(\"@ledgerhq/device-management-kit\", async (importOriginal) => {\n  const original =\n    // eslint-disable-next-line @typescript-eslint/consistent-type-imports\n    await importOriginal<typeof import(\"@ledgerhq/device-management-kit\")>();\n  return {\n    ...original,\n    GoToDashboardDeviceAction: vi.fn(() => ({\n      makeStateMachine: vi.fn(),\n    })),\n    OpenAppDeviceAction: vi.fn(() => ({\n      makeStateMachine: vi.fn(),\n    })),\n  };\n});\n\nconst OK_PROOF = { hmacProof: new Uint8Array(32).fill(0xee) };\n\nconst BASE_INPUT: RenameContactDAInput = {\n  previousContactName: \"Alice\",\n  newContactName: \"Bob\",\n  groupHandle: new Uint8Array(64).fill(0xcc),\n  hmacProof: new Uint8Array(32).fill(0xdd),\n};\n\nconst EXPECTED_OUTPUT: RenameContactDAOutput = {\n  previousContactName: \"Alice\",\n  contactName: \"Bob\",\n  groupHandle: BASE_INPUT.groupHandle,\n  hmacProof: OK_PROOF.hmacProof,\n};\n\ndescribe(\"RenameContactDeviceAction\", () => {\n  let apiMock: ReturnType<typeof makeDeviceActionInternalApiMock>;\n  let isOsSupportedMock: ReturnType<typeof vi.fn>;\n  let renameContactMock: ReturnType<typeof vi.fn>;\n\n  function extractDeps() {\n    return {\n      isOsSupported: isOsSupportedMock,\n      renameContact: renameContactMock,\n    };\n  }\n\n  beforeEach(() => {\n    vi.clearAllMocks();\n    apiMock = makeDeviceActionInternalApiMock();\n    isOsSupportedMock = vi.fn().mockReturnValue(true);\n    renameContactMock = vi\n      .fn()\n      .mockResolvedValue(CommandResultFactory({ data: OK_PROOF }));\n    apiMock.getDeviceSessionState.mockReturnValue({\n      sessionStateType: DeviceSessionStateType.ReadyWithoutSecureChannel,\n      deviceStatus: DeviceStatus.CONNECTED,\n      installedApps: [],\n      currentApp: { name: \"BOLOS\", version: \"1.7.0\" },\n      deviceModelId: DeviceModelId.FLEX,\n      isSecureConnectionAllowed: true,\n    });\n  });\n\n  function makeAction(input: RenameContactDAInput) {\n    const action = new RenameContactDeviceAction({ input });\n    vi.spyOn(action, \"extractDependencies\").mockReturnValue(extractDeps());\n    return action;\n  }\n\n  it(\"navigates to the dashboard, checks the OS, renames, and completes\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupGoToDashboardDAMock({\n        requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n      });\n      const action = makeAction(BASE_INPUT);\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.RegisterWallet,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          output: EXPECTED_OUTPUT,\n          status: DeviceActionStatus.Completed,\n        },\n      ] as DeviceActionState<\n        RenameContactDAOutput,\n        RenameContactDAError,\n        RenameContactDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: () => {\n          // Rename is a dashboard op: it navigates to the dashboard and never\n          // opens an app.\n          expect(GoToDashboardDeviceAction).toHaveBeenCalled();\n          expect(OpenAppDeviceAction).not.toHaveBeenCalled();\n          resolve();\n        },\n        onError: reject,\n      });\n    }));\n\n  it(\"rejects on an unsupported OS version without sending the APDU\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupGoToDashboardDAMock({\n        requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n      });\n      isOsSupportedMock.mockReturnValue(false);\n      const action = makeAction(BASE_INPUT);\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: new ContactsVersionRequirementError(),\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        RenameContactDAOutput,\n        RenameContactDAError,\n        RenameContactDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: () => {\n          expect(renameContactMock).not.toHaveBeenCalled();\n          expect(OpenAppDeviceAction).not.toHaveBeenCalled();\n          resolve();\n        },\n        onError: reject,\n      });\n    }));\n\n  it(\"surfaces a go-to-dashboard failure as the device action error\", () =>\n    new Promise<void>((resolve, reject) => {\n      const dashboardError = new UnknownDAError(\"go to dashboard failed\");\n      setupGoToDashboardDAMock({\n        error: dashboardError,\n        requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n      });\n      const action = makeAction(BASE_INPUT);\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: dashboardError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        RenameContactDAOutput,\n        RenameContactDAError,\n        RenameContactDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: () => {\n          expect(isOsSupportedMock).not.toHaveBeenCalled();\n          expect(renameContactMock).not.toHaveBeenCalled();\n          resolve();\n        },\n        onError: reject,\n      });\n    }));\n\n  it(\"surfaces a rename command error (e.g. seed mismatch)\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupGoToDashboardDAMock({\n        requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n      });\n      const commandError = new ContactsCommandError({\n        errorCode: \"6982\",\n        message: \"wrong seed\",\n      });\n      renameContactMock.mockResolvedValue(\n        CommandResultFactory({ error: commandError }),\n      );\n      const action = makeAction(BASE_INPUT);\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.RegisterWallet,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: commandError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        RenameContactDAOutput,\n        RenameContactDAError,\n        RenameContactDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n    }));\n\n  it(\"surfaces invalid input as a typed error after reaching the dashboard\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupGoToDashboardDAMock({\n        requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n      });\n      const invalidInput = { ...BASE_INPUT, newContactName: \"\" };\n      const validationError = validateRenameContactInput(invalidInput);\n      const action = makeAction(invalidInput);\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: validationError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        RenameContactDAOutput,\n        RenameContactDAError,\n        RenameContactDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: () => {\n          // Validation fails before the version guard and before any APDU.\n          expect(isOsSupportedMock).not.toHaveBeenCalled();\n          expect(renameContactMock).not.toHaveBeenCalled();\n          resolve();\n        },\n        onError: reject,\n      });\n    }));\n});\n"],
-  "mappings": "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",
-  "names": ["CommandResultFactory", "DeviceActionStatus", "DeviceModelId", "DeviceSessionStateType", "DeviceStatus", "GoToDashboardDeviceAction", "OpenAppDeviceAction", "UnknownDAError", "UserInteractionRequired", "beforeEach", "describe", "expect", "it", "vi", "makeDeviceActionInternalApiMock", "setupGoToDashboardDAMock", "testDeviceActionStates", "ContactsCommandError", "ContactsVersionRequirementError", "RenameContactDeviceAction", "validateRenameContactInput", "importOriginal", "OK_PROOF", "BASE_INPUT", "EXPECTED_OUTPUT", "apiMock", "isOsSupportedMock", "renameContactMock", "extractDeps", "makeAction", "input", "action", "resolve", "reject", "expected", "dashboardError", "commandError", "invalidInput", "validationError"]
+  "sourcesContent": ["import {\n  CommandResultFactory,\n  type DeviceActionState,\n  DeviceActionStatus,\n  DeviceModelId,\n  DeviceSessionStateType,\n  DeviceStatus,\n  GoToDashboardDeviceAction,\n  OpenAppDeviceAction,\n  UnknownDAError,\n  UserInteractionRequired,\n} from \"@ledgerhq/device-management-kit\";\nimport { beforeEach, describe, expect, it, vi } from \"vitest\";\n\nimport {\n  type RenameContactDAError,\n  type RenameContactDAInput,\n  type RenameContactDAIntermediateValue,\n  type RenameContactDAOutput,\n} from \"@api/app-binder/RenameContactDeviceActionTypes\";\nimport { makeDeviceActionInternalApiMock } from \"@internal/app-binder/device-action/__test-utils__/makeInternalApi\";\nimport { setupGoToDashboardDAMock } from \"@internal/app-binder/device-action/__test-utils__/setupGoToDashboardDAMock\";\nimport { testDeviceActionStates } from \"@internal/app-binder/device-action/__test-utils__/testDeviceActionStates\";\nimport {\n  ContactsCommandError,\n  ContactsVersionRequirementError,\n} from \"@internal/app-binder/model/contactsErrors\";\n\nimport { RenameContactDeviceAction } from \"./RenameContactDeviceAction\";\nimport { validateRenameContactInput } from \"./validateRenameContactInput\";\n\nvi.mock(\"@ledgerhq/device-management-kit\", async (importOriginal) => {\n  const original =\n    // eslint-disable-next-line @typescript-eslint/consistent-type-imports\n    await importOriginal<typeof import(\"@ledgerhq/device-management-kit\")>();\n  return {\n    ...original,\n    GoToDashboardDeviceAction: vi.fn(() => ({\n      makeStateMachine: vi.fn(),\n    })),\n    OpenAppDeviceAction: vi.fn(() => ({\n      makeStateMachine: vi.fn(),\n    })),\n  };\n});\n\nconst OK_PROOF = { hmacProof: new Uint8Array(32).fill(0xee) };\n\n// The OS version the device returns freshly via GetOsVersion after the\n// dashboard is reached. The version guard must be fed *this*, not session state.\nconst FRESH_OS_VERSION = \"1.7.0\";\n\nconst BASE_INPUT: RenameContactDAInput = {\n  previousContactName: \"Alice\",\n  newContactName: \"Bob\",\n  groupHandle: new Uint8Array(64).fill(0xcc),\n  hmacProof: new Uint8Array(32).fill(0xdd),\n};\n\nconst EXPECTED_OUTPUT: RenameContactDAOutput = {\n  previousContactName: \"Alice\",\n  contactName: \"Bob\",\n  groupHandle: BASE_INPUT.groupHandle,\n  hmacProof: OK_PROOF.hmacProof,\n};\n\ndescribe(\"RenameContactDeviceAction\", () => {\n  let apiMock: ReturnType<typeof makeDeviceActionInternalApiMock>;\n  let getOsVersionMock: ReturnType<typeof vi.fn>;\n  let isOsVersionSupportedMock: ReturnType<typeof vi.fn>;\n  let renameContactMock: ReturnType<typeof vi.fn>;\n\n  function extractDeps() {\n    return {\n      getOsVersion: getOsVersionMock,\n      isOsVersionSupported: isOsVersionSupportedMock,\n      renameContact: renameContactMock,\n    };\n  }\n\n  beforeEach(() => {\n    vi.clearAllMocks();\n    apiMock = makeDeviceActionInternalApiMock();\n    getOsVersionMock = vi\n      .fn()\n      .mockResolvedValue(\n        CommandResultFactory({ data: { seVersion: FRESH_OS_VERSION } }),\n      );\n    isOsVersionSupportedMock = vi.fn().mockReturnValue(true);\n    renameContactMock = vi\n      .fn()\n      .mockResolvedValue(CommandResultFactory({ data: OK_PROOF }));\n    apiMock.getDeviceSessionState.mockReturnValue({\n      sessionStateType: DeviceSessionStateType.ReadyWithoutSecureChannel,\n      deviceStatus: DeviceStatus.CONNECTED,\n      installedApps: [],\n      currentApp: { name: \"BOLOS\", version: \"1.7.0\" },\n      deviceModelId: DeviceModelId.FLEX,\n      isSecureConnectionAllowed: true,\n    });\n  });\n\n  function makeAction(input: RenameContactDAInput) {\n    const action = new RenameContactDeviceAction({ input });\n    vi.spyOn(action, \"extractDependencies\").mockReturnValue(extractDeps());\n    return action;\n  }\n\n  it(\"navigates to the dashboard, reads the OS freshly, renames, and completes\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupGoToDashboardDAMock({\n        requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n      });\n      const action = makeAction(BASE_INPUT);\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        // GetOsVersion clears the stale UnlockDevice interaction: one\n        // `pending / none` step before the rename prompt.\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.RegisterWallet,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          output: EXPECTED_OUTPUT,\n          status: DeviceActionStatus.Completed,\n        },\n      ] as DeviceActionState<\n        RenameContactDAOutput,\n        RenameContactDAError,\n        RenameContactDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: () => {\n          // Rename is a dashboard op: it navigates to the dashboard and never\n          // opens an app.\n          expect(GoToDashboardDeviceAction).toHaveBeenCalled();\n          expect(OpenAppDeviceAction).not.toHaveBeenCalled();\n          // The OS version is read freshly and fed to the guard \u2014 not the\n          // session state.\n          expect(getOsVersionMock).toHaveBeenCalled();\n          expect(isOsVersionSupportedMock).toHaveBeenCalledWith(\n            FRESH_OS_VERSION,\n          );\n          resolve();\n        },\n        onError: reject,\n      });\n    }));\n\n  it(\"succeeds when an app was open at start, gating on the freshly-read OS\", () =>\n    new Promise<void>((resolve, reject) => {\n      // An app (Ethereum) is running when rename begins \u2014 the scenario that\n      // left firmwareVersion absent and made the bug look intermittent. Rename\n      // must still succeed by reading the OS version fresh after the dashboard.\n      apiMock.getDeviceSessionState.mockReturnValue({\n        sessionStateType: DeviceSessionStateType.ReadyWithoutSecureChannel,\n        deviceStatus: DeviceStatus.CONNECTED,\n        installedApps: [],\n        currentApp: { name: \"Ethereum\", version: \"1.23.0\" },\n        deviceModelId: DeviceModelId.FLEX,\n        isSecureConnectionAllowed: true,\n      });\n      setupGoToDashboardDAMock({\n        requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n      });\n      const action = makeAction(BASE_INPUT);\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.RegisterWallet,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          output: EXPECTED_OUTPUT,\n          status: DeviceActionStatus.Completed,\n        },\n      ] as DeviceActionState<\n        RenameContactDAOutput,\n        RenameContactDAError,\n        RenameContactDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: () => {\n          expect(getOsVersionMock).toHaveBeenCalled();\n          expect(isOsVersionSupportedMock).toHaveBeenCalledWith(\n            FRESH_OS_VERSION,\n          );\n          resolve();\n        },\n        onError: reject,\n      });\n    }));\n\n  it(\"rejects on an unsupported OS version without sending the APDU\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupGoToDashboardDAMock({\n        requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n      });\n      isOsVersionSupportedMock.mockReturnValue(false);\n      const action = makeAction(BASE_INPUT);\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: new ContactsVersionRequirementError(),\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        RenameContactDAOutput,\n        RenameContactDAError,\n        RenameContactDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: () => {\n          // The fresh OS version was read and gated on.\n          expect(getOsVersionMock).toHaveBeenCalled();\n          expect(isOsVersionSupportedMock).toHaveBeenCalledWith(\n            FRESH_OS_VERSION,\n          );\n          expect(renameContactMock).not.toHaveBeenCalled();\n          expect(OpenAppDeviceAction).not.toHaveBeenCalled();\n          resolve();\n        },\n        onError: reject,\n      });\n    }));\n\n  it(\"surfaces a go-to-dashboard failure as the device action error\", () =>\n    new Promise<void>((resolve, reject) => {\n      const dashboardError = new UnknownDAError(\"go to dashboard failed\");\n      setupGoToDashboardDAMock({\n        error: dashboardError,\n        requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n      });\n      const action = makeAction(BASE_INPUT);\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: dashboardError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        RenameContactDAOutput,\n        RenameContactDAError,\n        RenameContactDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: () => {\n          expect(getOsVersionMock).not.toHaveBeenCalled();\n          expect(isOsVersionSupportedMock).not.toHaveBeenCalled();\n          expect(renameContactMock).not.toHaveBeenCalled();\n          resolve();\n        },\n        onError: reject,\n      });\n    }));\n\n  it(\"surfaces a rename command error (e.g. seed mismatch)\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupGoToDashboardDAMock({\n        requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n      });\n      const commandError = new ContactsCommandError({\n        errorCode: \"6982\",\n        message: \"wrong seed\",\n      });\n      renameContactMock.mockResolvedValue(\n        CommandResultFactory({ error: commandError }),\n      );\n      const action = makeAction(BASE_INPUT);\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.RegisterWallet,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: commandError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        RenameContactDAOutput,\n        RenameContactDAError,\n        RenameContactDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n    }));\n\n  it(\"surfaces invalid input as a typed error after reaching the dashboard\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupGoToDashboardDAMock({\n        requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n      });\n      const invalidInput = { ...BASE_INPUT, newContactName: \"\" };\n      const validationError = validateRenameContactInput(invalidInput);\n      const action = makeAction(invalidInput);\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: validationError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        RenameContactDAOutput,\n        RenameContactDAError,\n        RenameContactDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: () => {\n          // Validation fails before the OS is read, the version guard, and any\n          // APDU.\n          expect(getOsVersionMock).not.toHaveBeenCalled();\n          expect(isOsVersionSupportedMock).not.toHaveBeenCalled();\n          expect(renameContactMock).not.toHaveBeenCalled();\n          resolve();\n        },\n        onError: reject,\n      });\n    }));\n\n  it(\"surfaces a GetOsVersion failure as the command error, not a version error\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupGoToDashboardDAMock({\n        requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n      });\n      const osVersionError = new ContactsCommandError({\n        errorCode: \"6f00\",\n        message: \"GetOsVersion failed\",\n      });\n      getOsVersionMock.mockResolvedValue(\n        CommandResultFactory({ error: osVersionError }),\n      );\n      const action = makeAction(BASE_INPUT);\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: osVersionError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        RenameContactDAOutput,\n        RenameContactDAError,\n        RenameContactDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: () => {\n          // The version guard is never consulted, and the rename APDU is never\n          // sent: the raw command error propagates instead of a\n          // ContactsVersionRequirementError.\n          expect(isOsVersionSupportedMock).not.toHaveBeenCalled();\n          expect(renameContactMock).not.toHaveBeenCalled();\n          resolve();\n        },\n        onError: reject,\n      });\n    }));\n\n  // DSDK-1481: the derivation-path flag is derived from the fresh OS version +\n  // the (real) requirements table. deviceModelId is FLEX (cutoff 1.7.0-rc3).\n  const SUCCESS_STATES = [\n    {\n      intermediateValue: {\n        requiredUserInteraction: UserInteractionRequired.None,\n      },\n      status: DeviceActionStatus.Pending,\n    },\n    {\n      intermediateValue: {\n        requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n      },\n      status: DeviceActionStatus.Pending,\n    },\n    {\n      intermediateValue: {\n        requiredUserInteraction: UserInteractionRequired.None,\n      },\n      status: DeviceActionStatus.Pending,\n    },\n    {\n      intermediateValue: {\n        requiredUserInteraction: UserInteractionRequired.RegisterWallet,\n      },\n      status: DeviceActionStatus.Pending,\n    },\n    { output: EXPECTED_OUTPUT, status: DeviceActionStatus.Completed },\n  ] as DeviceActionState<\n    RenameContactDAOutput,\n    RenameContactDAError,\n    RenameContactDAIntermediateValue\n  >[];\n\n  it(\"sends the derivation path when the fresh OS is below the model cutoff (rc2)\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupGoToDashboardDAMock({\n        requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n      });\n      getOsVersionMock.mockResolvedValue(\n        CommandResultFactory({ data: { seVersion: \"1.7.0-rc2\" } }),\n      );\n      const action = makeAction(BASE_INPUT);\n\n      testDeviceActionStates(action, SUCCESS_STATES, apiMock, {\n        onDone: () => {\n          expect(renameContactMock).toHaveBeenCalledWith(BASE_INPUT, true);\n          resolve();\n        },\n        onError: reject,\n      });\n    }));\n\n  it(\"omits the derivation path when the fresh OS is at/after the cutoff (rc3/GA)\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupGoToDashboardDAMock({\n        requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n      });\n      getOsVersionMock.mockResolvedValue(\n        CommandResultFactory({ data: { seVersion: \"1.7.0-rc3\" } }),\n      );\n      const action = makeAction(BASE_INPUT);\n\n      testDeviceActionStates(action, SUCCESS_STATES, apiMock, {\n        onDone: () => {\n          expect(renameContactMock).toHaveBeenCalledWith(BASE_INPUT, false);\n          resolve();\n        },\n        onError: reject,\n      });\n    }));\n});\n"],
+  "mappings": "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",
+  "names": ["CommandResultFactory", "DeviceActionStatus", "DeviceModelId", "DeviceSessionStateType", "DeviceStatus", "GoToDashboardDeviceAction", "OpenAppDeviceAction", "UnknownDAError", "UserInteractionRequired", "beforeEach", "describe", "expect", "it", "vi", "makeDeviceActionInternalApiMock", "setupGoToDashboardDAMock", "testDeviceActionStates", "ContactsCommandError", "ContactsVersionRequirementError", "RenameContactDeviceAction", "validateRenameContactInput", "importOriginal", "OK_PROOF", "FRESH_OS_VERSION", "BASE_INPUT", "EXPECTED_OUTPUT", "apiMock", "getOsVersionMock", "isOsVersionSupportedMock", "renameContactMock", "extractDeps", "makeAction", "input", "action", "resolve", "reject", "expected", "dashboardError", "commandError", "invalidInput", "validationError", "osVersionError", "SUCCESS_STATES"]
 }

package/lib/esm/internal/app-binder/model/contactsConstants.js CHANGED Viewed

@@ -1,2 +1,2 @@
-const o=176,_=16,t=1,x=3,A=4,E=224,e=46,C=0,T=64,n=32,r=32,c=32,s={bitcoin:0,ethereum:1,solana:2,polkadot:3,cosmos:4,cardano:5};export{s as BLOCKCHAIN_FAMILY_BY_NAME,o as CONTACTS_APDU_CLA,_ as CONTACTS_APDU_INS,T as GROUP_HANDLE_BYTES,c as HMAC_NAME_BYTES,n as HMAC_PROOF_BYTES,r as HMAC_REST_BYTES,E as RENAME_CONTACT_APDU_CLA,e as RENAME_CONTACT_APDU_INS,C as RENAME_CONTACT_P1,x as SUB_CMD_EDIT_IDENTIFIER,A as SUB_CMD_EDIT_SCOPE,t as SUB_CMD_REGISTER_IDENTITY};
+const o=176,_=16,t=1,x=32,C=3,A=4,E=224,T=46,e=0,n=64,r=32,c=32,s=32,N={bitcoin:0,ethereum:1,solana:2,polkadot:3,cosmos:4,cardano:5};export{N as BLOCKCHAIN_FAMILY_BY_NAME,o as CONTACTS_APDU_CLA,_ as CONTACTS_APDU_INS,n as GROUP_HANDLE_BYTES,s as HMAC_NAME_BYTES,r as HMAC_PROOF_BYTES,c as HMAC_REST_BYTES,E as RENAME_CONTACT_APDU_CLA,T as RENAME_CONTACT_APDU_INS,e as RENAME_CONTACT_P1,C as SUB_CMD_EDIT_IDENTIFIER,A as SUB_CMD_EDIT_SCOPE,x as SUB_CMD_PROVIDE_CONTACT,t as SUB_CMD_REGISTER_IDENTITY};
 //# sourceMappingURL=contactsConstants.js.map

package/lib/esm/internal/app-binder/model/contactsConstants.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/internal/app-binder/model/contactsConstants.ts"],
-  "sourcesContent": ["/**\n * Protocol constants shared by the Contacts (Address Book) operations.\n *\n * Wire format and values follow the BOLOS SDK Address Book specification\n * (ledger-secure-sdk/app_features/address_book). Op-specific sub-command bytes\n * and response field sizes live here; TLV tags and struct-type bytes live in\n * {@link ./../services/contactsTlvSerializer}.\n */\n\n/** APDU class/instruction shared by every Address Book sub-command. */\nexport const CONTACTS_APDU_CLA = 0xb0;\nexport const CONTACTS_APDU_INS = 0x10;\n\n/** P1 sub-command selector for REGISTER IDENTITY (register external address). */\nexport const SUB_CMD_REGISTER_IDENTITY = 0x01;\n\n/**\n * P1 sub-command selector for EDIT IDENTIFIER \u2014 an address-book app sub-command\n * (CLA 0xB0 / INS 0x10) served by the coin app, never OS-dispatched.\n */\nexport const SUB_CMD_EDIT_IDENTIFIER = 0x03;\n\n/**\n * P1 sub-command selector for EDIT SCOPE \u2014 an address-book app sub-command\n * (CLA 0xB0 / INS 0x10) served by the coin app, never OS-dispatched. Changes an\n * entry's scope while keeping its contact name and identifier.\n */\nexport const SUB_CMD_EDIT_SCOPE = 0x04;\n\n/**\n * EDIT CONTACT NAME (rename) is a blockchain-agnostic OS/dashboard command with\n * its own CLA/INS \u2014 NOT a sub-command of the address-book app APDU (0xB0/0x10).\n * The OS serves it directly, so it must run on the dashboard. P1 is a fixed\n * 0x00 (there is no sub-command selector for this command); P2 still carries the\n * chunk-continuation flag handled by {@link ./../services/sendFramedContactsPayload}.\n */\nexport const RENAME_CONTACT_APDU_CLA = 0xe0;\nexport const RENAME_CONTACT_APDU_INS = 0x2e;\nexport const RENAME_CONTACT_P1 = 0x00;\n\n/** Sizes (bytes) of the fields in the REGISTER IDENTITY final-chunk response. */\nexport const GROUP_HANDLE_BYTES = 64;\nexport const HMAC_PROOF_BYTES = 32;\nexport const HMAC_REST_BYTES = 32;\n\n/**\n * Size (bytes) of the rotated `hmac_name` returned on the EDIT CONTACT NAME\n * final-chunk response \u2014 the replacement group-level name proof.\n */\nexport const HMAC_NAME_BYTES = 32;\n\n/**\n * Blockchain-family byte encoded in the `BLOCKCHAIN_FAMILY` TLV, keyed by a\n * lowercase family name. v1 ships Ethereum only; the remaining families are\n * listed for completeness and will be enabled as their chains are supported.\n */\nexport const BLOCKCHAIN_FAMILY_BY_NAME: Readonly<Record<string, number>> = {\n  bitcoin: 0x00,\n  ethereum: 0x01,\n  solana: 0x02,\n  polkadot: 0x03,\n  cosmos: 0x04,\n  cardano: 0x05,\n};\n"],
-  "mappings": "AAUO,MAAMA,EAAoB,IACpBC,EAAoB,GAGpBC,EAA4B,EAM5BC,EAA0B,EAO1BC,EAAqB,EASrBC,EAA0B,IAC1BC,EAA0B,GAC1BC,EAAoB,EAGpBC,EAAqB,GACrBC,EAAmB,GACnBC,EAAkB,GAMlBC,EAAkB,GAOlBC,EAA8D,CACzE,QAAS,EACT,SAAU,EACV,OAAQ,EACR,SAAU,EACV,OAAQ,EACR,QAAS,CACX",
-  "names": ["CONTACTS_APDU_CLA", "CONTACTS_APDU_INS", "SUB_CMD_REGISTER_IDENTITY", "SUB_CMD_EDIT_IDENTIFIER", "SUB_CMD_EDIT_SCOPE", "RENAME_CONTACT_APDU_CLA", "RENAME_CONTACT_APDU_INS", "RENAME_CONTACT_P1", "GROUP_HANDLE_BYTES", "HMAC_PROOF_BYTES", "HMAC_REST_BYTES", "HMAC_NAME_BYTES", "BLOCKCHAIN_FAMILY_BY_NAME"]
+  "sourcesContent": ["/**\n * Protocol constants shared by the Contacts (Address Book) operations.\n *\n * Wire format and values follow the BOLOS SDK Address Book specification\n * (ledger-secure-sdk/app_features/address_book). Op-specific sub-command bytes\n * and response field sizes live here; TLV tags and struct-type bytes live in\n * {@link ./../services/contactsTlvSerializer}.\n */\n\n/** APDU class/instruction shared by every Address Book sub-command. */\nexport const CONTACTS_APDU_CLA = 0xb0;\nexport const CONTACTS_APDU_INS = 0x10;\n\n/** P1 sub-command selector for REGISTER IDENTITY (register external address). */\nexport const SUB_CMD_REGISTER_IDENTITY = 0x01;\n\n/** P1 sub-command selector for PROVIDE CONTACT (pre-signing decoration). */\nexport const SUB_CMD_PROVIDE_CONTACT = 0x20;\n\n/**\n * P1 sub-command selector for EDIT IDENTIFIER \u2014 an address-book app sub-command\n * (CLA 0xB0 / INS 0x10) served by the coin app, never OS-dispatched.\n */\nexport const SUB_CMD_EDIT_IDENTIFIER = 0x03;\n\n/**\n * P1 sub-command selector for EDIT SCOPE \u2014 an address-book app sub-command\n * (CLA 0xB0 / INS 0x10) served by the coin app, never OS-dispatched. Changes an\n * entry's scope while keeping its contact name and identifier.\n */\nexport const SUB_CMD_EDIT_SCOPE = 0x04;\n\n/**\n * EDIT CONTACT NAME (rename) is a blockchain-agnostic OS/dashboard command with\n * its own CLA/INS \u2014 NOT a sub-command of the address-book app APDU (0xB0/0x10).\n * The OS serves it directly, so it must run on the dashboard. P1 is a fixed\n * 0x00 (there is no sub-command selector for this command); P2 still carries the\n * chunk-continuation flag handled by {@link ./../services/sendFramedContactsPayload}.\n */\nexport const RENAME_CONTACT_APDU_CLA = 0xe0;\nexport const RENAME_CONTACT_APDU_INS = 0x2e;\nexport const RENAME_CONTACT_P1 = 0x00;\n\n/** Sizes (bytes) of the fields in the REGISTER IDENTITY final-chunk response. */\nexport const GROUP_HANDLE_BYTES = 64;\nexport const HMAC_PROOF_BYTES = 32;\nexport const HMAC_REST_BYTES = 32;\n\n/**\n * Size (bytes) of the rotated `hmac_name` returned on the EDIT CONTACT NAME\n * final-chunk response \u2014 the replacement group-level name proof.\n */\nexport const HMAC_NAME_BYTES = 32;\n\n/**\n * Blockchain-family byte encoded in the `BLOCKCHAIN_FAMILY` TLV, keyed by a\n * lowercase family name. v1 ships Ethereum only; the remaining families are\n * listed for completeness and will be enabled as their chains are supported.\n */\nexport const BLOCKCHAIN_FAMILY_BY_NAME: Readonly<Record<string, number>> = {\n  bitcoin: 0x00,\n  ethereum: 0x01,\n  solana: 0x02,\n  polkadot: 0x03,\n  cosmos: 0x04,\n  cardano: 0x05,\n};\n"],
+  "mappings": "AAUO,MAAMA,EAAoB,IACpBC,EAAoB,GAGpBC,EAA4B,EAG5BC,EAA0B,GAM1BC,EAA0B,EAO1BC,EAAqB,EASrBC,EAA0B,IAC1BC,EAA0B,GAC1BC,EAAoB,EAGpBC,EAAqB,GACrBC,EAAmB,GACnBC,EAAkB,GAMlBC,EAAkB,GAOlBC,EAA8D,CACzE,QAAS,EACT,SAAU,EACV,OAAQ,EACR,SAAU,EACV,OAAQ,EACR,QAAS,CACX",
+  "names": ["CONTACTS_APDU_CLA", "CONTACTS_APDU_INS", "SUB_CMD_REGISTER_IDENTITY", "SUB_CMD_PROVIDE_CONTACT", "SUB_CMD_EDIT_IDENTIFIER", "SUB_CMD_EDIT_SCOPE", "RENAME_CONTACT_APDU_CLA", "RENAME_CONTACT_APDU_INS", "RENAME_CONTACT_P1", "GROUP_HANDLE_BYTES", "HMAC_PROOF_BYTES", "HMAC_REST_BYTES", "HMAC_NAME_BYTES", "BLOCKCHAIN_FAMILY_BY_NAME"]
 }

package/lib/esm/internal/app-binder/model/contactsErrors.js CHANGED Viewed

@@ -1,2 +1,2 @@
-import{DeviceExchangeError as o}from"@ledgerhq/device-management-kit";const t="6982",n={[t]:{message:"This address-book entry was registered with a different seed. Connect the Ledger device that registered it to modify this contact."},6800:{message:"Internal error (Please report)"},6983:{message:"Wrong data length"},6984:{message:"Unsupported address-book operation for this device or app configuration"},6985:{message:"Condition not satisfied"},"6a80":{message:"Invalid contact data, or operation refused on device"},"6a84":{message:"Insufficient memory: the device address book is full"},"6a88":{message:"Contact data not found"},"6af0":{message:"Invalid value for this contact entry"},"6b00":{message:"The app rejected the contact data"},"6f00":{message:"Technical problem (Internal error, please report)"}};class s extends o{constructor(r){super({tag:"ContactsCommandError",...r})}}const d=e=>new s(e);class c{constructor(r="The connected device or app does not meet the Contacts version requirements."){this.message=r}_tag="ContactsVersionRequirementError";originalError}export{n as CONTACTS_APP_ERRORS,t as CONTACT_SEED_MISMATCH_ERROR_CODE,s as ContactsCommandError,c as ContactsVersionRequirementError,d as contactsCommandErrorFactory};
+import{ApduParser as s,DeviceExchangeError as a,DmkResultFactory as n,InvalidStatusWordError as d,isSuccessCommandResult as c}from"@ledgerhq/device-management-kit";import{CommandErrorHelper as m}from"@ledgerhq/signer-utils";const i="6982",p={[i]:{message:"This address-book entry was registered with a different seed. Connect the Ledger device that registered it to modify this contact."},6800:{message:"Internal error (Please report)"},6983:{message:"Wrong data length"},6984:{message:"Unsupported address-book operation for this device or app configuration"},6985:{message:"Condition not satisfied"},"686a":{message:"This device's firmware is out of date for the address book. Update your Ledger device to the latest firmware, then try again."},"6a80":{message:"Invalid contact data, or operation refused on device"},"6a84":{message:"Insufficient memory: the device address book is full"},"6a88":{message:"Contact data not found"},"6af0":{message:"Invalid value for this contact entry"},"6b00":{message:"The app rejected the contact data"},"6f00":{message:"Technical problem (Internal error, please report)"}};class C extends a{constructor(e){super({tag:"ContactsCommandError",...e})}}const u=r=>new C(r);class l extends m{constructor(){super(p,u)}getError(e){const o=super.getError(e);if(o===void 0||c(o)||o.error._tag!=="UnknownDeviceExchangeError")return o;const t=new s(e).encodeToHexaString(e.statusCode);return n({error:new d(`The device returned an unexpected status word (0x${t}) for this address-book operation. Update your Ledger device and Ethereum app to the latest version, then try again.`)})}}class f{constructor(e="The connected device or app does not meet the Contacts version requirements."){this.message=e}_tag="ContactsVersionRequirementError";originalError}export{p as CONTACTS_APP_ERRORS,i as CONTACT_SEED_MISMATCH_ERROR_CODE,C as ContactsCommandError,l as ContactsCommandErrorHelper,f as ContactsVersionRequirementError,u as contactsCommandErrorFactory};
 //# sourceMappingURL=contactsErrors.js.map

package/lib/esm/internal/app-binder/model/contactsErrors.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/internal/app-binder/model/contactsErrors.ts"],
-  "sourcesContent": ["import {\n  type CommandErrorArgs,\n  type CommandErrors,\n  DeviceExchangeError,\n  type DmkError,\n} from \"@ledgerhq/device-management-kit\";\n\n/**\n * Status word returned by the app's Address Book *edit* operations when the\n * seed-bound HMAC / group-handle verification fails \u2014 i.e. the entry was\n * registered with a different seed than the one currently on the device.\n *\n * The device runs this check *before* showing any UI and returns 0x6982 *only*\n * for seed-binding failures (user rejection and TLV errors return 0x6a80,\n * address validation returns 0x6af0), so 0x6982 is an unambiguous \"wrong seed\"\n * signal that consumers (e.g. Ledger Wallet) can catch to guide the user.\n */\nexport const CONTACT_SEED_MISMATCH_ERROR_CODE = \"6982\" as const;\n\nexport type ContactsErrorCodes =\n  | \"6982\"\n  | \"6800\"\n  | \"6983\"\n  | \"6984\"\n  | \"6985\"\n  | \"6a80\"\n  | \"6a84\"\n  | \"6a88\"\n  | \"6af0\"\n  | \"6b00\"\n  | \"6f00\";\n\nexport const CONTACTS_APP_ERRORS: CommandErrors<ContactsErrorCodes> = {\n  [CONTACT_SEED_MISMATCH_ERROR_CODE]: {\n    message:\n      \"This address-book entry was registered with a different seed. Connect the Ledger device that registered it to modify this contact.\",\n  },\n  \"6800\": { message: \"Internal error (Please report)\" },\n  \"6983\": { message: \"Wrong data length\" },\n  \"6984\": {\n    message:\n      \"Unsupported address-book operation for this device or app configuration\",\n  },\n  \"6985\": { message: \"Condition not satisfied\" },\n  \"6a80\": { message: \"Invalid contact data, or operation refused on device\" },\n  \"6a84\": { message: \"Insufficient memory: the device address book is full\" },\n  \"6a88\": { message: \"Contact data not found\" },\n  \"6af0\": { message: \"Invalid value for this contact entry\" },\n  \"6b00\": { message: \"The app rejected the contact data\" },\n  \"6f00\": { message: \"Technical problem (Internal error, please report)\" },\n};\n\nexport class ContactsCommandError extends DeviceExchangeError<ContactsErrorCodes> {\n  constructor(args: CommandErrorArgs<ContactsErrorCodes>) {\n    super({ tag: \"ContactsCommandError\", ...args });\n  }\n}\n\nexport const contactsCommandErrorFactory = (\n  args: CommandErrorArgs<ContactsErrorCodes>,\n) => new ContactsCommandError(args);\n\n/**\n * Raised by a Contacts `DeviceAction` when the connected device model, app\n * version, or OS version does not meet the Contacts requirements \u2014 i.e. the\n * DSDK-1376 support check fails before any APDU is sent.\n */\nexport class ContactsVersionRequirementError implements DmkError {\n  readonly _tag = \"ContactsVersionRequirementError\";\n  readonly originalError?: unknown;\n  constructor(\n    readonly message = \"The connected device or app does not meet the Contacts version requirements.\",\n  ) {}\n}\n"],
-  "mappings": "AAAA,OAGE,uBAAAA,MAEK,kCAYA,MAAMC,EAAmC,OAenCC,EAAyD,CACpE,CAACD,CAAgC,EAAG,CAClC,QACE,oIACJ,EACA,KAAQ,CAAE,QAAS,gCAAiC,EACpD,KAAQ,CAAE,QAAS,mBAAoB,EACvC,KAAQ,CACN,QACE,yEACJ,EACA,KAAQ,CAAE,QAAS,yBAA0B,EAC7C,OAAQ,CAAE,QAAS,sDAAuD,EAC1E,OAAQ,CAAE,QAAS,sDAAuD,EAC1E,OAAQ,CAAE,QAAS,wBAAyB,EAC5C,OAAQ,CAAE,QAAS,sCAAuC,EAC1D,OAAQ,CAAE,QAAS,mCAAoC,EACvD,OAAQ,CAAE,QAAS,mDAAoD,CACzE,EAEO,MAAME,UAA6BH,CAAwC,CAChF,YAAYI,EAA4C,CACtD,MAAM,CAAE,IAAK,uBAAwB,GAAGA,CAAK,CAAC,CAChD,CACF,CAEO,MAAMC,EACXD,GACG,IAAID,EAAqBC,CAAI,EAO3B,MAAME,CAAoD,CAG/D,YACWC,EAAU,+EACnB,CADS,aAAAA,CACR,CAJM,KAAO,kCACP,aAIX",
-  "names": ["DeviceExchangeError", "CONTACT_SEED_MISMATCH_ERROR_CODE", "CONTACTS_APP_ERRORS", "ContactsCommandError", "args", "contactsCommandErrorFactory", "ContactsVersionRequirementError", "message"]
+  "sourcesContent": ["import {\n  ApduParser,\n  type ApduResponse,\n  type CommandErrorArgs,\n  type CommandErrorResult,\n  type CommandErrors,\n  type CommandResult,\n  DeviceExchangeError,\n  type DmkError,\n  DmkResultFactory,\n  InvalidStatusWordError,\n  isSuccessCommandResult,\n} from \"@ledgerhq/device-management-kit\";\nimport { CommandErrorHelper } from \"@ledgerhq/signer-utils\";\n\n/**\n * Status word returned by the app's Address Book *edit* operations when the\n * seed-bound HMAC / group-handle verification fails \u2014 i.e. the entry was\n * registered with a different seed than the one currently on the device.\n *\n * The device runs this check *before* showing any UI and returns 0x6982 *only*\n * for seed-binding failures (user rejection and TLV errors return 0x6a80,\n * address validation returns 0x6af0), so 0x6982 is an unambiguous \"wrong seed\"\n * signal that consumers (e.g. Ledger Wallet) can catch to guide the user.\n */\nexport const CONTACT_SEED_MISMATCH_ERROR_CODE = \"6982\" as const;\n\nexport type ContactsErrorCodes =\n  | \"6982\"\n  | \"6800\"\n  | \"6983\"\n  | \"6984\"\n  | \"6985\"\n  | \"686a\"\n  | \"6a80\"\n  | \"6a84\"\n  | \"6a88\"\n  | \"6af0\"\n  | \"6b00\"\n  | \"6f00\";\n\nexport const CONTACTS_APP_ERRORS: CommandErrors<ContactsErrorCodes> = {\n  [CONTACT_SEED_MISMATCH_ERROR_CODE]: {\n    message:\n      \"This address-book entry was registered with a different seed. Connect the Ledger device that registered it to modify this contact.\",\n  },\n  \"6800\": { message: \"Internal error (Please report)\" },\n  \"6983\": { message: \"Wrong data length\" },\n  \"6984\": {\n    message:\n      \"Unsupported address-book operation for this device or app configuration\",\n  },\n  \"6985\": { message: \"Condition not satisfied\" },\n  // Dashboard EDIT CONTACT NAME on an OS build that still mandates the\n  // DERIVATION_PATH (tag 0x69) but received a payload without it. DSDK-1481\n  // sends the path conditionally by OS version so this should not occur in\n  // practice; mapped here so that, if it ever does, the host gets an actionable\n  // message instead of a bare UnknownDeviceExchangeError.\n  \"686a\": {\n    message:\n      \"This device's firmware is out of date for the address book. Update your Ledger device to the latest firmware, then try again.\",\n  },\n  \"6a80\": { message: \"Invalid contact data, or operation refused on device\" },\n  \"6a84\": { message: \"Insufficient memory: the device address book is full\" },\n  \"6a88\": { message: \"Contact data not found\" },\n  \"6af0\": { message: \"Invalid value for this contact entry\" },\n  \"6b00\": { message: \"The app rejected the contact data\" },\n  \"6f00\": { message: \"Technical problem (Internal error, please report)\" },\n};\n\nexport class ContactsCommandError extends DeviceExchangeError<ContactsErrorCodes> {\n  constructor(args: CommandErrorArgs<ContactsErrorCodes>) {\n    super({ tag: \"ContactsCommandError\", ...args });\n  }\n}\n\nexport const contactsCommandErrorFactory = (\n  args: CommandErrorArgs<ContactsErrorCodes>,\n) => new ContactsCommandError(args);\n\n/**\n * A {@link CommandErrorHelper} preconfigured with the Contacts error map, that\n * additionally guarantees no address-book command ever surfaces a bare\n * `UnknownDeviceExchangeError`.\n *\n * The base helper maps known status words to a {@link ContactsCommandError} and\n * falls back to the global handler for the rest \u2014 which, for a status word in\n * neither the Contacts nor the global dictionary (e.g. 0x686A before it was\n * mapped), yields an `UnknownDeviceExchangeError` whose message is a generic\n * \"Unexpected device exchange error happened.\" with no status word and no\n * guidance. This subclass replaces that specific case with an\n * `InvalidStatusWordError` naming the actual status word and pointing at a\n * firmware/app update, so the host always has something actionable to show.\n */\nexport class ContactsCommandErrorHelper<Response> extends CommandErrorHelper<\n  Response,\n  ContactsErrorCodes\n> {\n  constructor() {\n    super(CONTACTS_APP_ERRORS, contactsCommandErrorFactory);\n  }\n\n  override getError(\n    apduResponse: ApduResponse,\n  ): CommandResult<Response, ContactsErrorCodes> | undefined {\n    const result = super.getError(apduResponse);\n    if (\n      result === undefined ||\n      isSuccessCommandResult(result) ||\n      result.error._tag !== \"UnknownDeviceExchangeError\"\n    ) {\n      return result;\n    }\n    const statusWord = new ApduParser(apduResponse).encodeToHexaString(\n      apduResponse.statusCode,\n    );\n    return DmkResultFactory<\n      Response,\n      CommandErrorResult<ContactsErrorCodes>[\"error\"]\n    >({\n      error: new InvalidStatusWordError(\n        `The device returned an unexpected status word (0x${statusWord}) for this address-book operation. Update your Ledger device and Ethereum app to the latest version, then try again.`,\n      ),\n    });\n  }\n}\n\n/**\n * Raised by a Contacts `DeviceAction` when the connected device model, app\n * version, or OS version does not meet the Contacts requirements \u2014 i.e. the\n * DSDK-1376 support check fails before any APDU is sent.\n */\nexport class ContactsVersionRequirementError implements DmkError {\n  readonly _tag = \"ContactsVersionRequirementError\";\n  readonly originalError?: unknown;\n  constructor(\n    readonly message = \"The connected device or app does not meet the Contacts version requirements.\",\n  ) {}\n}\n"],
+  "mappings": "AAAA,OACE,cAAAA,EAMA,uBAAAC,EAEA,oBAAAC,EACA,0BAAAC,EACA,0BAAAC,MACK,kCACP,OAAS,sBAAAC,MAA0B,yBAY5B,MAAMC,EAAmC,OAgBnCC,EAAyD,CACpE,CAACD,CAAgC,EAAG,CAClC,QACE,oIACJ,EACA,KAAQ,CAAE,QAAS,gCAAiC,EACpD,KAAQ,CAAE,QAAS,mBAAoB,EACvC,KAAQ,CACN,QACE,yEACJ,EACA,KAAQ,CAAE,QAAS,yBAA0B,EAM7C,OAAQ,CACN,QACE,+HACJ,EACA,OAAQ,CAAE,QAAS,sDAAuD,EAC1E,OAAQ,CAAE,QAAS,sDAAuD,EAC1E,OAAQ,CAAE,QAAS,wBAAyB,EAC5C,OAAQ,CAAE,QAAS,sCAAuC,EAC1D,OAAQ,CAAE,QAAS,mCAAoC,EACvD,OAAQ,CAAE,QAAS,mDAAoD,CACzE,EAEO,MAAME,UAA6BP,CAAwC,CAChF,YAAYQ,EAA4C,CACtD,MAAM,CAAE,IAAK,uBAAwB,GAAGA,CAAK,CAAC,CAChD,CACF,CAEO,MAAMC,EACXD,GACG,IAAID,EAAqBC,CAAI,EAgB3B,MAAME,UAA6CN,CAGxD,CACA,aAAc,CACZ,MAAME,EAAqBG,CAA2B,CACxD,CAES,SACPE,EACyD,CACzD,MAAMC,EAAS,MAAM,SAASD,CAAY,EAC1C,GACEC,IAAW,QACXT,EAAuBS,CAAM,GAC7BA,EAAO,MAAM,OAAS,6BAEtB,OAAOA,EAET,MAAMC,EAAa,IAAId,EAAWY,CAAY,EAAE,mBAC9CA,EAAa,UACf,EACA,OAAOV,EAGL,CACA,MAAO,IAAIC,EACT,oDAAoDW,CAAU,sHAChE,CACF,CAAC,CACH,CACF,CAOO,MAAMC,CAAoD,CAG/D,YACWC,EAAU,+EACnB,CADS,aAAAA,CACR,CAJM,KAAO,kCACP,aAIX",
+  "names": ["ApduParser", "DeviceExchangeError", "DmkResultFactory", "InvalidStatusWordError", "isSuccessCommandResult", "CommandErrorHelper", "CONTACT_SEED_MISMATCH_ERROR_CODE", "CONTACTS_APP_ERRORS", "ContactsCommandError", "args", "contactsCommandErrorFactory", "ContactsCommandErrorHelper", "apduResponse", "result", "statusWord", "ContactsVersionRequirementError", "message"]
 }

package/lib/esm/internal/app-binder/services/provideContact.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import{ByteArrayBuilder as c}from"@ledgerhq/device-management-kit";import{ProvideContactCommand as m}from"../../app-binder/command/ProvideContactCommand";import{BLOCKCHAIN_FAMILY_BY_NAME as l,SUB_CMD_PROVIDE_CONTACT as T}from"../../app-binder/model/contactsConstants";import{CONTACTS_TLV_TAG as r,encodeTlvAscii as d,encodeTlvBuffer as t,encodeTlvChainId as s,encodeTlvUInt8 as n,STRUCT_TYPE_PROVIDE_CONTACT as A,STRUCT_VERSION_VALUE as P}from"../../app-binder/services/contactsTlvSerializer";import{sendFramedContactsPayload as y}from"../../app-binder/services/sendFramedContactsPayload";function v(e){const a=l[e.blockchainFamily.toLowerCase()];if(a===void 0)throw new Error(`Unsupported blockchain family: ${e.blockchainFamily}`);const o=new c;return n(o,r.STRUCT_TYPE,A),n(o,r.STRUCT_VERSION,P),d(o,r.CONTACT_NAME,e.contactName),d(o,r.SCOPE,e.scope),t(o,r.ACCOUNT_IDENTIFIER,e.identifier),t(o,r.GROUP_HANDLE,e.groupHandle),e.chainId!==void 0&&s(o,r.CHAIN_ID,e.chainId),n(o,r.BLOCKCHAIN_FAMILY,a),t(o,r.HMAC_PROOF,e.hmacProof),t(o,r.HMAC_REST,e.hmacRest),o.build()}function R(e,{payload:a,logger:o}){return y(e,{payload:a,p1:T,makeCommand:(C,i)=>new m({data:C,p2:i}),logger:o,commandTag:"provideContact"})}export{v as buildProvideContactPayload,R as sendProvideContactPayload};
2	+ //# sourceMappingURL=provideContact.js.map

package/lib/esm/internal/app-binder/services/provideContact.js.map ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/internal/app-binder/services/provideContact.ts"],
+  "sourcesContent": ["// TLV assembly and transport for op 0x20 (Provide Contact), dispatched via the\n// chunked-framing scheme shared with the other address-book ops.\n//\n// Reference: Address Book Final Specifications \u2014 Provide Contact. Tag order:\n//   STRUCT_TYPE, STRUCT_VERSION, CONTACT_NAME, SCOPE, ACCOUNT_IDENTIFIER,\n//   GROUP_HANDLE, CHAIN_ID (Ethereum only), BLOCKCHAIN_FAMILY, HMAC_PROOF,\n//   HMAC_REST. No DERIVATION_PATH \u2014 that tag is Ledger-Account only.\n//\n// Device replies SW=0x9000 with empty data on success \u2014 no fields to extract.\nimport {\n  ByteArrayBuilder,\n  type CommandResult,\n  type InternalApi,\n  type LoggerPublisherService,\n} from \"@ledgerhq/device-management-kit\";\n\nimport { type ProvideContactInput } from \"@api/model/ProvideContact\";\nimport { ProvideContactCommand } from \"@internal/app-binder/command/ProvideContactCommand\";\nimport {\n  BLOCKCHAIN_FAMILY_BY_NAME,\n  SUB_CMD_PROVIDE_CONTACT,\n} from \"@internal/app-binder/model/contactsConstants\";\nimport { type ContactsErrorCodes } from \"@internal/app-binder/model/contactsErrors\";\nimport {\n  CONTACTS_TLV_TAG,\n  encodeTlvAscii,\n  encodeTlvBuffer,\n  encodeTlvChainId,\n  encodeTlvUInt8,\n  STRUCT_TYPE_PROVIDE_CONTACT,\n  STRUCT_VERSION_VALUE,\n} from \"@internal/app-binder/services/contactsTlvSerializer\";\nimport { sendFramedContactsPayload } from \"@internal/app-binder/services/sendFramedContactsPayload\";\n\n/**\n * Encode a matched contact as the PROVIDE CONTACT TLV payload, without the\n * chunk framing. Pure, so callers can build it while matching a recipient\n * against the address book, with no device involved.\n */\nexport function buildProvideContactPayload(\n  input: ProvideContactInput,\n): Uint8Array {\n  const family =\n    BLOCKCHAIN_FAMILY_BY_NAME[input.blockchainFamily.toLowerCase()];\n  if (family === undefined) {\n    throw new Error(`Unsupported blockchain family: ${input.blockchainFamily}`);\n  }\n\n  const builder = new ByteArrayBuilder();\n  encodeTlvUInt8(\n    builder,\n    CONTACTS_TLV_TAG.STRUCT_TYPE,\n    STRUCT_TYPE_PROVIDE_CONTACT,\n  );\n  encodeTlvUInt8(\n    builder,\n    CONTACTS_TLV_TAG.STRUCT_VERSION,\n    STRUCT_VERSION_VALUE,\n  );\n  encodeTlvAscii(builder, CONTACTS_TLV_TAG.CONTACT_NAME, input.contactName);\n  encodeTlvAscii(builder, CONTACTS_TLV_TAG.SCOPE, input.scope);\n  encodeTlvBuffer(\n    builder,\n    CONTACTS_TLV_TAG.ACCOUNT_IDENTIFIER,\n    input.identifier,\n  );\n  encodeTlvBuffer(builder, CONTACTS_TLV_TAG.GROUP_HANDLE, input.groupHandle);\n  if (input.chainId !== undefined) {\n    encodeTlvChainId(builder, CONTACTS_TLV_TAG.CHAIN_ID, input.chainId);\n  }\n  encodeTlvUInt8(builder, CONTACTS_TLV_TAG.BLOCKCHAIN_FAMILY, family);\n  encodeTlvBuffer(builder, CONTACTS_TLV_TAG.HMAC_PROOF, input.hmacProof);\n  encodeTlvBuffer(builder, CONTACTS_TLV_TAG.HMAC_REST, input.hmacRest);\n\n  return builder.build();\n}\n\nexport type SendProvideContactPayloadArgs = {\n  readonly payload: Uint8Array;\n  readonly logger?: LoggerPublisherService;\n};\n\nexport function sendProvideContactPayload(\n  api: InternalApi,\n  { payload, logger }: SendProvideContactPayloadArgs,\n): Promise<CommandResult<void, ContactsErrorCodes>> {\n  return sendFramedContactsPayload(api, {\n    payload,\n    p1: SUB_CMD_PROVIDE_CONTACT,\n    makeCommand: (chunk, p2) => new ProvideContactCommand({ data: chunk, p2 }),\n    logger,\n    commandTag: \"provideContact\",\n  }) as Promise<CommandResult<void, ContactsErrorCodes>>;\n}\n"],
+  "mappings": "AASA,OACE,oBAAAA,MAIK,kCAGP,OAAS,yBAAAC,MAA6B,qDACtC,OACE,6BAAAC,EACA,2BAAAC,MACK,+CAEP,OACE,oBAAAC,EACA,kBAAAC,EACA,mBAAAC,EACA,oBAAAC,EACA,kBAAAC,EACA,+BAAAC,EACA,wBAAAC,MACK,sDACP,OAAS,6BAAAC,MAAiC,0DAOnC,SAASC,EACdC,EACY,CACZ,MAAMC,EACJZ,EAA0BW,EAAM,iBAAiB,YAAY,CAAC,EAChE,GAAIC,IAAW,OACb,MAAM,IAAI,MAAM,kCAAkCD,EAAM,gBAAgB,EAAE,EAG5E,MAAME,EAAU,IAAIf,EACpB,OAAAQ,EACEO,EACAX,EAAiB,YACjBK,CACF,EACAD,EACEO,EACAX,EAAiB,eACjBM,CACF,EACAL,EAAeU,EAASX,EAAiB,aAAcS,EAAM,WAAW,EACxER,EAAeU,EAASX,EAAiB,MAAOS,EAAM,KAAK,EAC3DP,EACES,EACAX,EAAiB,mBACjBS,EAAM,UACR,EACAP,EAAgBS,EAASX,EAAiB,aAAcS,EAAM,WAAW,EACrEA,EAAM,UAAY,QACpBN,EAAiBQ,EAASX,EAAiB,SAAUS,EAAM,OAAO,EAEpEL,EAAeO,EAASX,EAAiB,kBAAmBU,CAAM,EAClER,EAAgBS,EAASX,EAAiB,WAAYS,EAAM,SAAS,EACrEP,EAAgBS,EAASX,EAAiB,UAAWS,EAAM,QAAQ,EAE5DE,EAAQ,MAAM,CACvB,CAOO,SAASC,EACdC,EACA,CAAE,QAAAC,EAAS,OAAAC,CAAO,EACgC,CAClD,OAAOR,EAA0BM,EAAK,CACpC,QAAAC,EACA,GAAIf,EACJ,YAAa,CAACiB,EAAOC,IAAO,IAAIpB,EAAsB,CAAE,KAAMmB,EAAO,GAAAC,CAAG,CAAC,EACzE,OAAAF,EACA,WAAY,gBACd,CAAC,CACH",
+  "names": ["ByteArrayBuilder", "ProvideContactCommand", "BLOCKCHAIN_FAMILY_BY_NAME", "SUB_CMD_PROVIDE_CONTACT", "CONTACTS_TLV_TAG", "encodeTlvAscii", "encodeTlvBuffer", "encodeTlvChainId", "encodeTlvUInt8", "STRUCT_TYPE_PROVIDE_CONTACT", "STRUCT_VERSION_VALUE", "sendFramedContactsPayload", "buildProvideContactPayload", "input", "family", "builder", "sendProvideContactPayload", "api", "payload", "logger", "chunk", "p2"]
+}

package/lib/esm/internal/app-binder/services/provideContact.test.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import{bufferToHexaString as c,CommandResultFactory as i,CommandResultStatus as s}from"@ledgerhq/device-management-kit";import{ProvideContactCommand as p}from"../../app-binder/command/ProvideContactCommand";import{makeDeviceActionInternalApiMock as r}from"../../app-binder/device-action/__test-utils__/makeInternalApi";import{ContactsCommandError as f}from"../../app-binder/model/contactsErrors";import{buildProvideContactPayload as t,sendProvideContactPayload as d}from"./provideContact";const h=new Uint8Array(20).fill(17),C=new Uint8Array(64).fill(34),u=new Uint8Array(32).fill(51),y=new Uint8Array(32).fill(68),o={contactName:"Alice",scope:"Ethereum",identifier:h,groupHandle:C,hmacProof:u,hmacRest:y,blockchainFamily:"ethereum",chainId:1n},T="010133",x="020101",E="81f005416c696365",P="81f108457468657265756d",_="81f214"+"11".repeat(20),l="81f640"+"22".repeat(64),I="230101",g="510101",A="2920"+"33".repeat(32),b="81f720"+"44".repeat(32);describe("buildProvideContactPayload",()=>{it("encodes every tag in the order the spec lists",()=>{const e=t(o);expect(c(e,!1)).toBe(T+x+E+P+_+l+I+g+A+b)}),it("fits an Ethereum contact in a single 255-byte chunk",()=>{expect(t(o).length).toBeLessThanOrEqual(253)}),it("omits CHAIN_ID for a family that does not carry one",()=>{const e=t({...o,blockchainFamily:"bitcoin",chainId:void 0});expect(c(e,!1)).toContain(l+"510100")}),it("encodes a multi-byte chain id big-endian with no leading zeroes",()=>{const e=t({...o,chainId:8453n});expect(c(e,!1)).toContain("23022105")}),it("accepts the family name case-insensitively",()=>{expect(t({...o,blockchainFamily:"Ethereum"})).toStrictEqual(t(o))}),it("throws on an unknown blockchain family",()=>{expect(()=>t({...o,blockchainFamily:"dogecoin"})).toThrow("Unsupported blockchain family: dogecoin")})});describe("sendProvideContactPayload",()=>{it("sends one chunk under P2=0x00, prefixed with the 2-byte BE total length",async()=>{const e=r();e.sendCommand.mockResolvedValue(i({data:void 0}));const n=t(o),m=await d(e,{payload:n});expect(e.sendCommand).toHaveBeenCalledTimes(1);const a=e.sendCommand.mock.calls[0][0];expect(a).toBeInstanceOf(p),expect(a.args.p2).toBe(0),expect(a.args.data.slice(0,2)).toStrictEqual(Uint8Array.from([n.length>>8&255,n.length&255])),expect(a.args.data.slice(2)).toStrictEqual(n),expect(m.status).toBe(s.Success)}),it("propagates a device rejection instead of throwing",async()=>{const e=r();e.sendCommand.mockResolvedValue(i({error:new f({errorCode:"6982",message:"wrong seed"})}));const n=await d(e,{payload:t(o)});expect(n.status).toBe(s.Error)})});
2	+ //# sourceMappingURL=provideContact.test.js.map

package/lib/esm/internal/app-binder/services/provideContact.test.js.map ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/internal/app-binder/services/provideContact.test.ts"],
+  "sourcesContent": ["import {\n  bufferToHexaString,\n  CommandResultFactory,\n  CommandResultStatus,\n} from \"@ledgerhq/device-management-kit\";\n\nimport { type ProvideContactInput } from \"@api/model/ProvideContact\";\nimport { ProvideContactCommand } from \"@internal/app-binder/command/ProvideContactCommand\";\nimport { makeDeviceActionInternalApiMock } from \"@internal/app-binder/device-action/__test-utils__/makeInternalApi\";\nimport { ContactsCommandError } from \"@internal/app-binder/model/contactsErrors\";\n\nimport {\n  buildProvideContactPayload,\n  sendProvideContactPayload,\n} from \"./provideContact\";\n\nconst IDENTIFIER = new Uint8Array(20).fill(0x11);\nconst GROUP_HANDLE = new Uint8Array(64).fill(0x22);\nconst HMAC_PROOF = new Uint8Array(32).fill(0x33);\nconst HMAC_REST = new Uint8Array(32).fill(0x44);\n\nconst INPUT: ProvideContactInput = {\n  contactName: \"Alice\",\n  scope: \"Ethereum\",\n  identifier: IDENTIFIER,\n  groupHandle: GROUP_HANDLE,\n  hmacProof: HMAC_PROOF,\n  hmacRest: HMAC_REST,\n  blockchainFamily: \"ethereum\",\n  chainId: 1n,\n};\n\n// Tags >= 0x80 use the DER long form (0x81 then the tag), hence the \"81\" prefix\n// on CONTACT_NAME (0xf0), SCOPE (0xf1), ACCOUNT_IDENTIFIER (0xf2),\n// GROUP_HANDLE (0xf6) and HMAC_REST (0xf7).\nconst STRUCT_TYPE_TLV = \"010133\";\nconst STRUCT_VERSION_TLV = \"020101\";\nconst CONTACT_NAME_TLV = \"81f005\" + \"416c696365\"; // \"Alice\"\nconst SCOPE_TLV = \"81f108\" + \"457468657265756d\"; // \"Ethereum\"\nconst IDENTIFIER_TLV = \"81f214\" + \"11\".repeat(20);\nconst GROUP_HANDLE_TLV = \"81f640\" + \"22\".repeat(64);\nconst CHAIN_ID_TLV = \"230101\";\nconst FAMILY_TLV = \"510101\";\nconst HMAC_PROOF_TLV = \"2920\" + \"33\".repeat(32);\nconst HMAC_REST_TLV = \"81f720\" + \"44\".repeat(32);\n\ndescribe(\"buildProvideContactPayload\", () => {\n  it(\"encodes every tag in the order the spec lists\", () => {\n    const payload = buildProvideContactPayload(INPUT);\n\n    expect(bufferToHexaString(payload, false)).toBe(\n      STRUCT_TYPE_TLV +\n        STRUCT_VERSION_TLV +\n        CONTACT_NAME_TLV +\n        SCOPE_TLV +\n        IDENTIFIER_TLV +\n        GROUP_HANDLE_TLV +\n        CHAIN_ID_TLV +\n        FAMILY_TLV +\n        HMAC_PROOF_TLV +\n        HMAC_REST_TLV,\n    );\n  });\n\n  it(\"fits an Ethereum contact in a single 255-byte chunk\", () => {\n    expect(buildProvideContactPayload(INPUT).length).toBeLessThanOrEqual(253);\n  });\n\n  it(\"omits CHAIN_ID for a family that does not carry one\", () => {\n    const payload = buildProvideContactPayload({\n      ...INPUT,\n      blockchainFamily: \"bitcoin\",\n      chainId: undefined,\n    });\n\n    expect(bufferToHexaString(payload, false)).toContain(\n      GROUP_HANDLE_TLV + \"510100\",\n    );\n  });\n\n  it(\"encodes a multi-byte chain id big-endian with no leading zeroes\", () => {\n    const payload = buildProvideContactPayload({ ...INPUT, chainId: 8453n });\n\n    expect(bufferToHexaString(payload, false)).toContain(\"2302\" + \"2105\");\n  });\n\n  it(\"accepts the family name case-insensitively\", () => {\n    expect(\n      buildProvideContactPayload({ ...INPUT, blockchainFamily: \"Ethereum\" }),\n    ).toStrictEqual(buildProvideContactPayload(INPUT));\n  });\n\n  it(\"throws on an unknown blockchain family\", () => {\n    expect(() =>\n      buildProvideContactPayload({ ...INPUT, blockchainFamily: \"dogecoin\" }),\n    ).toThrow(\"Unsupported blockchain family: dogecoin\");\n  });\n});\n\ndescribe(\"sendProvideContactPayload\", () => {\n  it(\"sends one chunk under P2=0x00, prefixed with the 2-byte BE total length\", async () => {\n    const api = makeDeviceActionInternalApiMock();\n    api.sendCommand.mockResolvedValue(\n      CommandResultFactory({ data: undefined }),\n    );\n    const payload = buildProvideContactPayload(INPUT);\n\n    const result = await sendProvideContactPayload(api, { payload });\n\n    expect(api.sendCommand).toHaveBeenCalledTimes(1);\n    const command = api.sendCommand.mock.calls[0]![0] as ProvideContactCommand;\n    expect(command).toBeInstanceOf(ProvideContactCommand);\n    expect(command.args.p2).toBe(0x00);\n    expect(command.args.data.slice(0, 2)).toStrictEqual(\n      Uint8Array.from([(payload.length >> 8) & 0xff, payload.length & 0xff]),\n    );\n    expect(command.args.data.slice(2)).toStrictEqual(payload);\n    expect(result.status).toBe(CommandResultStatus.Success);\n  });\n\n  it(\"propagates a device rejection instead of throwing\", async () => {\n    const api = makeDeviceActionInternalApiMock();\n    api.sendCommand.mockResolvedValue(\n      CommandResultFactory({\n        error: new ContactsCommandError({\n          errorCode: \"6982\",\n          message: \"wrong seed\",\n        }),\n      }),\n    );\n\n    const result = await sendProvideContactPayload(api, {\n      payload: buildProvideContactPayload(INPUT),\n    });\n\n    expect(result.status).toBe(CommandResultStatus.Error);\n  });\n});\n"],
+  "mappings": "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",
+  "names": ["bufferToHexaString", "CommandResultFactory", "CommandResultStatus", "ProvideContactCommand", "makeDeviceActionInternalApiMock", "ContactsCommandError", "buildProvideContactPayload", "sendProvideContactPayload", "IDENTIFIER", "GROUP_HANDLE", "HMAC_PROOF", "HMAC_REST", "INPUT", "STRUCT_TYPE_TLV", "STRUCT_VERSION_TLV", "CONTACT_NAME_TLV", "SCOPE_TLV", "IDENTIFIER_TLV", "GROUP_HANDLE_TLV", "CHAIN_ID_TLV", "FAMILY_TLV", "HMAC_PROOF_TLV", "HMAC_REST_TLV", "payload", "api", "result", "command"]
+}

package/lib/esm/internal/app-binder/task/SendRegisterIdentityTask.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/internal/app-binder/task/SendRegisterIdentityTask.ts"],
-  "sourcesContent": ["// Builds the TLV payload for op 1 (Register Identity / Register External\n// Address) and dispatches it via the chunked-framing scheme shared with the\n// other address-book ops (2-byte BE total length + <=255B chunks). The device\n// returns the 129-byte register response on the final chunk.\n//\n// Reference: Address Book Final Specifications \u2014 Register Identity. Tag order:\n//   STRUCT_TYPE, STRUCT_VERSION, CONTACT_NAME, SCOPE, ACCOUNT_IDENTIFIER,\n//   CHAIN_ID (Ethereum only), BLOCKCHAIN_FAMILY, then optional\n//   GROUP_HANDLE + HMAC_PROOF when extending an existing group.\n//\n// No DERIVATION_PATH: external-address ops carry no path. The current Ethereum\n// app rejects the tag when present (0x6a80) and no longer requires it; the tag\n// is Ledger-Account only (verified on-device, DSDK-1465).\nimport {\n  ByteArrayBuilder,\n  type CommandResult,\n  DmkResultFactory,\n  type InternalApi,\n  InvalidStatusWordError,\n  isSuccessCommandResult,\n  type LoggerPublisherService,\n} from \"@ledgerhq/device-management-kit\";\n\nimport { type ExistingContactGroup } from \"@api/model/RegisterExternalAddress\";\nimport { RegisterIdentityCommand } from \"@internal/app-binder/command/RegisterIdentityCommand\";\nimport {\n  BLOCKCHAIN_FAMILY_BY_NAME,\n  SUB_CMD_REGISTER_IDENTITY,\n} from \"@internal/app-binder/model/contactsConstants\";\nimport { type ContactsErrorCodes } from \"@internal/app-binder/model/contactsErrors\";\nimport {\n  CONTACTS_TLV_TAG,\n  encodeTlvAscii,\n  encodeTlvBuffer,\n  encodeTlvChainId,\n  encodeTlvUInt8,\n  STRUCT_TYPE_REGISTER_IDENTITY,\n  STRUCT_VERSION_VALUE,\n} from \"@internal/app-binder/services/contactsTlvSerializer\";\nimport { sendFramedContactsPayload } from \"@internal/app-binder/services/sendFramedContactsPayload\";\n\nexport type RegisterIdentityProofs = {\n  readonly groupHandle: Uint8Array;\n  readonly hmacProof: Uint8Array;\n  readonly hmacRest: Uint8Array;\n};\n\nexport type SendRegisterIdentityTaskArgs = {\n  readonly contactName: string;\n  readonly scope: string;\n  readonly identifier: Uint8Array;\n  readonly blockchainFamily: string;\n  readonly chainId?: bigint;\n  readonly existingContactGroup?: ExistingContactGroup;\n  readonly logger?: LoggerPublisherService;\n};\n\nexport class SendRegisterIdentityTask {\n  constructor(\n    private readonly api: InternalApi,\n    private readonly args: SendRegisterIdentityTaskArgs,\n  ) {}\n\n  async run(): Promise<\n    CommandResult<RegisterIdentityProofs, ContactsErrorCodes>\n  > {\n    const payload = this.buildPayload(this.args);\n\n    const result = (await sendFramedContactsPayload(this.api, {\n      payload,\n      p1: SUB_CMD_REGISTER_IDENTITY,\n      makeCommand: (chunk, p2) =>\n        new RegisterIdentityCommand({ data: chunk, p2 }),\n      logger: this.args.logger,\n      commandTag: \"SendRegisterIdentityTask\",\n    })) as CommandResult<\n      {\n        readonly groupHandle?: Uint8Array;\n        readonly hmacProof?: Uint8Array;\n        readonly hmacRest?: Uint8Array;\n      },\n      ContactsErrorCodes\n    >;\n\n    if (!isSuccessCommandResult(result)) {\n      return result;\n    }\n\n    const { groupHandle, hmacProof, hmacRest } = result.data;\n    if (!groupHandle || !hmacProof || !hmacRest) {\n      return DmkResultFactory({\n        error: new InvalidStatusWordError(\n          \"RegisterIdentity final-chunk response was incomplete\",\n        ),\n      });\n    }\n    return DmkResultFactory({ data: { groupHandle, hmacProof, hmacRest } });\n  }\n\n  private buildPayload(args: SendRegisterIdentityTaskArgs): Uint8Array {\n    const family =\n      BLOCKCHAIN_FAMILY_BY_NAME[args.blockchainFamily.toLowerCase()];\n    if (family === undefined) {\n      throw new Error(\n        `Unsupported blockchain family: ${args.blockchainFamily}`,\n      );\n    }\n\n    const builder = new ByteArrayBuilder();\n    encodeTlvUInt8(\n      builder,\n      CONTACTS_TLV_TAG.STRUCT_TYPE,\n      STRUCT_TYPE_REGISTER_IDENTITY,\n    );\n    encodeTlvUInt8(\n      builder,\n      CONTACTS_TLV_TAG.STRUCT_VERSION,\n      STRUCT_VERSION_VALUE,\n    );\n    encodeTlvAscii(builder, CONTACTS_TLV_TAG.CONTACT_NAME, args.contactName);\n    encodeTlvAscii(builder, CONTACTS_TLV_TAG.SCOPE, args.scope);\n    encodeTlvBuffer(\n      builder,\n      CONTACTS_TLV_TAG.ACCOUNT_IDENTIFIER,\n      args.identifier,\n    );\n    if (args.chainId !== undefined) {\n      encodeTlvChainId(builder, CONTACTS_TLV_TAG.CHAIN_ID, args.chainId);\n    }\n    encodeTlvUInt8(builder, CONTACTS_TLV_TAG.BLOCKCHAIN_FAMILY, family);\n\n    if (args.existingContactGroup) {\n      encodeTlvBuffer(\n        builder,\n        CONTACTS_TLV_TAG.GROUP_HANDLE,\n        args.existingContactGroup.groupHandle,\n      );\n      encodeTlvBuffer(\n        builder,\n        CONTACTS_TLV_TAG.HMAC_PROOF,\n        args.existingContactGroup.hmacProof,\n      );\n    }\n\n    return builder.build();\n  }\n}\n"],
-  "mappings": "AAaA,OACE,oBAAAA,EAEA,oBAAAC,EAEA,0BAAAC,EACA,0BAAAC,MAEK,kCAGP,OAAS,2BAAAC,MAA+B,uDACxC,OACE,6BAAAC,EACA,6BAAAC,MACK,+CAEP,OACE,oBAAAC,EACA,kBAAAC,EACA,mBAAAC,EACA,oBAAAC,EACA,kBAAAC,EACA,iCAAAC,EACA,wBAAAC,MACK,sDACP,OAAS,6BAAAC,MAAiC,0DAkBnC,MAAMC,CAAyB,CACpC,YACmBC,EACAC,EACjB,CAFiB,SAAAD,EACA,UAAAC,CAChB,CAEH,MAAM,KAEJ,CACA,MAAMC,EAAU,KAAK,aAAa,KAAK,IAAI,EAErCC,EAAU,MAAML,EAA0B,KAAK,IAAK,CACxD,QAAAI,EACA,GAAIZ,EACJ,YAAa,CAACc,EAAOC,IACnB,IAAIjB,EAAwB,CAAE,KAAMgB,EAAO,GAAAC,CAAG,CAAC,EACjD,OAAQ,KAAK,KAAK,OAClB,WAAY,0BACd,CAAC,EASD,GAAI,CAAClB,EAAuBgB,CAAM,EAChC,OAAOA,EAGT,KAAM,CAAE,YAAAG,EAAa,UAAAC,EAAW,SAAAC,CAAS,EAAIL,EAAO,KACpD,MAAI,CAACG,GAAe,CAACC,GAAa,CAACC,EAC1BvB,EAAiB,CACtB,MAAO,IAAIC,EACT,sDACF,CACF,CAAC,EAEID,EAAiB,CAAE,KAAM,CAAE,YAAAqB,EAAa,UAAAC,EAAW,SAAAC,CAAS,CAAE,CAAC,CACxE,CAEQ,aAAaP,EAAgD,CACnE,MAAMQ,EACJpB,EAA0BY,EAAK,iBAAiB,YAAY,CAAC,EAC/D,GAAIQ,IAAW,OACb,MAAM,IAAI,MACR,kCAAkCR,EAAK,gBAAgB,EACzD,EAGF,MAAMS,EAAU,IAAI1B,EACpB,OAAAW,EACEe,EACAnB,EAAiB,YACjBK,CACF,EACAD,EACEe,EACAnB,EAAiB,eACjBM,CACF,EACAL,EAAekB,EAASnB,EAAiB,aAAcU,EAAK,WAAW,EACvET,EAAekB,EAASnB,EAAiB,MAAOU,EAAK,KAAK,EAC1DR,EACEiB,EACAnB,EAAiB,mBACjBU,EAAK,UACP,EACIA,EAAK,UAAY,QACnBP,EAAiBgB,EAASnB,EAAiB,SAAUU,EAAK,OAAO,EAEnEN,EAAee,EAASnB,EAAiB,kBAAmBkB,CAAM,EAE9DR,EAAK,uBACPR,EACEiB,EACAnB,EAAiB,aACjBU,EAAK,qBAAqB,WAC5B,EACAR,EACEiB,EACAnB,EAAiB,WACjBU,EAAK,qBAAqB,SAC5B,GAGKS,EAAQ,MAAM,CACvB,CACF",
+  "sourcesContent": ["// Builds the TLV payload for op 1 (Register Identity / Register External\n// Address) and dispatches it via the chunked-framing scheme shared with the\n// other address-book ops (2-byte BE total length + <=255B chunks). The device\n// returns the 129-byte register response on the final chunk.\n//\n// Reference: Address Book Final Specifications \u2014 Register Identity. Tag order:\n//   STRUCT_TYPE, STRUCT_VERSION, CONTACT_NAME, SCOPE, ACCOUNT_IDENTIFIER,\n//   CHAIN_ID (Ethereum only), BLOCKCHAIN_FAMILY, then optional GROUP_HANDLE +\n//   HMAC_PROOF when extending an existing group.\n//\n// No DERIVATION_PATH. The tag's status changed three times in the BOLOS SDK,\n// and the address-book TLV parser is compiled into the app (app_features/), so\n// the SDK revision the app was *built* against decides \u2014 not the app version,\n// which reads 1.23.0-dev either way:\n//   - before 2026-08-07: tag 0x69 present and MANDATORY, omitting it -> 0x6a80\n//   - 8e7e7a4f (2026-08-07): made optional, both forms accepted\n//   - a0bb21f5 (2026-08-10): removed, sending it -> 0x6a80 (unknown tag)\n// Omitting it is therefore correct for any app built from 2026-08-07 onward,\n// and wrong for one built before. Both ends verified on hardware: a Flex\n// running a pre-08-07 build of app-ethereum a79f9f8f rejects the payload\n// without the tag in 9ms and no review screen; Speculos running a post-08-10\n// build of the same commit rejects it *with* the tag, the same way.\n// The OS derives the HMAC key from a fixed internal path.\nimport {\n  ByteArrayBuilder,\n  type CommandResult,\n  DmkResultFactory,\n  type InternalApi,\n  InvalidStatusWordError,\n  isSuccessCommandResult,\n  type LoggerPublisherService,\n} from \"@ledgerhq/device-management-kit\";\n\nimport { type ExistingContactGroup } from \"@api/model/RegisterExternalAddress\";\nimport { RegisterIdentityCommand } from \"@internal/app-binder/command/RegisterIdentityCommand\";\nimport {\n  BLOCKCHAIN_FAMILY_BY_NAME,\n  SUB_CMD_REGISTER_IDENTITY,\n} from \"@internal/app-binder/model/contactsConstants\";\nimport { type ContactsErrorCodes } from \"@internal/app-binder/model/contactsErrors\";\nimport {\n  CONTACTS_TLV_TAG,\n  encodeTlvAscii,\n  encodeTlvBuffer,\n  encodeTlvChainId,\n  encodeTlvUInt8,\n  STRUCT_TYPE_REGISTER_IDENTITY,\n  STRUCT_VERSION_VALUE,\n} from \"@internal/app-binder/services/contactsTlvSerializer\";\nimport { sendFramedContactsPayload } from \"@internal/app-binder/services/sendFramedContactsPayload\";\n\nexport type RegisterIdentityProofs = {\n  readonly groupHandle: Uint8Array;\n  readonly hmacProof: Uint8Array;\n  readonly hmacRest: Uint8Array;\n};\n\nexport type SendRegisterIdentityTaskArgs = {\n  readonly contactName: string;\n  readonly scope: string;\n  readonly identifier: Uint8Array;\n  readonly blockchainFamily: string;\n  readonly chainId?: bigint;\n  readonly existingContactGroup?: ExistingContactGroup;\n  readonly logger?: LoggerPublisherService;\n};\n\nexport class SendRegisterIdentityTask {\n  constructor(\n    private readonly api: InternalApi,\n    private readonly args: SendRegisterIdentityTaskArgs,\n  ) {}\n\n  async run(): Promise<\n    CommandResult<RegisterIdentityProofs, ContactsErrorCodes>\n  > {\n    const payload = this.buildPayload(this.args);\n\n    const result = (await sendFramedContactsPayload(this.api, {\n      payload,\n      p1: SUB_CMD_REGISTER_IDENTITY,\n      makeCommand: (chunk, p2) =>\n        new RegisterIdentityCommand({ data: chunk, p2 }),\n      logger: this.args.logger,\n      commandTag: \"SendRegisterIdentityTask\",\n    })) as CommandResult<\n      {\n        readonly groupHandle?: Uint8Array;\n        readonly hmacProof?: Uint8Array;\n        readonly hmacRest?: Uint8Array;\n      },\n      ContactsErrorCodes\n    >;\n\n    if (!isSuccessCommandResult(result)) {\n      return result;\n    }\n\n    const { groupHandle, hmacProof, hmacRest } = result.data;\n    if (!groupHandle || !hmacProof || !hmacRest) {\n      return DmkResultFactory({\n        error: new InvalidStatusWordError(\n          \"RegisterIdentity final-chunk response was incomplete\",\n        ),\n      });\n    }\n    return DmkResultFactory({ data: { groupHandle, hmacProof, hmacRest } });\n  }\n\n  private buildPayload(args: SendRegisterIdentityTaskArgs): Uint8Array {\n    const family =\n      BLOCKCHAIN_FAMILY_BY_NAME[args.blockchainFamily.toLowerCase()];\n    if (family === undefined) {\n      throw new Error(\n        `Unsupported blockchain family: ${args.blockchainFamily}`,\n      );\n    }\n\n    const builder = new ByteArrayBuilder();\n    encodeTlvUInt8(\n      builder,\n      CONTACTS_TLV_TAG.STRUCT_TYPE,\n      STRUCT_TYPE_REGISTER_IDENTITY,\n    );\n    encodeTlvUInt8(\n      builder,\n      CONTACTS_TLV_TAG.STRUCT_VERSION,\n      STRUCT_VERSION_VALUE,\n    );\n    encodeTlvAscii(builder, CONTACTS_TLV_TAG.CONTACT_NAME, args.contactName);\n    encodeTlvAscii(builder, CONTACTS_TLV_TAG.SCOPE, args.scope);\n    encodeTlvBuffer(\n      builder,\n      CONTACTS_TLV_TAG.ACCOUNT_IDENTIFIER,\n      args.identifier,\n    );\n    if (args.chainId !== undefined) {\n      encodeTlvChainId(builder, CONTACTS_TLV_TAG.CHAIN_ID, args.chainId);\n    }\n    encodeTlvUInt8(builder, CONTACTS_TLV_TAG.BLOCKCHAIN_FAMILY, family);\n\n    if (args.existingContactGroup) {\n      encodeTlvBuffer(\n        builder,\n        CONTACTS_TLV_TAG.GROUP_HANDLE,\n        args.existingContactGroup.groupHandle,\n      );\n      encodeTlvBuffer(\n        builder,\n        CONTACTS_TLV_TAG.HMAC_PROOF,\n        args.existingContactGroup.hmacProof,\n      );\n    }\n\n    return builder.build();\n  }\n}\n"],
+  "mappings": "AAuBA,OACE,oBAAAA,EAEA,oBAAAC,EAEA,0BAAAC,EACA,0BAAAC,MAEK,kCAGP,OAAS,2BAAAC,MAA+B,uDACxC,OACE,6BAAAC,EACA,6BAAAC,MACK,+CAEP,OACE,oBAAAC,EACA,kBAAAC,EACA,mBAAAC,EACA,oBAAAC,EACA,kBAAAC,EACA,iCAAAC,EACA,wBAAAC,MACK,sDACP,OAAS,6BAAAC,MAAiC,0DAkBnC,MAAMC,CAAyB,CACpC,YACmBC,EACAC,EACjB,CAFiB,SAAAD,EACA,UAAAC,CAChB,CAEH,MAAM,KAEJ,CACA,MAAMC,EAAU,KAAK,aAAa,KAAK,IAAI,EAErCC,EAAU,MAAML,EAA0B,KAAK,IAAK,CACxD,QAAAI,EACA,GAAIZ,EACJ,YAAa,CAACc,EAAOC,IACnB,IAAIjB,EAAwB,CAAE,KAAMgB,EAAO,GAAAC,CAAG,CAAC,EACjD,OAAQ,KAAK,KAAK,OAClB,WAAY,0BACd,CAAC,EASD,GAAI,CAAClB,EAAuBgB,CAAM,EAChC,OAAOA,EAGT,KAAM,CAAE,YAAAG,EAAa,UAAAC,EAAW,SAAAC,CAAS,EAAIL,EAAO,KACpD,MAAI,CAACG,GAAe,CAACC,GAAa,CAACC,EAC1BvB,EAAiB,CACtB,MAAO,IAAIC,EACT,sDACF,CACF,CAAC,EAEID,EAAiB,CAAE,KAAM,CAAE,YAAAqB,EAAa,UAAAC,EAAW,SAAAC,CAAS,CAAE,CAAC,CACxE,CAEQ,aAAaP,EAAgD,CACnE,MAAMQ,EACJpB,EAA0BY,EAAK,iBAAiB,YAAY,CAAC,EAC/D,GAAIQ,IAAW,OACb,MAAM,IAAI,MACR,kCAAkCR,EAAK,gBAAgB,EACzD,EAGF,MAAMS,EAAU,IAAI1B,EACpB,OAAAW,EACEe,EACAnB,EAAiB,YACjBK,CACF,EACAD,EACEe,EACAnB,EAAiB,eACjBM,CACF,EACAL,EAAekB,EAASnB,EAAiB,aAAcU,EAAK,WAAW,EACvET,EAAekB,EAASnB,EAAiB,MAAOU,EAAK,KAAK,EAC1DR,EACEiB,EACAnB,EAAiB,mBACjBU,EAAK,UACP,EACIA,EAAK,UAAY,QACnBP,EAAiBgB,EAASnB,EAAiB,SAAUU,EAAK,OAAO,EAEnEN,EAAee,EAASnB,EAAiB,kBAAmBkB,CAAM,EAE9DR,EAAK,uBACPR,EACEiB,EACAnB,EAAiB,aACjBU,EAAK,qBAAqB,WAC5B,EACAR,EACEiB,EACAnB,EAAiB,WACjBU,EAAK,qBAAqB,SAC5B,GAGKS,EAAQ,MAAM,CACvB,CACF",
   "names": ["ByteArrayBuilder", "DmkResultFactory", "InvalidStatusWordError", "isSuccessCommandResult", "RegisterIdentityCommand", "BLOCKCHAIN_FAMILY_BY_NAME", "SUB_CMD_REGISTER_IDENTITY", "CONTACTS_TLV_TAG", "encodeTlvAscii", "encodeTlvBuffer", "encodeTlvChainId", "encodeTlvUInt8", "STRUCT_TYPE_REGISTER_IDENTITY", "STRUCT_VERSION_VALUE", "sendFramedContactsPayload", "SendRegisterIdentityTask", "api", "args", "payload", "result", "chunk", "p2", "groupHandle", "hmacProof", "hmacRest", "family", "builder"]
 }

package/lib/esm/internal/app-binder/task/SendRegisterIdentityTask.test.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/internal/app-binder/task/SendRegisterIdentityTask.test.ts"],
-  "sourcesContent": ["// Validates that the TLV serializer + tag ordering + chunk framing produce the\n// expected wire bytes for op 1 (Register Identity): tags >= 0x80 use the 2-byte\n// DER form [0x81, tag], and Register Identity carries NO DERIVATION_PATH (the\n// Ethereum app rejects the tag on external-address ops). The framed chunk =\n// 2-byte BE total length + TLV.\nimport {\n  CommandResultFactory,\n  type InternalApi,\n  InvalidStatusWordError,\n} from \"@ledgerhq/device-management-kit\";\n\nimport { RegisterIdentityCommand } from \"@internal/app-binder/command/RegisterIdentityCommand\";\n\nimport { SendRegisterIdentityTask } from \"./SendRegisterIdentityTask\";\n\nfunction hexToBytes(hex: string): Uint8Array {\n  const out = new Uint8Array(hex.length / 2);\n  for (let i = 0; i < hex.length; i += 2) {\n    out[i / 2] = parseInt(hex.slice(i, i + 2), 16);\n  }\n  return out;\n}\n\n// Framed chunk = \"00 <Lc>\" (2-byte BE total TLV length) + TLV. Tag order:\n// STRUCT_TYPE, STRUCT_VERSION, CONTACT_NAME, SCOPE, ACCOUNT_IDENTIFIER,\n// CHAIN_ID, BLOCKCHAIN_FAMILY, then optional GROUP_HANDLE + HMAC_PROOF. Tags\n// >= 0x80 are encoded as [0x81, tag]. No DERIVATION_PATH TLV.\nconst FRESH_FRAMED_CHUNK = hexToBytes(\n  \"003601012d020101\" +\n    \"81f005416c696365\" +\n    \"81f108457468206d61696e\" +\n    \"81f21400000000000000000000000000000000deadbeef\" +\n    \"230101510101\",\n);\n\nconst EXTENSION_FRAMED_CHUNK = hexToBytes(\n  \"009c01012d020101\" +\n    \"81f005416c696365\" +\n    \"81f108417262206d61696e\" +\n    \"81f2144444444444444444444444444444444444444444\" +\n    \"2302a4b1510101\" +\n    \"81f640cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc\" +\n    \"2920dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd\",\n);\n\nconst OK_PROOFS = {\n  groupHandle: hexToBytes(\"cc\".repeat(64)),\n  hmacProof: hexToBytes(\"dd\".repeat(32)),\n  hmacRest: hexToBytes(\"aa\".repeat(32)),\n};\n\nfunction makeApiMock(): InternalApi & {\n  sendCommand: ReturnType<typeof vi.fn>;\n} {\n  return { sendCommand: vi.fn() } as unknown as InternalApi & {\n    sendCommand: ReturnType<typeof vi.fn>;\n  };\n}\n\ndescribe(\"SendRegisterIdentityTask\", () => {\n  it(\"assembles a fresh-register framed chunk and dispatches RegisterIdentityCommand\", async () => {\n    const api = makeApiMock();\n    api.sendCommand.mockResolvedValueOnce(\n      CommandResultFactory({ data: OK_PROOFS }),\n    );\n\n    const result = await new SendRegisterIdentityTask(api, {\n      contactName: \"Alice\",\n      scope: \"Eth main\",\n      identifier: hexToBytes(\"00000000000000000000000000000000deadbeef\"),\n      blockchainFamily: \"ethereum\",\n      chainId: 1n,\n    }).run();\n\n    expect(api.sendCommand.mock.calls).toHaveLength(1);\n    expect(api.sendCommand.mock.calls[0]![0]).toStrictEqual(\n      new RegisterIdentityCommand({ data: FRESH_FRAMED_CHUNK, p2: 0x00 }),\n    );\n    expect(result).toStrictEqual(CommandResultFactory({ data: OK_PROOFS }));\n  });\n\n  it(\"appends GROUP_HANDLE + HMAC_PROOF on extension and frames the extension payload\", async () => {\n    const api = makeApiMock();\n    api.sendCommand.mockResolvedValueOnce(\n      CommandResultFactory({ data: OK_PROOFS }),\n    );\n\n    await new SendRegisterIdentityTask(api, {\n      contactName: \"Alice\",\n      scope: \"Arb main\",\n      identifier: hexToBytes(\"44\".repeat(20)),\n      blockchainFamily: \"ethereum\",\n      chainId: 42161n,\n      existingContactGroup: {\n        groupHandle: hexToBytes(\"cc\".repeat(64)),\n        hmacProof: hexToBytes(\"dd\".repeat(32)),\n      },\n    }).run();\n\n    expect(api.sendCommand.mock.calls).toHaveLength(1);\n    expect(api.sendCommand.mock.calls[0]![0]).toStrictEqual(\n      new RegisterIdentityCommand({ data: EXTENSION_FRAMED_CHUNK, p2: 0x00 }),\n    );\n  });\n\n  it(\"omits the CHAIN_ID TLV when chainId is not provided\", async () => {\n    const api = makeApiMock();\n    api.sendCommand.mockResolvedValueOnce(\n      CommandResultFactory({ data: OK_PROOFS }),\n    );\n\n    await new SendRegisterIdentityTask(api, {\n      contactName: \"Alice\",\n      scope: \"Eth main\",\n      identifier: hexToBytes(\"00000000000000000000000000000000deadbeef\"),\n      blockchainFamily: \"ethereum\",\n    }).run();\n\n    const command = api.sendCommand.mock\n      .calls[0]![0] as RegisterIdentityCommand;\n    // No `23 01 ..` CHAIN_ID TLV; BLOCKCHAIN_FAMILY 51 01 01 follows the path.\n    const framedHex = Buffer.from(command.args.data).toString(\"hex\");\n    expect(framedHex).not.toContain(\"230101\");\n    expect(framedHex.endsWith(\"510101\")).toBe(true);\n  });\n\n  it(\"propagates command-level errors\", async () => {\n    const api = makeApiMock();\n    api.sendCommand.mockResolvedValueOnce(\n      CommandResultFactory({\n        error: new InvalidStatusWordError(\"user cancelled\"),\n      }),\n    );\n\n    const result = await new SendRegisterIdentityTask(api, {\n      contactName: \"Alice\",\n      scope: \"Eth main\",\n      identifier: hexToBytes(\"00000000000000000000000000000000deadbeef\"),\n      blockchainFamily: \"ethereum\",\n      chainId: 1n,\n    }).run();\n\n    expect(result).toStrictEqual(\n      CommandResultFactory({\n        error: new InvalidStatusWordError(\"user cancelled\"),\n      }),\n    );\n  });\n\n  it(\"throws on an unsupported blockchain family\", async () => {\n    const api = makeApiMock();\n\n    await expect(\n      new SendRegisterIdentityTask(api, {\n        contactName: \"Alice\",\n        scope: \"Eth main\",\n        identifier: hexToBytes(\"00000000000000000000000000000000deadbeef\"),\n        blockchainFamily: \"dogecoin\",\n        chainId: 1n,\n      }).run(),\n    ).rejects.toThrow(/Unsupported blockchain family/);\n    expect(api.sendCommand).not.toHaveBeenCalled();\n  });\n});\n"],
+  "sourcesContent": ["// Validates that the TLV serializer + tag ordering + chunk framing produce the\n// expected wire bytes for op 1 (Register Identity): tags >= 0x80 use the 2-byte\n// DER form [0x81, tag], and no DERIVATION_PATH is sent (the SDK removed tag\n// 0x69 from REGISTER_IDENTITY_TAGS on 2026-08-10 and rejects payloads carrying\n// it). The framed chunk = 2-byte BE total length + TLV.\nimport {\n  CommandResultFactory,\n  type InternalApi,\n  InvalidStatusWordError,\n} from \"@ledgerhq/device-management-kit\";\n\nimport { RegisterIdentityCommand } from \"@internal/app-binder/command/RegisterIdentityCommand\";\n\nimport { SendRegisterIdentityTask } from \"./SendRegisterIdentityTask\";\n\nfunction hexToBytes(hex: string): Uint8Array {\n  const out = new Uint8Array(hex.length / 2);\n  for (let i = 0; i < hex.length; i += 2) {\n    out[i / 2] = parseInt(hex.slice(i, i + 2), 16);\n  }\n  return out;\n}\n\n// Framed chunk = \"00 <Lc>\" (2-byte BE total TLV length) + TLV. Tag order:\n// STRUCT_TYPE, STRUCT_VERSION, CONTACT_NAME, SCOPE, ACCOUNT_IDENTIFIER,\n// CHAIN_ID, BLOCKCHAIN_FAMILY, then optional GROUP_HANDLE + HMAC_PROOF. Tags\n// >= 0x80 are encoded as [0x81, tag].\nconst FRESH_FRAMED_CHUNK = hexToBytes(\n  \"003601012d020101\" +\n    \"81f005416c696365\" +\n    \"81f108457468206d61696e\" +\n    \"81f21400000000000000000000000000000000deadbeef\" +\n    \"230101510101\",\n);\n\nconst EXTENSION_FRAMED_CHUNK = hexToBytes(\n  \"009c01012d020101\" +\n    \"81f005416c696365\" +\n    \"81f108417262206d61696e\" +\n    \"81f2144444444444444444444444444444444444444444\" +\n    \"2302a4b1510101\" +\n    \"81f640cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc\" +\n    \"2920dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd\",\n);\n\nconst OK_PROOFS = {\n  groupHandle: hexToBytes(\"cc\".repeat(64)),\n  hmacProof: hexToBytes(\"dd\".repeat(32)),\n  hmacRest: hexToBytes(\"aa\".repeat(32)),\n};\n\nfunction makeApiMock(): InternalApi & {\n  sendCommand: ReturnType<typeof vi.fn>;\n} {\n  return { sendCommand: vi.fn() } as unknown as InternalApi & {\n    sendCommand: ReturnType<typeof vi.fn>;\n  };\n}\n\ndescribe(\"SendRegisterIdentityTask\", () => {\n  it(\"assembles a fresh-register framed chunk and dispatches RegisterIdentityCommand\", async () => {\n    const api = makeApiMock();\n    api.sendCommand.mockResolvedValueOnce(\n      CommandResultFactory({ data: OK_PROOFS }),\n    );\n\n    const result = await new SendRegisterIdentityTask(api, {\n      contactName: \"Alice\",\n      scope: \"Eth main\",\n      identifier: hexToBytes(\"00000000000000000000000000000000deadbeef\"),\n      blockchainFamily: \"ethereum\",\n      chainId: 1n,\n    }).run();\n\n    expect(api.sendCommand.mock.calls).toHaveLength(1);\n    expect(api.sendCommand.mock.calls[0]![0]).toStrictEqual(\n      new RegisterIdentityCommand({ data: FRESH_FRAMED_CHUNK, p2: 0x00 }),\n    );\n    expect(result).toStrictEqual(CommandResultFactory({ data: OK_PROOFS }));\n  });\n\n  it(\"appends GROUP_HANDLE + HMAC_PROOF on extension and frames the extension payload\", async () => {\n    const api = makeApiMock();\n    api.sendCommand.mockResolvedValueOnce(\n      CommandResultFactory({ data: OK_PROOFS }),\n    );\n\n    await new SendRegisterIdentityTask(api, {\n      contactName: \"Alice\",\n      scope: \"Arb main\",\n      identifier: hexToBytes(\"44\".repeat(20)),\n      blockchainFamily: \"ethereum\",\n      chainId: 42161n,\n      existingContactGroup: {\n        groupHandle: hexToBytes(\"cc\".repeat(64)),\n        hmacProof: hexToBytes(\"dd\".repeat(32)),\n      },\n    }).run();\n\n    expect(api.sendCommand.mock.calls).toHaveLength(1);\n    expect(api.sendCommand.mock.calls[0]![0]).toStrictEqual(\n      new RegisterIdentityCommand({ data: EXTENSION_FRAMED_CHUNK, p2: 0x00 }),\n    );\n  });\n\n  it(\"omits the CHAIN_ID TLV when chainId is not provided\", async () => {\n    const api = makeApiMock();\n    api.sendCommand.mockResolvedValueOnce(\n      CommandResultFactory({ data: OK_PROOFS }),\n    );\n\n    await new SendRegisterIdentityTask(api, {\n      contactName: \"Alice\",\n      scope: \"Eth main\",\n      identifier: hexToBytes(\"00000000000000000000000000000000deadbeef\"),\n      blockchainFamily: \"ethereum\",\n    }).run();\n\n    const command = api.sendCommand.mock\n      .calls[0]![0] as RegisterIdentityCommand;\n    // No `23 01 ..` CHAIN_ID TLV; BLOCKCHAIN_FAMILY 51 01 01 follows the path.\n    const framedHex = Buffer.from(command.args.data).toString(\"hex\");\n    expect(framedHex).not.toContain(\"230101\");\n    expect(framedHex.endsWith(\"510101\")).toBe(true);\n  });\n\n  it(\"propagates command-level errors\", async () => {\n    const api = makeApiMock();\n    api.sendCommand.mockResolvedValueOnce(\n      CommandResultFactory({\n        error: new InvalidStatusWordError(\"user cancelled\"),\n      }),\n    );\n\n    const result = await new SendRegisterIdentityTask(api, {\n      contactName: \"Alice\",\n      scope: \"Eth main\",\n      identifier: hexToBytes(\"00000000000000000000000000000000deadbeef\"),\n      blockchainFamily: \"ethereum\",\n      chainId: 1n,\n    }).run();\n\n    expect(result).toStrictEqual(\n      CommandResultFactory({\n        error: new InvalidStatusWordError(\"user cancelled\"),\n      }),\n    );\n  });\n\n  it(\"throws on an unsupported blockchain family\", async () => {\n    const api = makeApiMock();\n\n    await expect(\n      new SendRegisterIdentityTask(api, {\n        contactName: \"Alice\",\n        scope: \"Eth main\",\n        identifier: hexToBytes(\"00000000000000000000000000000000deadbeef\"),\n        blockchainFamily: \"dogecoin\",\n        chainId: 1n,\n      }).run(),\n    ).rejects.toThrow(/Unsupported blockchain family/);\n    expect(api.sendCommand).not.toHaveBeenCalled();\n  });\n});\n"],
   "mappings": "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",
   "names": ["CommandResultFactory", "InvalidStatusWordError", "RegisterIdentityCommand", "SendRegisterIdentityTask", "hexToBytes", "hex", "out", "i", "FRESH_FRAMED_CHUNK", "EXTENSION_FRAMED_CHUNK", "OK_PROOFS", "makeApiMock", "api", "result", "command", "framedHex"]
 }

package/lib/esm/internal/app-binder/task/SendRenameContactTask.js CHANGED Viewed

@@ -1,2 +1,2 @@
-import{ByteArrayBuilder as c,DmkResultFactory as n,InvalidStatusWordError as C,isSuccessCommandResult as l}from"@ledgerhq/device-management-kit";import{RenameContactCommand as T}from"../../app-binder/command/RenameContactCommand";import{RENAME_CONTACT_P1 as p}from"../../app-binder/model/contactsConstants";import{CONTACTS_TLV_TAG as e,encodeTlvAscii as m,encodeTlvBuffer as o,encodeTlvUInt8 as s,packDerivationPath as y,STRUCT_TYPE_EDIT_CONTACT_NAME as u,STRUCT_VERSION_VALUE as A}from"../../app-binder/services/contactsTlvSerializer";import{sendFramedContactsPayload as R}from"../../app-binder/services/sendFramedContactsPayload";class S{constructor(a,r){this.api=a;this.args=r}async run(){const a=this.buildPayload(this.args),r=await R(this.api,{payload:a,p1:p,makeCommand:(d,i)=>new T({data:d,p2:i}),logger:this.args.logger,commandTag:"SendRenameContactTask"});if(!l(r))return r;const{hmacProof:t}=r.data;return t?n({data:{hmacProof:t}}):n({error:new C("RenameContact final-chunk response did not carry hmac_name")})}buildPayload(a){const r=new c;return s(r,e.STRUCT_TYPE,u),s(r,e.STRUCT_VERSION,A),m(r,e.CONTACT_NAME,a.newContactName),m(r,e.PREVIOUS_CONTACT_NAME,a.previousContactName),o(r,e.GROUP_HANDLE,a.groupHandle),o(r,e.DERIVATION_PATH,y([2147483692,2147483708,2147483648,0,0])),o(r,e.HMAC_PROOF,a.hmacProof),r.build()}}export{S as SendRenameContactTask};
+import{ByteArrayBuilder as s,DmkResultFactory as n,InvalidStatusWordError as l,isSuccessCommandResult as C}from"@ledgerhq/device-management-kit";import{RenameContactCommand as T}from"../../app-binder/command/RenameContactCommand";import{RENAME_CONTACT_P1 as p}from"../../app-binder/model/contactsConstants";import{CONTACTS_TLV_TAG as r,encodeTlvAscii as i,encodeTlvBuffer as o,encodeTlvUInt8 as d,packDerivationPath as y,STRUCT_TYPE_EDIT_CONTACT_NAME as u,STRUCT_VERSION_VALUE as A}from"../../app-binder/services/contactsTlvSerializer";import{sendFramedContactsPayload as R}from"../../app-binder/services/sendFramedContactsPayload";class S{constructor(a,e){this.api=a;this.args=e}async run(){const a=this.buildPayload(this.args),e=await R(this.api,{payload:a,p1:p,makeCommand:(m,c)=>new T({data:m,p2:c}),logger:this.args.logger,commandTag:"SendRenameContactTask"});if(!C(e))return e;const{hmacProof:t}=e.data;return t?n({data:{hmacProof:t}}):n({error:new l("RenameContact final-chunk response did not carry hmac_name")})}buildPayload(a){const e=new s;return d(e,r.STRUCT_TYPE,u),d(e,r.STRUCT_VERSION,A),i(e,r.CONTACT_NAME,a.newContactName),i(e,r.PREVIOUS_CONTACT_NAME,a.previousContactName),o(e,r.GROUP_HANDLE,a.groupHandle),a.includeDerivationPath&&o(e,r.DERIVATION_PATH,y([2147483692,2147483708,2147483648,0,0])),o(e,r.HMAC_PROOF,a.hmacProof),e.build()}}export{S as SendRenameContactTask};
 //# sourceMappingURL=SendRenameContactTask.js.map

package/lib/esm/internal/app-binder/task/SendRenameContactTask.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/internal/app-binder/task/SendRenameContactTask.ts"],
-  "sourcesContent": ["// Builds the TLV payload for the Rename Contact (EDIT CONTACT NAME) op and\n// dispatches it via the chunked-framing scheme shared with the other\n// address-book ops (2-byte BE total length + <=255B chunks). Rename is an\n// OS/dashboard command (CLA 0xE0 / INS 0x2E) \u2014 the caller runs this task after\n// navigating to the dashboard (GoToDashboardDeviceAction), never inside an app.\n//\n// The device rotates the contact-level hmac_name and returns the fresh proof on\n// the final chunk; per-entry hmac_rest values are untouched (they bind\n// gid|scope|id|family|chain_id, never the name), so a single APDU regardless of\n// the contact's entry count.\n//\n// Reference: Address Book Final Specifications \u2014 Edit Contact Name. Tag order:\n//   STRUCT_TYPE, STRUCT_VERSION, CONTACT_NAME (new), PREVIOUS_CONTACT_NAME\n//   (old), GROUP_HANDLE, DERIVATION_PATH, HMAC_PROOF.\nimport {\n  ByteArrayBuilder,\n  type CommandResult,\n  DmkResultFactory,\n  type InternalApi,\n  InvalidStatusWordError,\n  isSuccessCommandResult,\n  type LoggerPublisherService,\n} from \"@ledgerhq/device-management-kit\";\n\nimport { RenameContactCommand } from \"@internal/app-binder/command/RenameContactCommand\";\nimport { RENAME_CONTACT_P1 } from \"@internal/app-binder/model/contactsConstants\";\nimport { type ContactsErrorCodes } from \"@internal/app-binder/model/contactsErrors\";\nimport {\n  CONTACTS_TLV_TAG,\n  encodeTlvAscii,\n  encodeTlvBuffer,\n  encodeTlvUInt8,\n  packDerivationPath,\n  STRUCT_TYPE_EDIT_CONTACT_NAME,\n  STRUCT_VERSION_VALUE,\n} from \"@internal/app-binder/services/contactsTlvSerializer\";\nimport { sendFramedContactsPayload } from \"@internal/app-binder/services/sendFramedContactsPayload\";\n\nexport type RenameContactProof = {\n  readonly hmacProof: Uint8Array;\n};\n\nexport type SendRenameContactTaskArgs = {\n  readonly previousContactName: string;\n  readonly newContactName: string;\n  readonly groupHandle: Uint8Array;\n  readonly hmacProof: Uint8Array;\n  readonly logger?: LoggerPublisherService;\n};\n\nexport class SendRenameContactTask {\n  constructor(\n    private readonly api: InternalApi,\n    private readonly args: SendRenameContactTaskArgs,\n  ) {}\n\n  async run(): Promise<CommandResult<RenameContactProof, ContactsErrorCodes>> {\n    const payload = this.buildPayload(this.args);\n\n    const result = (await sendFramedContactsPayload(this.api, {\n      payload,\n      p1: RENAME_CONTACT_P1,\n      makeCommand: (chunk, p2) => new RenameContactCommand({ data: chunk, p2 }),\n      logger: this.args.logger,\n      commandTag: \"SendRenameContactTask\",\n    })) as CommandResult<\n      { readonly hmacProof?: Uint8Array },\n      ContactsErrorCodes\n    >;\n\n    if (!isSuccessCommandResult(result)) {\n      return result;\n    }\n\n    const { hmacProof } = result.data;\n    if (!hmacProof) {\n      return DmkResultFactory({\n        error: new InvalidStatusWordError(\n          \"RenameContact final-chunk response did not carry hmac_name\",\n        ),\n      });\n    }\n    return DmkResultFactory({ data: { hmacProof } });\n  }\n\n  private buildPayload(args: SendRenameContactTaskArgs): Uint8Array {\n    const builder = new ByteArrayBuilder();\n    encodeTlvUInt8(\n      builder,\n      CONTACTS_TLV_TAG.STRUCT_TYPE,\n      STRUCT_TYPE_EDIT_CONTACT_NAME,\n    );\n    encodeTlvUInt8(\n      builder,\n      CONTACTS_TLV_TAG.STRUCT_VERSION,\n      STRUCT_VERSION_VALUE,\n    );\n    encodeTlvAscii(builder, CONTACTS_TLV_TAG.CONTACT_NAME, args.newContactName);\n    encodeTlvAscii(\n      builder,\n      CONTACTS_TLV_TAG.PREVIOUS_CONTACT_NAME,\n      args.previousContactName,\n    );\n    encodeTlvBuffer(builder, CONTACTS_TLV_TAG.GROUP_HANDLE, args.groupHandle);\n    // The Ethereum app requires DERIVATION_PATH on Edit Contact Name (0x6a80\n    // without it), same as Register Identity. Default m/44'/60'/0'/0/0.\n    encodeTlvBuffer(\n      builder,\n      CONTACTS_TLV_TAG.DERIVATION_PATH,\n      packDerivationPath([0x8000002c, 0x8000003c, 0x80000000, 0, 0]),\n    );\n    encodeTlvBuffer(builder, CONTACTS_TLV_TAG.HMAC_PROOF, args.hmacProof);\n\n    return builder.build();\n  }\n}\n"],
-  "mappings": "AAcA,OACE,oBAAAA,EAEA,oBAAAC,EAEA,0BAAAC,EACA,0BAAAC,MAEK,kCAEP,OAAS,wBAAAC,MAA4B,oDACrC,OAAS,qBAAAC,MAAyB,+CAElC,OACE,oBAAAC,EACA,kBAAAC,EACA,mBAAAC,EACA,kBAAAC,EACA,sBAAAC,EACA,iCAAAC,EACA,wBAAAC,MACK,sDACP,OAAS,6BAAAC,MAAiC,0DAcnC,MAAMC,CAAsB,CACjC,YACmBC,EACAC,EACjB,CAFiB,SAAAD,EACA,UAAAC,CAChB,CAEH,MAAM,KAAsE,CAC1E,MAAMC,EAAU,KAAK,aAAa,KAAK,IAAI,EAErCC,EAAU,MAAML,EAA0B,KAAK,IAAK,CACxD,QAAAI,EACA,GAAIZ,EACJ,YAAa,CAACc,EAAOC,IAAO,IAAIhB,EAAqB,CAAE,KAAMe,EAAO,GAAAC,CAAG,CAAC,EACxE,OAAQ,KAAK,KAAK,OAClB,WAAY,uBACd,CAAC,EAKD,GAAI,CAACjB,EAAuBe,CAAM,EAChC,OAAOA,EAGT,KAAM,CAAE,UAAAG,CAAU,EAAIH,EAAO,KAC7B,OAAKG,EAOEpB,EAAiB,CAAE,KAAM,CAAE,UAAAoB,CAAU,CAAE,CAAC,EANtCpB,EAAiB,CACtB,MAAO,IAAIC,EACT,4DACF,CACF,CAAC,CAGL,CAEQ,aAAac,EAA6C,CAChE,MAAMM,EAAU,IAAItB,EACpB,OAAAS,EACEa,EACAhB,EAAiB,YACjBK,CACF,EACAF,EACEa,EACAhB,EAAiB,eACjBM,CACF,EACAL,EAAee,EAAShB,EAAiB,aAAcU,EAAK,cAAc,EAC1ET,EACEe,EACAhB,EAAiB,sBACjBU,EAAK,mBACP,EACAR,EAAgBc,EAAShB,EAAiB,aAAcU,EAAK,WAAW,EAGxER,EACEc,EACAhB,EAAiB,gBACjBI,EAAmB,CAAC,WAAY,WAAY,WAAY,EAAG,CAAC,CAAC,CAC/D,EACAF,EAAgBc,EAAShB,EAAiB,WAAYU,EAAK,SAAS,EAE7DM,EAAQ,MAAM,CACvB,CACF",
+  "sourcesContent": ["// Builds the TLV payload for the Rename Contact (EDIT CONTACT NAME) op and\n// dispatches it via the chunked-framing scheme shared with the other\n// address-book ops (2-byte BE total length + <=255B chunks). Rename is an\n// OS/dashboard command (CLA 0xE0 / INS 0x2E) \u2014 the caller runs this task after\n// navigating to the dashboard (GoToDashboardDeviceAction), never inside an app.\n//\n// The device rotates the contact-level hmac_name and returns the fresh proof on\n// the final chunk; per-entry hmac_rest values are untouched (they bind\n// gid|scope|id|family|chain_id, never the name), so a single APDU regardless of\n// the contact's entry count.\n//\n// Reference: Address Book Final Specifications \u2014 Edit Contact Name. Tag order:\n//   STRUCT_TYPE, STRUCT_VERSION, CONTACT_NAME (new), PREVIOUS_CONTACT_NAME\n//   (old), GROUP_HANDLE, [DERIVATION_PATH], HMAC_PROOF.\n//\n// DERIVATION_PATH (tag 0x69) is CONDITIONAL (DSDK-1481). The final product\n// serves rename from the OS, which needs no path \u2014 but the OS build decides the\n// payload shape, and the two shapes are mutually exclusive across builds:\n//   - OS below the model's cutoff (e.g. Flex 1.7.0-rc2 and earlier): the path\n//     is still MANDATORY, omitting it -> 0x686A (before any review screen).\n//   - OS at/after the cutoff (Flex 1.7.0-rc3, final, later): the path is\n//     rejected, sending it -> 0x6A80 (unknown tag).\n// So the caller passes includeDerivationPath, computed from the device OS\n// version read *freshly* from the device (renameRequiresDerivationPath), and we\n// emit the tag only for the older builds. This shim \u2014 the flag, the cutoff\n// table entries, and renameRequiresDerivationPath \u2014 is removed in one commit\n// once no in-the-field OS predates the cutoff. The rc2 requirement was verified\n// on hardware: a Flex on OS 1.7.0-rc2 rejects the path-free payload with 0x686A.\nimport {\n  ByteArrayBuilder,\n  type CommandResult,\n  DmkResultFactory,\n  type InternalApi,\n  InvalidStatusWordError,\n  isSuccessCommandResult,\n  type LoggerPublisherService,\n} from \"@ledgerhq/device-management-kit\";\n\nimport { RenameContactCommand } from \"@internal/app-binder/command/RenameContactCommand\";\nimport { RENAME_CONTACT_P1 } from \"@internal/app-binder/model/contactsConstants\";\nimport { type ContactsErrorCodes } from \"@internal/app-binder/model/contactsErrors\";\nimport {\n  CONTACTS_TLV_TAG,\n  encodeTlvAscii,\n  encodeTlvBuffer,\n  encodeTlvUInt8,\n  packDerivationPath,\n  STRUCT_TYPE_EDIT_CONTACT_NAME,\n  STRUCT_VERSION_VALUE,\n} from \"@internal/app-binder/services/contactsTlvSerializer\";\nimport { sendFramedContactsPayload } from \"@internal/app-binder/services/sendFramedContactsPayload\";\n\nexport type RenameContactProof = {\n  readonly hmacProof: Uint8Array;\n};\n\nexport type SendRenameContactTaskArgs = {\n  readonly previousContactName: string;\n  readonly newContactName: string;\n  readonly groupHandle: Uint8Array;\n  readonly hmacProof: Uint8Array;\n  /**\n   * TEMPORARY (DSDK-1481) \u2014 emit the `DERIVATION_PATH` (tag 0x69) TLV. Defaults\n   * to `false` (the GA payload, path-free). The caller sets it `true` only for\n   * OS builds below the model's cutoff, which still mandate the path; see\n   * {@link renameRequiresDerivationPath}. Not exposed on the public\n   * `RenameContactInput` \u2014 the host never chooses this.\n   */\n  readonly includeDerivationPath?: boolean;\n  readonly logger?: LoggerPublisherService;\n};\n\nexport class SendRenameContactTask {\n  constructor(\n    private readonly api: InternalApi,\n    private readonly args: SendRenameContactTaskArgs,\n  ) {}\n\n  async run(): Promise<CommandResult<RenameContactProof, ContactsErrorCodes>> {\n    const payload = this.buildPayload(this.args);\n\n    const result = (await sendFramedContactsPayload(this.api, {\n      payload,\n      p1: RENAME_CONTACT_P1,\n      makeCommand: (chunk, p2) => new RenameContactCommand({ data: chunk, p2 }),\n      logger: this.args.logger,\n      commandTag: \"SendRenameContactTask\",\n    })) as CommandResult<\n      { readonly hmacProof?: Uint8Array },\n      ContactsErrorCodes\n    >;\n\n    if (!isSuccessCommandResult(result)) {\n      return result;\n    }\n\n    const { hmacProof } = result.data;\n    if (!hmacProof) {\n      return DmkResultFactory({\n        error: new InvalidStatusWordError(\n          \"RenameContact final-chunk response did not carry hmac_name\",\n        ),\n      });\n    }\n    return DmkResultFactory({ data: { hmacProof } });\n  }\n\n  private buildPayload(args: SendRenameContactTaskArgs): Uint8Array {\n    const builder = new ByteArrayBuilder();\n    encodeTlvUInt8(\n      builder,\n      CONTACTS_TLV_TAG.STRUCT_TYPE,\n      STRUCT_TYPE_EDIT_CONTACT_NAME,\n    );\n    encodeTlvUInt8(\n      builder,\n      CONTACTS_TLV_TAG.STRUCT_VERSION,\n      STRUCT_VERSION_VALUE,\n    );\n    encodeTlvAscii(builder, CONTACTS_TLV_TAG.CONTACT_NAME, args.newContactName);\n    encodeTlvAscii(\n      builder,\n      CONTACTS_TLV_TAG.PREVIOUS_CONTACT_NAME,\n      args.previousContactName,\n    );\n    encodeTlvBuffer(builder, CONTACTS_TLV_TAG.GROUP_HANDLE, args.groupHandle);\n    // TEMPORARY (DSDK-1481): OS builds below the model's cutoff still mandate\n    // DERIVATION_PATH for EDIT CONTACT NAME (0x686A without it); newer builds\n    // reject it (0x6A80). The caller sets includeDerivationPath from the fresh\n    // device OS version. Fixed m/44'/60'/0'/0/0 \u2014 rename is name-only, the path\n    // is a payload-shape formality the old OS parser requires.\n    if (args.includeDerivationPath) {\n      encodeTlvBuffer(\n        builder,\n        CONTACTS_TLV_TAG.DERIVATION_PATH,\n        packDerivationPath([0x8000002c, 0x8000003c, 0x80000000, 0, 0]),\n      );\n    }\n    encodeTlvBuffer(builder, CONTACTS_TLV_TAG.HMAC_PROOF, args.hmacProof);\n\n    return builder.build();\n  }\n}\n"],
+  "mappings": "AA4BA,OACE,oBAAAA,EAEA,oBAAAC,EAEA,0BAAAC,EACA,0BAAAC,MAEK,kCAEP,OAAS,wBAAAC,MAA4B,oDACrC,OAAS,qBAAAC,MAAyB,+CAElC,OACE,oBAAAC,EACA,kBAAAC,EACA,mBAAAC,EACA,kBAAAC,EACA,sBAAAC,EACA,iCAAAC,EACA,wBAAAC,MACK,sDACP,OAAS,6BAAAC,MAAiC,0DAsBnC,MAAMC,CAAsB,CACjC,YACmBC,EACAC,EACjB,CAFiB,SAAAD,EACA,UAAAC,CAChB,CAEH,MAAM,KAAsE,CAC1E,MAAMC,EAAU,KAAK,aAAa,KAAK,IAAI,EAErCC,EAAU,MAAML,EAA0B,KAAK,IAAK,CACxD,QAAAI,EACA,GAAIZ,EACJ,YAAa,CAACc,EAAOC,IAAO,IAAIhB,EAAqB,CAAE,KAAMe,EAAO,GAAAC,CAAG,CAAC,EACxE,OAAQ,KAAK,KAAK,OAClB,WAAY,uBACd,CAAC,EAKD,GAAI,CAACjB,EAAuBe,CAAM,EAChC,OAAOA,EAGT,KAAM,CAAE,UAAAG,CAAU,EAAIH,EAAO,KAC7B,OAAKG,EAOEpB,EAAiB,CAAE,KAAM,CAAE,UAAAoB,CAAU,CAAE,CAAC,EANtCpB,EAAiB,CACtB,MAAO,IAAIC,EACT,4DACF,CACF,CAAC,CAGL,CAEQ,aAAac,EAA6C,CAChE,MAAMM,EAAU,IAAItB,EACpB,OAAAS,EACEa,EACAhB,EAAiB,YACjBK,CACF,EACAF,EACEa,EACAhB,EAAiB,eACjBM,CACF,EACAL,EAAee,EAAShB,EAAiB,aAAcU,EAAK,cAAc,EAC1ET,EACEe,EACAhB,EAAiB,sBACjBU,EAAK,mBACP,EACAR,EAAgBc,EAAShB,EAAiB,aAAcU,EAAK,WAAW,EAMpEA,EAAK,uBACPR,EACEc,EACAhB,EAAiB,gBACjBI,EAAmB,CAAC,WAAY,WAAY,WAAY,EAAG,CAAC,CAAC,CAC/D,EAEFF,EAAgBc,EAAShB,EAAiB,WAAYU,EAAK,SAAS,EAE7DM,EAAQ,MAAM,CACvB,CACF",
   "names": ["ByteArrayBuilder", "DmkResultFactory", "InvalidStatusWordError", "isSuccessCommandResult", "RenameContactCommand", "RENAME_CONTACT_P1", "CONTACTS_TLV_TAG", "encodeTlvAscii", "encodeTlvBuffer", "encodeTlvUInt8", "packDerivationPath", "STRUCT_TYPE_EDIT_CONTACT_NAME", "STRUCT_VERSION_VALUE", "sendFramedContactsPayload", "SendRenameContactTask", "api", "args", "payload", "result", "chunk", "p2", "hmacProof", "builder"]
 }

package/lib/esm/internal/app-binder/task/SendRenameContactTask.test.js CHANGED Viewed

@@ -1,2 +1,2 @@
-import{CommandResultFactory as t,InvalidStatusWordError as d}from"@ledgerhq/device-management-kit";import{RenameContactCommand as p}from"../../app-binder/command/RenameContactCommand";import{SendRenameContactTask as o}from"./SendRenameContactTask";function s(e){const n=new Uint8Array(e.length/2);for(let a=0;a<e.length;a+=2)n[a/2]=parseInt(e.slice(a,a+2),16);return n}const r=s("cc".repeat(64)),c=s("dd".repeat(32)),i=s("ee".repeat(32)),l="6915058000002c8000003c800000000000000000000000",u=s("009001012e02010181f003426f6281f305416c69636581f640"+"cc".repeat(64)+l+"2920"+"dd".repeat(32));function m(){return{sendCommand:vi.fn()}}describe("SendRenameContactTask",()=>{it("assembles the rename framed chunk and dispatches RenameContactCommand",async()=>{const e=m();e.sendCommand.mockResolvedValueOnce(t({data:{hmacProof:i}}));const n=await new o(e,{previousContactName:"Alice",newContactName:"Bob",groupHandle:r,hmacProof:c}).run();expect(e.sendCommand.mock.calls).toHaveLength(1),expect(e.sendCommand.mock.calls[0][0]).toStrictEqual(new p({data:u,p2:0})),expect(n).toStrictEqual(t({data:{hmacProof:i}}))}),it("emits the DERIVATION_PATH tag immediately before HMAC_PROOF",async()=>{const e=m();e.sendCommand.mockResolvedValueOnce(t({data:{hmacProof:i}})),await new o(e,{previousContactName:"Alice",newContactName:"Bob",groupHandle:r,hmacProof:c}).run();const n=e.sendCommand.mock.calls[0][0],a=Buffer.from(n.args.data).toString("hex");expect(a.endsWith(l+"2920"+"dd".repeat(32))).toBe(!0)}),it("propagates command-level errors",async()=>{const e=m();e.sendCommand.mockResolvedValueOnce(t({error:new d("user cancelled")}));const n=await new o(e,{previousContactName:"Alice",newContactName:"Bob",groupHandle:r,hmacProof:c}).run();expect(n).toStrictEqual(t({error:new d("user cancelled")}))}),it("returns InvalidStatusWordError when the final response carries no hmac_name",async()=>{const e=m();e.sendCommand.mockResolvedValueOnce(t({data:{}}));const n=await new o(e,{previousContactName:"Alice",newContactName:"Bob",groupHandle:r,hmacProof:c}).run();expect(n.status).not.toBe(void 0),"error"in n&&expect(n.error).toBeInstanceOf(d)})});
+import{CommandResultFactory as n,InvalidStatusWordError as i}from"@ledgerhq/device-management-kit";import{RenameContactCommand as l}from"../../app-binder/command/RenameContactCommand";import{SendRenameContactTask as o}from"./SendRenameContactTask";function s(e){const a=new Uint8Array(e.length/2);for(let t=0;t<e.length;t+=2)a[t/2]=parseInt(e.slice(t,t+2),16);return a}const c=s("cc".repeat(64)),r=s("dd".repeat(32)),d=s("ee".repeat(32)),u=s("007901012e02010181f003426f6281f305416c69636581f640"+"cc".repeat(64)+"2920"+"dd".repeat(32));function m(){return{sendCommand:vi.fn()}}describe("SendRenameContactTask",()=>{it("assembles the rename framed chunk and dispatches RenameContactCommand",async()=>{const e=m();e.sendCommand.mockResolvedValueOnce(n({data:{hmacProof:d}}));const a=await new o(e,{previousContactName:"Alice",newContactName:"Bob",groupHandle:c,hmacProof:r}).run();expect(e.sendCommand.mock.calls).toHaveLength(1),expect(e.sendCommand.mock.calls[0][0]).toStrictEqual(new l({data:u,p2:0})),expect(a).toStrictEqual(n({data:{hmacProof:d}}))}),it("does not emit a DERIVATION_PATH tag by default",async()=>{const e=m();e.sendCommand.mockResolvedValueOnce(n({data:{hmacProof:d}})),await new o(e,{previousContactName:"Alice",newContactName:"Bob",groupHandle:c,hmacProof:r}).run();const a=e.sendCommand.mock.calls[0][0],t=Buffer.from(a.args.data).toString("hex");expect(t).not.toContain("6915"),expect(t.endsWith("81f640"+"cc".repeat(64)+"2920"+"dd".repeat(32))).toBe(!0)}),it("emits the DERIVATION_PATH tag when includeDerivationPath is set",async()=>{const e=m();e.sendCommand.mockResolvedValueOnce(n({data:{hmacProof:d}})),await new o(e,{previousContactName:"Alice",newContactName:"Bob",groupHandle:c,hmacProof:r,includeDerivationPath:!0}).run();const t=s("009001012e02010181f003426f6281f305416c69636581f640"+"cc".repeat(64)+"6915058000002c8000003c800000000000000000000000"+"2920"+"dd".repeat(32)),p=e.sendCommand.mock.calls[0][0];expect(p).toStrictEqual(new l({data:t,p2:0}))}),it("propagates command-level errors",async()=>{const e=m();e.sendCommand.mockResolvedValueOnce(n({error:new i("user cancelled")}));const a=await new o(e,{previousContactName:"Alice",newContactName:"Bob",groupHandle:c,hmacProof:r}).run();expect(a).toStrictEqual(n({error:new i("user cancelled")}))}),it("returns InvalidStatusWordError when the final response carries no hmac_name",async()=>{const e=m();e.sendCommand.mockResolvedValueOnce(n({data:{}}));const a=await new o(e,{previousContactName:"Alice",newContactName:"Bob",groupHandle:c,hmacProof:r}).run();expect(a.status).not.toBe(void 0),"error"in a&&expect(a.error).toBeInstanceOf(i)})});
 //# sourceMappingURL=SendRenameContactTask.test.js.map