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

Documentation feedback #96

Open
Vishwas1 opened this issue Jul 19, 2023 · 1 comment
Open

Documentation feedback #96

Vishwas1 opened this issue Jul 19, 2023 · 1 comment

Comments

@Vishwas1
Copy link
Contributor

Vishwas1 commented Jul 19, 2023

  1. We are not asking for any ver method id in signClientSpec() method, whereas in sign() we are asking ver method id, why? is it hardcoded like the fist property? Why to ask for address: string; property, instead we should ask for ver_method_id and then fetch walletaddress out of blockchainaccountid right?
  1. Web3 latest version does not work; it works with "web3": "^1.6.0"
  1. Method definition for sign() and signClientSpec() return types are differnt. For sign() we have Promise<ISignedDIDDocument>; whereas for signedClientSpec() we have Promise<{ didDocument: Did; signature: string }>: There should be consistency.
  1. No explanation for ISignedDIDDocument for sign()
  1. Use ether.js in frontend and test as well since most devs uses ether.js
  1. Take entity API key as a param to the SDK, if developer has passed, offlinesigner, then use offlineSigner as primary wallet otherwise, use API to do all on chain activities. This was, developer a) dont have to worry about understanding offline signer, b) The dont have to worry about HID wallet since it will be abstracted out with APIs. They only focus on
    understanding doc of JS sdk. Entity API key as optional param in Hypersign SDK #95
  1. Explain about verifiable Relationship
  1. No explanation about clientSpec at all
  1. Explanation of retrun type for generate() is not there. Its just written Promise<object>
  1. Explanation of retrun type for sign() is not there. Its just written Promise<ISignedDIDDocument>
  1. Explanation of retrun type for verify() is not there. Its just written Promise<object>
  1. Explanation of retrun type for resolve() is not there. Its just written Promise<object>
  1. Explanation of retrun type for createByClientSpec() is not there. Its just written Promise<object>
  1. Explanation for IVerificationRelationships is missing
@Vishwas1
Copy link
Contributor Author

Vishwas1 commented Jul 19, 2023

  • point 1 is I feel is a bug. so fix it on priority,
  • Point 6 we need to implement
  • Point 3 is also important

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

No branches or pull requests

1 participant