New function in 'ak fs' '--net-cat-from-mapHEADorigin/masterorigin/HEADmaster

64 files changed, 1294 insertions, 100 deletions

diff --git a/LICENSE b/LICENSE
index 60ba7b5..e610f57 100755
--- a/LICENSE
+++ b/LICENSE
@@ -632,7 +632,7 @@ state the exclusion of warranty; and each file should have at least
 the "copyright" line and a pointer to where the full notice is found.
 
     Tools to interact and build an Arching Kaos Infochain
-    Copyright (C) 2021 - 2023  kaotisk
+    Copyright (C) 2021 - 2025  kaotisk
 
     This program is free software: you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
@@ -652,7 +652,7 @@ Also add information on how to contact you by electronic and paper mail.
   If the program does terminal interaction, make it output a short
 notice like this when it starts in an interactive mode:
 
-    arching-kaos-tools  Copyright (C) 2021 - 2023  kaotisk
+    arching-kaos-tools  Copyright (C) 2021 - 2025  kaotisk
     This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
     This is free software, and you are welcome to redistribute it
     under certain conditions; type `show c' for details.
diff --git a/bin/ak b/bin/ak
index 2d01ea5..8f6305f 100755
--- a/bin/ak
+++ b/bin/ak
@@ -1,4 +1,22 @@
 #!/usr/bin/env bash
+###
+### arching-kaos-tools
+### Tools to interact and build an Arching Kaos Infochain
+### Copyright (C) 2021 - 2025  kaotisk
+###
+### This program is free software: you can redistribute it and/or modify
+### it under the terms of the GNU General Public License as published by
+### the Free Software Foundation, either version 3 of the License, or
+### (at your option) any later version.
+###
+### This program is distributed in the hope that it will be useful,
+### but WITHOUT ANY WARRANTY; without even the implied warranty of
+### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+### GNU General Public License for more details.
+###
+### You should have received a copy of the GNU General Public License
+### along with this program.  If not, see <http://www.gnu.org/licenses/>.
+###
 export AK_DEBUG="yes"
 ##
 ## Arching Kaos CLI tool is the main executable script to use for exploring,
@@ -29,6 +47,7 @@ source $AK_LIBDIR/_ak_script
 if [ $# -eq 0 ]
 then
     _ak_log_warning "No command given"
+    _ak_log_info "Available commands:"
     (
         find $AK_BINDIR | grep 'ak-' | while read available
         do
@@ -41,7 +60,7 @@ then
                 #$(echo $subcmd) $args
             fi
         done
-    ) | sort | uniq
+    ) | sort | uniq | sed 's/^/# /g' | while read line; do _ak_log_info "$line";done
     exit 1
 fi
 
@@ -72,7 +91,7 @@ case "$1" in
         shift
         if [ ! -z $1 ] && [ -n "$1" ]
         then
-            grep -rnF "$1(){" $AK_BINDIR/* $AK_LIBDIR/* $AK_MODULESDIR/*
+            grep -rnF "$1(){" $AK_BINDIR/* $AK_LIBDIR/* $AK_MODULESDIR/* > /dev/null 2>&1
             if [ $? -ne 0 ]
             then
                 _ak_log_error "No function $1 found"
@@ -85,13 +104,20 @@ case "$1" in
             fi
             filename="$(grep -rnF "$1(){" $AK_LIBDIR/* $AK_MODULESDIR/* | cut -d ':' -f 1)"
             line="$(grep -rnF "$1(){" $AK_LIBDIR/* $AK_MODULESDIR/* | cut -d ':' -f 2)"
-            functionname="$(grep -rnF "$1(){" $AK_LIBDIR/* $AK_MODULESDIR/* | cut -d ':' -f 3)"
-            printf 'Use with:\n' >&2
+            functionname="$(grep -rnF "$1(){" $AK_LIBDIR/* $AK_MODULESDIR/* | cut -d ':' -f 3|sed -e 's/function //g')"
+            _ak_log_info "Use with:"
             printf 'source %s\n%s\n' "$filename" "$(echo -n $functionname | sed 's/(){//')"
             exit
         else
+            _ak_log_error "No function selected"
+            _ak_log_info "Available functions:"
             grep -rnF "(){" $AK_LIBDIR/* $AK_MODULESDIR/* | \
-                sed -e "s#$AK_WORKDIR/##g" | sed -e 's/(){//g' | cut -d ':' -f 1,3 | tr ':' $'\t'
+                sed -e "s#$AK_WORKDIR/##g" | \
+                sed -e 's/function //g;s/(){//g' | \
+                cut -d ':' -f 1,3 | \
+                tr ':' ' ' | \
+                awk '{print $1 " " $2}' | \
+                sort | while read line; do _ak_log_info "${line}"; done
             exit
         fi
         ;;
@@ -104,7 +130,8 @@ case "$1" in
         if [ ! -n "$1" ]
         then
             _ak_log_error "No module selected"
-            ls -1 $AK_MODULESDIR
+            _ak_log_info "Modules available:"
+            ls -1 $AK_MODULESDIR | sed 's/^/# /g' | while read line; do _ak_log_info "$line";done
             exit 1
         fi
         shift
diff --git a/bin/ak-cjdns b/bin/ak-cjdns
index 9219f19..d61a477 100755
--- a/bin/ak-cjdns
+++ b/bin/ak-cjdns
@@ -1,4 +1,22 @@
 #!/usr/bin/env bash
+###
+### arching-kaos-tools
+### Tools to interact and build an Arching Kaos Infochain
+### Copyright (C) 2021 - 2025  kaotisk
+###
+### This program is free software: you can redistribute it and/or modify
+### it under the terms of the GNU General Public License as published by
+### the Free Software Foundation, either version 3 of the License, or
+### (at your option) any later version.
+###
+### This program is distributed in the hope that it will be useful,
+### but WITHOUT ANY WARRANTY; without even the implied warranty of
+### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+### GNU General Public License for more details.
+###
+### You should have received a copy of the GNU General Public License
+### along with this program.  If not, see <http://www.gnu.org/licenses/>.
+###
 ##
 ## cjdns helper
 ##
diff --git a/bin/ak-clean b/bin/ak-clean
index f1d7f49..8e55515 100755
--- a/bin/ak-clean
+++ b/bin/ak-clean
@@ -1,4 +1,22 @@
 #!/usr/bin/env bash
+###
+### arching-kaos-tools
+### Tools to interact and build an Arching Kaos Infochain
+### Copyright (C) 2021 - 2025  kaotisk
+###
+### This program is free software: you can redistribute it and/or modify
+### it under the terms of the GNU General Public License as published by
+### the Free Software Foundation, either version 3 of the License, or
+### (at your option) any later version.
+###
+### This program is distributed in the hope that it will be useful,
+### but WITHOUT ANY WARRANTY; without even the implied warranty of
+### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+### GNU General Public License for more details.
+###
+### You should have received a copy of the GNU General Public License
+### along with this program.  If not, see <http://www.gnu.org/licenses/>.
+###
 ##
 ## Cleans up temporary directories and files
 ##
diff --git a/bin/ak-coin b/bin/ak-coin
index cd14602..0bd7f15 100755
--- a/bin/ak-coin
+++ b/bin/ak-coin
@@ -1,4 +1,22 @@
 #!/usr/bin/env bash
+###
+### arching-kaos-tools
+### Tools to interact and build an Arching Kaos Infochain
+### Copyright (C) 2021 - 2025  kaotisk
+###
+### This program is free software: you can redistribute it and/or modify
+### it under the terms of the GNU General Public License as published by
+### the Free Software Foundation, either version 3 of the License, or
+### (at your option) any later version.
+###
+### This program is distributed in the hope that it will be useful,
+### but WITHOUT ANY WARRANTY; without even the implied warranty of
+### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+### GNU General Public License for more details.
+###
+### You should have received a copy of the GNU General Public License
+### along with this program.  If not, see <http://www.gnu.org/licenses/>.
+###
 ##
 ## Coin status
 ##
diff --git a/bin/ak-config b/bin/ak-config
index 5d7b630..4337a2d 100755
--- a/bin/ak-config
+++ b/bin/ak-config
@@ -1,4 +1,22 @@
 #!/usr/bin/env bash
+###
+### arching-kaos-tools
+### Tools to interact and build an Arching Kaos Infochain
+### Copyright (C) 2021 - 2025  kaotisk
+###
+### This program is free software: you can redistribute it and/or modify
+### it under the terms of the GNU General Public License as published by
+### the Free Software Foundation, either version 3 of the License, or
+### (at your option) any later version.
+###
+### This program is distributed in the hope that it will be useful,
+### but WITHOUT ANY WARRANTY; without even the implied warranty of
+### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+### GNU General Public License for more details.
+###
+### You should have received a copy of the GNU General Public License
+### along with this program.  If not, see <http://www.gnu.org/licenses/>.
+###
 ##
 ## Usage:    ak-config [ -h | --help | --show | --publish | --get-published ]
 ##
diff --git a/bin/ak-fs b/bin/ak-fs
index 9ca4e6b..74aedfa 100755
--- a/bin/ak-fs
+++ b/bin/ak-fs
@@ -1,4 +1,22 @@
 #!/usr/bin/env bash
+###
+### arching-kaos-tools
+### Tools to interact and build an Arching Kaos Infochain
+### Copyright (C) 2021 - 2025  kaotisk
+###
+### This program is free software: you can redistribute it and/or modify
+### it under the terms of the GNU General Public License as published by
+### the Free Software Foundation, either version 3 of the License, or
+### (at your option) any later version.
+###
+### This program is distributed in the hope that it will be useful,
+### but WITHOUT ANY WARRANTY; without even the implied warranty of
+### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+### GNU General Public License for more details.
+###
+### You should have received a copy of the GNU General Public License
+### along with this program.  If not, see <http://www.gnu.org/licenses/>.
+###
 ##
 ## Tools to add, get and cat files to/from the Arching Kaos File System
 ##
@@ -9,6 +27,7 @@
 ##    --get, --export <hash> <output file>      Exports a file from the AKFS system
 ##    --cat <hash>                              Concatenates from given hash
 ##    --list                                    Lists names and roots available
+##    --net-cat-from-map                        Concatenates from map via the network
 ##
 fullprogrampath="$(realpath $0)"
 PROGRAM=$(basename $0)
diff --git a/bin/ak-get-balances b/bin/ak-get-balances
index 9fa7385..5b13999 100755
--- a/bin/ak-get-balances
+++ b/bin/ak-get-balances
@@ -1,4 +1,22 @@
 #!/usr/bin/env bash
+###
+### arching-kaos-tools
+### Tools to interact and build an Arching Kaos Infochain
+### Copyright (C) 2021 - 2025  kaotisk
+###
+### This program is free software: you can redistribute it and/or modify
+### it under the terms of the GNU General Public License as published by
+### the Free Software Foundation, either version 3 of the License, or
+### (at your option) any later version.
+###
+### This program is distributed in the hope that it will be useful,
+### but WITHOUT ANY WARRANTY; without even the implied warranty of
+### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+### GNU General Public License for more details.
+###
+### You should have received a copy of the GNU General Public License
+### along with this program.  If not, see <http://www.gnu.org/licenses/>.
+###
 ##
 ## Calculates the balances of the sblocks found from a chain
 ## Saves stuff too for later reference
diff --git a/bin/ak-gpg b/bin/ak-gpg
index 39dd6f6..e3169ca 100755
--- a/bin/ak-gpg
+++ b/bin/ak-gpg
@@ -1,4 +1,22 @@
 #!/usr/bin/env bash
+###
+### arching-kaos-tools
+### Tools to interact and build an Arching Kaos Infochain
+### Copyright (C) 2021 - 2025  kaotisk
+###
+### This program is free software: you can redistribute it and/or modify
+### it under the terms of the GNU General Public License as published by
+### the Free Software Foundation, either version 3 of the License, or
+### (at your option) any later version.
+###
+### This program is distributed in the hope that it will be useful,
+### but WITHOUT ANY WARRANTY; without even the implied warranty of
+### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+### GNU General Public License for more details.
+###
+### You should have received a copy of the GNU General Public License
+### along with this program.  If not, see <http://www.gnu.org/licenses/>.
+###
 ##
 ## It is a minimal wrapper aroung lib/_ak_gpg.
 ##
diff --git a/bin/ak-ipfs-daemon b/bin/ak-ipfs-daemon
index 3265966..e9a9bca 100755
--- a/bin/ak-ipfs-daemon
+++ b/bin/ak-ipfs-daemon
@@ -1,4 +1,22 @@
 #!/usr/bin/env bash
+###
+### arching-kaos-tools
+### Tools to interact and build an Arching Kaos Infochain
+### Copyright (C) 2021 - 2025  kaotisk
+###
+### This program is free software: you can redistribute it and/or modify
+### it under the terms of the GNU General Public License as published by
+### the Free Software Foundation, either version 3 of the License, or
+### (at your option) any later version.
+###
+### This program is distributed in the hope that it will be useful,
+### but WITHOUT ANY WARRANTY; without even the implied warranty of
+### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+### GNU General Public License for more details.
+###
+### You should have received a copy of the GNU General Public License
+### along with this program.  If not, see <http://www.gnu.org/licenses/>.
+###
 ##
 ## Starts IPFS daemon
 ##
diff --git a/bin/ak-ipfs-starter b/bin/ak-ipfs-starter
index 7ce85c2..8076427 100755
--- a/bin/ak-ipfs-starter
+++ b/bin/ak-ipfs-starter
@@ -1,4 +1,22 @@
 #!/usr/bin/env bash
+###
+### arching-kaos-tools
+### Tools to interact and build an Arching Kaos Infochain
+### Copyright (C) 2021 - 2025  kaotisk
+###
+### This program is free software: you can redistribute it and/or modify
+### it under the terms of the GNU General Public License as published by
+### the Free Software Foundation, either version 3 of the License, or
+### (at your option) any later version.
+###
+### This program is distributed in the hope that it will be useful,
+### but WITHOUT ANY WARRANTY; without even the implied warranty of
+### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+### GNU General Public License for more details.
+###
+### You should have received a copy of the GNU General Public License
+### along with this program.  If not, see <http://www.gnu.org/licenses/>.
+###
 PROGRAM="$(basename $0)"
 
 source $AK_LIBDIR/_ak_log
diff --git a/bin/ak-json2bash b/bin/ak-json2bash
index 28a7e37..235d698 100755
--- a/bin/ak-json2bash
+++ b/bin/ak-json2bash
@@ -1,4 +1,22 @@
 #!/usr/bin/env bash
+###
+### arching-kaos-tools
+### Tools to interact and build an Arching Kaos Infochain
+### Copyright (C) 2021 - 2025  kaotisk
+###
+### This program is free software: you can redistribute it and/or modify
+### it under the terms of the GNU General Public License as published by
+### the Free Software Foundation, either version 3 of the License, or
+### (at your option) any later version.
+###
+### This program is distributed in the hope that it will be useful,
+### but WITHOUT ANY WARRANTY; without even the implied warranty of
+### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+### GNU General Public License for more details.
+###
+### You should have received a copy of the GNU General Public License
+### along with this program.  If not, see <http://www.gnu.org/licenses/>.
+###
 #
 # ak-json2bash
 #
diff --git a/bin/ak-log b/bin/ak-log
index 31f13e8..543d8ee 100755
--- a/bin/ak-log
+++ b/bin/ak-log
@@ -1,4 +1,22 @@
 #!/usr/bin/env bash
+###
+### arching-kaos-tools
+### Tools to interact and build an Arching Kaos Infochain
+### Copyright (C) 2021 - 2025  kaotisk
+###
+### This program is free software: you can redistribute it and/or modify
+### it under the terms of the GNU General Public License as published by
+### the Free Software Foundation, either version 3 of the License, or
+### (at your option) any later version.
+###
+### This program is distributed in the hope that it will be useful,
+### but WITHOUT ANY WARRANTY; without even the implied warranty of
+### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+### GNU General Public License for more details.
+###
+### You should have received a copy of the GNU General Public License
+### along with this program.  If not, see <http://www.gnu.org/licenses/>.
+###
 ##
 ## Used to overview, archive or append to the log file
 ##
diff --git a/bin/ak-mempool b/bin/ak-mempool
index 98c003a..d411ca2 100755
--- a/bin/ak-mempool
+++ b/bin/ak-mempool
@@ -1,4 +1,22 @@
 #!/usr/bin/env bash
+###
+### arching-kaos-tools
+### Tools to interact and build an Arching Kaos Infochain
+### Copyright (C) 2021 - 2025  kaotisk
+###
+### This program is free software: you can redistribute it and/or modify
+### it under the terms of the GNU General Public License as published by
+### the Free Software Foundation, either version 3 of the License, or
+### (at your option) any later version.
+###
+### This program is distributed in the hope that it will be useful,
+### but WITHOUT ANY WARRANTY; without even the implied warranty of
+### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+### GNU General Public License for more details.
+###
+### You should have received a copy of the GNU General Public License
+### along with this program.  If not, see <http://www.gnu.org/licenses/>.
+###
 ##
 ## Brief description
 ##
diff --git a/bin/ak-mine b/bin/ak-mine
index dd3e970..46e106d 100755
--- a/bin/ak-mine
+++ b/bin/ak-mine
@@ -1,4 +1,22 @@
 #!/usr/bin/env bash
+###
+### arching-kaos-tools
+### Tools to interact and build an Arching Kaos Infochain
+### Copyright (C) 2021 - 2025  kaotisk
+###
+### This program is free software: you can redistribute it and/or modify
+### it under the terms of the GNU General Public License as published by
+### the Free Software Foundation, either version 3 of the License, or
+### (at your option) any later version.
+###
+### This program is distributed in the hope that it will be useful,
+### but WITHOUT ANY WARRANTY; without even the implied warranty of
+### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+### GNU General Public License for more details.
+###
+### You should have received a copy of the GNU General Public License
+### along with this program.  If not, see <http://www.gnu.org/licenses/>.
+###
 ##
 ## You can mine sblocks for schain
 ##
diff --git a/bin/ak-network b/bin/ak-network
index b14f0d2..9ab0e52 100755
--- a/bin/ak-network
+++ b/bin/ak-network
@@ -1,4 +1,22 @@
 #!/usr/bin/env bash
+###
+### arching-kaos-tools
+### Tools to interact and build an Arching Kaos Infochain
+### Copyright (C) 2021 - 2025  kaotisk
+###
+### This program is free software: you can redistribute it and/or modify
+### it under the terms of the GNU General Public License as published by
+### the Free Software Foundation, either version 3 of the License, or
+### (at your option) any later version.
+###
+### This program is distributed in the hope that it will be useful,
+### but WITHOUT ANY WARRANTY; without even the implied warranty of
+### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+### GNU General Public License for more details.
+###
+### You should have received a copy of the GNU General Public License
+### along with this program.  If not, see <http://www.gnu.org/licenses/>.
+###
 ##
 ## Network tools
 ##
diff --git a/bin/ak-node-info b/bin/ak-node-info
index 21255c6..2b9c458 100755
--- a/bin/ak-node-info
+++ b/bin/ak-node-info
@@ -1,4 +1,22 @@
 #!/usr/bin/env bash
+###
+### arching-kaos-tools
+### Tools to interact and build an Arching Kaos Infochain
+### Copyright (C) 2021 - 2025  kaotisk
+###
+### This program is free software: you can redistribute it and/or modify
+### it under the terms of the GNU General Public License as published by
+### the Free Software Foundation, either version 3 of the License, or
+### (at your option) any later version.
+###
+### This program is distributed in the hope that it will be useful,
+### but WITHOUT ANY WARRANTY; without even the implied warranty of
+### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+### GNU General Public License for more details.
+###
+### You should have received a copy of the GNU General Public License
+### along with this program.  If not, see <http://www.gnu.org/licenses/>.
+###
 ##
 ## Brief description
 ##
diff --git a/bin/ak-profile b/bin/ak-profile
index c7d55c0..97dcce3 100755
--- a/bin/ak-profile
+++ b/bin/ak-profile
@@ -1,4 +1,22 @@
 #!/usr/bin/env bash
+###
+### arching-kaos-tools
+### Tools to interact and build an Arching Kaos Infochain
+### Copyright (C) 2021 - 2025  kaotisk
+###
+### This program is free software: you can redistribute it and/or modify
+### it under the terms of the GNU General Public License as published by
+### the Free Software Foundation, either version 3 of the License, or
+### (at your option) any later version.
+###
+### This program is distributed in the hope that it will be useful,
+### but WITHOUT ANY WARRANTY; without even the implied warranty of
+### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+### GNU General Public License for more details.
+###
+### You should have received a copy of the GNU General Public License
+### along with this program.  If not, see <http://www.gnu.org/licenses/>.
+###
 ##
 ## Indexes, shows, imports, adds, sets and gets values from and to the
 ## zchain and files.
diff --git a/bin/ak-sblock b/bin/