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.

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.

# 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.

# 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:

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

Ethereum Wallet

Set the private key using the ETHEREUM_WALLET_PRIVATE_KEY environment variable:

ETHEREUM_WALLET_PRIVATE_KEY=your_private_key_here

Accessing Wallets in Code

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.

---