3 minute read


Build User-Centric Ethereum Apps

  • uport-connect/guides/usage

    The uPort Connect library is a client-side library that allows you to interact with a user’s uPort identity through a uPort client, primarily the uPort mobile app. The Connect library bundles functionality from our other libraries into a singular, easy to use interface.

    This guide describes the parts which make-up Connect and provides further details on how to configure it for your specific use case. While Connect is likely the best solution for most use cases, you may decide you need greater optionality and control over certain use cases, in that situation, you may be interested in using uport-tranports and uport-credentials as an alternative.

  • RequestVerification

    Much like logging in, using uport-connect to request verified data about uPort mobile clients is simple. So simple we will follow the same steps of logging in, but this time pass an array of verification titles that we want to request for disclosure. Our connect library manages the flow for you with minimal configuration.

  • SendVerification

    Much like logging in, using uport-connect to create and send verifications to uPort mobile clients is simple. Our connect library will manage much of the flow for you with minimal configuration.

  • Goodbye uPort DIDs, Hello Ethr-DIDs
  • Using the Ethr-DID library, you can:
    • Create and manage keys for DID identities
    • Sign JSON Web Tokens
    • Authorize third parties to sign on a DID’s behalf
    • Enable discovery of service endpoints (e.g. decentralized identity management services)

    The Ethr-DID library conforms to ERC-1056 and supports the proposed Decentralized Identifiers spec from the W3C Credentials Community Group. These allow for Ethereum addresses to be used as fully self-managed Decentralized Identifiers (DIDs), as a result, you can easily create and manage keys for these identities. This library also allows you to sign standard compliant JSON Web Tokens (JWTs) that can be consumed using the DID-JWT library.

  • uPort Credentials library allows you to:
    • Create and verify authentication requests
    • Request verified claims
    • Verify claims for your users
    • Ask users to sign Ethereum transactions
    • Create Ethereum smartcontract function call requests without web 3.0
  • Ethereum DID Registry

    This contract allows on-chain and off-chain resolving and management for DIDs (Decentralized Identifiers).

    A DID is an Identifier that allows you to lookup a DID document that can be used to authenticate you and messages created by you.

    It’s designed for resolving public keys for off-chain authentication—where the public key resolution is handled by using decentralized technology.

    This contract allows Ethereum addresses to present signing information about themselves with no prior registration. It allows them to perform key rotation and specify different keys and services that are used on its behalf for both on and off-chain usage.

  • uPort Transports allows you to:
    • Send messages to users using a QR code
    • Send requests and receive responses through URLs
    • Send encrypted push notifications
    • Create Transports specific to your use case and environment

Zug ID

  • A position paper on blockchain enabled identity and the road ahead—Identity Working Group of the German Blockchain Association [ϟ]

    City of Zug (UPort and ti&m)

    As a first pilot project in Switzerland, the city of Zug is currently piloting a SSI solution. The local administration is cooperating with the IT consulting company ti&m, as well as UPort to provide a basic infrastructure for their citizens to attest their identity. With the SSI implemented in Zug, users can now pay their parking fees, register for elections or perform online sign on for e-government services33. The benefits range for the city of Zug are low infrastructure requirements, decreased security risks, cost effectiveness, GDPR compliance and scalability.

  • Zug ID: Exploring the First Publicly Verified Blockchain Identity