From 451aed153f591a4f69bbe0d42fea0abc2bf983ce Mon Sep 17 00:00:00 2001 From: Michael Ficocelli Date: Fri, 6 Feb 2026 07:57:30 -0500 Subject: [PATCH] DARKNET: Add glossary of terms to the documentation page (#2469) --- src/Documentation/doc/en/programming/darknet.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/src/Documentation/doc/en/programming/darknet.md b/src/Documentation/doc/en/programming/darknet.md index 1ce3222cd..81a5ef0e1 100644 --- a/src/Documentation/doc/en/programming/darknet.md +++ b/src/Documentation/doc/en/programming/darknet.md @@ -33,6 +33,16 @@ In some cases, the only way to get to deeper parts of the net is to hitch a ride - `ns.dnet.induceServerMigration()` can be used to target a connected server and, when used enough, will force it to move to a new location on the darknet. - `ns.dnet.promoteStock()` increases the volatility of the targeted stock via propaganda, which can increase the potential profits from trading it. +### Glossary of Terms + +**Authenticated** - When a script calls dnet.authenticate with the correct password, two things happen. Firstly, you are given admin rights to the server (the same as nuking). Second, the script that called authenticate gets a session with the target server. A session on the target server is required for some dnet API methods. + +**Session** - A script needs a session on a darknet server in order to scp or exec targeting that server. A script gets a session after it calls `dnet.authenticate` with the correct password. Scripts can also get a session by calling `dnet.connectToSession` (a sync API with low RAM cost) after any script authenticates successfully on that server at least once. Note that sessions are per-pid (running instance of a script) - each script needs to individually get a session with a specific darknet server in order to exec or scp to that server. + +**Connected** - Each server on the network has specific other servers it is linked to. These are the links seen in the UI, the servers that appear when using "scan" in the terminal, or that can be seen by calling dnet.probe. This kind of direct connection is required for most dnet API methods. ns.exec requires either a direct connection, or a backdoor, or a stasis link (which also sets a backdoor) to target a darknet server. + +**Offline** - Sometimes darknet servers will go offline. Effectively, the server is deleted, and any running scripts that were on it are killed. Eventually, a server with the same name may come back online, but it will have a different password, and will be fully cleaned and cleared of scripts. + ### Darknet script design considerations As you design your darknet scripts, here are some ideas to keep in mind as you decide on your approach.