Refactor project structure for better organization

Author: Rainbow

README.md

@@ -1,36 +1,36 @@
-# AgentSDK.py
+# ATTPs SDK
 
-This library is a simple asynchronous python wrapper around [AI Agent SDK](https://github.com/APRO-com/ai-agent-sdk-python).
+This library is a simple asynchronous python wrapper around [ATTPs SDK](https://github.com/APRO-com/ATTPs-sdk-python).
 
 # Installation
 ```bash
-$ pip3 install ai-agent-sdk
+$ pip3 install attps-sdk
 ```
 
 # Usage
 
 ### Initialize AgentSDK
 
 ```python
-from ai_agent.agent import AgentSDK
+from attps.verify.agent import AgentSDK
 
-AGENT_PROXY_ADDRESS = "0x07771A3026E60776deC8C1C61106FB9623521394"
-NETWORK_RPC = "https://testnet-rpc.bitlayer.org"
+AGENT_PROXY_ADDRESS = "0x07771A3026E60776deC8C1C61106FB9623521394" # ATTPs verify module agent contract deployment address (EVM)
+NETWORK_RPC = "https://testnet-rpc.bitlayer.org" # ATTPs verify module agent contract deployment chain RPC address
 
 agent = AgentSDK(endpoint_uri=NETWORK_RPC, proxy_address=AGENT_PROXY_ADDRESS)
 ```
 
-To create a new agent, call the createAndRegisterAgent method:
+To create a new verify agent, call the createAndRegisterAgent method:
 
 ```python
 import time
-from ai_agent.entities import (
+from attps.verify.entities import (
     AgentSettings,
     AgentHeader,
     MessageType,
     Priority
 )
-from ai_agent.utils import (
+from utils.utils import (
     generate_uuid_v4
 )
 
@@ -45,17 +45,17 @@ AGENT_SETTINGS = AgentSettings(
         "0xD4E157c36E7299bB40800e4aE7909DDcA8097f67",
         "0xA3866A07ABEf3fD0643BD7e1c32600520F465ca8",
         "0x62f642Ae0Ed7F12Bc40F2a9Bf82ccD0a3F3b7531"
-    ],
-    threshold=2,
-    converter_address="0xaB303EF87774D9D259d1098E9aA4dD6c07F69240",
+    ], # Signer list corresponding to the Agent's signed data
+    threshold=2, # Verification threshold, minimum number of correct signatures from signers
+    converter_address="0xaB303EF87774D9D259d1098E9aA4dD6c07F69240", # Converter contract address for intermediate data processing between signed data and final signed data
     agent_header=AgentHeader(
-        version="1.0",
-        message_id="d4d0813f-ceb7-4ce1-8988-12899b26c4b6",
-        source_agent_id="da70f6b3-e580-470f-b88b-caa5369e7778",
-        source_agent_name="APRO Pull Mode Agent",
-        target_agent_id="",
-        timestamp=int(time.time()),
-        message_type=MessageType.Event,
+        version="1.0", # agent version
+        message_id="d4d0813f-ceb7-4ce1-8988-12899b26c4b6", # Agent‘s Message ID, Used for target agent uniqueness verification
+        source_agent_id="da70f6b3-e580-470f-b88b-caa5369e7778", # Source Agent ID, globally unique in the system
+        source_agent_name="APRO Pull Mode Agent", # Source agent name
+        target_agent_id="", # Target Agent ID
+        timestamp=int(time.time()), # Agent registration time
+        message_type=MessageType.Event, # Agent data transmission type, currently only supports Event
         priority=Priority.Low,
         ttl=60 * 60
     )
@@ -67,7 +67,7 @@ dynamic_setting.agent_header.target_agent_id = generate_uuid_v4()
 dynamic_setting.agent_header.message_id = generate_uuid_v4()
 user_owner = agent.add_account("0x_user_private_key")
 result = agent.create_and_register_agent(
-    transmitter="",
+    transmitter="", 
     nonce=None,
     settings=AGENT_SETTINGS)
 print("created agent:", result)
@@ -76,17 +76,17 @@ print("created agent:", result)
 To verify the data integrity, call the verify method:
 
 ```python
-from ai_agent.entities import (
+from attps.verify.entities import (
     AgentMessagePayload,
     Proofs,
     AgentMetadata,
 )
 
-AGENT_CONTRACT = "0xA1903361Ee8Ec35acC7c8951b4008dbE8D12C155"
-AGENT_SETTING_DIGEST = "0x010038164dba6abffb84eb5cb538850d9bc5d8f815149a371069b3255fd177a4"
+AGENT_CONTRACT = "0xA1903361Ee8Ec35acC7c8951b4008dbE8D12C155" # Verification contract corresponding to the agent
+AGENT_SETTING_DIGEST = "0x010038164dba6abffb84eb5cb538850d9bc5d8f815149a371069b3255fd177a4" # Agent's configuration information identifier, returned in the blockchain event during registration or modification
 AGENT_PAYLOAD = AgentMessagePayload(
     data="0x0006e706cf7ab41fa599311eb3de68be869198ce62aef1cd079475ca50e5b3f60000000000000000000000000000000000000000000000000000000002b1bf0e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000000000022000000000000000000000000000000000000000000000000000000000000002a0000101000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001200003665949c883f9e0f6f002eac32e00bd59dfe6c34e92a91c37d6a8322d6489000000000000000000000000000000000000000000000000000000006762677d000000000000000000000000000000000000000000000000000000006762677d000000000000000000000000000000000000000000000000000003128629ec0800000000000000000000000000000000000000000000000004db732547630000000000000000000000000000000000000000000000000000000000006763b8fd0000000000000000000000000000000000000000000015f0f60671beb95cc0000000000000000000000000000000000000000000000015f083baa654a7b900000000000000000000000000000000000000000000000015f103ec7cb057ea80000000000000000000000000000000000000000000000000000000000000000003b64f7e72208147bb898e8b215d0997967bef0219263726c76995d8a19107d6ba5306a176474f9ccdb1bc5841f97e0592013e404e15b0de0839b81d0efb26179f222e0191269a8560ebd9096707d225bc606d61466b85d8568d7620a3b59a73e800000000000000000000000000000000000000000000000000000000000000037cae0f05c1bf8353eb5db27635f02b40a534d4192099de445764891198231c597a303cd15f302dafbb1263eb6e8e19cbacea985c66c6fed3231fd84a84ebe0276f69f481fe7808c339a04ceb905bb49980846c8ceb89a27b1c09713cb356f773",
-    data_hash="0x53d9f133f1265bd4391fcdf89b63424cbcfd316c8448f76cc515647267ac0a8e",
+    data_hash="0x53d9f133f1265bd4391fcdf89b63424cbcfd316c8448f76cc515647267ac0a8e", # Hash of the corresponding data
     proofs=Proofs(
         zk_proof="0x",
         merkle_proof="0x",

ai_agent/__init__.py renamed to attps/__init__.py

@@ -15,8 +15,8 @@
     URI
 )
 
-from ai_agent.core.core import Agent
-from ai_agent.entities import  (
+from attps.verify.core.core import Agent
+from attps.verify.entities import  (
     AgentSettings,
     AgentMessagePayload,
     AgentRegisterResults,

ai_agent/core/__init__.py renamed to attps/verify/__init__.py

@@ -26,11 +26,11 @@
     Union, Optional, Any,
 )
 
-from ai_agent.core.abis.manger import AGENT_MANAGER_ABI
-from ai_agent.core.abis.proxy import AGENT_PROXY_ABI
-from ai_agent.core.abis.agent import AGENT_AGENT_ABI
+from attps.verify.core.abis import AGENT_MANAGER_ABI
+from attps.verify.core.abis import AGENT_PROXY_ABI
+from attps.verify.core.abis import AGENT_AGENT_ABI
 
-from ai_agent.entities import (
+from attps.verify.entities import (
     AgentSettings,
     AgentMessagePayload,
     AgentRegisterResults,
@@ -39,7 +39,7 @@
     Priority,
     _EIP1559GAS
 )
-from ai_agent.utils import (
+from utils.utils import (
     add_0x_prefix,
     is_valid_private_key,
     is_valid_address,

ai_agent/agent.py renamed to attps/verify/agent.py

@@ -7,22 +7,22 @@
 from pathlib import Path
 
 version = {}
-version_path = Path('ai_agent/version.py').resolve()
+version_path = Path('attps/version.py').resolve()
 with open(version_path) as f:
     exec(f.read(), version)
 
 with open("README.md", "r") as fh:
     long_description = fh.read()
 
 setup(
-    name='ai-agent-sdk',
+    name='attps-sdk',
     version=version['__version__'],
     author='APRO',
     author_email='apro@apro.com',
-    description='ai agent sdk for apro',
+    description='ATTPs sdk for APRO',
     long_description=long_description,
     long_description_content_type="text/markdown",
-    url='https://github.com/APRO-com/ai-agent-sdk-python',
+    url='https://github.com/APRO-com/ATTPs-sdk-python',
     packages=find_packages(),
     install_requires=[
         'web3 > 7.0.0',

attps/verify/core/__init__.py

@@ -2,14 +2,14 @@
 import time
 
 from dotenv import load_dotenv
-from ai_agent.agent import AgentSDK
-from ai_agent.entities import (
+from attps.verify.agent import AgentSDK
+from attps.verify.entities import (
     AgentSettings,
     AgentHeader,
     MessageType,
     Priority, AgentMessagePayload, Proofs, AgentMetadata
 )
-from ai_agent.utils import (
+from utils.utils import (
     generate_uuid_v4,
     is_valid_uuid_v4,
     is_valid_address,