docs: document deterministic PRISM DID generation

[Rahul-2k4]

Summary

This draft PR adds the deterministic PRISM DID docs requested in #249.

Changes

• Added documentation/develop/deterministic-did-creation.md
• Documented mnemonic -> seed -> deterministic DID flow
• Documented derivation path format: m/29'/29'/did-index'/key-usage'/key-index'
• Added deterministic test vectors and expected DID outputs
• Added code snippets for:
  • Cloud Agent API
  • SDK-TS
  • SDK-KMP
  • SDK-Swift
• Added sidebar entry in documentation/develop/sidebar.ts
• Linked from documentation/develop/cloud-agent/did-management.md

Validation

• New page compiles with @mdx-js/mdx (mdx-ok)
• npm run build in this environment currently fails on an existing upstream submodule MDX file:
  • sdk-ts/docs/decisions/20231110-sdk-package-release.md
  • this is outside the scope of this PR

Closes #249

[FabioPinheiro]

LGTM

You need to have the Signed-off-by: <Name> is not commits for DCO

[Rahul-2k4]

@FabioPinheiro thanks for the review. I pushed an update with the requested changes.

• Added an explicit note in the Mnemonic -> DID flow that the master key uses key-usage = 1.
• Added DCO sign-off to the commit and force-pushed the branch.
• Removed the Swift snippet for now so we do not document an unverified method name.

@goncalo-frade-iohk could you confirm the intended SDK-Swift API method for deterministic PRISM DID creation? I can add the correct snippet back right away once confirmed.

[Rahul-2k4]

@FabioPinheiro please do review on this and let me know if this looks good

[Rahul-2k4]

@yshyn-iohk could you please take a final review on this pr , and do lemme know if any thing can be added .
thank u

[yshyn-iohk]

The documentation is correct, but it won't be implemented across services and SDKs in the Identus Platform because it introduces a partial regression in the current test suites.
At the same time, anyone else can use this deterministic creation in their own solution.

The main aspect is that deterministic DID creation doesn't work with the long-form PRISM DID, as it creates the long-form DID using only the master key (no other keys, services, and verification methods can be added).

[Rahul-2k4]

Thanks, that makes sense. So the deterministic flow is valid on its own,, but it is not a good fit for Identus Platform right now because long-form PRISM DID creation depends on more than the master key. I appreciate the clarification.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[yshyn-iohk]

@Rahul-2k4, could you add DCO to your commits?

[Rahul-2k4]

@yshyn-iohk it's done

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud