enclave-py-sdk 0.1.0

No project description provided

Enclave Python SDK Example

This README provides an overview of how to use the Enclave Python SDK to interact with the Ethereum blockchain, specifically on the Optimism network. The example demonstrates creating a smart account, computing a quote for a transaction, building, signing, and submitting a transaction.

Note: This is a chain-abstracted transaction demo on Optimism, allowing users to make transactions by depositing USDC to any supported chain, even if it is not Optimism.

Prerequisites

• Python 3.x
• Required libraries:
  • web3
  • enclave_py_sdk
  • python-dotenv

Setup

1. Install the required libraries:

   pip install web3 enclave_py_sdk python-dotenv
   

2. Create a .env file in your project directory with the following variables:

   ALCHEMY_KEY=your_alchemy_key
   ENCLAVE_KEY=your_enclave_key
   PRIVATE_KEY=your_private_key
   

Example Usage

The following code demonstrates how to create a smart account, compute a transaction quote, and submit a transaction.

# Environment Setup
import os
from web3 import Web3
from enclave_py_sdk import Enclave
from dotenv import load_dotenv

load_dotenv()

# Web3 and Enclave Initialization
w3 = Web3(Web3.HTTPProvider(
    f"https://opt-mainnet.g.alchemy.com/v2/{os.getenv('ALCHEMY_KEY')}"))
client = Enclave(os.getenv("ENCLAVE_KEY"))

# Account Generation
eoa = w3.eth.account.from_key(os.getenv("PRIVATE_KEY"))
print("Address:", eoa.address)

# Smart Account Creation
account = client.create_smart_account(eoa.address)
print("Smart account created:", account.wallet.scw_address)

# Balance Retrieval
balance = client.get_smart_balance(account.wallet.scw_address)
print('Smart Account Balance:', balance['netBalance'])

# Quote Computation
network = 10
amount = 0.1 * 1e6  # Amount to compute the quote for
quote_type = 'AMOUNT_IN' 
quote = client.compute_quote(account.wallet.scw_address, network, amount, quote_type)
print('Quote computed:', quote)

# Transaction Preparation
usdc_on_optimism = '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85' 
recipient_address = '0x4E2ef45077FB15Ef5f0FfF9E86B38991aA4bAe5C'  # Replace with the recipient's address
credit_amount = int(quote['total_credit']) + int(quote['userWithdrawal'])

usdc_contract = w3.eth.contract(address=usdc_on_optimism, abi=[{
    'constant': False,
    'inputs': [
        {'name': 'to', 'type': 'address'},
        {'name': 'amount', 'type': 'uint256'}
    ],
    'name': 'transfer',
    'outputs': [{'name': '', 'type': 'bool'}],
    'payable': False,
    'stateMutability': 'nonpayable',
    'type': 'function'
}])
encoded_data = usdc_contract.encode_abi(
    "transfer",
    args=[
        Web3.to_checksum_address(recipient_address),
        credit_amount
    ]
)

transaction_details = [{
    'encodedData': encoded_data, 
    'targetContractAddress': usdc_on_optimism,
    'value': 0  # Assuming no ETH is being transferred, only USDC
}]

order_data = {
    'amount': str(int(amount)),  # Amount of USDC required for the transfer 
    'type': 'AMOUNT_IN'
}

# Signing and Submission
built_txn = client.build_transaction(
    transaction_details,
    10,  # Target network
    account.wallet.scw_address,  # User's smart account address
    order_data,
    None,
    1  # Sign mode
)

signature = eoa.sign_message(encode_defunct(hexstr=built_txn.message_to_sign))

try:
    response = client.submit_transaction(
        "0x" + signature.signature.hex(),
        user_op_serializable,
        10,  # Target network
        account.wallet.scw_address,
        1  # Signature type
    )
    print('Transaction submitted successfully:', response)
except Exception as e:
    print('Error submitting transaction:', str(e))