ts-dev-env-setup.md

TS Dev Environment Setup

Resources

• avalanchejs-scripts

Node Version Manager

• nvm

Currently we're using nodeJS v12.14.1. IIRC there's a new LTS but Emre asked that we stay on this version due to issues upgrading the web wallet.

Install

wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash

List remote versions

nvm ls-remote

List installed versions

nvm ls

Install a version

nvm install v12.14.1

Use an installed version

nvm use 12.14.1

Default to an installed version

nvm default 12.14.1

TS Node

• ts-node

Installation

# With TypeScript.
npm install -g typescript
npm install -g ts-node

Usage

# Execute a script as `node` + `tsc`.
ts-node script.ts

# Starts a TypeScript REPL.
ts-node

VSCode Debugging

• More info

TSConfig

{
  "compilerOptions": {
    "target": "es6",
    "module": "commonjs",
    "lib": ["es2015", "dom"],
    "allowJs": true,
    "skipLibCheck": true,
    "sourceMap": true,
    "outDir": "dist",
    "strict": true,
    "noImplicitAny": true,
    "moduleResolution": "node",
    "baseUrl": "./",
    "esModuleInterop": true
  },
  "include": ["*"],
  "exclude": ["node_modules"]
}

.vscode/launch.json

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch Program",
      "skipFiles": [
        "<node_internals>/**"
      ],
      "program": "${workspaceFolder}/FILENAME-TO-CHANGE.ts",
      "preLaunchTask": "tsc: build - tsconfig.json",
      "outFiles": [
        "${workspaceFolder}/dist/**/*.js"
      ]
    }
  ]
}

Usage

1. Add breakpoinst to FILENAME-TO-CHANGE from the previous step.
2. Open the "Run" tab with cmd+shift+D.
3. Have the top dropdown menu read "Launch Program" and click the green "Start Debugging" play button.
4. If you see a popup error click "Debug Anyway"
5. You'll now be debugging. You can step over/in/out of functions. You can observe the stack. You can inspect variable values and call methods from the debug terminal tab.