dappauth

README

dappauth

Example usage within a webserver

package main

import (
	"log"
	"net/http"

	"github.com/ethereum/go-ethereum/ethclient"
	"github.com/dapperlabs/dappauth"
)

// AuthenticationHandler ..
type AuthenticationHandler struct {
	client *ethclient.Client
}

// NewAuthenticationHandler ..
func NewAuthenticationHandler(rawurl string) (*AuthenticationHandler, error) {
	client, err := ethclient.Dial(rawurl)
	if err != nil {
		return nil, err
	}
	return &AuthenticationHandler{client: client}, nil
}

// ServeHTTP serves just a single route for authentication as an example
func (a *AuthenticationHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {

	challenge := r.PostFormValue("challenge")
	signature := r.PostFormValue("signature")
	addrHex := r.PostFormValue("addrHex")

	authenticator := dappauth.NewAuthenticator(r.Context(), a.client)
	isAuthorizedSigner, err := authenticator.IsAuthorizedSigner(challenge, signature, addrHex)
	if err != nil {
		// return a 5XX status code
	}
	if !isAuthorizedSigner{
		// return a 4XX status code
	}

	// create an authenticated session for address
	// return a 2XX status code
}

func main() {
	handler, err := NewAuthenticationHandler("https://mainnet.infura.io")
	if err != nil {
		log.Fatal(err)
	}

	log.Fatal(http.ListenAndServe(":8080", handler))
}

Documentation

Overview

Package dappauth provides the ability to check if an Ethereume address is an authorized signer for a signature generated via eth_sign rpc method. Supports both external wallets and contract wallets.

Index

• type Authenticator
  • func NewAuthenticator(ctx context.Context, cc bind.ContractCaller) *Authenticator
  • func (a *Authenticator) IsAuthorizedSigner(challenge, signature, addrHex string) (bool, error)

Types

type Authenticator

type Authenticator struct {
	// contains filtered or unexported fields
}

Authenticator is the instance that holds the ethclient.Client .

func NewAuthenticator

func NewAuthenticator(ctx context.Context, cc bind.ContractCaller) *Authenticator

NewAuthenticator creates a new Authenticator .

func (*Authenticator) IsAuthorizedSigner

func (a *Authenticator) IsAuthorizedSigner(challenge, signature, addrHex string) (bool, error)

IsAuthorizedSigner implements the logic to check if an address is an authorized signer for a signature and challenge.