Skip to content

ArisenIO/arisen-ual-dwebid

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

87 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UAL for dWebID Authenticator

This authenticator is meant to be used with the dWebID Authenticator Apps and the Universal Authenticator Library.

ARISEN Labs

Getting Started

yarn add arisen-ual-dwebid

Dependencies

  • All apps must follow the Manifest Specification

  • You must use one of the UAL renderers below.

    • React - https://github.com/arisenio/dwebual-reactjs-renderer

    • PlainJS - https://github.com/arisenio/dwebarisen-ual-plainjs-renderer

Basic Usage with React

import { ARISENAuth } from 'arisen-ual-dwebid'
import { UALProvider, withUAL } from '@dwebual/reactjs-renderer'

const exampleNet = {
  chainId: '',
  rpcEndpoints: [{
    protocol: '',
    host: '',
    port: '',
  }]
}

const App = (props) => <div>{JSON.stringify(props.ual)}</div>
const AppWithUAL = withUAL(App)

const arisenAuth = new ARISENAuth([exampleNet], { appName: 'Example App' })

<UALProvider chains={[exampleNet]} authenticators={[arisenAuth]}>
  <AppWithUAL />
</UALProvider>

Supported Environments

The UAL dWebID Authenticator is currently supported on the following environments and their required options are listed below:

  • Chrome Desktop Browser - dWebID Chrome Extension Authenticator App
    • Required option: appName
    • Optional option: securityExclusions
    const securityExclusions = {
      addAssertToTransactions: false
    }
    const arisenAuth = new ARISENAuth([exampleNet], { appName: 'Example App', securityExclusions })
  • iOS - dWebID iOS Authenticator App
    • Required options: appName, protocol
    • Optional option: securityExclusions
    const securityExclusions = {
      addAssertToTransactions: false
    }
    const arisenAuth = new ARISENAuth([exampleNet], { appName: 'Example App', protocol: 'arisen', securityExclusions })

License

MIT

Packages

No packages published

Languages

  • TypeScript 94.5%
  • JavaScript 5.5%