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

Start contributing a Q&A and Glossary #106

Open
wants to merge 33 commits into
base: master
Choose a base branch
from
Open
Changes from 1 commit
Commits
Show all changes
33 commits
Select commit Hold shift + click to select a range
2b07537
Henk signed CLA
henkvancann Feb 24, 2021
a26251d
first move
henkvancann Feb 24, 2021
0ef5bdb
the right file committed
henkvancann Feb 24, 2021
b96d74a
questions added
henkvancann Feb 24, 2021
9220a3e
five questions and answers added after testing
henkvancann Feb 28, 2021
76d21bc
Merge branch 'master' of https://github.com/BlockchainCommons/Gordian…
henkvancann Dec 15, 2021
ef71bce
Gordian Seed Tool instead of GordianGuardian
henkvancann Dec 15, 2021
e1ac38b
Gordian Seed Tool KEY export
henkvancann Dec 15, 2021
80da990
Glossary replaced by Definitions
henkvancann Dec 15, 2021
9b50c5d
Definitions.md created
henkvancann Dec 15, 2021
0d26cc0
Definitions.md moved in right directory
henkvancann Dec 15, 2021
26f5c7d
Try to solve the case insensitivity issue - take1
henkvancann Dec 15, 2021
eb70c9b
Try to solve the case insensitivity issue - take2
henkvancann Dec 15, 2021
ccd0826
First batch of Q&A and Definitions - take 1
henkvancann Dec 15, 2021
8c93cf8
First batch of Q&A and Definitions - take 2
henkvancann Dec 15, 2021
f7f2413
First batch of Q&A and Definitions - take3
henkvancann Dec 15, 2021
0060586
Merge branch 'master' of https://github.com/BlockchainCommons/Gordian…
henkvancann Dec 16, 2021
21f6e1d
Second batch of amendments Q&A, Definitions and Test Instructions - p…
henkvancann Dec 16, 2021
a57441b
Second batch of amendments Q&A, Definitions and Test Instructions - p…
henkvancann Dec 16, 2021
44cf6d7
Second batch of amendments Q&A, Definitions and Test Instructions - p…
henkvancann Dec 16, 2021
5aa512f
Second batch of amendments Q&A, Definitions and Test Instructions - p…
henkvancann Dec 16, 2021
0d03c71
Second batch of amendments Q&A, Definitions and Test Instructions - p…
henkvancann Dec 16, 2021
64c2434
Second batch of amendments Q&A, Definitions and Test Instructions - p…
henkvancann Dec 16, 2021
49b66af
Second batch of amendments Q&A, Definitions and Test Instructions - p…
henkvancann Dec 16, 2021
8f15afe
Second batch of amendments Q&A, Definitions and Test Instructions - p…
henkvancann Dec 16, 2021
c38f262
Second batch of amendments Q&A, Definitions and Test Instructions - p…
henkvancann Dec 16, 2021
80fd436
Second batch of amendments Q&A, Definitions and Test Instructions - p…
henkvancann Dec 16, 2021
7894abc
Third batch of documentation efforts on Q&A, defnitions and Testing d…
henkvancann Dec 18, 2021
61b3375
Third batch of documentation efforts on Q&A, defnitions and Testing d…
henkvancann Dec 18, 2021
00e7760
Third batch of documentation efforts on Q&A, defnitions and Testing d…
henkvancann Dec 19, 2021
4a24a59
editorial: revisions and polishing
shannona Jan 5, 2022
0d10a3a
removed a {TBW}
shannona Jan 5, 2022
e823644
editorial polish
shannona Jan 6, 2022
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Try to solve the case insensitivity issue - take2
  • Loading branch information
henkvancann committed Dec 15, 2021

Verified

This commit was signed with the committer’s verified signature.
paulmueller Paul Müller
commit eb70c9b2d20e4ad4bc35103cd1a7948e40892e02
178 changes: 178 additions & 0 deletions Docs/Q-and-A.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,178 @@
# Q&A about Gordian Seed Tool

<img src="../images//gg-list.jpg" alt="Gordian Seed Tool Seed manager" border="0" width="300">

This document depends on a common [Glossary](./Definitions.md)

Why should you read or step through the Q&A? To get a different angle to the same topic: Gordian Seed Tool.

**The questions are of a varied level: basic and detailed. The answers are mostly directed towards generally interested people and newbies.**\
*Q = one star question. Novice to Gordian Seed Tool, advanced in DIDs\
**Q = two star question. Proficient in DIDs and advanced in Gordian Seed Tool\
***Q = three star question. Expert in DIDs and proficient in Gordian Seed Tool

```
{TBW} means: to be written
{TBW prio 1} means to be written with the highest priority, 3 = no urgency, 2 = intermediate}
```
- [Q&A about Gordian Seed Tool](#qa-about-gordian-seed-tool)
+ [Disclaimer](#disclaimer)
+ [List of questions and definitions](#list-of-questions-and-definitions)
* [Knowledge you should be confidently applying](#knowledge-you-should-be-confidently-applying)
* [Actions you should be comfortable with](#actions-you-should-be-comfortable-with)
- [Jump table to categories](#jump-table-to-categories)


## Beware: A Q&A is always *work in progress*. Tips & help welcome.

### Disclaimer
None of the respondents in the **open** repo and presentations have been explicitly named as a source, except for ***Christopher Allen***, *** 🐺 Wolf mcNally*** and ***@henkvancann***. If there is no reference added to the answers, then it's Christopher Allen who answered the question. Most of the editing is done by @henkvancann, which might have introduced ommission, errors, language glitches and such. Sorry for that, feel free to correct by submitting a pull request (PR).\
For practical reasons educational images uploaded by Github members have been downloaded. We de-personalised them by giving images a new name. Under these new names these images have been uploaded to github and used in the Q&A to clarify the questions and answers.

Gordian Seed Tool's content is licensed under the [CC by SA 4.0. license](https://creativecommons.org/licenses/by-sa/4.0/).

We've done our best to protect the privacy of the Github by investigating the images we used. We haven't come across personal identifiable information (pii). However, should we have made a mistake after all, please let us know and we'll correct this immediately.

### List of questions and definitions

- [Definitions:](#definitions)
- [Cryptocurrency](./Definitions.md#cryptocurrency)
- [Decentralized Identity](./Definitions.md#decentralized-identity)
- [Entropy](./Definitions.md#entropy)
- [Entity](./Definitions.md#entity)
- [Inconsistency](./Definitions.md#inconsistency)
- [Identity](./Definitions.md#identity)
- [Key](./Definitions.md#key)
- [Payload](./Definitions.md#payload)
- [Public Key Infrastructure](./Definitions.md#public-key-infrastructure)
- [Root of trust](./Definitions.md#root-of-trust)
- [Secret](./Definitions.md#secret)
- [Transfer](./Definitions.md#transfer)
- [Trust-over-IP](./Definitions.md#trust-over-ip)
- [Validator](./Definitions.md#validator)
- [Verifiable Credential](./Definitions.md#verifiable-credential)
- [W3C DID](./Definitions.md#w3c-did)
- [(Digital Identity) Wallet](./Definitions.md#-digital-identity--wallet)


<small><i><a href='http://ecotrust-canada.github.io/markdown-toc/'>Table of contents generated with markdown-toc</a></i></small>

## Knowledge you should be confidently applying
- The definitions in the [glossary](./Definitions.md)
- Public private key pairs
- Hashing and hashes
- Signatures and Seeds
- W3C DIDs
## Actions you should be comfortable with
- Amend knowledge and keep existing knowledge up to date
- create a key pair safely and back it up safely
- sweep to a new wallet

# Jump table to categories
- [General](#qa-section-general)
- [Gordian Seed Tool and DIDs](#qa-gordian-seed-tool-and-dids)
- [Wallets](#qa-section-wallets)
- [Schemes](#qa-section-schemes)
- [Proofs](#qa-section-proofs)
- [Private Key Management](#qa-section-private-key-management)
- [Blockchain](#qa-key-blockchain)
- [Security](#qa-section-security)
- [Gordian Seed Tool operational](#qa-section-gordian-seed-tool-operational)
- [Agencies](#qa-key-agencies)
- [Virtual Credentials](#virtual-credentials)

# Q&A section General

## *Q: What is Gordian Seed Tool?
The old name for the Gordian Seed Tool, it's a synonym.

## *Q: What is GordianGuardian?
The old name for the Gordian Seed Tool, it's a synonym.

## **Q: Is there crypto-request for Output Descriptors or Account Descriptors as well?
We haven't defined them yet (WM, December 2021).

<img src="../images/xxxx.png" alt="xxxx" border="0" width="600">

## For who Gordian Seed Tool?

## WHy should I use Gordian Seed Tool?

## When should I use Gordian Seed Tool?

# Q&A section Gordian Seed Tool operational

## *Q: On what platform or devices does Gordian Seed Tool run?
March 2021: Currently only iOS Testflight, alpha release.

## I get confused by a *seed request* on one device. Could explain more?
- [x] github [issue 40](https://github.com/BlockchainCommons/GordianGuardian-iOS/issues/40)

🐺 I'm not sure how to make this clearer. Typically "another device" **will note** be this device. If the requested seed is not already on the device, it obviously can't send it, and will tell you so. It also makes clear the consequences of sending the seed (via the QR Code) to another device.\
The request URs available [in the test PDFs](https://github.com/BlockchainCommons/GordianGuardian-iOS/tree/master/Testing) are so, you can test a UR similar to what another device would show when requesting a seed from this device.

# Q&A Schemes

## **Q: Is SSKR a rebrand of SSSS, Shamir Secret Sharing scheme?
- [x] github [issue 37](https://github.com/BlockchainCommons/GordianGuardian-iOS/issues/37)
🐺 Under the hood SSKR is using the technique of Shamir's Secret Sharing (SSS) but SSKR is a particular packaging of that technique optimized for `CBOR` and `UR`s.

| ===| | =========================== |
|---| -------- | ------------------------ |
| | ![](https://i.imgur.com/SYpP0sK.png) | |

# Q&A Security

## *Q: I can import the same seed twice
*I can't think of a reason why I would want to import the same seed twice.*
- [x] github [issue 41](https://github.com/BlockchainCommons/GordianGuardian-iOS/issues/41)

🐺 `ur:crypto-seed` contains metadata like name and notes that can be different. It's up to the user to reconcile these differences.

| ===| | =========================== |
|---| -------- | ------------------------ |
| | ![](https://i.imgur.com/y7QwKOI.png) | |


## *Q: Why it is recommended to delete all data from the device before deleting the app?
🐺 {TBW1}
- [x] github [issue 36](https://github.com/BlockchainCommons/GordianGuardian-iOS/issues/36)

| ===| | =========================== |
|---| -------- | ------------------------ |
| | ![](https://i.imgur.com/QuQ9EZB.png) | |

## *Q: I swiped to delete a seed, now the settings cog asks me to delete ALL seeds??
*If as a user 'I don't know that I have to right-left swipe' to delete a rendundant seed, then clicking on the seed and as natural flow, I choose the cog, I might go forward and delete everything, instead of trying to get rid of just one seed.*
- [x] github [issue 42](https://github.com/BlockchainCommons/GordianGuardian-iOS/issues/42)

| Swipe left | Click on |
| -------- | -------- |
| ![](https://i.imgur.com/3knEgl3.png) | ![](https://i.imgur.com/hqilJcJ.jpg) |

🐺 **You don't have to swipe on a seed to delete it**. Just tap the Edit button and then tap one of the Delete buttons that appear. This is iOS-standard behavior. Swipe-to-delete is a shortcut. Later when we have more settings the "Danger Zone" box will get pushed down further.
> The warning message has been clarified to: "All data will be erased from the app, including ALL seeds stored in the device keychain. This is recommended before deleting the app from your device, because deleting an app does not guarantee deletion of all data added to the keychain by that app."

## *Q: Copy paste of a BIP39 seed is a good idea?
There are security issues related to copy-pasting when your computer has been compromised. On the other hand it's easy and less error prone to copy and paste. It's your choice. You can also type in the 24 word seed.


## *Q: On which platforms is Gordian Seed Tool available
Gordian Seed Tool is available for iOS and Mac 1.3 (December 2021)

## **Q: To which formats can I export my GST keys?
Key Export: Master keys derived from seeds can now be exported to Output Descriptors (`crypto-output`) or Account Descriptors (`crypto-account`).

## **Q: How can I export my GST keys?

* To see this new feature:
1. choose a seed from the Seed List,
2. In the Encrypted Data section, tap Authenticate,
3. Tap Derive Key and then Other Key Derivations,
4. In the Parameters area, make sure Bitcoin and Master Key are selected,
5. Scroll down to the Secondary Derivation section and choose Output Descriptor or Account Descriptor.
6. Choose Output Descriptor or Account Descriptor, and edit the Account Number field if desired.
7. If you chose Output Descriptor, then choose an Output Type.
8. Scroll down to the bottom to export your Output Descriptor or Account Descriptor.

* Output Descriptors may be exported as text format or `ur:crypto-output` format. Account Descriptors may be exported in `ur:crypto-account` format.