@ledgerhq/device-contacts-kit 0.0.0-develop-20260831001535 → 0.0.0-develop-20260901001631

package/lib/esm/internal/app-binder/command/EditExternalAddressScopeCommand.test.js

@@ -0,0 +1,2 @@
+import{CommandResultStatus as a}from"@ledgerhq/device-management-kit";import{CONTACT_SEED_MISMATCH_ERROR_CODE as m,ContactsCommandError as n}from"../../app-binder/model/contactsErrors";import{EditExternalAddressScopeCommand as o}from"./EditExternalAddressScopeCommand";function d(e){const t=new Uint8Array(e.length/2);for(let r=0;r<e.length;r+=2)t[r/2]=parseInt(e.slice(r,r+2),16);return t}const p=d("88".repeat(32)),c="32"+"88".repeat(32);function s(e){return{data:Buffer.from(d(e)),statusCode:Buffer.from([144,0])}}describe("EditExternalAddressScopeCommand",()=>{describe("getApdu",()=>{it("wraps the framed chunk under B0 10 04 with P2=0x00 for the first/only chunk",()=>{const e=Uint8Array.from([0,3,170,187,204]),t=new o({data:e,p2:0}).getApdu();expect(t.getRawApdu()).toStrictEqual(Uint8Array.from([176,16,4,0,5,0,3,170,187,204]))}),it("uses P2=0x80 for continuation chunks",()=>{const e=Uint8Array.from([170,187]),t=new o({data:e,p2:128}).getApdu();expect(t.getRawApdu()).toStrictEqual(Uint8Array.from([176,16,4,128,2,170,187]))})}),describe("parseResponse",()=>{it("returns an empty payload for an intermediate chunk (SW=0x9000, no data)",()=>{const e=new o({data:new Uint8Array,p2:0}).parseResponse({data:Buffer.from([]),statusCode:Buffer.from([144,0])});expect(e).toStrictEqual({status:a.Success,data:{}})}),it("extracts the rotated hmac_rest from the final-chunk response",()=>{const t=new o({data:new Uint8Array,p2:0}).parseResponse(s(c));expect(t).toStrictEqual({status:a.Success,data:{hmacRest:p}})}),it("returns InvalidStatusWordError when struct_type is wrong",()=>{const e="ee"+c.slice(2),r=new o({data:new Uint8Array,p2:0}).parseResponse(s(e));expect(r.status).toBe(a.Error)}),it("returns InvalidStatusWordError when hmac_rest is truncated",()=>{const e="32"+"88".repeat(16),r=new o({data:new Uint8Array,p2:0}).parseResponse(s(e));expect(r.status).toBe(a.Error)}),it("maps a known SW (0x6985) to a ContactsCommandError",()=>{const t=new o({data:new Uint8Array,p2:0}).parseResponse({data:Buffer.from([]),statusCode:Buffer.from([105,133])});expect(t.status).toBe(a.Error),t.status===a.Error&&(expect(t.error).toBeInstanceOf(n),expect(t.error.errorCode).toBe("6985"))}),it("maps SW=0x6982 to a seed-mismatch ContactsCommandError",()=>{const t=new o({data:new Uint8Array,p2:0}).parseResponse({data:Buffer.from([]),statusCode:Buffer.from([105,130])});expect(t.status).toBe(a.Error),t.status===a.Error&&(expect(t.error).toBeInstanceOf(n),expect(t.error.errorCode).toBe(m))})})});
+//# sourceMappingURL=EditExternalAddressScopeCommand.test.js.map

package/lib/esm/internal/app-binder/command/EditExternalAddressScopeCommand.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/internal/app-binder/command/EditExternalAddressScopeCommand.test.ts"],
+  "sourcesContent": ["// Thin chunk-framer: wraps a pre-framed chunk under B0 10 04 <P2> and parses\n// the 33-byte edit response (struct_type 0x32 + hmac_rest) on the final chunk.\n// TLV byte-parity is asserted in SendEditExternalAddressScopeTask.test.ts.\nimport {\n  type ApduResponse,\n  CommandResultStatus,\n} from \"@ledgerhq/device-management-kit\";\n\nimport {\n  CONTACT_SEED_MISMATCH_ERROR_CODE,\n  ContactsCommandError,\n} from \"@internal/app-binder/model/contactsErrors\";\n\nimport { EditExternalAddressScopeCommand } from \"./EditExternalAddressScopeCommand\";\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// Device response: struct_type(0x32) + rotated hmac_rest(32).\nconst HMAC_REST = hexToBytes(\"88\".repeat(32));\nconst RESPONSE_HEX = \"32\" + \"88\".repeat(32);\n\nfunction makeResponse(hex: string): ApduResponse {\n  return {\n    data: Buffer.from(hexToBytes(hex)),\n    statusCode: Buffer.from([0x90, 0x00]),\n  };\n}\n\ndescribe(\"EditExternalAddressScopeCommand\", () => {\n  describe(\"getApdu\", () => {\n    it(\"wraps the framed chunk under B0 10 04 with P2=0x00 for the first/only chunk\", () => {\n      const data = Uint8Array.from([0x00, 0x03, 0xaa, 0xbb, 0xcc]);\n\n      const apdu = new EditExternalAddressScopeCommand({\n        data,\n        p2: 0x00,\n      }).getApdu();\n\n      expect(apdu.getRawApdu()).toStrictEqual(\n        Uint8Array.from([\n          0xb0, 0x10, 0x04, 0x00, 0x05, 0x00, 0x03, 0xaa, 0xbb, 0xcc,\n        ]),\n      );\n    });\n\n    it(\"uses P2=0x80 for continuation chunks\", () => {\n      const data = Uint8Array.from([0xaa, 0xbb]);\n\n      const apdu = new EditExternalAddressScopeCommand({\n        data,\n        p2: 0x80,\n      }).getApdu();\n\n      expect(apdu.getRawApdu()).toStrictEqual(\n        Uint8Array.from([0xb0, 0x10, 0x04, 0x80, 0x02, 0xaa, 0xbb]),\n      );\n    });\n  });\n\n  describe(\"parseResponse\", () => {\n    it(\"returns an empty payload for an intermediate chunk (SW=0x9000, no data)\", () => {\n      const result = new EditExternalAddressScopeCommand({\n        data: new Uint8Array(),\n        p2: 0x00,\n      }).parseResponse({\n        data: Buffer.from([]),\n        statusCode: Buffer.from([0x90, 0x00]),\n      });\n\n      expect(result).toStrictEqual({\n        status: CommandResultStatus.Success,\n        data: {},\n      });\n    });\n\n    it(\"extracts the rotated hmac_rest from the final-chunk response\", () => {\n      const command = new EditExternalAddressScopeCommand({\n        data: new Uint8Array(),\n        p2: 0x00,\n      });\n\n      const result = command.parseResponse(makeResponse(RESPONSE_HEX));\n\n      expect(result).toStrictEqual({\n        status: CommandResultStatus.Success,\n        data: { hmacRest: HMAC_REST },\n      });\n    });\n\n    it(\"returns InvalidStatusWordError when struct_type is wrong\", () => {\n      const wrongType = \"ee\" + RESPONSE_HEX.slice(2); // replace 0x32 with 0xee\n      const command = new EditExternalAddressScopeCommand({\n        data: new Uint8Array(),\n        p2: 0x00,\n      });\n\n      const result = command.parseResponse(makeResponse(wrongType));\n\n      expect(result.status).toBe(CommandResultStatus.Error);\n    });\n\n    it(\"returns InvalidStatusWordError when hmac_rest is truncated\", () => {\n      const truncated = \"32\" + \"88\".repeat(16); // only 16 of 32 bytes\n      const command = new EditExternalAddressScopeCommand({\n        data: new Uint8Array(),\n        p2: 0x00,\n      });\n\n      const result = command.parseResponse(makeResponse(truncated));\n\n      expect(result.status).toBe(CommandResultStatus.Error);\n    });\n\n    it(\"maps a known SW (0x6985) to a ContactsCommandError\", () => {\n      const command = new EditExternalAddressScopeCommand({\n        data: new Uint8Array(),\n        p2: 0x00,\n      });\n\n      const result = command.parseResponse({\n        data: Buffer.from([]),\n        statusCode: Buffer.from([0x69, 0x85]),\n      });\n\n      expect(result.status).toBe(CommandResultStatus.Error);\n      if (result.status === CommandResultStatus.Error) {\n        expect(result.error).toBeInstanceOf(ContactsCommandError);\n        expect((result.error as ContactsCommandError).errorCode).toBe(\"6985\");\n      }\n    });\n\n    it(\"maps SW=0x6982 to a seed-mismatch ContactsCommandError\", () => {\n      // The device returns 0x6982 when the seed-bound HMAC / group-handle\n      // verification fails \u2014 i.e. the entry was registered with another seed.\n      const command = new EditExternalAddressScopeCommand({\n        data: new Uint8Array(),\n        p2: 0x00,\n      });\n\n      const result = command.parseResponse({\n        data: Buffer.from([]),\n        statusCode: Buffer.from([0x69, 0x82]),\n      });\n\n      expect(result.status).toBe(CommandResultStatus.Error);\n      if (result.status === CommandResultStatus.Error) {\n        expect(result.error).toBeInstanceOf(ContactsCommandError);\n        expect((result.error as ContactsCommandError).errorCode).toBe(\n          CONTACT_SEED_MISMATCH_ERROR_CODE,\n        );\n      }\n    });\n  });\n});\n"],
+  "mappings": "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",
+  "names": ["CommandResultStatus", "CONTACT_SEED_MISMATCH_ERROR_CODE", "ContactsCommandError", "EditExternalAddressScopeCommand", "hexToBytes", "hex", "out", "i", "HMAC_REST", "RESPONSE_HEX", "makeResponse", "data", "apdu", "result", "wrongType", "truncated"]
+}

package/lib/esm/internal/app-binder/device-action/EditExternalAddressIdentifier/EditExternalAddressIdentifierDeviceAction.js

@@ -0,0 +1,2 @@
+import{isSuccessCommandResult as c,OpenAppDeviceAction as u,UnknownDAError as l,UserInteractionRequired as s,WaitForAppAndVersionDeviceAction as A,XStateDeviceAction as E}from"@ledgerhq/device-management-kit";import{Left as I,Right as f}from"purify-ts";import{assign as n,fromPromise as m,setup as S}from"xstate";import{isContactsSupportedForSession as h}from"../../../app-binder/isContactsSupportedForSession";import{ContactsVersionRequirementError as g}from"../../../app-binder/model/contactsErrors";import{SendEditExternalAddressIdentifierTask as D}from"../../../app-binder/task/SendEditExternalAddressIdentifierTask";import{validateEditExternalAddressIdentifierInput as x}from"./validateEditExternalAddressIdentifierInput";class O extends E{makeStateMachine(d){const{isSupported:o,editIdentifier:p}=this.extractDependencies(d),r=this.input.appName;return S({types:{input:{},context:{},output:{}},actors:{openAppStateMachine:new u({input:{appName:r}}).makeStateMachine(d),waitForAppAndVersionStateMachine:new A({input:{}}).makeStateMachine(d),editIdentifier:m(({input:e})=>p(e))},guards:{skipOpenApp:({context:e})=>e.input.skipOpenApp===!0,noInternalError:({context:e})=>e._internalState.error===null,contactsSupported:({context:e})=>{const{appAndVersion:t}=e._internalState;return t!==null&&o(t)}},actions:{assignValidationError:n({_internalState:({context:e})=>{const t=x(e.input);return t?{...e._internalState,error:t}:e._internalState}}),assignVersionError:n({_internalState:({context:e})=>({...e._internalState,error:new g})}),assignErrorFromEvent:n({_internalState:({context:e,event:t})=>({...e._internalState,error:new l(t.error instanceof Error?t.error.message:String(t.error))})})}}).createMachine({id:"EditExternalAddressIdentifierDeviceAction",initial:"InitialState",context:({input:e})=>({input:e,intermediateValue:{requiredUserInteraction:s.None},_internalState:{error:null,appAndVersion:null,hmacRest:null}}),states:{InitialState:{always:[{target:"ValidateInput",guard:"skipOpenApp"},{target:"OpenAppDeviceAction"}]},OpenAppDeviceAction:{invoke:{id:"openAppStateMachine",src:"openAppStateMachine",input:()=>({appName:r}),onSnapshot:{actions:n({intermediateValue:({event:e})=>e.snapshot.context.intermediateValue})},onDone:{target:"CheckOpenAppResult",actions:n({_internalState:({event:e,context:t})=>e.output.caseOf({Right:()=>t._internalState,Left:i=>({...t._internalState,error:i})})})}}},CheckOpenAppResult:{always:[{target:"ValidateInput",guard:"noInternalError"},{target:"Error"}]},ValidateInput:{entry:"assignValidationError",always:[{target:"WaitForAppAndVersion",guard:"noInternalError"},{target:"Error"}]},WaitForAppAndVersion:{entry:n({intermediateValue:{requiredUserInteraction:s.None}}),invoke:{id:"waitForAppAndVersion",src:"waitForAppAndVersionStateMachine",input:()=>({}),onSnapshot:{actions:n({intermediateValue:({event:e})=>e.snapshot.context.intermediateValue})},onDone:{target:"CheckAppAndVersion",actions:n({_internalState:({event:e,context:t})=>e.output.caseOf({Right:i=>({...t._internalState,appAndVersion:{name:i.name,version:i.version}}),Left:i=>({...t._internalState,error:i})})})}}},CheckAppAndVersion:{always:[{target:"VersionGuard",guard:"noInternalError"},{target:"Error"}]},VersionGuard:{always:[{target:"EditIdentifier",guard:"contactsSupported"},{target:"Error",actions:"assignVersionError"}]},EditIdentifier:{entry:n({intermediateValue:{requiredUserInteraction:s.RegisterWallet}}),exit:n({intermediateValue:{requiredUserInteraction:s.None}}),invoke:{id:"editIdentifier",src:"editIdentifier",input:({context:e})=>e.input,onDone:{target:"EditIdentifierResultCheck",actions:n({_internalState:({event:e,context:t})=>c(e.output)?{...t._internalState,hmacRest:e.output.data.hmacRest}:{...t._internalState,error:e.output.error}})},onError:{target:"Error",actions:"assignErrorFromEvent"}}},EditIdentifierResultCheck:{always:[{target:"Success",guard:"noInternalError"},{target:"Error"}]},Success:{type:"final"},Error:{type:"final"}},output:({context:e})=>{const{hmacRest:t,error:i}=e._internalState;if(t){const{input:a}=e;return f({contactName:a.contactName,scope:a.scope,previousIdentifier:a.previousIdentifier,identifier:a.newIdentifier,blockchainFamily:a.blockchainFamily,chainId:a.chainId,groupHandle:a.groupHandle,hmacProof:a.hmacProof,hmacRest:t})}return I(i??new l("No error in final state"))}})}extractDependencies(d){return{isSupported:r=>h(d,r),editIdentifier:r=>new D(d,{contactName:r.contactName,scope:r.scope,previousIdentifier:r.previousIdentifier,newIdentifier:r.newIdentifier,blockchainFamily:r.blockchainFamily,chainId:r.chainId,groupHandle:r.groupHandle,hmacProof:r.hmacProof,hmacRest:r.hmacRest}).run()}}}export{O as EditExternalAddressIdentifierDeviceAction};
+//# sourceMappingURL=EditExternalAddressIdentifierDeviceAction.js.map

package/lib/esm/internal/app-binder/device-action/EditExternalAddressIdentifier/EditExternalAddressIdentifierDeviceAction.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/internal/app-binder/device-action/EditExternalAddressIdentifier/EditExternalAddressIdentifierDeviceAction.ts"],
+  "sourcesContent": ["import {\n  type DeviceActionStateMachine,\n  type InternalApi,\n  isSuccessCommandResult,\n  OpenAppDeviceAction,\n  type StateMachineTypes,\n  UnknownDAError,\n  UserInteractionRequired,\n  WaitForAppAndVersionDeviceAction,\n  XStateDeviceAction,\n} from \"@ledgerhq/device-management-kit\";\nimport { Left, Right } from \"purify-ts\";\nimport { assign, fromPromise, setup } from \"xstate\";\n\nimport {\n  type EditExternalAddressIdentifierDAError,\n  type EditExternalAddressIdentifierDAInput,\n  type EditExternalAddressIdentifierDAIntermediateValue,\n  type EditExternalAddressIdentifierDAInternalState,\n  type EditExternalAddressIdentifierDAOutput,\n} from \"@api/app-binder/EditExternalAddressIdentifierDeviceActionTypes\";\nimport {\n  isContactsSupportedForSession,\n  type RunningApp,\n} from \"@internal/app-binder/isContactsSupportedForSession\";\nimport { ContactsVersionRequirementError } from \"@internal/app-binder/model/contactsErrors\";\nimport {\n  type EditIdentifierProof,\n  SendEditExternalAddressIdentifierTask,\n} from \"@internal/app-binder/task/SendEditExternalAddressIdentifierTask\";\n\nimport { validateEditExternalAddressIdentifierInput } from \"./validateEditExternalAddressIdentifierInput\";\n\nexport type EditExternalAddressIdentifierMachineDependencies = {\n  readonly isSupported: (app: RunningApp) => boolean;\n  readonly editIdentifier: (\n    input: EditExternalAddressIdentifierDAInput,\n  ) => Promise<\n    Awaited<ReturnType<SendEditExternalAddressIdentifierTask[\"run\"]>>\n  >;\n};\n\nexport class EditExternalAddressIdentifierDeviceAction extends XStateDeviceAction<\n  EditExternalAddressIdentifierDAOutput,\n  EditExternalAddressIdentifierDAInput,\n  EditExternalAddressIdentifierDAError,\n  EditExternalAddressIdentifierDAIntermediateValue,\n  EditExternalAddressIdentifierDAInternalState\n> {\n  makeStateMachine(\n    internalApi: InternalApi,\n  ): DeviceActionStateMachine<\n    EditExternalAddressIdentifierDAOutput,\n    EditExternalAddressIdentifierDAInput,\n    EditExternalAddressIdentifierDAError,\n    EditExternalAddressIdentifierDAIntermediateValue,\n    EditExternalAddressIdentifierDAInternalState\n  > {\n    type types = StateMachineTypes<\n      EditExternalAddressIdentifierDAOutput,\n      EditExternalAddressIdentifierDAInput,\n      EditExternalAddressIdentifierDAError,\n      EditExternalAddressIdentifierDAIntermediateValue,\n      EditExternalAddressIdentifierDAInternalState\n    >;\n\n    const { isSupported, editIdentifier } =\n      this.extractDependencies(internalApi);\n    const appName = this.input.appName;\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        openAppStateMachine: new OpenAppDeviceAction({\n          input: { appName },\n        }).makeStateMachine(internalApi),\n        waitForAppAndVersionStateMachine: new WaitForAppAndVersionDeviceAction({\n          input: {},\n        }).makeStateMachine(internalApi),\n        editIdentifier: fromPromise(\n          ({ input }: { input: EditExternalAddressIdentifierDAInput }) =>\n            editIdentifier(input),\n        ),\n      },\n      guards: {\n        skipOpenApp: ({ context }) => context.input.skipOpenApp === true,\n        noInternalError: ({ context }) => context._internalState.error === null,\n        contactsSupported: ({ context }) => {\n          const { appAndVersion } = context._internalState;\n          return appAndVersion !== null && isSupported(appAndVersion);\n        },\n      },\n      actions: {\n        assignValidationError: assign({\n          _internalState: ({ context }) => {\n            const error = validateEditExternalAddressIdentifierInput(\n              context.input,\n            );\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: \"EditExternalAddressIdentifierDeviceAction\",\n      initial: \"InitialState\",\n      context: ({ input }) => ({\n        input,\n        intermediateValue: {\n          requiredUserInteraction: UserInteractionRequired.None,\n        },\n        _internalState: {\n          error: null,\n          appAndVersion: null,\n          hmacRest: null,\n        },\n      }),\n      states: {\n        InitialState: {\n          always: [\n            { target: \"ValidateInput\", guard: \"skipOpenApp\" },\n            { target: \"OpenAppDeviceAction\" },\n          ],\n        },\n        OpenAppDeviceAction: {\n          invoke: {\n            id: \"openAppStateMachine\",\n            src: \"openAppStateMachine\",\n            input: () => ({ appName }),\n            onSnapshot: {\n              actions: assign({\n                intermediateValue: ({ event }) =>\n                  event.snapshot.context.intermediateValue,\n              }),\n            },\n            onDone: {\n              target: \"CheckOpenAppResult\",\n              actions: assign({\n                _internalState: ({ event, context }) =>\n                  event.output.caseOf<EditExternalAddressIdentifierDAInternalState>(\n                    {\n                      Right: () => context._internalState,\n                      Left: (error) => ({ ...context._internalState, error }),\n                    },\n                  ),\n              }),\n            },\n          },\n        },\n        CheckOpenAppResult: {\n          always: [\n            { target: \"ValidateInput\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        // Input validation runs inside the device action (after the app is\n        // opened) so invalid caller input surfaces as a typed terminal error\n        // state on the observable instead of a synchronous throw. Runs on both\n        // the open-app and skip-open-app paths.\n        ValidateInput: {\n          entry: \"assignValidationError\",\n          always: [\n            { target: \"WaitForAppAndVersion\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        // Read the running app + version freshly from the device (rather than\n        // the possibly-stale session state) so the version guard evaluates the\n        // app that is actually running \u2014 e.g. when open-app is skipped and the\n        // app was changed outside DMK. Runs on both paths.\n        WaitForAppAndVersion: {\n          // Start the phase from a clean value, clearing any interaction left\n          // over from the OpenApp phase (e.g. ConfirmOpenApp).\n          entry: assign({\n            intermediateValue: {\n              requiredUserInteraction: UserInteractionRequired.None,\n            },\n          }),\n          invoke: {\n            id: \"waitForAppAndVersion\",\n            src: \"waitForAppAndVersionStateMachine\",\n            input: () => ({}),\n            // Propagate the child DA's intermediate value so a consuming client\n            // can render, e.g., a \"please unlock your device\" prompt when the\n            // device is locked. Mirrors the OpenAppDeviceAction invoke above.\n            onSnapshot: {\n              actions: assign({\n                intermediateValue: ({ event }) =>\n                  event.snapshot.context.intermediateValue,\n              }),\n            },\n            onDone: {\n              target: \"CheckAppAndVersion\",\n              actions: assign({\n                _internalState: ({ event, context }) =>\n                  event.output.caseOf<EditExternalAddressIdentifierDAInternalState>(\n                    {\n                      Right: (appAndVersion) => ({\n                        ...context._internalState,\n                        appAndVersion: {\n                          name: appAndVersion.name,\n                          version: appAndVersion.version,\n                        },\n                      }),\n                      Left: (error) => ({ ...context._internalState, error }),\n                    },\n                  ),\n              }),\n            },\n          },\n        },\n        CheckAppAndVersion: {\n          always: [\n            { target: \"VersionGuard\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        // Version guard evaluates support from the fresh WaitForAppAndVersion\n        // result. Runs on both the open-app and skip-open-app paths.\n        VersionGuard: {\n          always: [\n            { target: \"EditIdentifier\", guard: \"contactsSupported\" },\n            { target: \"Error\", actions: \"assignVersionError\" },\n          ],\n        },\n        EditIdentifier: {\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: \"editIdentifier\",\n            src: \"editIdentifier\",\n            input: ({ context }) => context.input,\n            onDone: {\n              target: \"EditIdentifierResultCheck\",\n              actions: assign({\n                _internalState: ({ event, context }) =>\n                  isSuccessCommandResult(event.output)\n                    ? {\n                        ...context._internalState,\n                        hmacRest: event.output.data.hmacRest,\n                      }\n                    : {\n                        ...context._internalState,\n                        error: event.output.error,\n                      },\n              }),\n            },\n            onError: {\n              target: \"Error\",\n              actions: \"assignErrorFromEvent\",\n            },\n          },\n        },\n        EditIdentifierResultCheck: {\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 { hmacRest, error } = context._internalState;\n        if (hmacRest) {\n          const { input } = context;\n          return Right({\n            contactName: input.contactName,\n            scope: input.scope,\n            previousIdentifier: input.previousIdentifier,\n            identifier: input.newIdentifier,\n            blockchainFamily: input.blockchainFamily,\n            chainId: input.chainId,\n            groupHandle: input.groupHandle,\n            // Preserved: the group-level name proof is untouched by an identifier\n            // edit \u2014 only `hmacRest` (the address-level proof) rotates.\n            hmacProof: input.hmacProof,\n            hmacRest,\n          });\n        }\n        return Left(error ?? new UnknownDAError(\"No error in final state\"));\n      },\n    });\n  }\n\n  extractDependencies(\n    internalApi: InternalApi,\n  ): EditExternalAddressIdentifierMachineDependencies {\n    const isSupported = (app: RunningApp) =>\n      isContactsSupportedForSession(internalApi, app);\n\n    const editIdentifier = (\n      input: EditExternalAddressIdentifierDAInput,\n    ): Promise<\n      Awaited<ReturnType<SendEditExternalAddressIdentifierTask[\"run\"]>>\n    > =>\n      new SendEditExternalAddressIdentifierTask(internalApi, {\n        contactName: input.contactName,\n        scope: input.scope,\n        previousIdentifier: input.previousIdentifier,\n        newIdentifier: input.newIdentifier,\n        blockchainFamily: input.blockchainFamily,\n        chainId: input.chainId,\n        groupHandle: input.groupHandle,\n        hmacProof: input.hmacProof,\n        hmacRest: input.hmacRest,\n      }).run();\n\n    return { isSupported, editIdentifier };\n  }\n}\n\nexport type { EditIdentifierProof };\n"],
+  "mappings": "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",
+  "names": ["isSuccessCommandResult", "OpenAppDeviceAction", "UnknownDAError", "UserInteractionRequired", "WaitForAppAndVersionDeviceAction", "XStateDeviceAction", "Left", "Right", "assign", "fromPromise", "setup", "isContactsSupportedForSession", "ContactsVersionRequirementError", "SendEditExternalAddressIdentifierTask", "validateEditExternalAddressIdentifierInput", "EditExternalAddressIdentifierDeviceAction", "internalApi", "isSupported", "editIdentifier", "appName", "input", "context", "appAndVersion", "error", "event", "hmacRest", "app"]
+}

package/lib/esm/internal/app-binder/device-action/EditExternalAddressIdentifier/EditExternalAddressIdentifierDeviceAction.test.js

@@ -0,0 +1,2 @@
+import{CommandResultFactory as V,DeviceActionStatus as e,DeviceModelId as S,DeviceSessionStateType as C,DeviceStatus as N,UnknownDAError as h,UserInteractionRequired as t}from"@ledgerhq/device-management-kit";import{beforeEach as q,describe as w,it as c,vi as A}from"vitest";import{makeDeviceActionInternalApiMock as T}from"../../../app-binder/device-action/__test-utils__/makeInternalApi";import{setupOpenAppDAMock as p}from"../../../app-binder/device-action/__test-utils__/setupOpenAppDAMock";import{setupWaitForAppAndVersionDAMock as D}from"../../../app-binder/device-action/__test-utils__/setupWaitForAppAndVersionDAMock";import{testDeviceActionStates as u}from"../../../app-binder/device-action/__test-utils__/testDeviceActionStates";import{ContactsCommandError as F,ContactsVersionRequirementError as H}from"../../../app-binder/model/contactsErrors";import{EditExternalAddressIdentifierDeviceAction as M}from"./EditExternalAddressIdentifierDeviceAction";import{validateEditExternalAddressIdentifierInput as P}from"./validateEditExternalAddressIdentifierInput";A.mock("@ledgerhq/device-management-kit",async o=>({...await o(),OpenAppDeviceAction:A.fn(()=>({makeStateMachine:A.fn()})),WaitForAppAndVersionDeviceAction:A.fn(()=>({makeStateMachine:A.fn()}))}));const g={name:"Ethereum",version:"1.15.0"},U=new Uint8Array(64).fill(204),v=new Uint8Array(32).fill(221),k=new Uint8Array(32).fill(170),x=new Uint8Array(32).fill(136),O=new Uint8Array(20).fill(17),R=new Uint8Array(20).fill(34),W={hmacRest:x},l={contactName:"Alice",scope:"Eth main",previousIdentifier:O,newIdentifier:R,blockchainFamily:"ethereum",chainId:1n,groupHandle:U,hmacProof:v,hmacRest:k,appName:"Ethereum"},I={contactName:"Alice",scope:"Eth main",previousIdentifier:O,identifier:R,blockchainFamily:"ethereum",chainId:1n,groupHandle:U,hmacProof:v,hmacRest:x};w("EditExternalAddressIdentifierDeviceAction",()=>{let o,E,m;function y(){return{isSupported:E,editIdentifier:m}}q(()=>{o=T(),D(g),E=A.fn().mockReturnValue(!0),m=A.fn().mockResolvedValue(V({data:W})),o.getDeviceSessionState.mockReturnValue({sessionStateType:C.ReadyWithoutSecureChannel,deviceStatus:N.CONNECTED,installedApps:[],currentApp:{name:"Ethereum",version:"1.15.0"},deviceModelId:S.FLEX,isSecureConnectionAllowed:!0})});function s(i){const n=new M({input:i});return A.spyOn(n,"extractDependencies").mockReturnValue(y()),n}c("open-app path: OpenApp -> VersionGuard -> EditIdentifier -> Completed",()=>new Promise((i,n)=>{p();const r=s({...l,skipOpenApp:!1}),a=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.ConfirmOpenApp},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.RegisterWallet},status:e.Pending},{output:I,status:e.Completed}];u(r,a,o,{onDone:i,onError:n})})),c("skip-open-app path: VersionGuard -> EditIdentifier -> Completed, preserving the group proof",()=>new Promise((i,n)=>{p();const r=s({...l,skipOpenApp:!0}),a=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.RegisterWallet},status:e.Pending},{output:I,status:e.Completed}];u(r,a,o,{onDone:()=>{try{expect(I.hmacProof).toBe(v),expect(I.hmacRest).toBe(x),expect(I.hmacRest).not.toBe(k),i()}catch(d){n(d)}},onError:n})})),c("version guard rejects on skip-open-app path without running EDIT IDENTIFIER",()=>new Promise((i,n)=>{p(),E.mockReturnValue(!1);const r=s({...l,skipOpenApp:!0}),a=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{error:new H,status:e.Error}];u(r,a,o,{onDone:i,onError:n}),expect(m).not.toHaveBeenCalled()})),c("surfaces an open-app failure as the device action error",()=>new Promise((i,n)=>{const r=new h("open app failed");p(r);const a=s({...l,skipOpenApp:!1}),d=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.ConfirmOpenApp},status:e.Pending},{error:r,status:e.Error}];u(a,d,o,{onDone:i,onError:n}),expect(E).not.toHaveBeenCalled()})),c("surfaces an Edit Identifier command error",()=>new Promise((i,n)=>{p();const r=new F({errorCode:"6982",message:"seed mismatch"});m.mockResolvedValue(V({error:r}));const a=s({...l,skipOpenApp:!0}),d=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.RegisterWallet},status:e.Pending},{error:r,status:e.Error}];u(a,d,o,{onDone:i,onError:n})})),c("surfaces invalid input as a typed error state on the skip-open-app path",()=>new Promise((i,n)=>{p();const r={...l,skipOpenApp:!0,contactName:""},a=P(r),d=s(r),f=[{error:a,status:e.Error}];u(d,f,o,{onDone:i,onError:n}),expect(E).not.toHaveBeenCalled(),expect(m).not.toHaveBeenCalled()})),c("validates only after opening the app on the default path",()=>new Promise((i,n)=>{p();const r={...l,skipOpenApp:!1,contactName:""},a=P(r),d=s(r),f=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.ConfirmOpenApp},status:e.Pending},{error:a,status:e.Error}];u(d,f,o,{onDone:i,onError:n}),expect(m).not.toHaveBeenCalled()})),c("evaluates support from the fresh WaitForAppAndVersion result, not stale session state",()=>new Promise((i,n)=>{p();const r={name:"Ethereum",version:"9.9.9"};D(r);const a=s({...l,skipOpenApp:!0}),d=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.RegisterWallet},status:e.Pending},{output:I,status:e.Completed}];u(a,d,o,{onDone:()=>{try{expect(E).toHaveBeenCalledWith(r),i()}catch(f){n(f)}},onError:n})})),c("surfaces a WaitForAppAndVersion failure as the device action error",()=>new Promise((i,n)=>{p();const r=new h("could not read app and version");D({error:r});const a=s({...l,skipOpenApp:!0}),d=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{error:r,status:e.Error}];u(a,d,o,{onDone:i,onError:n}),expect(E).not.toHaveBeenCalled(),expect(m).not.toHaveBeenCalled()})),c("propagates the UnlockDevice interaction emitted by WaitForAppAndVersion",()=>new Promise((i,n)=>{p(),D(g,t.UnlockDevice);const r=s({...l,skipOpenApp:!0}),a=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.UnlockDevice},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.RegisterWallet},status:e.Pending},{output:I,status:e.Completed}];u(r,a,o,{onDone:i,onError:n})}))});
+//# sourceMappingURL=EditExternalAddressIdentifierDeviceAction.test.js.map

package/lib/esm/internal/app-binder/device-action/EditExternalAddressIdentifier/EditExternalAddressIdentifierDeviceAction.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/internal/app-binder/device-action/EditExternalAddressIdentifier/EditExternalAddressIdentifierDeviceAction.test.ts"],
+  "sourcesContent": ["import {\n  CommandResultFactory,\n  type DeviceActionState,\n  DeviceActionStatus,\n  DeviceModelId,\n  DeviceSessionStateType,\n  DeviceStatus,\n  UnknownDAError,\n  UserInteractionRequired,\n} from \"@ledgerhq/device-management-kit\";\nimport { beforeEach, describe, it, vi } from \"vitest\";\n\nimport {\n  type EditExternalAddressIdentifierDAError,\n  type EditExternalAddressIdentifierDAInput,\n  type EditExternalAddressIdentifierDAIntermediateValue,\n  type EditExternalAddressIdentifierDAOutput,\n} from \"@api/app-binder/EditExternalAddressIdentifierDeviceActionTypes\";\nimport { makeDeviceActionInternalApiMock } from \"@internal/app-binder/device-action/__test-utils__/makeInternalApi\";\nimport { setupOpenAppDAMock } from \"@internal/app-binder/device-action/__test-utils__/setupOpenAppDAMock\";\nimport { setupWaitForAppAndVersionDAMock } from \"@internal/app-binder/device-action/__test-utils__/setupWaitForAppAndVersionDAMock\";\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 { EditExternalAddressIdentifierDeviceAction } from \"./EditExternalAddressIdentifierDeviceAction\";\nimport { validateEditExternalAddressIdentifierInput } from \"./validateEditExternalAddressIdentifierInput\";\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    OpenAppDeviceAction: vi.fn(() => ({\n      makeStateMachine: vi.fn(),\n    })),\n    WaitForAppAndVersionDeviceAction: vi.fn(() => ({\n      makeStateMachine: vi.fn(),\n    })),\n  };\n});\n\nconst FRESH_APP = { name: \"Ethereum\", version: \"1.15.0\" };\n\nconst GROUP_HANDLE = new Uint8Array(64).fill(0xcc);\nconst HMAC_PROOF = new Uint8Array(32).fill(0xdd);\nconst HMAC_REST_OLD = new Uint8Array(32).fill(0xaa);\nconst HMAC_REST_NEW = new Uint8Array(32).fill(0x88);\nconst PREVIOUS_IDENTIFIER = new Uint8Array(20).fill(0x11);\nconst NEW_IDENTIFIER = new Uint8Array(20).fill(0x22);\n\nconst OK_PROOF = { hmacRest: HMAC_REST_NEW };\n\nconst BASE_INPUT = {\n  contactName: \"Alice\",\n  scope: \"Eth main\",\n  previousIdentifier: PREVIOUS_IDENTIFIER,\n  newIdentifier: NEW_IDENTIFIER,\n  blockchainFamily: \"ethereum\",\n  chainId: 1n,\n  groupHandle: GROUP_HANDLE,\n  hmacProof: HMAC_PROOF,\n  hmacRest: HMAC_REST_OLD,\n  appName: \"Ethereum\",\n};\n\nconst EXPECTED_OUTPUT = {\n  contactName: \"Alice\",\n  scope: \"Eth main\",\n  previousIdentifier: PREVIOUS_IDENTIFIER,\n  identifier: NEW_IDENTIFIER,\n  blockchainFamily: \"ethereum\",\n  chainId: 1n,\n  groupHandle: GROUP_HANDLE,\n  // Preserved: the group-level name proof is unchanged by an identifier edit.\n  hmacProof: HMAC_PROOF,\n  // Rotated: only the address-level proof changes.\n  hmacRest: HMAC_REST_NEW,\n};\n\ndescribe(\"EditExternalAddressIdentifierDeviceAction\", () => {\n  let apiMock: ReturnType<typeof makeDeviceActionInternalApiMock>;\n  let isSupportedMock: ReturnType<typeof vi.fn>;\n  let editIdentifierMock: ReturnType<typeof vi.fn>;\n\n  function extractDeps() {\n    return {\n      isSupported: isSupportedMock,\n      editIdentifier: editIdentifierMock,\n    };\n  }\n\n  beforeEach(() => {\n    apiMock = makeDeviceActionInternalApiMock();\n    setupWaitForAppAndVersionDAMock(FRESH_APP);\n    isSupportedMock = vi.fn().mockReturnValue(true);\n    editIdentifierMock = 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: \"Ethereum\", version: \"1.15.0\" },\n      deviceModelId: DeviceModelId.FLEX,\n      isSecureConnectionAllowed: true,\n    });\n  });\n\n  function makeAction(input: EditExternalAddressIdentifierDAInput) {\n    const action = new EditExternalAddressIdentifierDeviceAction({ input });\n    vi.spyOn(action, \"extractDependencies\").mockReturnValue(extractDeps());\n    return action;\n  }\n\n  it(\"open-app path: OpenApp -> VersionGuard -> EditIdentifier -> Completed\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: false });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.ConfirmOpenApp,\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.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        EditExternalAddressIdentifierDAOutput,\n        EditExternalAddressIdentifierDAError,\n        EditExternalAddressIdentifierDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n    }));\n\n  it(\"skip-open-app path: VersionGuard -> EditIdentifier -> Completed, preserving the group proof\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: true });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\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        EditExternalAddressIdentifierDAOutput,\n        EditExternalAddressIdentifierDAError,\n        EditExternalAddressIdentifierDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: () => {\n          try {\n            // The device rotates only the address-level hmac_rest; the contact\n            // group's name proof passes through unchanged.\n            expect(EXPECTED_OUTPUT.hmacProof).toBe(HMAC_PROOF);\n            expect(EXPECTED_OUTPUT.hmacRest).toBe(HMAC_REST_NEW);\n            expect(EXPECTED_OUTPUT.hmacRest).not.toBe(HMAC_REST_OLD);\n            resolve();\n          } catch (e) {\n            reject(e as Error);\n          }\n        },\n        onError: reject,\n      });\n    }));\n\n  it(\"version guard rejects on skip-open-app path without running EDIT IDENTIFIER\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      isSupportedMock.mockReturnValue(false);\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: true });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\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        EditExternalAddressIdentifierDAOutput,\n        EditExternalAddressIdentifierDAError,\n        EditExternalAddressIdentifierDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n      expect(editIdentifierMock).not.toHaveBeenCalled();\n    }));\n\n  it(\"surfaces an open-app failure as the device action error\", () =>\n    new Promise<void>((resolve, reject) => {\n      const openAppError = new UnknownDAError(\"open app failed\");\n      setupOpenAppDAMock(openAppError);\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: false });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.ConfirmOpenApp,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: openAppError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        EditExternalAddressIdentifierDAOutput,\n        EditExternalAddressIdentifierDAError,\n        EditExternalAddressIdentifierDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n      expect(isSupportedMock).not.toHaveBeenCalled();\n    }));\n\n  it(\"surfaces an Edit Identifier command error\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const commandError = new ContactsCommandError({\n        errorCode: \"6982\",\n        message: \"seed mismatch\",\n      });\n      editIdentifierMock.mockResolvedValue(\n        CommandResultFactory({ error: commandError }),\n      );\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: true });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\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        EditExternalAddressIdentifierDAOutput,\n        EditExternalAddressIdentifierDAError,\n        EditExternalAddressIdentifierDAIntermediateValue\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 state on the skip-open-app path\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const invalidInput = {\n        ...BASE_INPUT,\n        skipOpenApp: true,\n        contactName: \"\",\n      };\n      const validationError =\n        validateEditExternalAddressIdentifierInput(invalidInput);\n      const action = makeAction(invalidInput);\n\n      const expected = [\n        {\n          error: validationError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        EditExternalAddressIdentifierDAOutput,\n        EditExternalAddressIdentifierDAError,\n        EditExternalAddressIdentifierDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n      expect(isSupportedMock).not.toHaveBeenCalled();\n      expect(editIdentifierMock).not.toHaveBeenCalled();\n    }));\n\n  it(\"validates only after opening the app on the default path\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const invalidInput = {\n        ...BASE_INPUT,\n        skipOpenApp: false,\n        contactName: \"\",\n      };\n      const validationError =\n        validateEditExternalAddressIdentifierInput(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.ConfirmOpenApp,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: validationError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        EditExternalAddressIdentifierDAOutput,\n        EditExternalAddressIdentifierDAError,\n        EditExternalAddressIdentifierDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n      expect(editIdentifierMock).not.toHaveBeenCalled();\n    }));\n\n  it(\"evaluates support from the fresh WaitForAppAndVersion result, not stale session state\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const freshApp = { name: \"Ethereum\", version: \"9.9.9\" };\n      setupWaitForAppAndVersionDAMock(freshApp);\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: true });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\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        EditExternalAddressIdentifierDAOutput,\n        EditExternalAddressIdentifierDAError,\n        EditExternalAddressIdentifierDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: () => {\n          try {\n            expect(isSupportedMock).toHaveBeenCalledWith(freshApp);\n            resolve();\n          } catch (e) {\n            reject(e as Error);\n          }\n        },\n        onError: reject,\n      });\n    }));\n\n  it(\"surfaces a WaitForAppAndVersion failure as the device action error\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const waitError = new UnknownDAError(\"could not read app and version\");\n      setupWaitForAppAndVersionDAMock({ error: waitError });\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: true });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: waitError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        EditExternalAddressIdentifierDAOutput,\n        EditExternalAddressIdentifierDAError,\n        EditExternalAddressIdentifierDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n      expect(isSupportedMock).not.toHaveBeenCalled();\n      expect(editIdentifierMock).not.toHaveBeenCalled();\n    }));\n\n  it(\"propagates the UnlockDevice interaction emitted by WaitForAppAndVersion\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      setupWaitForAppAndVersionDAMock(\n        FRESH_APP,\n        UserInteractionRequired.UnlockDevice,\n      );\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: true });\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        EditExternalAddressIdentifierDAOutput,\n        EditExternalAddressIdentifierDAError,\n        EditExternalAddressIdentifierDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n    }));\n});\n"],
+  "mappings": "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",
+  "names": ["CommandResultFactory", "DeviceActionStatus", "DeviceModelId", "DeviceSessionStateType", "DeviceStatus", "UnknownDAError", "UserInteractionRequired", "beforeEach", "describe", "it", "vi", "makeDeviceActionInternalApiMock", "setupOpenAppDAMock", "setupWaitForAppAndVersionDAMock", "testDeviceActionStates", "ContactsCommandError", "ContactsVersionRequirementError", "EditExternalAddressIdentifierDeviceAction", "validateEditExternalAddressIdentifierInput", "importOriginal", "FRESH_APP", "GROUP_HANDLE", "HMAC_PROOF", "HMAC_REST_OLD", "HMAC_REST_NEW", "PREVIOUS_IDENTIFIER", "NEW_IDENTIFIER", "OK_PROOF", "BASE_INPUT", "EXPECTED_OUTPUT", "apiMock", "isSupportedMock", "editIdentifierMock", "extractDeps", "makeAction", "input", "action", "resolve", "reject", "expected", "e", "openAppError", "commandError", "invalidInput", "validationError", "freshApp", "waitError"]
+}

package/lib/esm/internal/app-binder/device-action/EditExternalAddressIdentifier/validateEditExternalAddressIdentifierInput.js

@@ -0,0 +1,2 @@
+import{BLOCKCHAIN_FAMILY_BY_NAME as a}from"../../../app-binder/model/contactsConstants";import{CONTACT_NAME_BUFFER_LENGTH as f,ContactsValidationError as i,ETH_ADDRESS_BYTES as n,GROUP_HANDLE_SIZE as l,HMAC_PROOF_LENGTH as o,SCOPE_BUFFER_LENGTH as c,validateByteLength as r,validateChainId as s,validatePrintableLabel as d}from"../../../app-binder/model/contactsValidation";const h=o;function I(e){try{d(e.contactName,{field:"contactName",bufferLength:f}),d(e.scope,{field:"scope",bufferLength:c});const t=e.blockchainFamily.toLowerCase();if(!(t in a))throw new i(`Unsupported blockchain family: ${e.blockchainFamily}`);if(t==="ethereum"){if(r(e.previousIdentifier,{field:"previousIdentifier",expectedBytes:n}),r(e.newIdentifier,{field:"newIdentifier",expectedBytes:n}),e.chainId===void 0)throw new i("chainId is required for the Ethereum blockchain family.")}else{if(e.previousIdentifier.length===0)throw new i("previousIdentifier must not be empty.");if(e.newIdentifier.length===0)throw new i("newIdentifier must not be empty.")}return e.chainId!==void 0&&s(e.chainId),r(e.groupHandle,{field:"groupHandle",expectedBytes:l}),r(e.hmacProof,{field:"hmacProof",expectedBytes:o}),r(e.hmacRest,{field:"hmacRest",expectedBytes:h}),null}catch(t){if(t instanceof i)return t;throw t}}export{I as validateEditExternalAddressIdentifierInput};
+//# sourceMappingURL=validateEditExternalAddressIdentifierInput.js.map

package/lib/esm/internal/app-binder/device-action/EditExternalAddressIdentifier/validateEditExternalAddressIdentifierInput.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/internal/app-binder/device-action/EditExternalAddressIdentifier/validateEditExternalAddressIdentifierInput.ts"],
+  "sourcesContent": ["import { type EditExternalAddressIdentifierInput } from \"@api/model/EditExternalAddressIdentifier\";\nimport { BLOCKCHAIN_FAMILY_BY_NAME } from \"@internal/app-binder/model/contactsConstants\";\nimport {\n  CONTACT_NAME_BUFFER_LENGTH,\n  ContactsValidationError,\n  ETH_ADDRESS_BYTES,\n  GROUP_HANDLE_SIZE,\n  HMAC_PROOF_LENGTH,\n  SCOPE_BUFFER_LENGTH,\n  validateByteLength,\n  validateChainId,\n  validatePrintableLabel,\n} from \"@internal/app-binder/model/contactsValidation\";\n\n// The address-level proof (`hmac_rest`) shares the 32-byte HMAC width.\nconst HMAC_REST_LENGTH = HMAC_PROOF_LENGTH;\n\n/**\n * Validate the caller input for Edit External Address Identifier. Returns the\n * first `ContactsValidationError`, or `null` when valid. Non-throwing so the\n * device action can surface it as a typed terminal error state.\n */\nexport function validateEditExternalAddressIdentifierInput(\n  input: EditExternalAddressIdentifierInput,\n): ContactsValidationError | null {\n  try {\n    validatePrintableLabel(input.contactName, {\n      field: \"contactName\",\n      bufferLength: CONTACT_NAME_BUFFER_LENGTH,\n    });\n    validatePrintableLabel(input.scope, {\n      field: \"scope\",\n      bufferLength: SCOPE_BUFFER_LENGTH,\n    });\n\n    const family = input.blockchainFamily.toLowerCase();\n    if (!(family in BLOCKCHAIN_FAMILY_BY_NAME)) {\n      throw new ContactsValidationError(\n        `Unsupported blockchain family: ${input.blockchainFamily}`,\n      );\n    }\n    if (family === \"ethereum\") {\n      validateByteLength(input.previousIdentifier, {\n        field: \"previousIdentifier\",\n        expectedBytes: ETH_ADDRESS_BYTES,\n      });\n      validateByteLength(input.newIdentifier, {\n        field: \"newIdentifier\",\n        expectedBytes: ETH_ADDRESS_BYTES,\n      });\n      // CHAIN_ID is mandatory for the Ethereum family (multiple networks share\n      // the same address format).\n      if (input.chainId === undefined) {\n        throw new ContactsValidationError(\n          \"chainId is required for the Ethereum blockchain family.\",\n        );\n      }\n    } else {\n      if (input.previousIdentifier.length === 0) {\n        throw new ContactsValidationError(\n          \"previousIdentifier must not be empty.\",\n        );\n      }\n      if (input.newIdentifier.length === 0) {\n        throw new ContactsValidationError(\"newIdentifier must not be empty.\");\n      }\n    }\n\n    if (input.chainId !== undefined) {\n      validateChainId(input.chainId);\n    }\n\n    validateByteLength(input.groupHandle, {\n      field: \"groupHandle\",\n      expectedBytes: GROUP_HANDLE_SIZE,\n    });\n    validateByteLength(input.hmacProof, {\n      field: \"hmacProof\",\n      expectedBytes: HMAC_PROOF_LENGTH,\n    });\n    validateByteLength(input.hmacRest, {\n      field: \"hmacRest\",\n      expectedBytes: HMAC_REST_LENGTH,\n    });\n\n    return null;\n  } catch (error) {\n    if (error instanceof ContactsValidationError) {\n      return error;\n    }\n    throw error;\n  }\n}\n"],
+  "mappings": "AACA,OAAS,6BAAAA,MAAiC,+CAC1C,OACE,8BAAAC,EACA,2BAAAC,EACA,qBAAAC,EACA,qBAAAC,EACA,qBAAAC,EACA,uBAAAC,EACA,sBAAAC,EACA,mBAAAC,EACA,0BAAAC,MACK,gDAGP,MAAMC,EAAmBL,EAOlB,SAASM,EACdC,EACgC,CAChC,GAAI,CACFH,EAAuBG,EAAM,YAAa,CACxC,MAAO,cACP,aAAcX,CAChB,CAAC,EACDQ,EAAuBG,EAAM,MAAO,CAClC,MAAO,QACP,aAAcN,CAChB,CAAC,EAED,MAAMO,EAASD,EAAM,iBAAiB,YAAY,EAClD,GAAI,EAAEC,KAAUb,GACd,MAAM,IAAIE,EACR,kCAAkCU,EAAM,gBAAgB,EAC1D,EAEF,GAAIC,IAAW,YAWb,GAVAN,EAAmBK,EAAM,mBAAoB,CAC3C,MAAO,qBACP,cAAeT,CACjB,CAAC,EACDI,EAAmBK,EAAM,cAAe,CACtC,MAAO,gBACP,cAAeT,CACjB,CAAC,EAGGS,EAAM,UAAY,OACpB,MAAM,IAAIV,EACR,yDACF,MAEG,CACL,GAAIU,EAAM,mBAAmB,SAAW,EACtC,MAAM,IAAIV,EACR,uCACF,EAEF,GAAIU,EAAM,cAAc,SAAW,EACjC,MAAM,IAAIV,EAAwB,kCAAkC,CAExE,CAEA,OAAIU,EAAM,UAAY,QACpBJ,EAAgBI,EAAM,OAAO,EAG/BL,EAAmBK,EAAM,YAAa,CACpC,MAAO,cACP,cAAeR,CACjB,CAAC,EACDG,EAAmBK,EAAM,UAAW,CAClC,MAAO,YACP,cAAeP,CACjB,CAAC,EACDE,EAAmBK,EAAM,SAAU,CACjC,MAAO,WACP,cAAeF,CACjB,CAAC,EAEM,IACT,OAASI,EAAO,CACd,GAAIA,aAAiBZ,EACnB,OAAOY,EAET,MAAMA,CACR,CACF",
+  "names": ["BLOCKCHAIN_FAMILY_BY_NAME", "CONTACT_NAME_BUFFER_LENGTH", "ContactsValidationError", "ETH_ADDRESS_BYTES", "GROUP_HANDLE_SIZE", "HMAC_PROOF_LENGTH", "SCOPE_BUFFER_LENGTH", "validateByteLength", "validateChainId", "validatePrintableLabel", "HMAC_REST_LENGTH", "validateEditExternalAddressIdentifierInput", "input", "family", "error"]
+}

package/lib/esm/internal/app-binder/device-action/EditExternalAddressIdentifier/validateEditExternalAddressIdentifierInput.test.js

@@ -0,0 +1,2 @@
+import{ContactsValidationError as n}from"../../../app-binder/model/contactsValidation";import{validateEditExternalAddressIdentifierInput as t}from"./validateEditExternalAddressIdentifierInput";const r={contactName:"Alice",scope:"Eth main",previousIdentifier:new Uint8Array(20).fill(17),newIdentifier:new Uint8Array(20).fill(34),blockchainFamily:"ethereum",chainId:1n,groupHandle:new Uint8Array(64).fill(204),hmacProof:new Uint8Array(32).fill(221),hmacRest:new Uint8Array(32).fill(170)};describe("validateEditExternalAddressIdentifierInput",()=>{it("returns null for a valid input",()=>{expect(t(r)).toBeNull()}),it("rejects an empty contactName",()=>{const e=t({...r,contactName:""});expect(e).toBeInstanceOf(n)}),it("rejects a non-printable scope",()=>{const e=t({...r,scope:"caf\xE9"});expect(e).toBeInstanceOf(n)}),it("rejects an unsupported blockchain family",()=>{const e=t({...r,blockchainFamily:"dogecoin"});expect(e).toBeInstanceOf(n)}),it("rejects a previousIdentifier of the wrong length for Ethereum",()=>{const e=t({...r,previousIdentifier:new Uint8Array(19).fill(17)});expect(e).toBeInstanceOf(n)}),it("rejects a newIdentifier of the wrong length for Ethereum",()=>{const e=t({...r,newIdentifier:new Uint8Array(21).fill(34)});expect(e).toBeInstanceOf(n)}),it("requires chainId for the Ethereum family",()=>{const e=t({...r,chainId:void 0});expect(e).toBeInstanceOf(n)}),it("rejects a groupHandle of the wrong length",()=>{const e=t({...r,groupHandle:new Uint8Array(63).fill(204)});expect(e).toBeInstanceOf(n)}),it("rejects an hmacProof of the wrong length",()=>{const e=t({...r,hmacProof:new Uint8Array(31).fill(221)});expect(e).toBeInstanceOf(n)}),it("rejects an hmacRest of the wrong length",()=>{const e=t({...r,hmacRest:new Uint8Array(33).fill(170)});expect(e).toBeInstanceOf(n)})});
+//# sourceMappingURL=validateEditExternalAddressIdentifierInput.test.js.map

package/lib/esm/internal/app-binder/device-action/EditExternalAddressIdentifier/validateEditExternalAddressIdentifierInput.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/internal/app-binder/device-action/EditExternalAddressIdentifier/validateEditExternalAddressIdentifierInput.test.ts"],
+  "sourcesContent": ["import { type EditExternalAddressIdentifierInput } from \"@api/model/EditExternalAddressIdentifier\";\nimport { ContactsValidationError } from \"@internal/app-binder/model/contactsValidation\";\n\nimport { validateEditExternalAddressIdentifierInput } from \"./validateEditExternalAddressIdentifierInput\";\n\nconst VALID_INPUT: EditExternalAddressIdentifierInput = {\n  contactName: \"Alice\",\n  scope: \"Eth main\",\n  previousIdentifier: new Uint8Array(20).fill(0x11),\n  newIdentifier: new Uint8Array(20).fill(0x22),\n  blockchainFamily: \"ethereum\",\n  chainId: 1n,\n  groupHandle: new Uint8Array(64).fill(0xcc),\n  hmacProof: new Uint8Array(32).fill(0xdd),\n  hmacRest: new Uint8Array(32).fill(0xaa),\n};\n\ndescribe(\"validateEditExternalAddressIdentifierInput\", () => {\n  it(\"returns null for a valid input\", () => {\n    expect(validateEditExternalAddressIdentifierInput(VALID_INPUT)).toBeNull();\n  });\n\n  it(\"rejects an empty contactName\", () => {\n    const error = validateEditExternalAddressIdentifierInput({\n      ...VALID_INPUT,\n      contactName: \"\",\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects a non-printable scope\", () => {\n    const error = validateEditExternalAddressIdentifierInput({\n      ...VALID_INPUT,\n      scope: \"caf\u00E9\", // 0xC3 0xA9 is non-ASCII\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects an unsupported blockchain family\", () => {\n    const error = validateEditExternalAddressIdentifierInput({\n      ...VALID_INPUT,\n      blockchainFamily: \"dogecoin\",\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects a previousIdentifier of the wrong length for Ethereum\", () => {\n    const error = validateEditExternalAddressIdentifierInput({\n      ...VALID_INPUT,\n      previousIdentifier: new Uint8Array(19).fill(0x11),\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects a newIdentifier of the wrong length for Ethereum\", () => {\n    const error = validateEditExternalAddressIdentifierInput({\n      ...VALID_INPUT,\n      newIdentifier: new Uint8Array(21).fill(0x22),\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"requires chainId for the Ethereum family\", () => {\n    const error = validateEditExternalAddressIdentifierInput({\n      ...VALID_INPUT,\n      chainId: undefined,\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects a groupHandle of the wrong length\", () => {\n    const error = validateEditExternalAddressIdentifierInput({\n      ...VALID_INPUT,\n      groupHandle: new Uint8Array(63).fill(0xcc),\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects an hmacProof of the wrong length\", () => {\n    const error = validateEditExternalAddressIdentifierInput({\n      ...VALID_INPUT,\n      hmacProof: new Uint8Array(31).fill(0xdd),\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects an hmacRest of the wrong length\", () => {\n    const error = validateEditExternalAddressIdentifierInput({\n      ...VALID_INPUT,\n      hmacRest: new Uint8Array(33).fill(0xaa),\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n});\n"],
+  "mappings": "AACA,OAAS,2BAAAA,MAA+B,gDAExC,OAAS,8CAAAC,MAAkD,+CAE3D,MAAMC,EAAkD,CACtD,YAAa,QACb,MAAO,WACP,mBAAoB,IAAI,WAAW,EAAE,EAAE,KAAK,EAAI,EAChD,cAAe,IAAI,WAAW,EAAE,EAAE,KAAK,EAAI,EAC3C,iBAAkB,WAClB,QAAS,GACT,YAAa,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,EACzC,UAAW,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,EACvC,SAAU,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,CACxC,EAEA,SAAS,6CAA8C,IAAM,CAC3D,GAAG,iCAAkC,IAAM,CACzC,OAAOD,EAA2CC,CAAW,CAAC,EAAE,SAAS,CAC3E,CAAC,EAED,GAAG,+BAAgC,IAAM,CACvC,MAAMC,EAAQF,EAA2C,CACvD,GAAGC,EACH,YAAa,EACf,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,gCAAiC,IAAM,CACxC,MAAMG,EAAQF,EAA2C,CACvD,GAAGC,EACH,MAAO,SACT,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,2CAA4C,IAAM,CACnD,MAAMG,EAAQF,EAA2C,CACvD,GAAGC,EACH,iBAAkB,UACpB,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,gEAAiE,IAAM,CACxE,MAAMG,EAAQF,EAA2C,CACvD,GAAGC,EACH,mBAAoB,IAAI,WAAW,EAAE,EAAE,KAAK,EAAI,CAClD,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,2DAA4D,IAAM,CACnE,MAAMG,EAAQF,EAA2C,CACvD,GAAGC,EACH,cAAe,IAAI,WAAW,EAAE,EAAE,KAAK,EAAI,CAC7C,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,2CAA4C,IAAM,CACnD,MAAMG,EAAQF,EAA2C,CACvD,GAAGC,EACH,QAAS,MACX,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,4CAA6C,IAAM,CACpD,MAAMG,EAAQF,EAA2C,CACvD,GAAGC,EACH,YAAa,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,CAC3C,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,2CAA4C,IAAM,CACnD,MAAMG,EAAQF,EAA2C,CACvD,GAAGC,EACH,UAAW,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,CACzC,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,0CAA2C,IAAM,CAClD,MAAMG,EAAQF,EAA2C,CACvD,GAAGC,EACH,SAAU,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,CACxC,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,CACH,CAAC",
+  "names": ["ContactsValidationError", "validateEditExternalAddressIdentifierInput", "VALID_INPUT", "error"]
+}

package/lib/esm/internal/app-binder/device-action/EditExternalAddressScope/EditExternalAddressScopeDeviceAction.js

@@ -0,0 +1,2 @@
+import{isSuccessCommandResult as l,OpenAppDeviceAction as u,UnknownDAError as c,UserInteractionRequired as p,WaitForAppAndVersionDeviceAction as S,XStateDeviceAction as A}from"@ledgerhq/device-management-kit";import{Left as E,Right as m}from"purify-ts";import{assign as n,fromPromise as h,setup as g}from"xstate";import{isContactsSupportedForSession as D}from"../../../app-binder/isContactsSupportedForSession";import{ContactsVersionRequirementError as I}from"../../../app-binder/model/contactsErrors";import{SendEditExternalAddressScopeTask as x}from"../../../app-binder/task/SendEditExternalAddressScopeTask";import{validateEditExternalAddressScopeInput as y}from"./validateEditExternalAddressScopeInput";class O extends A{makeStateMachine(o){const{isSupported:s,editScope:d}=this.extractDependencies(o),r=this.input.appName;return g({types:{input:{},context:{},output:{}},actors:{openAppStateMachine:new u({input:{appName:r}}).makeStateMachine(o),waitForAppAndVersionStateMachine:new S({input:{}}).makeStateMachine(o),editScope:h(({input:e})=>d(e))},guards:{skipOpenApp:({context:e})=>e.input.skipOpenApp===!0,noInternalError:({context:e})=>e._internalState.error===null,contactsSupported:({context:e})=>{const{appAndVersion:t}=e._internalState;return t!==null&&s(t)}},actions:{assignValidationError:n({_internalState:({context:e})=>{const t=y(e.input);return t?{...e._internalState,error:t}:e._internalState}}),assignVersionError:n({_internalState:({context:e})=>({...e._internalState,error:new I})}),assignErrorFromEvent:n({_internalState:({context:e,event:t})=>({...e._internalState,error:new c(t.error instanceof Error?t.error.message:String(t.error))})})}}).createMachine({id:"EditExternalAddressScopeDeviceAction",initial:"InitialState",context:({input:e})=>({input:e,intermediateValue:{requiredUserInteraction:p.None},_internalState:{error:null,appAndVersion:null,hmacRest:null}}),states:{InitialState:{always:[{target:"ValidateInput",guard:"skipOpenApp"},{target:"OpenAppDeviceAction"}]},OpenAppDeviceAction:{invoke:{id:"openAppStateMachine",src:"openAppStateMachine",input:()=>({appName:r}),onSnapshot:{actions:n({intermediateValue:({event:e})=>e.snapshot.context.intermediateValue})},onDone:{target:"CheckOpenAppResult",actions:n({_internalState:({event:e,context:t})=>e.output.caseOf({Right:()=>t._internalState,Left:a=>({...t._internalState,error:a})})})}}},CheckOpenAppResult:{always:[{target:"ValidateInput",guard:"noInternalError"},{target:"Error"}]},ValidateInput:{entry:"assignValidationError",always:[{target:"WaitForAppAndVersion",guard:"noInternalError"},{target:"Error"}]},WaitForAppAndVersion:{entry:n({intermediateValue:{requiredUserInteraction:p.None}}),invoke:{id:"waitForAppAndVersion",src:"waitForAppAndVersionStateMachine",input:()=>({}),onSnapshot:{actions:n({intermediateValue:({event:e})=>e.snapshot.context.intermediateValue})},onDone:{target:"CheckAppAndVersion",actions:n({_internalState:({event:e,context:t})=>e.output.caseOf({Right:a=>({...t._internalState,appAndVersion:{name:a.name,version:a.version}}),Left:a=>({...t._internalState,error:a})})})}}},CheckAppAndVersion:{always:[{target:"VersionGuard",guard:"noInternalError"},{target:"Error"}]},VersionGuard:{always:[{target:"EditScope",guard:"contactsSupported"},{target:"Error",actions:"assignVersionError"}]},EditScope:{entry:n({intermediateValue:{requiredUserInteraction:p.RegisterWallet}}),exit:n({intermediateValue:{requiredUserInteraction:p.None}}),invoke:{id:"editScope",src:"editScope",input:({context:e})=>e.input,onDone:{target:"EditScopeResultCheck",actions:n({_internalState:({event:e,context:t})=>l(e.output)?{...t._internalState,hmacRest:e.output.data.hmacRest}:{...t._internalState,error:e.output.error}})},onError:{target:"Error",actions:"assignErrorFromEvent"}}},EditScopeResultCheck:{always:[{target:"Success",guard:"noInternalError"},{target:"Error"}]},Success:{type:"final"},Error:{type:"final"}},output:({context:e})=>{const{hmacRest:t,error:a}=e._internalState;if(t){const{input:i}=e;return m({contactName:i.contactName,previousScope:i.previousScope,scope:i.newScope,identifier:i.identifier,blockchainFamily:i.blockchainFamily,chainId:i.chainId,groupHandle:i.groupHandle,hmacProof:i.hmacProof,hmacRest:t})}return E(a??new c("No error in final state"))}})}extractDependencies(o){return{isSupported:r=>D(o,r),editScope:r=>new x(o,{contactName:r.contactName,previousScope:r.previousScope,newScope:r.newScope,identifier:r.identifier,blockchainFamily:r.blockchainFamily,chainId:r.chainId,groupHandle:r.groupHandle,hmacProof:r.hmacProof,hmacRest:r.hmacRest}).run()}}}export{O as EditExternalAddressScopeDeviceAction};
+//# sourceMappingURL=EditExternalAddressScopeDeviceAction.js.map

package/lib/esm/internal/app-binder/device-action/EditExternalAddressScope/EditExternalAddressScopeDeviceAction.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/internal/app-binder/device-action/EditExternalAddressScope/EditExternalAddressScopeDeviceAction.ts"],
+  "sourcesContent": ["import {\n  type DeviceActionStateMachine,\n  type InternalApi,\n  isSuccessCommandResult,\n  OpenAppDeviceAction,\n  type StateMachineTypes,\n  UnknownDAError,\n  UserInteractionRequired,\n  WaitForAppAndVersionDeviceAction,\n  XStateDeviceAction,\n} from \"@ledgerhq/device-management-kit\";\nimport { Left, Right } from \"purify-ts\";\nimport { assign, fromPromise, setup } from \"xstate\";\n\nimport {\n  type EditExternalAddressScopeDAError,\n  type EditExternalAddressScopeDAInput,\n  type EditExternalAddressScopeDAIntermediateValue,\n  type EditExternalAddressScopeDAInternalState,\n  type EditExternalAddressScopeDAOutput,\n} from \"@api/app-binder/EditExternalAddressScopeDeviceActionTypes\";\nimport {\n  isContactsSupportedForSession,\n  type RunningApp,\n} from \"@internal/app-binder/isContactsSupportedForSession\";\nimport { ContactsVersionRequirementError } from \"@internal/app-binder/model/contactsErrors\";\nimport {\n  type EditScopeProof,\n  SendEditExternalAddressScopeTask,\n} from \"@internal/app-binder/task/SendEditExternalAddressScopeTask\";\n\nimport { validateEditExternalAddressScopeInput } from \"./validateEditExternalAddressScopeInput\";\n\nexport type EditExternalAddressScopeMachineDependencies = {\n  readonly isSupported: (app: RunningApp) => boolean;\n  readonly editScope: (\n    input: EditExternalAddressScopeDAInput,\n  ) => Promise<Awaited<ReturnType<SendEditExternalAddressScopeTask[\"run\"]>>>;\n};\n\nexport class EditExternalAddressScopeDeviceAction extends XStateDeviceAction<\n  EditExternalAddressScopeDAOutput,\n  EditExternalAddressScopeDAInput,\n  EditExternalAddressScopeDAError,\n  EditExternalAddressScopeDAIntermediateValue,\n  EditExternalAddressScopeDAInternalState\n> {\n  makeStateMachine(\n    internalApi: InternalApi,\n  ): DeviceActionStateMachine<\n    EditExternalAddressScopeDAOutput,\n    EditExternalAddressScopeDAInput,\n    EditExternalAddressScopeDAError,\n    EditExternalAddressScopeDAIntermediateValue,\n    EditExternalAddressScopeDAInternalState\n  > {\n    type types = StateMachineTypes<\n      EditExternalAddressScopeDAOutput,\n      EditExternalAddressScopeDAInput,\n      EditExternalAddressScopeDAError,\n      EditExternalAddressScopeDAIntermediateValue,\n      EditExternalAddressScopeDAInternalState\n    >;\n\n    const { isSupported, editScope } = this.extractDependencies(internalApi);\n    const appName = this.input.appName;\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        openAppStateMachine: new OpenAppDeviceAction({\n          input: { appName },\n        }).makeStateMachine(internalApi),\n        waitForAppAndVersionStateMachine: new WaitForAppAndVersionDeviceAction({\n          input: {},\n        }).makeStateMachine(internalApi),\n        editScope: fromPromise(\n          ({ input }: { input: EditExternalAddressScopeDAInput }) =>\n            editScope(input),\n        ),\n      },\n      guards: {\n        skipOpenApp: ({ context }) => context.input.skipOpenApp === true,\n        noInternalError: ({ context }) => context._internalState.error === null,\n        contactsSupported: ({ context }) => {\n          const { appAndVersion } = context._internalState;\n          return appAndVersion !== null && isSupported(appAndVersion);\n        },\n      },\n      actions: {\n        assignValidationError: assign({\n          _internalState: ({ context }) => {\n            const error = validateEditExternalAddressScopeInput(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: \"EditExternalAddressScopeDeviceAction\",\n      initial: \"InitialState\",\n      context: ({ input }) => ({\n        input,\n        intermediateValue: {\n          requiredUserInteraction: UserInteractionRequired.None,\n        },\n        _internalState: {\n          error: null,\n          appAndVersion: null,\n          hmacRest: null,\n        },\n      }),\n      states: {\n        InitialState: {\n          always: [\n            { target: \"ValidateInput\", guard: \"skipOpenApp\" },\n            { target: \"OpenAppDeviceAction\" },\n          ],\n        },\n        OpenAppDeviceAction: {\n          invoke: {\n            id: \"openAppStateMachine\",\n            src: \"openAppStateMachine\",\n            input: () => ({ appName }),\n            onSnapshot: {\n              actions: assign({\n                intermediateValue: ({ event }) =>\n                  event.snapshot.context.intermediateValue,\n              }),\n            },\n            onDone: {\n              target: \"CheckOpenAppResult\",\n              actions: assign({\n                _internalState: ({ event, context }) =>\n                  event.output.caseOf<EditExternalAddressScopeDAInternalState>({\n                    Right: () => context._internalState,\n                    Left: (error) => ({ ...context._internalState, error }),\n                  }),\n              }),\n            },\n          },\n        },\n        CheckOpenAppResult: {\n          always: [\n            { target: \"ValidateInput\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        // Input validation runs inside the device action (after the app is\n        // opened) so invalid caller input surfaces as a typed terminal error\n        // state on the observable instead of a synchronous throw. Runs on both\n        // the open-app and skip-open-app paths.\n        ValidateInput: {\n          entry: \"assignValidationError\",\n          always: [\n            { target: \"WaitForAppAndVersion\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        // Read the running app + version freshly from the device (rather than\n        // the possibly-stale session state) so the version guard evaluates the\n        // app that is actually running \u2014 e.g. when open-app is skipped and the\n        // app was changed outside DMK. Runs on both paths.\n        WaitForAppAndVersion: {\n          // Start the phase from a clean value, clearing any interaction left\n          // over from the OpenApp phase (e.g. ConfirmOpenApp).\n          entry: assign({\n            intermediateValue: {\n              requiredUserInteraction: UserInteractionRequired.None,\n            },\n          }),\n          invoke: {\n            id: \"waitForAppAndVersion\",\n            src: \"waitForAppAndVersionStateMachine\",\n            input: () => ({}),\n            // Propagate the child DA's intermediate value so a consuming client\n            // can render, e.g., a \"please unlock your device\" prompt when the\n            // device is locked. Mirrors the OpenAppDeviceAction invoke above.\n            onSnapshot: {\n              actions: assign({\n                intermediateValue: ({ event }) =>\n                  event.snapshot.context.intermediateValue,\n              }),\n            },\n            onDone: {\n              target: \"CheckAppAndVersion\",\n              actions: assign({\n                _internalState: ({ event, context }) =>\n                  event.output.caseOf<EditExternalAddressScopeDAInternalState>({\n                    Right: (appAndVersion) => ({\n                      ...context._internalState,\n                      appAndVersion: {\n                        name: appAndVersion.name,\n                        version: appAndVersion.version,\n                      },\n                    }),\n                    Left: (error) => ({ ...context._internalState, error }),\n                  }),\n              }),\n            },\n          },\n        },\n        CheckAppAndVersion: {\n          always: [\n            { target: \"VersionGuard\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        // Version guard evaluates support from the fresh WaitForAppAndVersion\n        // result. Runs on both the open-app and skip-open-app paths.\n        VersionGuard: {\n          always: [\n            { target: \"EditScope\", guard: \"contactsSupported\" },\n            { target: \"Error\", actions: \"assignVersionError\" },\n          ],\n        },\n        EditScope: {\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: \"editScope\",\n            src: \"editScope\",\n            input: ({ context }) => context.input,\n            onDone: {\n              target: \"EditScopeResultCheck\",\n              actions: assign({\n                _internalState: ({ event, context }) =>\n                  isSuccessCommandResult(event.output)\n                    ? {\n                        ...context._internalState,\n                        hmacRest: event.output.data.hmacRest,\n                      }\n                    : {\n                        ...context._internalState,\n                        error: event.output.error,\n                      },\n              }),\n            },\n            onError: {\n              target: \"Error\",\n              actions: \"assignErrorFromEvent\",\n            },\n          },\n        },\n        EditScopeResultCheck: {\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 { hmacRest, error } = context._internalState;\n        if (hmacRest) {\n          const { input } = context;\n          return Right({\n            contactName: input.contactName,\n            previousScope: input.previousScope,\n            scope: input.newScope,\n            identifier: input.identifier,\n            blockchainFamily: input.blockchainFamily,\n            chainId: input.chainId,\n            groupHandle: input.groupHandle,\n            // Preserved: the group-level name proof is untouched by a scope\n            // edit \u2014 only `hmacRest` (the address-level proof) rotates.\n            hmacProof: input.hmacProof,\n            hmacRest,\n          });\n        }\n        return Left(error ?? new UnknownDAError(\"No error in final state\"));\n      },\n    });\n  }\n\n  extractDependencies(\n    internalApi: InternalApi,\n  ): EditExternalAddressScopeMachineDependencies {\n    const isSupported = (app: RunningApp) =>\n      isContactsSupportedForSession(internalApi, app);\n\n    const editScope = (\n      input: EditExternalAddressScopeDAInput,\n    ): Promise<Awaited<ReturnType<SendEditExternalAddressScopeTask[\"run\"]>>> =>\n      new SendEditExternalAddressScopeTask(internalApi, {\n        contactName: input.contactName,\n        previousScope: input.previousScope,\n        newScope: input.newScope,\n        identifier: input.identifier,\n        blockchainFamily: input.blockchainFamily,\n        chainId: input.chainId,\n        groupHandle: input.groupHandle,\n        hmacProof: input.hmacProof,\n        hmacRest: input.hmacRest,\n      }).run();\n\n    return { isSupported, editScope };\n  }\n}\n\nexport type { EditScopeProof };\n"],
+  "mappings": "AAAA,OAGE,0BAAAA,EACA,uBAAAC,EAEA,kBAAAC,EACA,2BAAAC,EACA,oCAAAC,EACA,sBAAAC,MACK,kCACP,OAAS,QAAAC,EAAM,SAAAC,MAAa,YAC5B,OAAS,UAAAC,EAAQ,eAAAC,EAAa,SAAAC,MAAa,SAS3C,OACE,iCAAAC,MAEK,qDACP,OAAS,mCAAAC,MAAuC,4CAChD,OAEE,oCAAAC,MACK,6DAEP,OAAS,yCAAAC,MAA6C,0CAS/C,MAAMC,UAA6CV,CAMxD,CACA,iBACEW,EAOA,CASA,KAAM,CAAE,YAAAC,EAAa,UAAAC,CAAU,EAAI,KAAK,oBAAoBF,CAAW,EACjEG,EAAU,KAAK,MAAM,QAE3B,OAAOT,EAAM,CACX,MAAO,CACL,MAAO,CAAC,EACR,QAAS,CAAC,EACV,OAAQ,CAAC,CACX,EACA,OAAQ,CACN,oBAAqB,IAAIT,EAAoB,CAC3C,MAAO,CAAE,QAAAkB,CAAQ,CACnB,CAAC,EAAE,iBAAiBH,CAAW,EAC/B,iCAAkC,IAAIZ,EAAiC,CACrE,MAAO,CAAC,CACV,CAAC,EAAE,iBAAiBY,CAAW,EAC/B,UAAWP,EACT,CAAC,CAAE,MAAAW,CAAM,IACPF,EAAUE,CAAK,CACnB,CACF,EACA,OAAQ,CACN,YAAa,CAAC,CAAE,QAAAC,CAAQ,IAAMA,EAAQ,MAAM,cAAgB,GAC5D,gBAAiB,CAAC,CAAE,QAAAA,CAAQ,IAAMA,EAAQ,eAAe,QAAU,KACnE,kBAAmB,CAAC,CAAE,QAAAA,CAAQ,IAAM,CAClC,KAAM,CAAE,cAAAC,CAAc,EAAID,EAAQ,eAClC,OAAOC,IAAkB,MAAQL,EAAYK,CAAa,CAC5D,CACF,EACA,QAAS,CACP,sBAAuBd,EAAO,CAC5B,eAAgB,CAAC,CAAE,QAAAa,CAAQ,IAAM,CAC/B,MAAME,EAAQT,EAAsCO,EAAQ,KAAK,EACjE,OAAOE,EACH,CAAE,GAAGF,EAAQ,eAAgB,MAAAE,CAAM,EACnCF,EAAQ,cACd,CACF,CAAC,EACD,mBAAoBb,EAAO,CACzB,eAAgB,CAAC,CAAE,QAAAa,CAAQ,KAAO,CAChC,GAAGA,EAAQ,eACX,MAAO,IAAIT,CACb,EACF,CAAC,EACD,qBAAsBJ,EAAO,CAC3B,eAAgB,CAAC,CAAE,QAAAa,EAAS,MAAAG,CAAM,KAAO,CACvC,GAAGH,EAAQ,eACX,MAAO,IAAInB,EACTsB,EAAM,iBAAoB,MACtBA,EAAM,MAAS,QACf,OAAOA,EAAM,KAAQ,CAC3B,CACF,EACF,CAAC,CACH,CACF,CAAC,EAAE,cAAc,CACf,GAAI,uCACJ,QAAS,eACT,QAAS,CAAC,CAAE,MAAAJ,CAAM,KAAO,CACvB,MAAAA,EACA,kBAAmB,CACjB,wBAAyBjB,EAAwB,IACnD,EACA,eAAgB,CACd,MAAO,KACP,cAAe,KACf,SAAU,IACZ,CACF,GACA,OAAQ,CACN,aAAc,CACZ,OAAQ,CACN,CAAE,OAAQ,gBAAiB,MAAO,aAAc,EAChD,CAAE,OAAQ,qBAAsB,CAClC,CACF,EACA,oBAAqB,CACnB,OAAQ,CACN,GAAI,sBACJ,IAAK,sBACL,MAAO,KAAO,CAAE,QAAAgB,CAAQ,GACxB,WAAY,CACV,QAASX,EAAO,CACd,kBAAmB,CAAC,CAAE,MAAAgB,CAAM,IAC1BA,EAAM,SAAS,QAAQ,iBAC3B,CAAC,CACH,EACA,OAAQ,CACN,OAAQ,qBACR,QAAShB,EAAO,CACd,eAAgB,CAAC,CAAE,MAAAgB,EAAO,QAAAH,CAAQ,IAChCG,EAAM,OAAO,OAAgD,CAC3D,MAAO,IAAMH,EAAQ,eACrB,KAAOE,IAAW,CAAE,GAAGF,EAAQ,eAAgB,MAAAE,CAAM,EACvD,CAAC,CACL,CAAC,CACH,CACF,CACF,EACA,mBAAoB,CAClB,OAAQ,CACN,CAAE,OAAQ,gBAAiB,MAAO,iBAAkB,EACpD,CAAE,OAAQ,OAAQ,CACpB,CACF,EAKA,cAAe,CACb,MAAO,wBACP,OAAQ,CACN,CAAE,OAAQ,uBAAwB,MAAO,iBAAkB,EAC3D,CAAE,OAAQ,OAAQ,CACpB,CACF,EAKA,qBAAsB,CAGpB,MAAOf,EAAO,CACZ,kBAAmB,CACjB,wBAAyBL,EAAwB,IACnD,CACF,CAAC,EACD,OAAQ,CACN,GAAI,uBACJ,IAAK,mCACL,MAAO,KAAO,CAAC,GAIf,WAAY,CACV,QAASK,EAAO,CACd,kBAAmB,CAAC,CAAE,MAAAgB,CAAM,IAC1BA,EAAM,SAAS,QAAQ,iBAC3B,CAAC,CACH,EACA,OAAQ,CACN,OAAQ,qBACR,QAAShB,EAAO,CACd,eAAgB,CAAC,CAAE,MAAAgB,EAAO,QAAAH,CAAQ,IAChCG,EAAM,OAAO,OAAgD,CAC3D,MAAQF,IAAmB,CACzB,GAAGD,EAAQ,eACX,cAAe,CACb,KAAMC,EAAc,KACpB,QAASA,EAAc,OACzB,CACF,GACA,KAAOC,IAAW,CAAE,GAAGF,EAAQ,eAAgB,MAAAE,CAAM,EACvD,CAAC,CACL,CAAC,CACH,CACF,CACF,EACA,mBAAoB,CAClB,OAAQ,CACN,CAAE,OAAQ,eAAgB,MAAO,iBAAkB,EACnD,CAAE,OAAQ,OAAQ,CACpB,CACF,EAGA,aAAc,CACZ,OAAQ,CACN,CAAE,OAAQ,YAAa,MAAO,mBAAoB,EAClD,CAAE,OAAQ,QAAS,QAAS,oBAAqB,CACnD,CACF,EACA,UAAW,CACT,MAAOf,EAAO,CACZ,kBAAmB,CACjB,wBAAyBL,EAAwB,cACnD,CACF,CAAC,EACD,KAAMK,EAAO,CACX,kBAAmB,CACjB,wBAAyBL,EAAwB,IACnD,CACF,CAAC,EACD,OAAQ,CACN,GAAI,YACJ,IAAK,YACL,MAAO,CAAC,CAAE,QAAAkB,CAAQ,IAAMA,EAAQ,MAChC,OAAQ,CACN,OAAQ,uBACR,QAASb,EAAO,CACd,eAAgB,CAAC,CAAE,MAAAgB,EAAO,QAAAH,CAAQ,IAChCrB,EAAuBwB,EAAM,MAAM,EAC/B,CACE,GAAGH,EAAQ,eACX,SAAUG,EAAM,OAAO,KAAK,QAC9B,EACA,CACE,GAAGH,EAAQ,eACX,MAAOG,EAAM,OAAO,KACtB,CACR,CAAC,CACH,EACA,QAAS,CACP,OAAQ,QACR,QAAS,sBACX,CACF,CACF,EACA,qBAAsB,CACpB,OAAQ,CACN,CAAE,OAAQ,UAAW,MAAO,iBAAkB,EAC9C,CAAE,OAAQ,OAAQ,CACpB,CACF,EACA,QAAS,CAAE,KAAM,OAAQ,EACzB,MAAO,CAAE,KAAM,OAAQ,CACzB,EACA,OAAQ,CAAC,CAAE,QAAAH,CAAQ,IAAM,CACvB,KAAM,CAAE,SAAAI,EAAU,MAAAF,CAAM,EAAIF,EAAQ,eACpC,GAAII,EAAU,CACZ,KAAM,CAAE,MAAAL,CAAM,EAAIC,EAClB,OAAOd,EAAM,CACX,YAAaa,EAAM,YACnB,cAAeA,EAAM,cACrB,MAAOA,EAAM,SACb,WAAYA,EAAM,WAClB,iBAAkBA,EAAM,iBACxB,QAASA,EAAM,QACf,YAAaA,EAAM,YAGnB,UAAWA,EAAM,UACjB,SAAAK,CACF,CAAC,CACH,CACA,OAAOnB,EAAKiB,GAAS,IAAIrB,EAAe,yBAAyB,CAAC,CACpE,CACF,CAAC,CACH,CAEA,oBACEc,EAC6C,CAmB7C,MAAO,CAAE,YAlBYU,GACnBf,EAA8BK,EAAaU,CAAG,EAiB1B,UAdpBN,GAEA,IAAIP,EAAiCG,EAAa,CAChD,YAAaI,EAAM,YACnB,cAAeA,EAAM,cACrB,SAAUA,EAAM,SAChB,WAAYA,EAAM,WAClB,iBAAkBA,EAAM,iBACxB,QAASA,EAAM,QACf,YAAaA,EAAM,YACnB,UAAWA,EAAM,UACjB,SAAUA,EAAM,QAClB,CAAC,EAAE,IAAI,CAEuB,CAClC,CACF",
+  "names": ["isSuccessCommandResult", "OpenAppDeviceAction", "UnknownDAError", "UserInteractionRequired", "WaitForAppAndVersionDeviceAction", "XStateDeviceAction", "Left", "Right", "assign", "fromPromise", "setup", "isContactsSupportedForSession", "ContactsVersionRequirementError", "SendEditExternalAddressScopeTask", "validateEditExternalAddressScopeInput", "EditExternalAddressScopeDeviceAction", "internalApi", "isSupported", "editScope", "appName", "input", "context", "appAndVersion", "error", "event", "hmacRest", "app"]
+}

package/lib/esm/internal/app-binder/device-action/EditExternalAddressScope/EditExternalAddressScopeDeviceAction.test.js

@@ -0,0 +1,2 @@
+import{CommandResultFactory as V,DeviceActionStatus as e,DeviceModelId as C,DeviceSessionStateType as y,DeviceStatus as R,UnknownDAError as h,UserInteractionRequired as t}from"@ledgerhq/device-management-kit";import{beforeEach as q,describe as N,it as c,vi as m}from"vitest";import{makeDeviceActionInternalApiMock as w}from"../../../app-binder/device-action/__test-utils__/makeInternalApi";import{setupOpenAppDAMock as p}from"../../../app-binder/device-action/__test-utils__/setupOpenAppDAMock";import{setupWaitForAppAndVersionDAMock as v}from"../../../app-binder/device-action/__test-utils__/setupWaitForAppAndVersionDAMock";import{testDeviceActionStates as u}from"../../../app-binder/device-action/__test-utils__/testDeviceActionStates";import{ContactsCommandError as H,ContactsVersionRequirementError as M}from"../../../app-binder/model/contactsErrors";import{EditExternalAddressScopeDeviceAction as T}from"./EditExternalAddressScopeDeviceAction";import{validateEditExternalAddressScopeInput as P}from"./validateEditExternalAddressScopeInput";m.mock("@ledgerhq/device-management-kit",async a=>({...await a(),OpenAppDeviceAction:m.fn(()=>({makeStateMachine:m.fn()})),WaitForAppAndVersionDeviceAction:m.fn(()=>({makeStateMachine:m.fn()}))}));const g={name:"Ethereum",version:"1.15.0"},k=new Uint8Array(64).fill(204),x=new Uint8Array(32).fill(221),U=new Uint8Array(32).fill(170),f=new Uint8Array(32).fill(136),I=new Uint8Array(20).fill(17),B={hmacRest:f},l={contactName:"Alice",previousScope:"Eth main",newScope:"Eth cold",identifier:I,blockchainFamily:"ethereum",chainId:1n,groupHandle:k,hmacProof:x,hmacRest:U,appName:"Ethereum"},E={contactName:"Alice",previousScope:"Eth main",scope:"Eth cold",identifier:I,blockchainFamily:"ethereum",chainId:1n,groupHandle:k,hmacProof:x,hmacRest:f};N("EditExternalAddressScopeDeviceAction",()=>{let a,A,D;function O(){return{isSupported:A,editScope:D}}q(()=>{a=w(),v(g),A=m.fn().mockReturnValue(!0),D=m.fn().mockResolvedValue(V({data:B})),a.getDeviceSessionState.mockReturnValue({sessionStateType:y.ReadyWithoutSecureChannel,deviceStatus:R.CONNECTED,installedApps:[],currentApp:{name:"Ethereum",version:"1.15.0"},deviceModelId:C.FLEX,isSecureConnectionAllowed:!0})});function d(o){const n=new T({input:o});return m.spyOn(n,"extractDependencies").mockReturnValue(O()),n}c("open-app path: OpenApp -> VersionGuard -> EditScope -> Completed",()=>new Promise((o,n)=>{p();const r=d({...l,skipOpenApp:!1}),i=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.ConfirmOpenApp},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.RegisterWallet},status:e.Pending},{output:E,status:e.Completed}];u(r,i,a,{onDone:o,onError:n})})),c("skip-open-app path: VersionGuard -> EditScope -> Completed, preserving the group proof and identifier",()=>new Promise((o,n)=>{p();const r=d({...l,skipOpenApp:!0}),i=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.RegisterWallet},status:e.Pending},{output:E,status:e.Completed}];u(r,i,a,{onDone:()=>{try{expect(E.hmacProof).toBe(x),expect(E.identifier).toBe(I),expect(E.hmacRest).toBe(f),expect(E.hmacRest).not.toBe(U),o()}catch(s){n(s)}},onError:n})})),c("version guard rejects on skip-open-app path without running EDIT SCOPE",()=>new Promise((o,n)=>{p(),A.mockReturnValue(!1);const r=d({...l,skipOpenApp:!0}),i=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{error:new M,status:e.Error}];u(r,i,a,{onDone:o,onError:n}),expect(D).not.toHaveBeenCalled()})),c("surfaces an open-app failure as the device action error",()=>new Promise((o,n)=>{const r=new h("open app failed");p(r);const i=d({...l,skipOpenApp:!1}),s=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.ConfirmOpenApp},status:e.Pending},{error:r,status:e.Error}];u(i,s,a,{onDone:o,onError:n}),expect(A).not.toHaveBeenCalled()})),c("surfaces an Edit Scope command error",()=>new Promise((o,n)=>{p();const r=new H({errorCode:"6982",message:"seed mismatch"});D.mockResolvedValue(V({error:r}));const i=d({...l,skipOpenApp:!0}),s=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.RegisterWallet},status:e.Pending},{error:r,status:e.Error}];u(i,s,a,{onDone:o,onError:n})})),c("surfaces invalid input as a typed error state on the skip-open-app path",()=>new Promise((o,n)=>{p();const r={...l,skipOpenApp:!0,contactName:""},i=P(r),s=d(r),S=[{error:i,status:e.Error}];u(s,S,a,{onDone:o,onError:n}),expect(A).not.toHaveBeenCalled(),expect(D).not.toHaveBeenCalled()})),c("validates only after opening the app on the default path",()=>new Promise((o,n)=>{p();const r={...l,skipOpenApp:!1,contactName:""},i=P(r),s=d(r),S=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.ConfirmOpenApp},status:e.Pending},{error:i,status:e.Error}];u(s,S,a,{onDone:o,onError:n}),expect(D).not.toHaveBeenCalled()})),c("evaluates support from the fresh WaitForAppAndVersion result, not stale session state",()=>new Promise((o,n)=>{p();const r={name:"Ethereum",version:"9.9.9"};v(r);const i=d({...l,skipOpenApp:!0}),s=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.RegisterWallet},status:e.Pending},{output:E,status:e.Completed}];u(i,s,a,{onDone:()=>{try{expect(A).toHaveBeenCalledWith(r),o()}catch(S){n(S)}},onError:n})})),c("surfaces a WaitForAppAndVersion failure as the device action error",()=>new Promise((o,n)=>{p();const r=new h("could not read app and version");v({error:r});const i=d({...l,skipOpenApp:!0}),s=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{error:r,status:e.Error}];u(i,s,a,{onDone:o,onError:n}),expect(A).not.toHaveBeenCalled(),expect(D).not.toHaveBeenCalled()})),c("propagates the UnlockDevice interaction emitted by WaitForAppAndVersion",()=>new Promise((o,n)=>{p(),v(g,t.UnlockDevice);const r=d({...l,skipOpenApp:!0}),i=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.UnlockDevice},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.RegisterWallet},status:e.Pending},{output:E,status:e.Completed}];u(r,i,a,{onDone:o,onError:n})}))});
+//# sourceMappingURL=EditExternalAddressScopeDeviceAction.test.js.map

package/lib/esm/internal/app-binder/device-action/EditExternalAddressScope/EditExternalAddressScopeDeviceAction.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/internal/app-binder/device-action/EditExternalAddressScope/EditExternalAddressScopeDeviceAction.test.ts"],
+  "sourcesContent": ["import {\n  CommandResultFactory,\n  type DeviceActionState,\n  DeviceActionStatus,\n  DeviceModelId,\n  DeviceSessionStateType,\n  DeviceStatus,\n  UnknownDAError,\n  UserInteractionRequired,\n} from \"@ledgerhq/device-management-kit\";\nimport { beforeEach, describe, it, vi } from \"vitest\";\n\nimport {\n  type EditExternalAddressScopeDAError,\n  type EditExternalAddressScopeDAInput,\n  type EditExternalAddressScopeDAIntermediateValue,\n  type EditExternalAddressScopeDAOutput,\n} from \"@api/app-binder/EditExternalAddressScopeDeviceActionTypes\";\nimport { makeDeviceActionInternalApiMock } from \"@internal/app-binder/device-action/__test-utils__/makeInternalApi\";\nimport { setupOpenAppDAMock } from \"@internal/app-binder/device-action/__test-utils__/setupOpenAppDAMock\";\nimport { setupWaitForAppAndVersionDAMock } from \"@internal/app-binder/device-action/__test-utils__/setupWaitForAppAndVersionDAMock\";\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 { EditExternalAddressScopeDeviceAction } from \"./EditExternalAddressScopeDeviceAction\";\nimport { validateEditExternalAddressScopeInput } from \"./validateEditExternalAddressScopeInput\";\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    OpenAppDeviceAction: vi.fn(() => ({\n      makeStateMachine: vi.fn(),\n    })),\n    WaitForAppAndVersionDeviceAction: vi.fn(() => ({\n      makeStateMachine: vi.fn(),\n    })),\n  };\n});\n\nconst FRESH_APP = { name: \"Ethereum\", version: \"1.15.0\" };\n\nconst GROUP_HANDLE = new Uint8Array(64).fill(0xcc);\nconst HMAC_PROOF = new Uint8Array(32).fill(0xdd);\nconst HMAC_REST_OLD = new Uint8Array(32).fill(0xaa);\nconst HMAC_REST_NEW = new Uint8Array(32).fill(0x88);\nconst IDENTIFIER = new Uint8Array(20).fill(0x11);\n\nconst OK_PROOF = { hmacRest: HMAC_REST_NEW };\n\nconst BASE_INPUT = {\n  contactName: \"Alice\",\n  previousScope: \"Eth main\",\n  newScope: \"Eth cold\",\n  identifier: IDENTIFIER,\n  blockchainFamily: \"ethereum\",\n  chainId: 1n,\n  groupHandle: GROUP_HANDLE,\n  hmacProof: HMAC_PROOF,\n  hmacRest: HMAC_REST_OLD,\n  appName: \"Ethereum\",\n};\n\nconst EXPECTED_OUTPUT = {\n  contactName: \"Alice\",\n  previousScope: \"Eth main\",\n  scope: \"Eth cold\",\n  identifier: IDENTIFIER,\n  blockchainFamily: \"ethereum\",\n  chainId: 1n,\n  groupHandle: GROUP_HANDLE,\n  // Preserved: the group-level name proof is unchanged by a scope edit.\n  hmacProof: HMAC_PROOF,\n  // Rotated: only the address-level proof changes.\n  hmacRest: HMAC_REST_NEW,\n};\n\ndescribe(\"EditExternalAddressScopeDeviceAction\", () => {\n  let apiMock: ReturnType<typeof makeDeviceActionInternalApiMock>;\n  let isSupportedMock: ReturnType<typeof vi.fn>;\n  let editScopeMock: ReturnType<typeof vi.fn>;\n\n  function extractDeps() {\n    return {\n      isSupported: isSupportedMock,\n      editScope: editScopeMock,\n    };\n  }\n\n  beforeEach(() => {\n    apiMock = makeDeviceActionInternalApiMock();\n    setupWaitForAppAndVersionDAMock(FRESH_APP);\n    isSupportedMock = vi.fn().mockReturnValue(true);\n    editScopeMock = 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: \"Ethereum\", version: \"1.15.0\" },\n      deviceModelId: DeviceModelId.FLEX,\n      isSecureConnectionAllowed: true,\n    });\n  });\n\n  function makeAction(input: EditExternalAddressScopeDAInput) {\n    const action = new EditExternalAddressScopeDeviceAction({ input });\n    vi.spyOn(action, \"extractDependencies\").mockReturnValue(extractDeps());\n    return action;\n  }\n\n  it(\"open-app path: OpenApp -> VersionGuard -> EditScope -> Completed\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: false });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.ConfirmOpenApp,\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.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        EditExternalAddressScopeDAOutput,\n        EditExternalAddressScopeDAError,\n        EditExternalAddressScopeDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n    }));\n\n  it(\"skip-open-app path: VersionGuard -> EditScope -> Completed, preserving the group proof and identifier\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: true });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\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        EditExternalAddressScopeDAOutput,\n        EditExternalAddressScopeDAError,\n        EditExternalAddressScopeDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: () => {\n          try {\n            // The device rotates only the address-level hmac_rest; the contact\n            // group's name proof and the entry's identifier pass through\n            // unchanged.\n            expect(EXPECTED_OUTPUT.hmacProof).toBe(HMAC_PROOF);\n            expect(EXPECTED_OUTPUT.identifier).toBe(IDENTIFIER);\n            expect(EXPECTED_OUTPUT.hmacRest).toBe(HMAC_REST_NEW);\n            expect(EXPECTED_OUTPUT.hmacRest).not.toBe(HMAC_REST_OLD);\n            resolve();\n          } catch (e) {\n            reject(e as Error);\n          }\n        },\n        onError: reject,\n      });\n    }));\n\n  it(\"version guard rejects on skip-open-app path without running EDIT SCOPE\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      isSupportedMock.mockReturnValue(false);\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: true });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\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        EditExternalAddressScopeDAOutput,\n        EditExternalAddressScopeDAError,\n        EditExternalAddressScopeDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n      expect(editScopeMock).not.toHaveBeenCalled();\n    }));\n\n  it(\"surfaces an open-app failure as the device action error\", () =>\n    new Promise<void>((resolve, reject) => {\n      const openAppError = new UnknownDAError(\"open app failed\");\n      setupOpenAppDAMock(openAppError);\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: false });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.ConfirmOpenApp,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: openAppError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        EditExternalAddressScopeDAOutput,\n        EditExternalAddressScopeDAError,\n        EditExternalAddressScopeDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n      expect(isSupportedMock).not.toHaveBeenCalled();\n    }));\n\n  it(\"surfaces an Edit Scope command error\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const commandError = new ContactsCommandError({\n        errorCode: \"6982\",\n        message: \"seed mismatch\",\n      });\n      editScopeMock.mockResolvedValue(\n        CommandResultFactory({ error: commandError }),\n      );\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: true });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\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        EditExternalAddressScopeDAOutput,\n        EditExternalAddressScopeDAError,\n        EditExternalAddressScopeDAIntermediateValue\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 state on the skip-open-app path\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const invalidInput = {\n        ...BASE_INPUT,\n        skipOpenApp: true,\n        contactName: \"\",\n      };\n      const validationError =\n        validateEditExternalAddressScopeInput(invalidInput);\n      const action = makeAction(invalidInput);\n\n      const expected = [\n        {\n          error: validationError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        EditExternalAddressScopeDAOutput,\n        EditExternalAddressScopeDAError,\n        EditExternalAddressScopeDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n      expect(isSupportedMock).not.toHaveBeenCalled();\n      expect(editScopeMock).not.toHaveBeenCalled();\n    }));\n\n  it(\"validates only after opening the app on the default path\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const invalidInput = {\n        ...BASE_INPUT,\n        skipOpenApp: false,\n        contactName: \"\",\n      };\n      const validationError =\n        validateEditExternalAddressScopeInput(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.ConfirmOpenApp,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: validationError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        EditExternalAddressScopeDAOutput,\n        EditExternalAddressScopeDAError,\n        EditExternalAddressScopeDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n      expect(editScopeMock).not.toHaveBeenCalled();\n    }));\n\n  it(\"evaluates support from the fresh WaitForAppAndVersion result, not stale session state\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const freshApp = { name: \"Ethereum\", version: \"9.9.9\" };\n      setupWaitForAppAndVersionDAMock(freshApp);\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: true });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\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        EditExternalAddressScopeDAOutput,\n        EditExternalAddressScopeDAError,\n        EditExternalAddressScopeDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: () => {\n          try {\n            expect(isSupportedMock).toHaveBeenCalledWith(freshApp);\n            resolve();\n          } catch (e) {\n            reject(e as Error);\n          }\n        },\n        onError: reject,\n      });\n    }));\n\n  it(\"surfaces a WaitForAppAndVersion failure as the device action error\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const waitError = new UnknownDAError(\"could not read app and version\");\n      setupWaitForAppAndVersionDAMock({ error: waitError });\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: true });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: waitError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        EditExternalAddressScopeDAOutput,\n        EditExternalAddressScopeDAError,\n        EditExternalAddressScopeDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n      expect(isSupportedMock).not.toHaveBeenCalled();\n      expect(editScopeMock).not.toHaveBeenCalled();\n    }));\n\n  it(\"propagates the UnlockDevice interaction emitted by WaitForAppAndVersion\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      setupWaitForAppAndVersionDAMock(\n        FRESH_APP,\n        UserInteractionRequired.UnlockDevice,\n      );\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: true });\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        EditExternalAddressScopeDAOutput,\n        EditExternalAddressScopeDAError,\n        EditExternalAddressScopeDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n    }));\n});\n"],
+  "mappings": "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",
+  "names": ["CommandResultFactory", "DeviceActionStatus", "DeviceModelId", "DeviceSessionStateType", "DeviceStatus", "UnknownDAError", "UserInteractionRequired", "beforeEach", "describe", "it", "vi", "makeDeviceActionInternalApiMock", "setupOpenAppDAMock", "setupWaitForAppAndVersionDAMock", "testDeviceActionStates", "ContactsCommandError", "ContactsVersionRequirementError", "EditExternalAddressScopeDeviceAction", "validateEditExternalAddressScopeInput", "importOriginal", "FRESH_APP", "GROUP_HANDLE", "HMAC_PROOF", "HMAC_REST_OLD", "HMAC_REST_NEW", "IDENTIFIER", "OK_PROOF", "BASE_INPUT", "EXPECTED_OUTPUT", "apiMock", "isSupportedMock", "editScopeMock", "extractDeps", "makeAction", "input", "action", "resolve", "reject", "expected", "e", "openAppError", "commandError", "invalidInput", "validationError", "freshApp", "waitError"]
+}

package/lib/esm/internal/app-binder/device-action/EditExternalAddressScope/validateEditExternalAddressScopeInput.js

@@ -0,0 +1,2 @@
+import{BLOCKCHAIN_FAMILY_BY_NAME as n}from"../../../app-binder/model/contactsConstants";import{CONTACT_NAME_BUFFER_LENGTH as c,ContactsValidationError as r,ETH_ADDRESS_BYTES as f,GROUP_HANDLE_SIZE as l,HMAC_PROOF_LENGTH as d,SCOPE_BUFFER_LENGTH as a,validateByteLength as i,validateChainId as h,validatePrintableLabel as o}from"../../../app-binder/model/contactsValidation";const s=d;function _(e){try{o(e.contactName,{field:"contactName",bufferLength:c}),o(e.previousScope,{field:"previousScope",bufferLength:a}),o(e.newScope,{field:"newScope",bufferLength:a});const t=e.blockchainFamily.toLowerCase();if(!(t in n))throw new r(`Unsupported blockchain family: ${e.blockchainFamily}`);if(t==="ethereum"){if(i(e.identifier,{field:"identifier",expectedBytes:f}),e.chainId===void 0)throw new r("chainId is required for the Ethereum blockchain family.")}else if(e.identifier.length===0)throw new r("identifier must not be empty.");return e.chainId!==void 0&&h(e.chainId),i(e.groupHandle,{field:"groupHandle",expectedBytes:l}),i(e.hmacProof,{field:"hmacProof",expectedBytes:d}),i(e.hmacRest,{field:"hmacRest",expectedBytes:s}),null}catch(t){if(t instanceof r)return t;throw t}}export{_ as validateEditExternalAddressScopeInput};
+//# sourceMappingURL=validateEditExternalAddressScopeInput.js.map

package/lib/esm/internal/app-binder/device-action/EditExternalAddressScope/validateEditExternalAddressScopeInput.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/internal/app-binder/device-action/EditExternalAddressScope/validateEditExternalAddressScopeInput.ts"],
+  "sourcesContent": ["import { type EditExternalAddressScopeInput } from \"@api/model/EditExternalAddressScope\";\nimport { BLOCKCHAIN_FAMILY_BY_NAME } from \"@internal/app-binder/model/contactsConstants\";\nimport {\n  CONTACT_NAME_BUFFER_LENGTH,\n  ContactsValidationError,\n  ETH_ADDRESS_BYTES,\n  GROUP_HANDLE_SIZE,\n  HMAC_PROOF_LENGTH,\n  SCOPE_BUFFER_LENGTH,\n  validateByteLength,\n  validateChainId,\n  validatePrintableLabel,\n} from \"@internal/app-binder/model/contactsValidation\";\n\n// The address-level proof (`hmac_rest`) shares the 32-byte HMAC width.\nconst HMAC_REST_LENGTH = HMAC_PROOF_LENGTH;\n\n/**\n * Validate the caller input for Edit External Address Scope. Returns the first\n * `ContactsValidationError`, or `null` when valid. Non-throwing so the device\n * action can surface it as a typed terminal error state.\n */\nexport function validateEditExternalAddressScopeInput(\n  input: EditExternalAddressScopeInput,\n): ContactsValidationError | null {\n  try {\n    validatePrintableLabel(input.contactName, {\n      field: \"contactName\",\n      bufferLength: CONTACT_NAME_BUFFER_LENGTH,\n    });\n    validatePrintableLabel(input.previousScope, {\n      field: \"previousScope\",\n      bufferLength: SCOPE_BUFFER_LENGTH,\n    });\n    validatePrintableLabel(input.newScope, {\n      field: \"newScope\",\n      bufferLength: SCOPE_BUFFER_LENGTH,\n    });\n\n    const family = input.blockchainFamily.toLowerCase();\n    if (!(family in BLOCKCHAIN_FAMILY_BY_NAME)) {\n      throw new ContactsValidationError(\n        `Unsupported blockchain family: ${input.blockchainFamily}`,\n      );\n    }\n    if (family === \"ethereum\") {\n      validateByteLength(input.identifier, {\n        field: \"identifier\",\n        expectedBytes: ETH_ADDRESS_BYTES,\n      });\n      // CHAIN_ID is mandatory for the Ethereum family (multiple networks share\n      // the same address format).\n      if (input.chainId === undefined) {\n        throw new ContactsValidationError(\n          \"chainId is required for the Ethereum blockchain family.\",\n        );\n      }\n    } else {\n      if (input.identifier.length === 0) {\n        throw new ContactsValidationError(\"identifier must not be empty.\");\n      }\n    }\n\n    if (input.chainId !== undefined) {\n      validateChainId(input.chainId);\n    }\n\n    validateByteLength(input.groupHandle, {\n      field: \"groupHandle\",\n      expectedBytes: GROUP_HANDLE_SIZE,\n    });\n    validateByteLength(input.hmacProof, {\n      field: \"hmacProof\",\n      expectedBytes: HMAC_PROOF_LENGTH,\n    });\n    validateByteLength(input.hmacRest, {\n      field: \"hmacRest\",\n      expectedBytes: HMAC_REST_LENGTH,\n    });\n\n    return null;\n  } catch (error) {\n    if (error instanceof ContactsValidationError) {\n      return error;\n    }\n    throw error;\n  }\n}\n"],
+  "mappings": "AACA,OAAS,6BAAAA,MAAiC,+CAC1C,OACE,8BAAAC,EACA,2BAAAC,EACA,qBAAAC,EACA,qBAAAC,EACA,qBAAAC,EACA,uBAAAC,EACA,sBAAAC,EACA,mBAAAC,EACA,0BAAAC,MACK,gDAGP,MAAMC,EAAmBL,EAOlB,SAASM,EACdC,EACgC,CAChC,GAAI,CACFH,EAAuBG,EAAM,YAAa,CACxC,MAAO,cACP,aAAcX,CAChB,CAAC,EACDQ,EAAuBG,EAAM,cAAe,CAC1C,MAAO,gBACP,aAAcN,CAChB,CAAC,EACDG,EAAuBG,EAAM,SAAU,CACrC,MAAO,WACP,aAAcN,CAChB,CAAC,EAED,MAAMO,EAASD,EAAM,iBAAiB,YAAY,EAClD,GAAI,EAAEC,KAAUb,GACd,MAAM,IAAIE,EACR,kCAAkCU,EAAM,gBAAgB,EAC1D,EAEF,GAAIC,IAAW,YAOb,GANAN,EAAmBK,EAAM,WAAY,CACnC,MAAO,aACP,cAAeT,CACjB,CAAC,EAGGS,EAAM,UAAY,OACpB,MAAM,IAAIV,EACR,yDACF,UAGEU,EAAM,WAAW,SAAW,EAC9B,MAAM,IAAIV,EAAwB,+BAA+B,EAIrE,OAAIU,EAAM,UAAY,QACpBJ,EAAgBI,EAAM,OAAO,EAG/BL,EAAmBK,EAAM,YAAa,CACpC,MAAO,cACP,cAAeR,CACjB,CAAC,EACDG,EAAmBK,EAAM,UAAW,CAClC,MAAO,YACP,cAAeP,CACjB,CAAC,EACDE,EAAmBK,EAAM,SAAU,CACjC,MAAO,WACP,cAAeF,CACjB,CAAC,EAEM,IACT,OAASI,EAAO,CACd,GAAIA,aAAiBZ,EACnB,OAAOY,EAET,MAAMA,CACR,CACF",
+  "names": ["BLOCKCHAIN_FAMILY_BY_NAME", "CONTACT_NAME_BUFFER_LENGTH", "ContactsValidationError", "ETH_ADDRESS_BYTES", "GROUP_HANDLE_SIZE", "HMAC_PROOF_LENGTH", "SCOPE_BUFFER_LENGTH", "validateByteLength", "validateChainId", "validatePrintableLabel", "HMAC_REST_LENGTH", "validateEditExternalAddressScopeInput", "input", "family", "error"]
+}

package/lib/esm/internal/app-binder/device-action/EditExternalAddressScope/validateEditExternalAddressScopeInput.test.js

@@ -0,0 +1,2 @@
+import{ContactsValidationError as r}from"../../../app-binder/model/contactsValidation";import{validateEditExternalAddressScopeInput as t}from"./validateEditExternalAddressScopeInput";const n={contactName:"Alice",previousScope:"Eth main",newScope:"Eth cold",identifier:new Uint8Array(20).fill(17),blockchainFamily:"ethereum",chainId:1n,groupHandle:new Uint8Array(64).fill(204),hmacProof:new Uint8Array(32).fill(221),hmacRest:new Uint8Array(32).fill(170)};describe("validateEditExternalAddressScopeInput",()=>{it("returns null for a valid input",()=>{expect(t(n)).toBeNull()}),it("rejects an empty contactName",()=>{const e=t({...n,contactName:""});expect(e).toBeInstanceOf(r)}),it("rejects a non-printable previousScope",()=>{const e=t({...n,previousScope:"caf\xE9"});expect(e).toBeInstanceOf(r)}),it("rejects a non-printable newScope",()=>{const e=t({...n,newScope:"caf\xE9"});expect(e).toBeInstanceOf(r)}),it("rejects an unsupported blockchain family",()=>{const e=t({...n,blockchainFamily:"dogecoin"});expect(e).toBeInstanceOf(r)}),it("rejects an identifier of the wrong length for Ethereum",()=>{const e=t({...n,identifier:new Uint8Array(19).fill(17)});expect(e).toBeInstanceOf(r)}),it("requires chainId for the Ethereum family",()=>{const e=t({...n,chainId:void 0});expect(e).toBeInstanceOf(r)}),it("rejects a groupHandle of the wrong length",()=>{const e=t({...n,groupHandle:new Uint8Array(63).fill(204)});expect(e).toBeInstanceOf(r)}),it("rejects an hmacProof of the wrong length",()=>{const e=t({...n,hmacProof:new Uint8Array(31).fill(221)});expect(e).toBeInstanceOf(r)}),it("rejects an hmacRest of the wrong length",()=>{const e=t({...n,hmacRest:new Uint8Array(33).fill(170)});expect(e).toBeInstanceOf(r)})});
+//# sourceMappingURL=validateEditExternalAddressScopeInput.test.js.map

package/lib/esm/internal/app-binder/device-action/EditExternalAddressScope/validateEditExternalAddressScopeInput.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/internal/app-binder/device-action/EditExternalAddressScope/validateEditExternalAddressScopeInput.test.ts"],
+  "sourcesContent": ["import { type EditExternalAddressScopeInput } from \"@api/model/EditExternalAddressScope\";\nimport { ContactsValidationError } from \"@internal/app-binder/model/contactsValidation\";\n\nimport { validateEditExternalAddressScopeInput } from \"./validateEditExternalAddressScopeInput\";\n\nconst VALID_INPUT: EditExternalAddressScopeInput = {\n  contactName: \"Alice\",\n  previousScope: \"Eth main\",\n  newScope: \"Eth cold\",\n  identifier: new Uint8Array(20).fill(0x11),\n  blockchainFamily: \"ethereum\",\n  chainId: 1n,\n  groupHandle: new Uint8Array(64).fill(0xcc),\n  hmacProof: new Uint8Array(32).fill(0xdd),\n  hmacRest: new Uint8Array(32).fill(0xaa),\n};\n\ndescribe(\"validateEditExternalAddressScopeInput\", () => {\n  it(\"returns null for a valid input\", () => {\n    expect(validateEditExternalAddressScopeInput(VALID_INPUT)).toBeNull();\n  });\n\n  it(\"rejects an empty contactName\", () => {\n    const error = validateEditExternalAddressScopeInput({\n      ...VALID_INPUT,\n      contactName: \"\",\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects a non-printable previousScope\", () => {\n    const error = validateEditExternalAddressScopeInput({\n      ...VALID_INPUT,\n      previousScope: \"caf\u00E9\", // 0xC3 0xA9 is non-ASCII\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects a non-printable newScope\", () => {\n    const error = validateEditExternalAddressScopeInput({\n      ...VALID_INPUT,\n      newScope: \"caf\u00E9\",\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects an unsupported blockchain family\", () => {\n    const error = validateEditExternalAddressScopeInput({\n      ...VALID_INPUT,\n      blockchainFamily: \"dogecoin\",\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects an identifier of the wrong length for Ethereum\", () => {\n    const error = validateEditExternalAddressScopeInput({\n      ...VALID_INPUT,\n      identifier: new Uint8Array(19).fill(0x11),\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"requires chainId for the Ethereum family\", () => {\n    const error = validateEditExternalAddressScopeInput({\n      ...VALID_INPUT,\n      chainId: undefined,\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects a groupHandle of the wrong length\", () => {\n    const error = validateEditExternalAddressScopeInput({\n      ...VALID_INPUT,\n      groupHandle: new Uint8Array(63).fill(0xcc),\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects an hmacProof of the wrong length\", () => {\n    const error = validateEditExternalAddressScopeInput({\n      ...VALID_INPUT,\n      hmacProof: new Uint8Array(31).fill(0xdd),\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects an hmacRest of the wrong length\", () => {\n    const error = validateEditExternalAddressScopeInput({\n      ...VALID_INPUT,\n      hmacRest: new Uint8Array(33).fill(0xaa),\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n});\n"],
+  "mappings": "AACA,OAAS,2BAAAA,MAA+B,gDAExC,OAAS,yCAAAC,MAA6C,0CAEtD,MAAMC,EAA6C,CACjD,YAAa,QACb,cAAe,WACf,SAAU,WACV,WAAY,IAAI,WAAW,EAAE,EAAE,KAAK,EAAI,EACxC,iBAAkB,WAClB,QAAS,GACT,YAAa,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,EACzC,UAAW,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,EACvC,SAAU,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,CACxC,EAEA,SAAS,wCAAyC,IAAM,CACtD,GAAG,iCAAkC,IAAM,CACzC,OAAOD,EAAsCC,CAAW,CAAC,EAAE,SAAS,CACtE,CAAC,EAED,GAAG,+BAAgC,IAAM,CACvC,MAAMC,EAAQF,EAAsC,CAClD,GAAGC,EACH,YAAa,EACf,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,wCAAyC,IAAM,CAChD,MAAMG,EAAQF,EAAsC,CAClD,GAAGC,EACH,cAAe,SACjB,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,mCAAoC,IAAM,CAC3C,MAAMG,EAAQF,EAAsC,CAClD,GAAGC,EACH,SAAU,SACZ,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,2CAA4C,IAAM,CACnD,MAAMG,EAAQF,EAAsC,CAClD,GAAGC,EACH,iBAAkB,UACpB,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,yDAA0D,IAAM,CACjE,MAAMG,EAAQF,EAAsC,CAClD,GAAGC,EACH,WAAY,IAAI,WAAW,EAAE,EAAE,KAAK,EAAI,CAC1C,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,2CAA4C,IAAM,CACnD,MAAMG,EAAQF,EAAsC,CAClD,GAAGC,EACH,QAAS,MACX,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,4CAA6C,IAAM,CACpD,MAAMG,EAAQF,EAAsC,CAClD,GAAGC,EACH,YAAa,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,CAC3C,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,2CAA4C,IAAM,CACnD,MAAMG,EAAQF,EAAsC,CAClD,GAAGC,EACH,UAAW,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,CACzC,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,0CAA2C,IAAM,CAClD,MAAMG,EAAQF,EAAsC,CAClD,GAAGC,EACH,SAAU,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,CACxC,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,CACH,CAAC",
+  "names": ["ContactsValidationError", "validateEditExternalAddressScopeInput", "VALID_INPUT", "error"]
+}

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

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

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

@@ -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 * 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,EAS5BC,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", "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/**\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"]
 }

package/lib/esm/internal/app-binder/task/SendEditExternalAddressIdentifierTask.js

@@ -0,0 +1,2 @@
+import{ByteArrayBuilder as c,DmkResultFactory as o,InvalidStatusWordError as m,isSuccessCommandResult as I}from"@ledgerhq/device-management-kit";import{EditExternalAddressIdentifierCommand as y}from"../../app-binder/command/EditExternalAddressIdentifierCommand";import{BLOCKCHAIN_FAMILY_BY_NAME as E,SUB_CMD_EDIT_IDENTIFIER as A}from"../../app-binder/model/contactsConstants";import{CONTACTS_TLV_TAG as t,encodeTlvAscii as d,encodeTlvBuffer as i,encodeTlvChainId as f,encodeTlvUInt8 as a,STRUCT_TYPE_EDIT_IDENTIFIER as C,STRUCT_VERSION_VALUE as T}from"../../app-binder/services/contactsTlvSerializer";import{sendFramedContactsPayload as p}from"../../app-binder/services/sendFramedContactsPayload";class N{constructor(r,n){this.api=r;this.args=n}async run(){const r=this.buildPayload(this.args),n=await p(this.api,{payload:r,p1:A,makeCommand:(s,l)=>new y({data:s,p2:l}),logger:this.args.logger,commandTag:"SendEditExternalAddressIdentifierTask"});if(!I(n))return n;const{hmacRest:e}=n.data;return e?o({data:{hmacRest:e}}):o({error:new m("EditIdentifier final-chunk response did not carry hmac_rest")})}buildPayload(r){const n=E[r.blockchainFamily.toLowerCase()];if(n===void 0)throw new Error(`Unsupported blockchain family: ${r.blockchainFamily}`);const e=new c;return a(e,t.STRUCT_TYPE,C),a(e,t.STRUCT_VERSION,T),d(e,t.CONTACT_NAME,r.contactName),d(e,t.SCOPE,r.scope),i(e,t.ACCOUNT_IDENTIFIER,r.newIdentifier),i(e,t.PREVIOUS_IDENTIFIER,r.previousIdentifier),i(e,t.GROUP_HANDLE,r.groupHandle),r.chainId!==void 0&&f(e,t.CHAIN_ID,r.chainId),i(e,t.HMAC_PROOF,r.hmacProof),i(e,t.HMAC_REST,r.hmacRest),a(e,t.BLOCKCHAIN_FAMILY,n),e.build()}}export{N as SendEditExternalAddressIdentifierTask};
+//# sourceMappingURL=SendEditExternalAddressIdentifierTask.js.map

package/lib/esm/internal/app-binder/task/SendEditExternalAddressIdentifierTask.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/internal/app-binder/task/SendEditExternalAddressIdentifierTask.ts"],
+  "sourcesContent": ["// Builds the op-3 (Edit Identifier) TLV and dispatches it via the shared\n// chunked framing; the device returns struct_type + hmac_rest on the final\n// chunk. Tag order: STRUCT_TYPE, STRUCT_VERSION, CONTACT_NAME, SCOPE,\n// ACCOUNT_IDENTIFIER (new), PREVIOUS_IDENTIFIER (old), GROUP_HANDLE,\n// CHAIN_ID (Ethereum only), HMAC_PROOF, HMAC_REST (old), BLOCKCHAIN_FAMILY.\n// No DERIVATION_PATH: external-address ops carry no path \u2014 the current Ethereum\n// app rejects the tag (0x6a80); it is Ledger-Account only (DSDK-1465).\n// Reference: Address Book Final Specifications \u2014 Edit Identifier.\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 { EditExternalAddressIdentifierCommand } from \"@internal/app-binder/command/EditExternalAddressIdentifierCommand\";\nimport {\n  BLOCKCHAIN_FAMILY_BY_NAME,\n  SUB_CMD_EDIT_IDENTIFIER,\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_EDIT_IDENTIFIER,\n  STRUCT_VERSION_VALUE,\n} from \"@internal/app-binder/services/contactsTlvSerializer\";\nimport { sendFramedContactsPayload } from \"@internal/app-binder/services/sendFramedContactsPayload\";\n\nexport type EditIdentifierProof = {\n  readonly hmacRest: Uint8Array;\n};\n\nexport type SendEditExternalAddressIdentifierTaskArgs = {\n  readonly contactName: string;\n  readonly scope: string;\n  readonly previousIdentifier: Uint8Array;\n  readonly newIdentifier: Uint8Array;\n  readonly blockchainFamily: string;\n  readonly chainId?: bigint;\n  readonly groupHandle: Uint8Array;\n  readonly hmacProof: Uint8Array;\n  readonly hmacRest: Uint8Array;\n  readonly logger?: LoggerPublisherService;\n};\n\nexport class SendEditExternalAddressIdentifierTask {\n  constructor(\n    private readonly api: InternalApi,\n    private readonly args: SendEditExternalAddressIdentifierTaskArgs,\n  ) {}\n\n  async run(): Promise<CommandResult<EditIdentifierProof, ContactsErrorCodes>> {\n    const payload = this.buildPayload(this.args);\n\n    const result = (await sendFramedContactsPayload(this.api, {\n      payload,\n      p1: SUB_CMD_EDIT_IDENTIFIER,\n      makeCommand: (chunk, p2) =>\n        new EditExternalAddressIdentifierCommand({ data: chunk, p2 }),\n      logger: this.args.logger,\n      commandTag: \"SendEditExternalAddressIdentifierTask\",\n    })) as CommandResult<\n      { readonly hmacRest?: Uint8Array },\n      ContactsErrorCodes\n    >;\n\n    if (!isSuccessCommandResult(result)) {\n      return result;\n    }\n\n    const { hmacRest } = result.data;\n    if (!hmacRest) {\n      return DmkResultFactory({\n        error: new InvalidStatusWordError(\n          \"EditIdentifier final-chunk response did not carry hmac_rest\",\n        ),\n      });\n    }\n    return DmkResultFactory({ data: { hmacRest } });\n  }\n\n  private buildPayload(\n    args: SendEditExternalAddressIdentifierTaskArgs,\n  ): 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_EDIT_IDENTIFIER,\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.newIdentifier,\n    );\n    encodeTlvBuffer(\n      builder,\n      CONTACTS_TLV_TAG.PREVIOUS_IDENTIFIER,\n      args.previousIdentifier,\n    );\n    encodeTlvBuffer(builder, CONTACTS_TLV_TAG.GROUP_HANDLE, args.groupHandle);\n    if (args.chainId !== undefined) {\n      encodeTlvChainId(builder, CONTACTS_TLV_TAG.CHAIN_ID, args.chainId);\n    }\n    encodeTlvBuffer(builder, CONTACTS_TLV_TAG.HMAC_PROOF, args.hmacProof);\n    encodeTlvBuffer(builder, CONTACTS_TLV_TAG.HMAC_REST, args.hmacRest);\n    encodeTlvUInt8(builder, CONTACTS_TLV_TAG.BLOCKCHAIN_FAMILY, family);\n\n    return builder.build();\n  }\n}\n"],
+  "mappings": "AAQA,OACE,oBAAAA,EAEA,oBAAAC,EAEA,0BAAAC,EACA,0BAAAC,MAEK,kCAEP,OAAS,wCAAAC,MAA4C,oEACrD,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,0DAmBnC,MAAMC,CAAsC,CACjD,YACmBC,EACAC,EACjB,CAFiB,SAAAD,EACA,UAAAC,CAChB,CAEH,MAAM,KAAuE,CAC3E,MAAMC,EAAU,KAAK,aAAa,KAAK,IAAI,EAErCC,EAAU,MAAML,EAA0B,KAAK,IAAK,CACxD,QAAAI,EACA,GAAIZ,EACJ,YAAa,CAACc,EAAOC,IACnB,IAAIjB,EAAqC,CAAE,KAAMgB,EAAO,GAAAC,CAAG,CAAC,EAC9D,OAAQ,KAAK,KAAK,OAClB,WAAY,uCACd,CAAC,EAKD,GAAI,CAAClB,EAAuBgB,CAAM,EAChC,OAAOA,EAGT,KAAM,CAAE,SAAAG,CAAS,EAAIH,EAAO,KAC5B,OAAKG,EAOErB,EAAiB,CAAE,KAAM,CAAE,SAAAqB,CAAS,CAAE,CAAC,EANrCrB,EAAiB,CACtB,MAAO,IAAIC,EACT,6DACF,CACF,CAAC,CAGL,CAEQ,aACNe,EACY,CACZ,MAAMM,EACJlB,EAA0BY,EAAK,iBAAiB,YAAY,CAAC,EAC/D,GAAIM,IAAW,OACb,MAAM,IAAI,MACR,kCAAkCN,EAAK,gBAAgB,EACzD,EAGF,MAAMO,EAAU,IAAIxB,EACpB,OAAAW,EACEa,EACAjB,EAAiB,YACjBK,CACF,EACAD,EACEa,EACAjB,EAAiB,eACjBM,CACF,EACAL,EAAegB,EAASjB,EAAiB,aAAcU,EAAK,WAAW,EACvET,EAAegB,EAASjB,EAAiB,MAAOU,EAAK,KAAK,EAC1DR,EACEe,EACAjB,EAAiB,mBACjBU,EAAK,aACP,EACAR,EACEe,EACAjB,EAAiB,oBACjBU,EAAK,kBACP,EACAR,EAAgBe,EAASjB,EAAiB,aAAcU,EAAK,WAAW,EACpEA,EAAK,UAAY,QACnBP,EAAiBc,EAASjB,EAAiB,SAAUU,EAAK,OAAO,EAEnER,EAAgBe,EAASjB,EAAiB,WAAYU,EAAK,SAAS,EACpER,EAAgBe,EAASjB,EAAiB,UAAWU,EAAK,QAAQ,EAClEN,EAAea,EAASjB,EAAiB,kBAAmBgB,CAAM,EAE3DC,EAAQ,MAAM,CACvB,CACF",
+  "names": ["ByteArrayBuilder", "DmkResultFactory", "InvalidStatusWordError", "isSuccessCommandResult", "EditExternalAddressIdentifierCommand", "BLOCKCHAIN_FAMILY_BY_NAME", "SUB_CMD_EDIT_IDENTIFIER", "CONTACTS_TLV_TAG", "encodeTlvAscii", "encodeTlvBuffer", "encodeTlvChainId", "encodeTlvUInt8", "STRUCT_TYPE_EDIT_IDENTIFIER", "STRUCT_VERSION_VALUE", "sendFramedContactsPayload", "SendEditExternalAddressIdentifierTask", "api", "args", "payload", "result", "chunk", "p2", "hmacRest", "family", "builder"]
+}

package/lib/esm/internal/app-binder/task/SendEditExternalAddressIdentifierTask.test.js

@@ -0,0 +1,2 @@
+import{CommandResultFactory as a,InvalidStatusWordError as s}from"@ledgerhq/device-management-kit";import{EditExternalAddressIdentifierCommand as m}from"../../app-binder/command/EditExternalAddressIdentifierCommand";import{SendEditExternalAddressIdentifierTask as o}from"./SendEditExternalAddressIdentifierTask";function r(e){const n=new Uint8Array(e.length/2);for(let t=0;t<e.length;t+=2)n[t/2]=parseInt(e.slice(t,t+2),16);return n}const l=r("00d501013102010181f005416c69636581f108457468206d61696e81f214555555555555555555555555555555555555555581f41400000000000000000000000000000000deadbeef81f640"+"cc".repeat(64)+"2301012920"+"dd".repeat(32)+"81f720"+"aa".repeat(32)+"510101"),i={hmacRest:r("88".repeat(32))},d={contactName:"Alice",scope:"Eth main",newIdentifier:r("55".repeat(20)),previousIdentifier:r("00000000000000000000000000000000deadbeef"),blockchainFamily:"ethereum",chainId:1n,groupHandle:r("cc".repeat(64)),hmacProof:r("dd".repeat(32)),hmacRest:r("aa".repeat(32))};function c(){return{sendCommand:vi.fn()}}describe("SendEditExternalAddressIdentifierTask",()=>{it("assembles the framed chunk byte-equal to the fixture and dispatches EditExternalAddressIdentifierCommand",async()=>{const e=c();e.sendCommand.mockResolvedValueOnce(a({data:i}));const n=await new o(e,d).run();expect(e.sendCommand.mock.calls).toHaveLength(1),expect(e.sendCommand.mock.calls[0][0]).toStrictEqual(new m({data:l,p2:0})),expect(n).toStrictEqual(a({data:i}))}),it("omits the CHAIN_ID TLV when chainId is not provided",async()=>{const e=c();e.sendCommand.mockResolvedValueOnce(a({data:i})),await new o(e,{...d,chainId:void 0}).run();const n=e.sendCommand.mock.calls[0][0],t=Buffer.from(n.args.data).toString("hex");expect(t).not.toContain("230101"),expect(t.endsWith("510101")).toBe(!0)}),it("propagates command-level errors",async()=>{const e=c();e.sendCommand.mockResolvedValueOnce(a({error:new s("user cancelled")}));const n=await new o(e,d).run();expect(n).toStrictEqual(a({error:new s("user cancelled")}))}),it("errors when the final-chunk response does not carry hmac_rest",async()=>{const e=c();e.sendCommand.mockResolvedValueOnce(a({data:{}}));const n=await new o(e,d).run();expect(n).toStrictEqual(a({error:new s("EditIdentifier final-chunk response did not carry hmac_rest")}))}),it("throws on an unsupported blockchain family",async()=>{const e=c();await expect(new o(e,{...d,blockchainFamily:"dogecoin"}).run()).rejects.toThrow(/Unsupported blockchain family/),expect(e.sendCommand).not.toHaveBeenCalled()})});
+//# sourceMappingURL=SendEditExternalAddressIdentifierTask.test.js.map

package/lib/esm/internal/app-binder/task/SendEditExternalAddressIdentifierTask.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/internal/app-binder/task/SendEditExternalAddressIdentifierTask.test.ts"],
+  "sourcesContent": ["// Asserts the op-3 (Edit Identifier) framed chunk (2-byte BE length + TLV) is\n// byte-for-byte parity with the signer-eth `edit_external_address` fixture.\nimport {\n  CommandResultFactory,\n  type InternalApi,\n  InvalidStatusWordError,\n} from \"@ledgerhq/device-management-kit\";\n\nimport { EditExternalAddressIdentifierCommand } from \"@internal/app-binder/command/EditExternalAddressIdentifierCommand\";\n\nimport { SendEditExternalAddressIdentifierTask } from \"./SendEditExternalAddressIdentifierTask\";\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 d5\" (2-byte BE total TLV length = 213) + TLV. No\n// DERIVATION_PATH TLV (external-address ops carry no path).\nconst FRAMED_CHUNK = hexToBytes(\n  \"00d5\" +\n    \"010131\" +\n    \"020101\" +\n    \"81f005416c696365\" +\n    \"81f108457468206d61696e\" +\n    \"81f2145555555555555555555555555555555555555555\" +\n    \"81f41400000000000000000000000000000000deadbeef\" +\n    \"81f640\" +\n    \"cc\".repeat(64) +\n    \"230101\" +\n    \"2920\" +\n    \"dd\".repeat(32) +\n    \"81f720\" +\n    \"aa\".repeat(32) +\n    \"510101\",\n);\n\nconst OK_PROOF = { hmacRest: hexToBytes(\"88\".repeat(32)) };\n\nconst BASE_ARGS = {\n  contactName: \"Alice\",\n  scope: \"Eth main\",\n  newIdentifier: hexToBytes(\"55\".repeat(20)),\n  previousIdentifier: hexToBytes(\"00000000000000000000000000000000deadbeef\"),\n  blockchainFamily: \"ethereum\",\n  chainId: 1n,\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(\"SendEditExternalAddressIdentifierTask\", () => {\n  it(\"assembles the framed chunk byte-equal to the fixture and dispatches EditExternalAddressIdentifierCommand\", async () => {\n    const api = makeApiMock();\n    api.sendCommand.mockResolvedValueOnce(\n      CommandResultFactory({ data: OK_PROOF }),\n    );\n\n    const result = await new SendEditExternalAddressIdentifierTask(\n      api,\n      BASE_ARGS,\n    ).run();\n\n    expect(api.sendCommand.mock.calls).toHaveLength(1);\n    expect(api.sendCommand.mock.calls[0]![0]).toStrictEqual(\n      new EditExternalAddressIdentifierCommand({\n        data: FRAMED_CHUNK,\n        p2: 0x00,\n      }),\n    );\n    expect(result).toStrictEqual(CommandResultFactory({ data: OK_PROOF }));\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_PROOF }),\n    );\n\n    await new SendEditExternalAddressIdentifierTask(api, {\n      ...BASE_ARGS,\n      chainId: undefined,\n    }).run();\n\n    const command = api.sendCommand.mock\n      .calls[0]![0] as EditExternalAddressIdentifierCommand;\n    const framedHex = Buffer.from(command.args.data).toString(\"hex\");\n    // No `23 01 ..` CHAIN_ID TLV; HMAC_PROOF (29 20 ..) follows the path directly.\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 SendEditExternalAddressIdentifierTask(\n      api,\n      BASE_ARGS,\n    ).run();\n\n    expect(result).toStrictEqual(\n      CommandResultFactory({\n        error: new InvalidStatusWordError(\"user cancelled\"),\n      }),\n    );\n  });\n\n  it(\"errors when the final-chunk response does not carry hmac_rest\", async () => {\n    const api = makeApiMock();\n    api.sendCommand.mockResolvedValueOnce(CommandResultFactory({ data: {} }));\n\n    const result = await new SendEditExternalAddressIdentifierTask(\n      api,\n      BASE_ARGS,\n    ).run();\n\n    expect(result).toStrictEqual(\n      CommandResultFactory({\n        error: new InvalidStatusWordError(\n          \"EditIdentifier final-chunk response did not carry hmac_rest\",\n        ),\n      }),\n    );\n  });\n\n  it(\"throws on an unsupported blockchain family\", async () => {\n    const api = makeApiMock();\n\n    await expect(\n      new SendEditExternalAddressIdentifierTask(api, {\n        ...BASE_ARGS,\n        blockchainFamily: \"dogecoin\",\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", "EditExternalAddressIdentifierCommand", "SendEditExternalAddressIdentifierTask", "hexToBytes", "hex", "out", "i", "FRAMED_CHUNK", "OK_PROOF", "BASE_ARGS", "makeApiMock", "api", "result", "command", "framedHex"]
+}

package/lib/esm/internal/app-binder/task/SendEditExternalAddressScopeTask.js

@@ -0,0 +1,2 @@
+import{ByteArrayBuilder as l,DmkResultFactory as i,InvalidStatusWordError as m,isSuccessCommandResult as p}from"@ledgerhq/device-management-kit";import{EditExternalAddressScopeCommand as y}from"../../app-binder/command/EditExternalAddressScopeCommand";import{BLOCKCHAIN_FAMILY_BY_NAME as E,SUB_CMD_EDIT_SCOPE as C}from"../../app-binder/model/contactsConstants";import{CONTACTS_TLV_TAG as o,encodeTlvAscii as a,encodeTlvBuffer as n,encodeTlvChainId as S,encodeTlvUInt8 as d,STRUCT_TYPE_EDIT_SCOPE as A,STRUCT_VERSION_VALUE as T}from"../../app-binder/services/contactsTlvSerializer";import{sendFramedContactsPayload as u}from"../../app-binder/services/sendFramedContactsPayload";class U{constructor(r,t){this.api=r;this.args=t}async run(){const r=this.buildPayload(this.args),t=await u(this.api,{payload:r,p1:C,makeCommand:(s,c)=>new y({data:s,p2:c}),logger:this.args.logger,commandTag:"SendEditExternalAddressScopeTask"});if(!p(t))return t;const{hmacRest:e}=t.data;return e?i({data:{hmacRest:e}}):i({error:new m("EditScope final-chunk response did not carry hmac_rest")})}buildPayload(r){const t=E[r.blockchainFamily.toLowerCase()];if(t===void 0)throw new Error(`Unsupported blockchain family: ${r.blockchainFamily}`);const e=new l;return d(e,o.STRUCT_TYPE,A),d(e,o.STRUCT_VERSION,T),a(e,o.CONTACT_NAME,r.contactName),a(e,o.SCOPE,r.newScope),n(e,o.ACCOUNT_IDENTIFIER,r.identifier),a(e,o.PREVIOUS_SCOPE,r.previousScope),n(e,o.GROUP_HANDLE,r.groupHandle),r.chainId!==void 0&&S(e,o.CHAIN_ID,r.chainId),n(e,o.HMAC_PROOF,r.hmacProof),n(e,o.HMAC_REST,r.hmacRest),d(e,o.BLOCKCHAIN_FAMILY,t),e.build()}}export{U as SendEditExternalAddressScopeTask};
+//# sourceMappingURL=SendEditExternalAddressScopeTask.js.map