Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create resolvable json-ld for DID Doc examples #55

Closed

Conversation

c2bo
Copy link
Member

@c2bo c2bo commented Feb 28, 2022

The main focus was to try to create fully resolvable json-ld and updating to be compliant to the examples given in did-core
Fixes #51

Signed-off-by: Christian Bormann [email protected]

@@ -173,7 +174,6 @@ If clients want to continue to retrieve and use the `endpoint` [[ref: ATTRIB]] t

``` json
"diddocContent" : {
"@context" : [ "https://identity.foundation/didcomm-messaging/service-endpoint/v1" ],
"service": [
{
"id": "did:indy:sovrin:123456#did-communication",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, but this is still not a complete JSON-LD DIDdoc because we still need a resolvable context for the DIDcomm service. If we want to be correct, we'd either need this context or restrict it to a JSON DIDdoc.

If you look at the example DIDdoc in the JSON-LD playground, you'll see that all the unknown properties in the service object get dropped during JSON-LD processing.

Copy link
Member Author

@c2bo c2bo Feb 28, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, i couldn't find any context to use here - the did-core example only shows:

{
  "service": [{
    "id":"did:example:123#linked-domain",
    "type": "LinkedDomains", // external (property value)
    "serviceEndpoint": "https://bar.example.com"
  }]
}

LinkedDomains is defined here: https://identity.foundation/.well-known/did-configuration/v1
I wasn't really sure what to use here - i guess we have to provide a context for did-communication ourselves ?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@swcurran @TelegramSam Would it be possible to host an appropriate context e.g. at https://identity.foundation or https://didcomm.org/ ? This context would not be Indy specific but define the properties according to Aries RFC 67

Copy link
Member Author

@c2bo c2bo Feb 28, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess we would need 2 documents?

  • one definining did-communication (aries rfc)
  • and one defining DIDCommMessaging (didcommv2)

Unless I am blind (which very well might be the case) all examples for didcommv2 are also given without a resolvable context.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Apparently, I am blind. This isn't used anywhere in the examples in https://identity.foundation/didcomm-messaging/spec/ and only in https://www.w3.org/TR/did-spec-registries/#didcommmessaging?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not certain where this sits based on the comments. Is this ready to merge?

Let's finalize at the meeting tomorrow.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We still don't have a didcommv1context that is resolvable as far as I understand. It is marked with a TODO in the text for the time being (::: todo Fix DIDcommv1 / aries rfc 0067 compliant context).

@domwoe
Copy link
Contributor

domwoe commented Mar 1, 2022

Besides the open point with the context for the DID Communication service, I think this is a valuable PR. It is really painful to see lots of invalid JSON-LD examples everywhere

@swcurran swcurran marked this pull request as ready for review March 28, 2022 17:29
@c2bo
Copy link
Member Author

c2bo commented May 10, 2022

Do we want to merge this in its current state as an example and adjust it once we start touching these points in the aries implementations (and need a valid context for the service endpoint according to https://github.com/hyperledger/aries-rfcs/tree/main/features/0067-didcomm-diddoc-conventions) ?

@swcurran
Copy link
Member

I think it would be good to merge it. Those that know more about contexts and the state of the DIDComm contexts can weigh in before or after. Let's wait a few more days for feedback or other approaches to this one.

@TelegramSam -- comments?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

DIDcomm service-endpoint in example DID Docs
4 participants