# Blockchain Smart Contract Interaction

**Overview**

Aether Framework includes built-in support for interacting with blockchain smart contracts. This feature enables agents to execute trustless, verifiable actions such as task logging, resource allocation, and decentralized governance.

The framework supports **Ethereum** and **Solana**, with additional functionality for deploying, calling, and managing smart contracts.

***

#### **Key Features**

* **Smart Contract Deployment**: Deploy contracts directly from agents to enable automation and on-chain verification.
* **Function Invocation**: Call contract functions to perform tasks or retrieve data.
* **On-Chain Task Logging**: Record task results securely for auditing and collaboration.
* **Multi-Chain Support**: Use Ethereum for complex computations and Solana for high-speed, low-cost transactions.

***

#### **Examples**

**1. Deploying a Smart Contract**

Agents can deploy smart contracts on Ethereum to automate tasks and establish secure workflows.

```python
from src.utils.blockchain_manager import BlockchainManager

# Initialize the Blockchain Manager
blockchain = BlockchainManager()

# Define contract ABI and Bytecode
abi = [
    {
        "constant": True,
        "inputs": [],
        "name": "getValue",
        "outputs": [{"name": "", "type": "uint256"}],
        "payable": False,
        "stateMutability": "view",
        "type": "function",
    }
]
bytecode = "0x608060405234801561001057600080fd5b5060405161010038038061010083398101806040528101908080518201929190505050806000819055505060d58061003e6000396000f3fe6080604052600080fdfea165627a7a723058202cfa2cf67d..."

# Deploy the smart contract
contract_address = blockchain.deploy_contract(abi, bytecode)
print(f"Smart contract deployed at: {contract_address}")
```

***

**2. Calling a Smart Contract Function**

Once deployed, agents can interact with the contract's functions to retrieve or modify on-chain data.

```python
# Call a function from the deployed contract
result = blockchain.call_contract_function(contract_address, abi, "getValue")
print(f"Contract result: {result}")
```

***

**3. Logging Tasks on the Blockchain**

Agents can log task results on-chain for secure, immutable storage and auditing.

```python
# Log a task result on-chain
transaction_hash = blockchain.log_task(
    sender_keypair="path/to/solana_keypair.json",
    task_description="Analyze energy consumption data",
    task_result="Task completed successfully"
)
print(f"Task logged on blockchain. Transaction hash: {transaction_hash}")
```

***

#### **Wallet Configuration**

To interact with blockchains, agents need to securely configure wallets. Use **environment variables** to store sensitive information like wallet paths and private keys.

**Solana Wallet**

Set the wallet path using the `SOLANA_WALLET_PATH` environment variable:

```plaintext
SOLANA_WALLET_PATH=/path/to/solana-wallet.json
```

**Ethereum Wallet**

Set the private key using the `ETHEREUM_WALLET_PRIVATE_KEY` environment variable:

```plaintext
ETHEREUM_WALLET_PRIVATE_KEY=your_private_key_here
```

**Accessing Wallets in Code**

```python
import os

# Load Solana wallet path
solana_wallet_path = os.getenv("SOLANA_WALLET_PATH")
print(f"Solana Wallet Path: {solana_wallet_path}")

# Load Ethereum private key
ethereum_private_key = os.getenv("ETHEREUM_WALLET_PRIVATE_KEY")
print("Ethereum Private Key Loaded.")
```

***

#### **Common Use Cases**

1. **Task Verification**: Deploy contracts to verify that tasks were executed correctly.
2. **Resource Allocation**: Use contracts to manage on-chain resource distribution.
3. **Decentralized Governance**: Implement voting mechanisms for swarm decision-making.

***

#### **Common Issues and Solutions**

| **Problem**                                 | **Solution**                                                                       |
| ------------------------------------------- | ---------------------------------------------------------------------------------- |
| `FileNotFoundError: Wallet path not found.` | Ensure the `SOLANA_WALLET_PATH` environment variable is correctly set.             |
| `ValueError: Ethereum private key missing.` | Add the `ETHEREUM_WALLET_PRIVATE_KEY` variable to your environment.                |
| `Contract deployment failed.`               | Verify the RPC URL, ensure sufficient gas fees, and check for ABI/bytecode errors. |

***

#### **Best Practices**

* Always use environment variables to manage sensitive information like private keys.
* For high-security applications, encrypt wallets and only decrypt them during runtime.
* Test smart contracts thoroughly on testnets (e.g., Ethereum’s Goerli or Solana’s Devnet) before deploying to mainnets.
* Use multi-signature wallets for tasks involving significant resources or sensitive data.

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://aether-framework.gitbook.io/aetherframework/blockchain-smart-contract-interaction.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.