@depay/widgets 6.0.0 → 6.2.0

package/README.md

@@ -3,7 +3,7 @@
 You can either load the `@depay/widgets` package via CDN:
 
 ```
-<script src="https://integrate.depay.fi/widgets/v5.js"></script>
+<script src="https://integrate.depay.fi/widgets/v6.js"></script>
 ```
 
 or you install `@depay/widgets` via the package manager of your choice and ship it as part of your application bundle:
@@ -58,7 +58,7 @@ In order to receive decentralized payments on any blockchain you need to have yo
 ### Quick start
 
 ```
-<script src="https://integrate.depay.fi/widgets/v5.js"/>
+<script src="https://integrate.depay.fi/widgets/v6.js"/>
 ```
 
 ```
@@ -539,7 +539,7 @@ In order to sell tokens in a decentralized way, that token needs to have a liqui
 ### Quick start
 
 ```
-<script src="https://integrate.depay.fi/widgets/v5.js"/>
+<script src="https://integrate.depay.fi/widgets/v6.js"/>
 ```
 
 ```javascript
@@ -901,7 +901,7 @@ In order to receive decentralized donation payments on any blockchain you need t
 ### Quick start
 
 ```
-<script src="https://integrate.depay.fi/widgets/v5.js"/>
+<script src="https://integrate.depay.fi/widgets/v6.js"/>
 ```
 
 ```javascript
@@ -1255,7 +1255,7 @@ DePay Connect allows you to have your users connect their crypto wallet to your
 Returns connected `account`, `accounts` and `wallet` in return. 
 
 ```
-<script src="https://integrate.depay.fi/widgets/v5.js"/>
+<script src="https://integrate.depay.fi/widgets/v6.js"/>
 ```
 
 ```javascript
@@ -1276,6 +1276,83 @@ DePayWidgets.Connect().then(()=>{}).catch((error)=>{
 
 ```
 
+## DePay Login
+
+DePay Login allows you to perform web3 wallet logins with ease.
+
+Returns `account` if succesfully signed and recovered log in message.
+
+```
+<script src="https://integrate.depay.fi/widgets/v6.js"/>
+```
+
+```javascript
+let message = "Sign to login"
+let account = await DePayWidgets.Login({ message })
+```
+
+Connects wallet and instructs connected wallet to sign `message`, afterwards sends `signature` and `message` to `POST /login` (or `endpoint` if defined):
+
+```
+POST /login
+BODY
+  {
+    "message": "Sign to login",
+    "signature": "0x123456" // raw signature
+  }
+```
+
+The `/login` endpoint needs to recover the address for `message` and `signature` and needs to return it in the response:
+
+```
+POST /login
+RESPONSE
+  "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
+```
+
+Which will resolve the `DePayWidgets.Login` request to the resolved account:
+
+```javascript
+account // 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
+```
+
+You can also pass a `recover` function that takes care of signature recovery:
+
+```javascript
+DePayWidgets.Login({ message, recover: ({ message, signature })=>{
+    return new Promise((resolve, reject)=>{
+      fetch('https://example.com/login', {
+        method: 'POST',
+        body: JSON.stringify({ message, signature })
+      })
+        .then((response)=>{
+          if(response.status == 200) {
+            response.text().then((account)=>{
+              resolve(account)
+            }).catch(reject)
+          } else {
+            response.text().then((text)=>{
+              reject(text || 'Recovering login signature failed!')
+            }).catch(reject)
+          }
+        })
+    })
+  }
+})
+```
+
+### Rejections
+
+1. Rejects if user just closes the dialog without connecting any wallet:
+
+```javascript
+
+DePayWidgets.Login().then(()=>{}).catch((error)=>{
+  error // "USER_CLOSED_DIALOG"
+})
+
+```
+
 ## Development
 
 ### Quick start