Skip to content

Commit

Permalink
docs: 📖 issuer publickey specification
Browse files Browse the repository at this point in the history
  • Loading branch information
matteo-cristino committed Jan 17, 2024
1 parent 41e8acc commit f6efef4
Showing 1 changed file with 23 additions and 3 deletions.
26 changes: 23 additions & 3 deletions docs/did_security.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ This class represents a linked data signature verification key. See the [Dilithi

```json
{
"id": "did:example:123#key1",
"id": "did:example:123#dilithium_public_key",
"type": "Dilithium2VerificationKey",
"controller": "did:example:123",
"publicKeyBase58": "HKJdoS2NDCYGEVVMNDAVwHiEMjcYphbeeqshLtZJ6gqeFQjEKxXzB5X7tKFqXqVjqHRf8vCQoUVRUPifATqN7bosyBPUJsytYi6pwtvpMQJ9cakZzmhZnbeh8yJd2hxZNK3yTMNpQ6Y1rymzPGxyTZ3syDPLVk8HeHeaH399gabYfjnj7knM6cfmfyyZf6Vz5JmbCtPpAGpyaGPBtixHhMc8n1b9zEiXeaY4JpkjPVATM45pYo6di2ZNfhQh72VrhaVPZ8iLiPy2YQzoRRDfWz8byoVNqBDHS48uaEQ3tXbEHxcbbUfyoXfR7hh6s43ZKtBLgR2FuxTYwvJrji2e2BmC6bs8esNMfMNsaNWQxygf9R21iZAo7kvYU318CL7Tm8raDcGsiXzB24r9XWzCs7fFEYfQjWppcVwqGG7jdMr867KaxMBq1TpkSibhtYzJ7X3zLhEZge2hmD16Wa7vBh7hdwoRrq5uS7HRYzD9cXR5WVn7M39NcHqLzio9wub66YETi5pgbdD7EKwxEDN7WPSiVvjLzqGVpMhGwzKPpD7dBQof3bdDywxpzGmzwi2wbpuHDBwRceR7zy8TVdS1oDdGXkvjPQKrLXjwZMpWY3a31CEtxLp56Xqp5m12fx5L3d46ET7GdQDHE18inNPg1qNdjgJkbJc2X6qVFB6NWgQpAng4htiZSrNTLeTbbCik5xLaBUdBWoKiHkm3c12Xh9QvEEZq9xKZNEiDBsC6vnH2jcz55kfeJyKj9872hXhHe3MgfpFTm7aVWLghFj48YMwF7v8twUuEVmvVyLSWTkrRjEgnteELXUCdfbnjRw9H2ykbYK1eB8Q3cM6T6P94W3Qxy8axHMKmzCLVVTozXiED7vQS6vr7fERzrA4QRWbzbYc9utAhJewBaDGiLUuLQze5NLBLmGQEw6jCj9UtLj9sikzc6fSMYKrE9DQ2qXMN7ZGE5vfPd3y24acPGviezmcvTYAK3JnYsDso6UmZh5RH7BERXgX8R978hYYD1AWpjDcnV5rJp59cSTGWV26DCdhr1YrnLWtAAEsooRzYwoeU23dpCrUVJdSSQMp3QDF26hGDJ3ed6tP2jSW7ZvZQYPfjE7LinQfuLhLS282uoRxFopEJ8A5SP7ofpqDEayhPsfvYbHZqv5tzuvAP6nJyKd2Be1FuLzjszBHbms2Hc5Z6JYt48xz9UDawd1UJqkcWbk8YehoEyETr4DXaDErnmmKYk5o216xJK3gdHpvPB2uxQHfGWmBx9Gsrhr7xT82jdLGdpJ1iYA4CU4KcG3PNSwUonsSNpQfb9e9CTwDoGZaDqTs283WGn1ZG1dDsPzdTMkUYRc9TJPSgeoatmjad7mM1o2wsYCvZbEbU1ZGP21rayoWif7SZSRRUrtSRtWj75buTESf5C5rr7xFQkepuuEdmm2E4FwypQpQHxGVNJxAeaFTRtTu7LK6conHmQawaXM76zE2YqiVadpfBwqpQAcq8jSTRHSsoawon2ESaRd4yvcNKfu3HkJ4MJjfySQzwrFf2Ugyt2dfat62AcVF2RN1YukKSgWgaD7VmZvkM4iQg5pEtJyEsf3D6K4rqKH1UJBvYdCSvCbeYvS91JNNR9y37X35famBXkA6XLndLRMUqYd31CXbBmaPRnHnDmoQ2Q6NcXtAKUt2DSf2U9tVv4tCBqCbD8wAxwjAMXLbSeDWvcDjnLxGDPyroNFeKP3YZfZierDpEMbgdxpfoiWd6dhYRvy6mekDSLQftb45n3CK951oJjDrdi1V4if9FkwuH"
Expand All @@ -52,7 +52,7 @@ This class represents a linked data signature verification key. See the [BBS pap

```json
{
"id": "did:example:123#key1",
"id": "did:example:123#bbs_public_key",
"type": "BbsVerificationKey",
"controller": "did:example:123",
"publicKeyBase58": "rqGGNqCnuL1xWXGZZ2NYedvHVeAyG3wJUq451TE8q3MrQQFjcbgUPXtXiG87MAtBG4d4oyjiGGQNjPufGuo1t4AptCxGNTGvoGfWqLLwX1ozaJUAAwooTp5CCcWQZrkT1Sv"
Expand All @@ -71,9 +71,29 @@ This class represents a linked data signature verification key. This key represe

```json
{
"id": "did:example:123#key1",
"id": "did:example:123#es256_public_key",
"type": "EcdsaSecp256r1VerificationKey",
"controller": "did:example:123",
"publicKeyBase58": "5a1vFrHHfCULezmUm3mAsd6G9qtyHVvMH9aMLj7QGBkEg3nkqSjgVo4Pk64nMrm8z2ZmJ6whqzp1nPdqaQX5j6Hr"
}
```

### IssuerBLS12381VerificationKey
This class represents a linked data signature verification key. This key represent a compressed issuer key in the (Coconut)[https://arxiv.org/pdf/1802.07344.pdf] selective disclosure credential
scheme. The compression scheme transform a pair of two BLS12381 points (the original issuer public key) in one base58 string by first applying the (zcash compression)[https://datatracker.ietf.org/doc/html/draft-irtf-cfrg-pairing-friendly-curves-08#name-zcash-serialization-format-] to both of them followed by a simple concatenation.

**Status**:
*Stable*
**Expected properties**:
*id, type, controller, publicKeyBase58*

**Example**:

```json
{
"id": "did:example:123#issuer_public_key",
"type": "IssuerBLS12381VerificationKey",
"controller": "did:example:123",
"publicKeyBase58": "2eeoyWMdUh1KxbLNydhZxpbNDqh1aGiJaCMwMWP4PpqyD1oEBW9rmBaET5ZugQvocw3w5NzL1znB2SmSJLmd5J13QNnP4xGtmT8itf3j7jyakGBLmy3zg2sXJvkqZLsDySoHEfjJLGP8c5CbZvQCSydphNo4NWoi6s2RXBLotSXMQ2NsrcL6HoYsnJxTFcEDcFMuYiDGyyzpATPLBBNEVQ4VypdKtwrzgqwkMk1SDjiEqhwy61hYHknCJM6bDhirnjptpxL"
}
```

0 comments on commit f6efef4

Please sign in to comment.