snowballtools-base-old/README.md
Nabarun Gogoi ef0eac8293
Implement authentication with SIWE (#99)
* Create web3 modal provider with SIWE

* Add auth router to handle SIWE authentication

* Use axios instance to make request

* Add button for SIWE authentication

* Add changes to access session in web-app GQL requests

* Add auth check in GQL context and load/create user

* Use authenticated user from context

* Redirect to sign in page if unauthenticated and logout button

* Change sign-in route to login

* Get project domain from config file

* Set user ethAddress column as unique

* Use formatted user name

* Get session secret and origin url from config file

* Add unique constraint for eth address

* Get secure and samesite from origin url

* Get wallet connect id and backend url from env file

* Format user email in member tab panel

* Add backend config isProduction to set trust proxy

* Use only one server url config

* Add tool tip for displaying email

* Add trustProxy and domain in server.session config

* Add SERVER_GQL_PATH constant in frontend

---------

Co-authored-by: neeraj <neeraj.rtly@gmail.com>
2024-02-22 17:26:26 +05:30

3.9 KiB

snowballtools

Setup

  • Clone the snowballtools repo

    git clone git@github.com:snowball-tools/snowballtools-base.git
    
  • In root of the repo, install depedencies

    yarn
    
  • Build packages

    yarn build --ignore frontend
    

Backend

  • Change directory to packages/backend

    cd packages/backend
    
  • Load fixtures in database

    yarn test:db:load:fixtures
    
  • Set gitHub.oAuth.clientId and gitHub.oAuth.clientSecret in backend config file

  • Run the laconicd stack following this doc

  • Get the private key and set registryConfig.privateKey in backend config file

    laconic-so --stack fixturenet-laconic-loaded deploy exec laconicd "laconicd keys export mykey --unarmored-hex --unsafe"
    # WARNING: The private key will be exported as an unarmored hexadecimal string. USE AT YOUR OWN RISK. Continue? [y/N]: y
    # 754cca7b4b729a99d156913aea95366411d072856666e95ba09ef6c664357d81
    
  • Get the REST and GQL endpoint ports of Laconicd and replace the ports for registryConfig.restEndpoint and registryConfig.gqlEndpoint in backend config file

    # For registryConfig.restEndpoint
    laconic-so --stack fixturenet-laconic-loaded deploy port laconicd 1317
    # 0.0.0.0:32777
    
    # For registryConfig.gqlEndpoint
    laconic-so --stack fixturenet-laconic-loaded deploy port laconicd 9473
    # 0.0.0.0:32771
    
  • Run the script to create bond, reserve the authority and set authority bond

    yarn test:registry:init
    # snowball:initialize-registry bondId: 6af0ab81973b93d3511ae79841756fb5da3fd2f70ea1279e81fae7c9b19af6c4 +0ms
    
    • Get the bond id and set registryConfig.bondId in backend config file
  • Setup ngrok for GitHub webhooks

    • https://ngrok.com/docs/getting-started/
    • Start ngrok and point to backend server endpoint
      ngrok http http://localhost:8000
      
    • Look for the forwarding URL in ngrok
      ...
      Forwarding                    https://19c1-61-95-158-116.ngrok-free.app -> http://localhost:8000
      ...
      
    • Set gitHub.webhookUrl in backend config file
      ...
      [gitHub]
        webhookUrl = "https://19c1-61-95-158-116.ngrok-free.app"
      ...
      
  • Start the server in packages/backend

    yarn start
    

Frontend

  • Change directory to packages/frontend in a new terminal

    cd packages/frontend
    
  • Copy the graphQL endpoint from terminal and add the endpoint in the .env file present in packages/frontend

    REACT_APP_SERVER_URL = 'http://localhost:8000'
    
  • Copy the GitHub OAuth app client ID from previous steps and set it in frontend .env file

    REACT_APP_GITHUB_CLIENT_ID = <CLIENT_ID>
    
  • Set REACT_APP_GITHUB_TEMPLATE_REPO in .env file

    REACT_APP_GITHUB_TEMPLATE_REPO = cerc-io/test-progressive-web-app
    

Development

  • Start the React application

    yarn start
    
  • The React application will be running in http://localhost:3000/

Production

  • Build the React application

    yarn build
    
  • Use a web server for hosting static built files

    python3 -m http.server -d build 3000