tlsn-js/quickstart.md

Quick Start Guide

There is a simple react/typescript demo app in ./demo/react-ts-webpack. The directory contains a webpack configuration file that allows you to quickly bootstrap a webpack app using tlsn-js.

Run a local notary server and websocket proxy

Websocket Proxy

Since a web browser doesn't have the ability to make TCP connection, we need to use a websocket proxy server.

To run your own websocket proxy for https://swapi.dev locally:

1. Install websocat:

   tool	command
   cargo	cargo install websocat
   brew	brew install websocat
   source	https://github.com/vi/websocat

2. Run a websocket proxy for https://swapi.dev:

websocat --binary -v ws-l:0.0.0.0:55688 tcp:swapi.dev:443

Note the tcp:swapi.dev:443 argument on the last line, this is the server we will use in this quick start.

Run a Local Notary Server

For this demo, we also need to run a local notary server.

• Use docker

  npm run notary
  

• Or, compile and run the notary server natively:

  # Clone the TLSNotary repository:
  git clone https://github.com/tlsnotary/tlsn.git --branch "v0.1.0-alpha.10"
  cd tlsn/crates/notary/server/
  # Run the ntoary server
  cargo run --release -- --tls-enabled false
  

The notary server will now be running in the background waiting for connections.

tlsn-js in a React/Typescript app

1. Compile tlns-js

   npm i
   npm run build
   

2. Go to the demo folder

   cd demo/react-ts-webpack
   

3. Install dependencies

   npm i
   

4. Start Webpack Dev Server:

   npm run dev
   

5. Open http://localhost:8080 in your browser
6. Click the start demo button
7. Open developer tools and monitor the console logs