updated readme + rootpath

README.md

@@ -25,6 +25,7 @@ TODO:
 
 
 # What is the Darknet Lantern Project ?
+
 Darknet Lantern is a minimalistic Peer to Peer Decentralised Search Engine for the Darknet.
 
 ## Why is the Darknet Lantern relevant ?
@@ -42,8 +43,7 @@ All you need is to run your own Darknet Lantern instance, and to join the Webrin
 
 
 ## How can I setup my own Darknet Lantern ?
-We'll first cover how you can run your own Darknet Lantern instance, In short you'll need the latest debian (which is debian 12 currently), Tor, php8, python and a few python libraries that you'll install via the apt package manager.
-
+We'll first cover how you can run your own Darknet Lantern instance, In short you'll need the latest debian (which is debian 12 currently), Tor, php8.2-fpm, python and a few python libraries that you'll install via the apt package manager.
 
 
 ## How to join the Darknet Lantern Webring ? (TODO)
@@ -146,12 +146,42 @@ http://robosats6tkf3eva7x2voqso3a5wcorsnw34jveyxfqi2fu7oyheasid.onion/ ✔️
 ```
 
 
-## What is the trust model ?
+## What is the default trust model ?
+
+When spinning up your own Darknet Lantern instance, you are automatically creating your instance folder in www/participants/yourinstancehostname.onion/ and in there you'll find a copy of the blank verified.csv, unverified.csv, and webring-participants.csv files, along with the default banner.png file.
+
+By default, as they are in the templates/ directory, the verified.csv and unverified.csv files are empty as you shouldn't trust random links that other people are trusting, you should verify them yourself one by one, to make sure that they aren't malicious.
+
+That is why by default, when you first setup your own lantern instance, you are not listing anything, nor trusting any links, nor trusting any webring participants. This is a safety measure by default to avoid vector of abuse.
+
+
+## What is the lifecycle of a Lantern instance ? 
+
+At first, you have an empty Lantern, no links listed, no links trusted, no webring participants trusted either.
+
+If you want to go your own way to explore the darknet yourself, you can start to list links yourself, into the unverified.csv file, and later on once you browse them enough to verify their authenticity, you may choose to trust them, to move them from unverified.csv to verified.csv
+
+If you want to avoid doing the same work that other webring participants may have already done, you may choose to synchronize with their lists of links, and to add the ones that you didn't list yet into your own unverified.csv file. That way you'll be able to start exploring the Darknet starting from where others's progress.
+
+After a while of adding new links and verifying them, you may choose to trust another webring participant's list of links, to automatically add their verified links into your own verified.csv file. However be warned that this is risky due to the fact that you may inadvertently trust malicious links.
 
 ## What if there are malicious Lantern Instances ?
 
+As stated above, it is possible that there will be malicious Lantern instances, meaning that you may have malicious peers that start to list some extremely illegal websites into their verified.csv file. This is why by default you are not trusting any Lantern webring participant, nor any links.
+
+This is also the reason why there is a blacklist.csv file. That way, if there are any malicious keywords or links to be found, they will be immediately deleted. I for instance, refuse to list any porn sites and i encourage you to do the same, as those can link to some extremely illegal content, that you definitely don't want to get associated with. 
+
+Using the blacklist.csv file you can list blacklisted words or links that will automatically be removed if encountered by the python scripts.
+
+## When should I mark websites as sensitive ?
+
+In order to avoid putting all eggs in one basket, i recommend marking websites that are related to Drugs (as this is the most popular sensitive darknet topic) as sensitive whenever you add them into your unverified.csv file.
+
+There is also a sensitive.csv file in your instance directory to list those keywords, so that they get automatically marked as sensitive by the python scripts.
+
 ## How can I add more links ?
 
+Use the scripts/darknet_exploration.py to do the following:
 
 ## How can I verify links ?
 

scripts/darknet_exploration.py

@@ -9,7 +9,7 @@ def main():
 		'https': 'socks5h://127.0.0.1:9050'
 	}
 
-	rootpath='/srv/darknet-onion-webring/'
+	rootpath='/srv/darknet-lantern/'
 	urlpath=pwd.getpwuid(os.getuid()).pw_dir+"/.darknet_participant_url"
 	#print(urlpath)
 

scripts/uptimechecker.py

@@ -11,7 +11,7 @@ def main():
 	print('[+] ONION UPTIME CHECKER')
 
 	# TODO get the instance name and exit if its not there
-	rootpath='/srv/darknet-onion-webring/'
+	rootpath='/srv/darknet-lantern/'
 	urlpath=pwd.getpwuid(os.getuid()).pw_dir+"/.darknet_participant_url"
 	#print(urlpath)
 
@@ -45,7 +45,7 @@ def main():
 	csvfiles2check=['verified.csv','unverified.csv','webring-participants.csv']
 	csvfiles2sortcat=['verified.csv','unverified.csv']
 	
-	#for csvfile in glob.glob("/srv/darknet-onion-webring/www/links/*.csv"):
+	#for csvfile in glob.glob("/srv/darknet-lantern/www/links/*.csv"):
 	for csvfilename in csvfiles2check:
 		csvfile = instancepath+csvfilename
 		print('[+] Reading the CSV File:', csvfile)