neuronum 1.4.1__py3-none-any.whl → 1.4.2__py3-none-any.whl

neuronum/neuronum.py

@@ -5,7 +5,6 @@ import ssl
 from websocket import create_connection
 import json
 
-
 class Cell:
     def __init__(self, host: str, password: str, network: str, synapse: str):
         self.host = host
@@ -30,12 +29,63 @@ class Cell:
         self.sock.sendall(credentials.encode('utf-8'))
 
         response = self.sock.recv(1024).decode('utf-8')
-        print(response)
         return "Authentication successful" in response
     
 
-    def activate(self, txID: str, data: dict):
-        url = f"https://{self.network}/activateTX/{txID}"
+    def create_tx(self, descr: str, key_values: dict, ctx: str, label: str, partners: list):
+        url = f"https://{self.network}/api/create_tx"
+
+        TX = {
+            "descr": descr,
+            "key_values": key_values,
+            "ctx": ctx,
+            "label": label,
+            "partners": partners,
+            "cell": self.to_dict()
+        }
+
+        try:
+            response = requests.post(
+                url,
+                json=TX,
+            )
+
+            response.raise_for_status()
+
+            return response.json()["txID"]
+
+        except requests.exceptions.RequestException as e:
+            print(f"Error sending request: {e}")
+        except Exception as e:
+            print(f"Unexpected error: {e}")
+
+
+    def delete_tx(self, txID: str):
+        url = f"https://{self.network}/api/delete_tx"
+
+        TX = {
+            "txID": txID,
+            "cell": self.to_dict()
+        }
+
+        try:
+            response = requests.post(
+                url,
+                json=TX,
+            )
+
+            response.raise_for_status()
+
+            print(f"Response from Neuronum: {response.json()}")
+
+        except requests.exceptions.RequestException as e:
+            print(f"Error sending request: {e}")
+        except Exception as e:
+            print(f"Unexpected error: {e}")
+    
+
+    def activate_tx(self, txID: str, data: dict):
+        url = f"https://{self.network}/api/activate_tx/{txID}"
 
         TX = {
             "data": data,
@@ -58,17 +108,114 @@ class Cell:
             print(f"Unexpected error: {e}")
 
 
+    def create_ctx(self, descr: str, partners: list):
+        url = f"https://{self.network}/api/create_ctx"
+
+        CTX = {
+            "descr": descr,
+            "partners": partners,
+            "cell": self.to_dict()
+        }
 
-    def register(self, node: str, mode: str, stx: str):
+        try:
+            response = requests.post(
+                url,
+                json=CTX,
+            )
+
+            response.raise_for_status()
+
+            return response.json()["ctxID"]
+
+        except requests.exceptions.RequestException as e:
+            print(f"Error sending request: {e}")
+        except Exception as e:
+            print(f"Unexpected error: {e}")
+
+
+    def delete_ctx(self, ctxID: str):
+        url = f"https://{self.network}/api/delete_ctx"
+
+        CTX = {
+            "ctxID": ctxID,
+            "cell": self.to_dict()
+        }
+
+        try:
+            response = requests.post(
+                url,
+                json=CTX,
+            )
+
+            response.raise_for_status()
+
+            print(f"Response from Neuronum: {response.json()}")
+
+        except requests.exceptions.RequestException as e:
+            print(f"Error sending request: {e}")
+        except Exception as e:
+            print(f"Unexpected error: {e}")
+
+
+    def create_stx(self, descr: str, partners: list):
+        url = f"https://{self.network}/api/create_stx"
+
+        STX = {
+            "descr": descr,
+            "partners": partners,
+            "cell": self.to_dict()
+        }
+
+        try:
+            response = requests.post(
+                url,
+                json=STX,
+            )
+
+            response.raise_for_status()["stxID"]
+
+            return response.json()
+
+        except requests.exceptions.RequestException as e:
+            print(f"Error sending request: {e}")
+        except Exception as e:
+            print(f"Unexpected error: {e}")
+
+
+    def delete_stx(self, stxID: str):
+        url = f"https://{self.network}/api/delete_stx"
+
+        STX = {
+            "stxID": stxID,
+            "cell": self.to_dict()
+        }
+
+        try:
+            response = requests.post(
+                url,
+                json=STX,
+            )
+
+            response.raise_for_status()
+
+            print(f"Response from Neuronum: {response.json()}")
+
+        except requests.exceptions.RequestException as e:
+            print(f"Error sending request: {e}")
+        except Exception as e:
+            print(f"Unexpected error: {e}")
+
+
+    def register_node(self, descr: str, mode: str, stx: str):
         if mode == "public":
-            url = f"https://{self.network}/register/node/public"
+            url = f"https://{self.network}/api/register_node/public"
         elif mode == "private":
-            url = f"https://{self.network}/register/node/private"
+            url = f"https://{self.network}/api/register_node/private"
         else:
             return {"error": "Invalid mode", "message": "Mode has to be 'public' or 'private'"}
 
         node_data = {
-            "name": node,
+            "descr": descr,
             "mode": mode,
             "stream": stx,
             "cell": self.to_dict()
@@ -82,17 +229,225 @@ class Cell:
 
             response.raise_for_status()
 
+            return response.json()["nodeID"]
+
+        except requests.exceptions.RequestException as e:
+            print(f"Error sending request: {e}")
+        except Exception as e:
+            print(f"Unexpected error: {e}")
+
+
+    def delete_node(self, nodeID: str):
+        url = f"https://{self.network}/api/delete_node"
+
+        delete_node = {
+            "nodeID": nodeID,
+            "cell": self.to_dict()
+        }
+
+        try:
+            response = requests.post(
+                url,
+                json=delete_node,
+            )
+
+            response.raise_for_status()
+            print(response.json())
+
+        except requests.exceptions.RequestException as e:
+            print(f"Error sending request: {e}")
+        except Exception as e:
+            print(f"Unexpected error: {e}")
+
+
+    def sign_contract(self, contractID: str):
+        full_url = f"https://{self.network}/api/sign_contract"
+        
+        sign_contract = {
+            "contractID": contractID,
+            "cell": self.to_dict() 
+        }
+
+        try:
+            response = requests.post(full_url, json=sign_contract)
+            response.raise_for_status()
+            return response.json()["token"]
+        except requests.exceptions.RequestException as e:
+            print(f"Error sending request: {e}")
+        except Exception as e:
+            print(f"Unexpected error: {e}")
+
+
+    def validate_token(self, token: str, cp: str, contractID: str):
+        full_url = f"https://{self.network}/api/validate_token"
+        
+        validate = {
+            "token": token,
+            "cp": cp,
+            "contractID": contractID,
+            "cell": self.to_dict() 
+        }
+
+        try:
+            response = requests.post(full_url, json=validate)
+            response.raise_for_status()
+            return response.json()["validity"]
+        except requests.exceptions.RequestException as e:
+            print(f"Error sending request: {e}")
+        except Exception as e:
+            print(f"Unexpected error: {e}")
+
+
+    def request_token(self, cp: str, contractID: str):
+        full_url = f"https://{self.network}/api/request_token"
+        
+        request_token = {
+            "cp": cp,
+            "contractID": contractID,
+            "cell": self.to_dict() 
+        }
+
+        try:
+            response = requests.post(full_url, json=request_token)
+            response.raise_for_status()
+            print(response.json())
+        except requests.exceptions.RequestException as e:
+            print(f"Error sending request: {e}")
+        except Exception as e:
+            print(f"Unexpected error: {e}")
+
+    
+    def present_token(self, token: str, cp: str, contractID: str):
+        full_url = f"https://{self.network}/api/present_token"
+        
+        present_token = {
+            "token": token,
+            "cp": cp,
+            "contractID": contractID,
+            "cell": self.to_dict() 
+        }
+
+        try:
+            response = requests.post(full_url, json=present_token)
+            response.raise_for_status()
+            print(response.json()) 
+        except requests.exceptions.RequestException as e:
+            print(f"Error sending request: {e}")
+        except Exception as e:
+            print(f"Unexpected error: {e}")
+
+
+    def create_contract(self, descr: str, details: dict, partners: list):
+        full_url = f"https://{self.network}/api/create_contract"
+        
+        create_contract = {
+            "cell": self.to_dict(),  
+            "descr": descr,
+            "details": details,
+            "partners": partners
+        }
+        try:
+            response = requests.post(full_url, json=create_contract)
+            response.raise_for_status()
+            return response.json()["contractID"]
+        except requests.exceptions.RequestException as e:
+            print(f"Error sending request: {e}")
+        except Exception as e:
+            print(f"Unexpected error: {e}")
+
+
+    def delete_contract(self, contractID: str):
+        full_url = f"https://{self.network}/api/delete_contract"
+        
+        request = {
+            "cell": self.to_dict(),  
+            "contractID": contractID
+        }
+
+        try:
+            response = requests.post(full_url, json=request)
+            response.raise_for_status()
             print(f"Response from Neuronum: {response.json()}")
+        except requests.exceptions.RequestException as e:
+            print(f"Error sending request: {e}")
+        except Exception as e:
+            print(f"Unexpected error: {e}")
+
+
+    def list_contracts(self, cp: str):
+        full_url = f"https://{self.network}/api/list_contracts"
+        
+        list_contracts = {
+            "cell": self.to_dict(),  
+            "cp": cp
+        }
 
+        try:
+            response = requests.post(full_url, json=list_contracts)
+            response.raise_for_status()
+            return response.json()
         except requests.exceptions.RequestException as e:
             print(f"Error sending request: {e}")
         except Exception as e:
             print(f"Unexpected error: {e}")
 
 
+    def list_tx(self, cp: str):
+        full_url = f"https://{self.network}/api/list_tx"
+        
+        list_tx = {
+            "cell": self.to_dict(),  
+            "cp": cp
+        }
+
+        try:
+            response = requests.post(full_url, json=list_tx)
+            response.raise_for_status()
+            return response.json()
+        except requests.exceptions.RequestException as e:
+            print(f"Error sending request: {e}")
+        except Exception as e:
+            print(f"Unexpected error: {e}")
+
 
-    def test_connection(self):
-            url = f"https://{self.network}/testConnection"
+    def list_ctx(self, cp: str):
+        full_url = f"https://{self.network}/api/list_ctx"
+        
+        list_ctx = {
+            "cell": self.to_dict(),  
+            "cp": cp
+        }
+
+        try:
+            response = requests.post(full_url, json=list_ctx)
+            response.raise_for_status()
+            return response.json()
+        except requests.exceptions.RequestException as e:
+            print(f"Error sending request: {e}")
+        except Exception as e:
+            print(f"Unexpected error: {e}")
+
+
+    def list_stx(self, cp: str):
+        full_url = f"https://{self.network}/api/list_stx"
+        
+        list_stx = {
+            "cell": self.to_dict(),  
+            "cp": cp
+        }
+
+        try:
+            response = requests.post(full_url, json=list_stx)
+            response.raise_for_status()
+            return response.json()
+        except requests.exceptions.RequestException as e:
+            print(f"Error sending request: {e}")
+        except Exception as e:
+            print(f"Unexpected error: {e}")
+
+
+    def connect(self):
+            url = f"https://{self.network}/api/connect"
 
             test = {
                 "cell": self.to_dict() 
@@ -101,7 +456,7 @@ class Cell:
             try:
                 response = requests.post(url, json=test)
                 response.raise_for_status()
-                print(response.json())
+                print(response.json()["connection"]) 
             except requests.exceptions.RequestException as e:
                 print(f"Error sending request: {e}")
             except Exception as e:
@@ -110,9 +465,9 @@ class Cell:
         
     def store(self, label: str, data: dict, ctx: Optional[str] = None):
         if ctx:
-            full_url = f"https://{self.network}/store_ctx/{ctx}"
+            full_url = f"https://{self.network}/api/store_in_ctx/{ctx}"
         else:
-            full_url = f"https://{self.network}/store"
+            full_url = f"https://{self.network}/api/store"
         
         store = {
             "label": label,
@@ -133,11 +488,9 @@ class Cell:
 
     def load(self, label: str, ctx: Optional[str] = None):
         if ctx:
-            full_url = f"https://{self.network}/load_ctx/{ctx}"
+            full_url = f"https://{self.network}/api/load_from_ctx/{ctx}"
         else:
-            full_url = f"https://{self.network}/load"
-        
-        print(f"Full URL: {full_url}")
+            full_url = f"https://{self.network}/api/load"
 
         load = {
             "label": label,
@@ -157,11 +510,9 @@ class Cell:
 
     def delete(self, label: str, ctx: Optional[str] = None):
         if ctx:
-            full_url = f"https://{self.network}/delete_ctx/{ctx}"
+            full_url = f"https://{self.network}/api/delete_from_ctx/{ctx}"
         else:
-            full_url = f"https://{self.network}/delete"
-        
-        print(f"Full URL: {full_url}")
+            full_url = f"https://{self.network}/api/delete"
 
         delete = {
             "label": label,
@@ -180,11 +531,9 @@ class Cell:
 
     def clear(self, ctx: Optional[str] = None):
         if ctx:
-            full_url = f"https://{self.network}/clear_ctx/{ctx}"
+            full_url = f"https://{self.network}/api/clear_ctx/{ctx}"
         else:
-            full_url = f"https://{self.network}/clear"
-        
-        print(f"Full URL: {full_url}")
+            full_url = f"https://{self.network}/api/clear"
 
         clear = {
             "cell": self.to_dict() 
@@ -240,48 +589,35 @@ class Cell:
             "password": self.password,
             "synapse": self.synapse,
         }
-        ws = None
 
         try:
-            while True:
-                try:
-                    ws = create_connection(f"wss://{self.network}/sync/{stx}")
-                    ws.settimeout(1)
-                    ws.send(json.dumps(auth))
-                    print("Stream connection set...")
+            ws = create_connection(f"wss://{self.network}/sync/{stx}")
+            ws.send(json.dumps(auth))
+            print("Stream connection set...")
 
+            try:
+                while True:
                     try:
                         raw_operation = ws.recv()
                         operation = json.loads(raw_operation)
                         print("Listening to Stream...")
                         yield operation
 
-                        ws.settimeout(None)
-
-                        while True:
-                            raw_operation = ws.recv()
-                            operation = json.loads(raw_operation)
-                            yield operation
                     except socket.timeout:
-                        print("No initial data received. Retrying connection...")
-                        ws.close()
-
-                except KeyboardInterrupt:
-                    print("Stream-Synchronization ended!")
-                    if ws:
-                        ws.close()
-                    print("Connection closed. Exiting.")
-                    return
-                except Exception as e:
-                    print(f"{e}")
-                finally:
-                    if ws:
-                        ws.close()
-                        print("Connection closed.")
+                        print("No initial data received. Continuing to listen...") 
+                        continue 
+
+            except KeyboardInterrupt:
+                print("Stream-Synchronization ended!")
+            except Exception as e:
+                print(f"Error: {e}")
+            finally:
+                ws.close()
+                print("Connection closed.")
+
         except KeyboardInterrupt:
             print("Stream-Synchronization ended!")
-            if ws:
-                ws.close()
+            ws.close()
             print("Connection closed. Goodbye!")
 
 

neuronum-1.4.2.dist-info/METADATA

@@ -0,0 +1,317 @@
+Metadata-Version: 2.1
+Name: neuronum
+Version: 1.4.2
+Summary: Interact with the Neuronum Network to build, connect & automate real-time data streams
+Home-page: https://neuronum.net
+Author: Neuronum Cybernetics
+Author-email: welcome@neuronum.net
+Project-URL: GitHub, https://github.com/neuronumcybernetics/neuronum
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: websocket-client
+Requires-Dist: iota-sdk
+
+![Neuronum Logo](https://neuronum.net/static/logo_pip.png "Neuronum")
+
+[![Website](https://img.shields.io/badge/Website-Neuronum-blue)](https://neuronum.net)
+[![Documentation](https://img.shields.io/badge/Docs-Read%20now-green)](https://github.com/neuronumcybernetics/neuronum)
+[![Tutorials](https://img.shields.io/badge/Tutorials-Watch%20now-red)](https://www.youtube.com/@neuronumnet)
+
+`Neuronum` is a cybernetic framework enabling businesses to build interconnected networks of Hardware and Software components
+
+## Features
+- **Cell**: Identity to connect and interact with the Neuronum Network
+- **Transmitters (TX)**: Automate economic data transfer and storage
+- **Circuits (CTX)**: Store data in a Key-Value-Label database
+- **Streams (STX)**: Stream, synchronize and control data in real time
+- **Nodes**: Hard-/Software components participating in the Network ecosystem
+- **Contracts/Tokens**: Automate Contract-based authorization between Nodes
+
+## Getting Started
+To interact with the Network you will need to create a Neuronum Cell. 
+Create your Cell: [Create Cell](https://neuronum.net/createcell)
+
+Start with installing the Neuronum library using pip:
+```python
+pip install neuronum
+```
+
+Configure and test Cell connection:
+```python
+import neuronum
+
+cell = neuronum.Cell(
+host="host::cell",           # specify your cell host 
+password="your_password",    # enter your cell password 
+network="neuronum.net",      # choose network 
+synapse="your_synapse"       # provide the synapse (token)
+)
+cell.connect()
+```
+
+### Transmitters (TX)
+Transmitters (TX) are used to create predefined templates to receive and send data in a standardized format. Data send with TX is always and automatically stored in a predefined Circuit (CTX)
+
+Create Transmitter (TX):
+```python
+descr = "Test Transmitter"  # short description (max 25 characters)
+key_values = {              # predefined keys with example values
+    "key1": "value1",
+    "key2": "value2",
+    "key3": "value3",
+}
+ctx = "id::ctx"             # target Circuit (CTX)
+label = "key1:key2"         # label data sent with the TX
+partners = ["id::cell", "id::cell"]         # authorized cells
+txID = cell.create_tx(decr, key_values, ctx, label, partners) 
+```
+
+Activate Transmitter (TX):
+```python
+TX = "id::tx"               # specify the Transmitter (TX)
+data = {                    # enter key values
+    "key1": "value1",
+    "key2": "value2",
+    "key3": "value3",
+}
+cell.activate_tx(TX, data)  
+```
+
+Delete Transmitter (TX):
+```python
+TX = "id::tx"               # specify the Transmitter (TX)
+cell.delete_tx(TX)  
+```
+
+List Transmitter (TX) from cell:
+```python
+cell = "id::cell"           # specify cell
+txList = cell.list_tx(cell)  
+```
+
+### Circuits (CTX)
+Circuits (CTX) store and organize data sent via Transmitters (TX) using a Key-Value-Label system, ensuring efficient retrieval and management within the Neuronum network
+
+Create Circuit (CTX):
+```python
+descr = "Test Circuit"      # short description of the circuit (max 25 characters) 
+partners = ["id::cell", "id::cell"]          # authorized cells
+ctxID = cell.create_ctx(decr, partners)   
+```
+
+Store data on your private Circuit (CTX):
+```python
+label = "your_label"        # define a unique label (tag)
+data = {                    # store data as key-value pairs
+    "key1": "value1",
+    "key2": "value2",
+    "key3": "value3",
+}
+cell.store(label, data)
+```
+
+Store data on a public Circuit (CTX):
+```python
+CTX = "id::ctx"             # specify the Circuit (CTX
+label = "your_label"        # define a unique label (tag)
+data = {                    # store data as key-value pairs
+    "key1": "value1",
+    "key2": "value2",
+    "key3": "value3",
+}
+cell.store(label, data, CTX)
+```
+
+Load data from your private Circuit (CTX):
+```python
+label = "your_label"        # load data by label
+data = cell.load(label)  
+key1 = data["key1"]         # get the data from the keys
+key2 = data["key2"]
+key3 = data["key3"]
+```
+
+Load data from a public Circuit (CTX):
+```python
+CTX = "id::ctx"             # specify the CTX
+label = "your_label"        # load data by label
+data = cell.load(label, CTX)    
+key1 = data["key1"]         # get the data from the keys
+key2 = data["key2"]
+key3 = data["key3"]
+```
+
+Delete data from your private Circuit (CTX):
+```python
+label = "your_label"        # delete data by label
+cell.delete(label)      
+```
+
+Delete data from a public Circuit (CTX):
+```python
+CTX = "id::ctx"             # specify the CTX
+label = "your_label"        # delete data by label
+cell.delete(label, CTX)
+```
+
+Empty your private Circuit (CTX):
+```python
+cell.clear()
+```
+
+Empty a Circuit (CTX):
+```python
+CTX = "id::ctx"            # specify the CTX
+cell.clear(CTX)
+```
+
+Delete Circuit (CTX):
+```python
+CTX = "id::ctx"            # specify the Circuit (CTX)
+cell.delete_ctx(CTX)   
+```
+
+List Circuits (CTX) from cell:
+```python
+cell = "id::cell"          # specify cell
+ctxList = cell.list_ctx(cell)  
+```
+
+### Streams (STX)
+Streams (STX) facilitate real-time data synchronization and interaction, ensuring seamless connectivity between all Nodes in the Neuronum network
+
+Create Stream (CTX):
+```python
+descr = "Test Stream"      # short description (max 25 characters) 
+partners = ["id::cell", "id::cell"]          # authorized cells
+stxID = cell.create_stx(decr, partners)  
+```
+
+Stream data to your private Stream (STX):
+```python
+label = "your_label"       # label your data
+data = {                   # define data package (key-values)
+    "key1": "value1",
+    "key2": "value2",
+    "key3": "value3",
+}
+cell.stream(label, data)
+```
+
+Stream data to a public Stream (STX):
+```python
+STX = "id::stx"            # specify the STX
+label = "your_label"       # label your data
+data = {                   # define data package (key-values)
+    "key1": "value1",
+    "key2": "value2",
+    "key3": "value3",
+}
+cell.stream(label, data, STX)
+```
+
+Sync data from your private Stream (STX):
+```python
+stream = cell.sync()       # retrieve stream data
+for operation in stream:   # iterate through each operation
+    label = operation.get("label")      # get the operation details
+    key1 = operation.get("data").get("key1")
+    key2 = operation.get("data").get("key2")
+    key3 = operation.get("data").get("key3")
+    ts = operation.get("time")
+    stxID = operation.get("stxID")
+    operator = operation.get("operator")
+```
+
+Sync data from a public Stream (STX):
+```python
+STX = "id::stx"            # specify the STX  
+stream = cell.sync(STX)    # retrieve stream data
+for operation in stream:   # iterate through each operation
+    label = operation.get("label")      # get the operation details
+    key1 = operation.get("data").get("key1")
+    key2 = operation.get("data").get("key2")
+    key3 = operation.get("data").get("key3")
+    ts = operation.get("time")
+    stxID = operation.get("stxID")
+    operator = operation.get("operator")
+```
+
+List Streams (STX) from cell:
+```python
+cell = "id::cell"          # specify cell
+stxList = cell.list_stx(cell)  
+```
+
+### Nodes
+Neuronum Nodes are computing hardware running the Neuronum Client Library, enabling seamless data transmission, synchronization, and facilitating public Stream (STX) access
+
+Register a Node with its associated Stream (STX):
+```python
+descr = "node_name"        # short description (max 25 characters) 
+mode = "public"            # set to "public or "private
+STX = "id::stx"            # specify the STX
+nodeID = cell.register_node(descr, mode, STX)  
+```
+
+Remove a Node:
+```python
+nodeID = "id::node"        # get Node by ID
+cell.delete_node(nodeID)  
+```
+
+
+### Contracts/Tokens
+Contracts define rules for authorization, allowing users to sign and generate unique tokens for secure access
+
+Create a Contract:
+```python
+descr = "Test Contract"    # short description (max 25 characters)
+details = {                # define token details
+    "price_in_eur": 10,    # token price in EUR
+    "max_usage": 10,       # max number of uses
+    "validity_in_min": 10  # token expiration time (minutes)
+    }          
+partners = ["id::cell", "id::cell"]           
+contractID = cell.create_contract(descr, details, partners)
+```
+
+Sign a Contract:
+```python         
+contractID = "id::contract"     # specify the contract        
+token = cell.sign_contract(contractID)
+```
+
+Request a Token from another Cell to authorize a service:
+```python         
+cp = "id::cell"                 # specify the counterparty cell
+contractID = "id::contract"     # specify the contract  
+cell.request_token(cp, contractID)
+```
+
+Present a Token to another Cell to authorize a service:
+```python   
+token = "token"            # specify the token
+cp = "id::cell"                 # specify the counterparty cell
+contractID = "id::contract"     # specify the contract  
+cell.present_token(token, cp, contractID)
+```
+
+Validate a Token to authorize a service:
+```python   
+token = "token"            # specify the token
+cp = "id::cell"                 # specify the counterparty cell
+contractID = "id::contract"     # specify the contract  
+cell.validate_token(token, cp, contractID)
+```
+
+List Contracts from cell:
+```python
+cell = "id::cell"          # specify cell
+contractList = cell.list_contracts(cell)  
+```

neuronum-1.4.2.dist-info/RECORD

@@ -0,0 +1,7 @@
+neuronum/__init__.py,sha256=Drsm263_w3_VWgl1YsKLUr8WwVodqV3TSjqpxLjyq_M,46
+neuronum/neuronum.py,sha256=Qe8Va5cI5LRFDV0nksedM8HwmbZiTsyNP5QSg9ffFVI,18737
+neuronum-1.4.2.dist-info/LICENSE,sha256=UiZjNHiCyRP6WoZfbYQh9cv4JW96wIofKXmzBJrYSUk,1125
+neuronum-1.4.2.dist-info/METADATA,sha256=J5B-8ngh_GhQW0829pBx3JHoyKk9J6xa663JqPqPH88,10116
+neuronum-1.4.2.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
+neuronum-1.4.2.dist-info/top_level.txt,sha256=73zXVVO9UTTiwEcSaXytsJ8n0q47OCwAqPlIh-hzWJU,9
+neuronum-1.4.2.dist-info/RECORD,,

neuronum-1.4.1.dist-info/METADATA

@@ -1,195 +0,0 @@
-Metadata-Version: 2.1
-Name: neuronum
-Version: 1.4.1
-Summary: Interact with the Neuronum Network to build, connect & automate real-time data streams
-Home-page: https://neuronum.net
-Author: Neuronum Cybernetics
-Author-email: welcome@neuronum.net
-Project-URL: GitHub, https://github.com/neuronumcybernetics/neuronum
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests
-Requires-Dist: websocket-client
-
-![Neuronum Logo](https://neuronum.net/static/logo_pip.png "Neuronum")
-
-[![Website](https://img.shields.io/badge/Website-Neuronum-blue)](https://neuronum.net)
-[![Documentation](https://img.shields.io/badge/Docs-Read%20now-green)](https://github.com/neuronumcybernetics/neuronum)
-[![Tutorials](https://img.shields.io/badge/Tutorials-Watch%20now-red)](https://www.youtube.com/@neuronumnet)
-
-Interact with the `Neuronum Network` to build, connect & automate real-time data streams.
-
-## Cell Features
-- **Transmitters (TX)**: Automate economic data transfer + Circuits Integration
-- **Circuits (CTX)**: A simple Key-Value-Label database to store economic data
-- **Streams (STX)**: Stream, synchronize and control data in real time
-- **Nodes**: Register hardware nodes actively streaming real-time data into the network
-
-## Getting Started
-Create your Neuronum Cell: [Create Cell](https://neuronum.net/createcell)
-
-Install the Neuronum library using pip:
-```bash
-pip install neuronum
-```
-
-Set and test Cell connection:
-```bash
-import neuronum
-
-cell = neuronum.Cell(
-host="host::cell",
-password="your_password",
-network="neuronum.net",
-synapse="your_synapse"
-)
-cell.test_connection()
-```
-
-### Transmitters (TX)
-Activate Transmitter (TX):
-```bash
-TX = "id::tx"
-data = {
-    "key1": "value1",
-    "key2": "value2",
-    "key3": "value3",
-}
-cell.activate(TX, data)
-```
-
-### Circuits (CTX)
-Store data on your private Circuit (CTX):
-```bash
-label = "your_label"
-data = {
-    "key1": "value1",
-    "key2": "value2",
-    "key3": "value3",
-}
-cell.store(label, data)
-```
-
-Store data on a public Circuit (CTX):
-```bash
-CTX = "id::ctx"
-label = "your_label"
-data = {
-    "key1": "value1",
-    "key2": "value2",
-    "key3": "value3",
-}
-cell.store(label, data, CTX)
-```
-
-Load data from your private Circuit (CTX):
-```bash
-label = "your_label"
-data = cell.load(label)
-key1 = data["key1"]
-key2 = data["key2"]
-key3 = data["key3"]
-```
-
-Load data from a public Circuit (CTX):
-```bash
-CTX = "id::ctx"
-label = "your_label"
-data = cell.load(label, CTX)
-key1 = data["key1"]
-key2 = data["key2"]
-key3 = data["key3"]
-```
-
-Delete data from your private Circuit (CTX):
-```bash
-label = "your_label"
-data = cell.delete(label)
-```
-
-Delete data from a public Circuit (CTX):
-```bash
-CTX = "id::ctx"
-label = "your_label"
-data = cell.delete(label, CTX)
-```
-
-Empty your private Circuit (CTX):
-```bash
-cell.clear()
-```
-
-Empty a public Circuit (CTX):
-```bash
-CTX = "id::ctx"
-cell.clear(CTX)
-```
-
-### Streams (STX)
-Stream data to your private Stream (STX):
-```bash
-label = "your_label"
-data = {
-    "key1": "value1",
-    "key2": "value2",
-    "key3": "value3",
-}
-cell.stream(label, data)
-```
-
-Stream data to a public Stream (STX):
-```bash
-STX = "id::stx"
-label = "your_label"
-data = {
-    "key1": "value1",
-    "key2": "value2",
-    "key3": "value3",
-}
-cell.stream(label, data, STX)
-```
-
-Sync data from your private Stream (STX):
-```bash
-stream = cell.sync()
-for operation in stream:
-    label = operation.get("label")
-    value = operation.get("data").get("key1")
-    ts = operation.get("time")
-    stxID = operation.get("stxID")
-    operator = operation.get("operator")
-```
-
-Sync data from a public Stream (STX):
-```bash
-STX = "id::stx"
-stream = cell.sync(STX)
-for operation in stream:
-    label = operation.get("label")
-    value = operation.get("data").get("key1")
-    ts = operation.get("time")
-    stxID = operation.get("stxID")
-    operator = operation.get("operator")
-```
-
-### Nodes
-Register a public Node with its associated Stream (STX):
-```bash
-node = "node_name"  # Unique node name
-mode = "public"
-STX = "id::stx"
-cell.register(node, mode, STX)
-```
-
-Register a private Node with its associated Stream (STX):
-```bash
-node = "node_name"  # Unique node name
-mode = "private"    
-STX = "id::stx"
-cell.register(node, mode, STX)
-```
-

neuronum-1.4.1.dist-info/RECORD

@@ -1,7 +0,0 @@
-neuronum/__init__.py,sha256=Drsm263_w3_VWgl1YsKLUr8WwVodqV3TSjqpxLjyq_M,46
-neuronum/neuronum.py,sha256=X5peM3ZOK7MJU-zS8GeqBC2vBu-weAJgCfzQ48I3FvI,8908
-neuronum-1.4.1.dist-info/LICENSE,sha256=UiZjNHiCyRP6WoZfbYQh9cv4JW96wIofKXmzBJrYSUk,1125
-neuronum-1.4.1.dist-info/METADATA,sha256=lg-qZ407i0vZsj4BNVR7X8_keos82I4r7pnzMVjwjwc,4590
-neuronum-1.4.1.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
-neuronum-1.4.1.dist-info/top_level.txt,sha256=73zXVVO9UTTiwEcSaXytsJ8n0q47OCwAqPlIh-hzWJU,9
-neuronum-1.4.1.dist-info/RECORD,,