Setup nix

.envrc

@@ -0,0 +1,2 @@
+watch_dir nix
+use flake

.gitignore

@@ -1 +1,2 @@
 .idea/
+.direnv/

docs/CONTRIBUTING.md

@@ -7,6 +7,7 @@
 As a requirement under the hyperledger foundation, all commits must be signed off. This can be done by adding the `-s` flag every time you commit.
 
 An alternative is to add the follow git hook (at `.git/hooks/prepare-commit-msg`):
+
 ```
 #!/bin/sh
 
@@ -30,4 +31,22 @@ git interpret-trailers --if-exists doNothing --trailer \
 
 it is also recommended (but not required) to add a gpg key: https://docs.github.com/en/authentication/managing-commit-signature-verification/adding-a-gpg-key-to-your-github-account
 
+### repo tooling
+
+The easiest way to setup the repo for development is to install [direnv](https://direnv.net/) and the [nix package manager](https://nixos.org/). This guarantees that all contributors have identical dev environments on their machine. If set up correctly, then `cd`-ing into the repo root will automatically install all build tooling dependencies. To check that you've done this successfully, run
+
+```sh
+$ which node
+/nix/store/gxr9abzyqmva25p3k142qs1djj9q5fqw-nodejs-22.14.0/bin/node
+```
+
+you should see an output similar to the above.
+
+#### manual setup
+
+If you'd rather avoid installing and using Nix, then ensure you've installed the following packages and their respective versions on your machine.
 
+| Package | Version |
+| ------- | ------- |
+| NodeJS  | 22.14.0 |
+| NPM     | 10.9.2  |

flake.nix

@@ -0,0 +1,19 @@
+{
+  description = "Splice Wallet Kernel";
+
+  inputs = {
+    nixpkgs.url = "nixpkgs/b97cce1538cc03ffe511dbcbf0ec8fe0f2c8a269";
+    flake-utils.url = "github:numtide/flake-utils/11707dc2f618dd54ca8739b309ec4fc024de578b";
+  };
+
+  outputs = { self, nixpkgs, flake-utils }:
+    flake-utils.lib.eachDefaultSystem
+      (system:
+        let
+          pkgs = import nixpkgs { inherit system; config = { allowUnfree = true; }; };
+        in
+        {
+          devShells.default = import ./nix/shell.nix { inherit pkgs; };
+        }
+      );
+}

nix/shell.nix

@@ -0,0 +1,6 @@
+{ pkgs }:
+pkgs.mkShell {
+  packages = with pkgs; [
+    nodejs
+  ];
+}