Add comprehensive installation and setup documentation

- Add GETTING_STARTED.md with quick start guide and development modes
- Add INSTALL.sh automated installation script
- Add INSTALLATION_CHECKLIST.md, INSTALLATION_SUCCESS.md, and INSTALLATION_SUMMARY.md
- Add QUICK_REFERENCE.md for common commands
- Add SETUP_GUIDE.md with detailed setup instructions
- Update README.md with improved project overview
- Add did-wallet app dependencies and node_modules

apps/web5-dwn/node_modules/@dnsquery/dns-packet/examples/doh.js

@@ -0,0 +1,47 @@
+"use strict";
+
+var dnsPacket = _interopRequireWildcard(require("@leichtgewicht/dns-packet"), true);
+var _https = require("https");
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+/*
+ * Sample code to make DNS over HTTPS request using POST
+ * AUTHOR: Tom Pusateri <pusateri@bangj.com>
+ * DATE: March 17, 2018
+ * LICENSE: MIT
+ */
+
+function getRandomInt(min, max) {
+  return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+const buf = dnsPacket.encode({
+  type: 'query',
+  id: getRandomInt(1, 65534),
+  flags: dnsPacket.RECURSION_DESIRED,
+  questions: [{
+    type: 'A',
+    name: 'google.com'
+  }]
+});
+const options = {
+  hostname: 'dns.google',
+  port: 443,
+  path: '/dns-query',
+  method: 'POST',
+  headers: {
+    'Content-Type': 'application/dns-message',
+    'Content-Length': Buffer.byteLength(buf)
+  }
+};
+const request = _https.request(options, response => {
+  console.log('statusCode:', response.statusCode);
+  console.log('headers:', response.headers);
+  response.on('data', d => {
+    console.log(dnsPacket.decode(d));
+  });
+});
+request.on('error', e => {
+  console.error(e);
+});
+request.write(buf);
+request.end();

apps/web5-dwn/node_modules/@dnsquery/dns-packet/examples/doh.mjs

@@ -0,0 +1,49 @@
+/*
+ * Sample code to make DNS over HTTPS request using POST
+ * AUTHOR: Tom Pusateri <pusateri@bangj.com>
+ * DATE: March 17, 2018
+ * LICENSE: MIT
+ */
+
+import * as dnsPacket from '@leichtgewicht/dns-packet'
+import https from 'https'
+
+function getRandomInt (min, max) {
+  return Math.floor(Math.random() * (max - min + 1)) + min
+}
+
+const buf = dnsPacket.encode({
+  type: 'query',
+  id: getRandomInt(1, 65534),
+  flags: dnsPacket.RECURSION_DESIRED,
+  questions: [{
+    type: 'A',
+    name: 'google.com'
+  }]
+})
+
+const options = {
+  hostname: 'dns.google',
+  port: 443,
+  path: '/dns-query',
+  method: 'POST',
+  headers: {
+    'Content-Type': 'application/dns-message',
+    'Content-Length': Buffer.byteLength(buf)
+  }
+}
+
+const request = https.request(options, (response) => {
+  console.log('statusCode:', response.statusCode)
+  console.log('headers:', response.headers)
+
+  response.on('data', (d) => {
+    console.log(dnsPacket.decode(d))
+  })
+})
+
+request.on('error', (e) => {
+  console.error(e)
+})
+request.write(buf)
+request.end()

apps/web5-dwn/node_modules/@dnsquery/dns-packet/examples/tcp.js

@@ -0,0 +1,47 @@
+"use strict";
+
+var dnsPacket = _interopRequireWildcard(require("@leichtgewicht/dns-packet"), true);
+var _net = require("net");
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+let response = null;
+let expectedLength = 0;
+function getRandomInt(min, max) {
+  return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+const buf = dnsPacket.streamEncode({
+  type: 'query',
+  id: getRandomInt(1, 65534),
+  flags: dnsPacket.RECURSION_DESIRED,
+  questions: [{
+    type: 'A',
+    name: 'google.com'
+  }]
+});
+const client = new _net.Socket();
+client.connect(53, '8.8.8.8', function () {
+  console.log('Connected');
+  client.write(buf);
+});
+client.on('data', function (data) {
+  console.log('Received response: %d bytes', data.byteLength);
+  if (response == null) {
+    if (data.byteLength > 1) {
+      const plen = data.readUInt16BE(0);
+      expectedLength = plen;
+      if (plen < 12) {
+        throw new Error('below DNS minimum packet length');
+      }
+      response = Buffer.from(data);
+    }
+  } else {
+    response = Buffer.concat([response, data]);
+  }
+  if (response.byteLength >= expectedLength) {
+    console.log(dnsPacket.streamDecode(response));
+    client.destroy();
+  }
+});
+client.on('close', function () {
+  console.log('Connection closed');
+});

apps/web5-dwn/node_modules/@dnsquery/dns-packet/examples/tcp.mjs

@@ -0,0 +1,50 @@
+import * as dnsPacket from '@leichtgewicht/dns-packet'
+import net from 'net'
+
+let response = null
+let expectedLength = 0
+
+function getRandomInt (min, max) {
+  return Math.floor(Math.random() * (max - min + 1)) + min
+}
+
+const buf = dnsPacket.streamEncode({
+  type: 'query',
+  id: getRandomInt(1, 65534),
+  flags: dnsPacket.RECURSION_DESIRED,
+  questions: [{
+    type: 'A',
+    name: 'google.com'
+  }]
+})
+
+const client = new net.Socket()
+client.connect(53, '8.8.8.8', function () {
+  console.log('Connected')
+  client.write(buf)
+})
+
+client.on('data', function (data) {
+  console.log('Received response: %d bytes', data.byteLength)
+  if (response == null) {
+    if (data.byteLength > 1) {
+      const plen = data.readUInt16BE(0)
+      expectedLength = plen
+      if (plen < 12) {
+        throw new Error('below DNS minimum packet length')
+      }
+      response = Buffer.from(data)
+    }
+  } else {
+    response = Buffer.concat([response, data])
+  }
+
+  if (response.byteLength >= expectedLength) {
+    console.log(dnsPacket.streamDecode(response))
+    client.destroy()
+  }
+})
+
+client.on('close', function () {
+  console.log('Connection closed')
+})

apps/web5-dwn/node_modules/@dnsquery/dns-packet/examples/tls.js

@@ -0,0 +1,54 @@
+"use strict";
+
+var dnsPacket = _interopRequireWildcard(require("@leichtgewicht/dns-packet"), true);
+var _tls = require("tls");
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+let response = null;
+let expectedLength = 0;
+function getRandomInt(min, max) {
+  return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+const buf = dnsPacket.streamEncode({
+  type: 'query',
+  id: getRandomInt(1, 65534),
+  flags: dnsPacket.RECURSION_DESIRED,
+  questions: [{
+    type: 'A',
+    name: 'google.com'
+  }]
+});
+const context = _tls.createSecureContext({
+  secureProtocol: 'TLSv1_2_method'
+});
+const options = {
+  port: 853,
+  host: 'getdnsapi.net',
+  secureContext: context
+};
+const client = _tls.connect(options, () => {
+  console.log('client connected');
+  client.write(buf);
+});
+client.on('data', function (data) {
+  console.log('Received response: %d bytes', data.byteLength);
+  if (response == null) {
+    if (data.byteLength > 1) {
+      const plen = data.readUInt16BE(0);
+      expectedLength = plen;
+      if (plen < 12) {
+        throw new Error('below DNS minimum packet length');
+      }
+      response = Buffer.from(data);
+    }
+  } else {
+    response = Buffer.concat([response, data]);
+  }
+  if (response.byteLength >= expectedLength) {
+    console.log(dnsPacket.streamDecode(response));
+    client.destroy();
+  }
+});
+client.on('end', () => {
+  console.log('Connection ended');
+});

apps/web5-dwn/node_modules/@dnsquery/dns-packet/examples/tls.mjs

@@ -0,0 +1,59 @@
+import * as dnsPacket from '@leichtgewicht/dns-packet'
+import tls from 'tls'
+
+let response = null
+let expectedLength = 0
+
+function getRandomInt (min, max) {
+  return Math.floor(Math.random() * (max - min + 1)) + min
+}
+
+const buf = dnsPacket.streamEncode({
+  type: 'query',
+  id: getRandomInt(1, 65534),
+  flags: dnsPacket.RECURSION_DESIRED,
+  questions: [{
+    type: 'A',
+    name: 'google.com'
+  }]
+})
+
+const context = tls.createSecureContext({
+  secureProtocol: 'TLSv1_2_method'
+})
+
+const options = {
+  port: 853,
+  host: 'getdnsapi.net',
+  secureContext: context
+}
+
+const client = tls.connect(options, () => {
+  console.log('client connected')
+  client.write(buf)
+})
+
+client.on('data', function (data) {
+  console.log('Received response: %d bytes', data.byteLength)
+  if (response == null) {
+    if (data.byteLength > 1) {
+      const plen = data.readUInt16BE(0)
+      expectedLength = plen
+      if (plen < 12) {
+        throw new Error('below DNS minimum packet length')
+      }
+      response = Buffer.from(data)
+    }
+  } else {
+    response = Buffer.concat([response, data])
+  }
+
+  if (response.byteLength >= expectedLength) {
+    console.log(dnsPacket.streamDecode(response))
+    client.destroy()
+  }
+})
+
+client.on('end', () => {
+  console.log('Connection ended')
+})

apps/web5-dwn/node_modules/@dnsquery/dns-packet/examples/udp.js

@@ -0,0 +1,25 @@
+"use strict";
+
+var dnsPacket = _interopRequireWildcard(require("@leichtgewicht/dns-packet"), true);
+var _dgram = require("dgram");
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+const socket = _dgram.createSocket('udp4');
+function getRandomInt(min, max) {
+  return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+const buf = dnsPacket.encode({
+  type: 'query',
+  id: getRandomInt(1, 65534),
+  flags: dnsPacket.RECURSION_DESIRED,
+  questions: [{
+    type: 'A',
+    name: 'google.com'
+  }]
+});
+socket.on('message', function (message, rinfo) {
+  console.log(rinfo);
+  console.log(dnsPacket.decode(message)); // prints out a response from google dns
+  socket.close();
+});
+socket.send(buf, 0, buf.length, 53, '8.8.8.8');

apps/web5-dwn/node_modules/@dnsquery/dns-packet/examples/udp.mjs

@@ -0,0 +1,26 @@
+import * as dnsPacket from '@leichtgewicht/dns-packet'
+import dgram from 'dgram'
+
+const socket = dgram.createSocket('udp4')
+
+function getRandomInt (min, max) {
+  return Math.floor(Math.random() * (max - min + 1)) + min
+}
+
+const buf = dnsPacket.encode({
+  type: 'query',
+  id: getRandomInt(1, 65534),
+  flags: dnsPacket.RECURSION_DESIRED,
+  questions: [{
+    type: 'A',
+    name: 'google.com'
+  }]
+})
+
+socket.on('message', function (message, rinfo) {
+  console.log(rinfo)
+  console.log(dnsPacket.decode(message)) // prints out a response from google dns
+  socket.close()
+})
+
+socket.send(buf, 0, buf.length, 53, '8.8.8.8')