> ## Documentation Index
> Fetch the complete documentation index at: https://www.dynamic.xyz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# EVM Integration

## sdk.evm

EVM blockchain operations module for Ethereum and compatible chains.

### createPublicClient

Create a public client for a specific chain.

```swift theme={"system"}
try await sdk.evm.createPublicClient(chainId: Int) -> PublicClient
```

#### Parameters

* **chainId** (Int) - Chain ID of the network

#### Returns

* **PublicClient** - Public client for the specified chain

#### Example

```swift theme={"system"}
let sdk = DynamicSDK.instance()

// Ethereum mainnet
let mainnetClient = try await sdk.evm.createPublicClient(chainId: 1)

// Base Sepolia testnet
let baseSepoliaClient = try await sdk.evm.createPublicClient(chainId: 84532)

// Get gas price
let gasPrice = try await baseSepoliaClient.getGasPrice()
print("Gas price: \(gasPrice.value) wei")
```

### sendTransaction

Send an EVM transaction.

```swift theme={"system"}
try await sdk.evm.sendTransaction(
    transaction: EthereumTransaction,
    wallet: BaseWallet
) -> String
```

#### Parameters

* **transaction** (EthereumTransaction) - Transaction to send
* **wallet** (BaseWallet) - Wallet to send from

#### Returns

* **String** - Transaction hash

#### Example

```swift theme={"system"}
let sdk = DynamicSDK.instance()

// Get gas price first
let client = try await sdk.evm.createPublicClient(chainId: 84532)
let gasPrice = try await client.getGasPrice()

// Create transaction
let transaction = EthereumTransaction(
    from: wallet.address,
    to: "0xRecipientAddress...",
    value: BigUInt(1000000000000000),  // 0.001 ETH in Wei
    gas: BigUInt(21000),
    maxFeePerGas: gasPrice * 2,
    maxPriorityFeePerGas: gasPrice
)

// Send transaction
if let wallet = sdk.wallets.userWallets.first {
    let txHash = try await sdk.evm.sendTransaction(
        transaction: transaction,
        wallet: wallet
    )
    print("Transaction hash: \(txHash)")
}
```

### signTransaction

Sign a transaction without sending it.

```swift theme={"system"}
try await sdk.evm.signTransaction(
    transaction: EthereumTransaction,
    wallet: BaseWallet
) -> String
```

#### Parameters

* **transaction** (EthereumTransaction) - Transaction to sign
* **wallet** (BaseWallet) - Wallet to sign with

#### Returns

* **String** - Signed transaction

#### Example

```swift theme={"system"}
import SwiftBigInt

let sdk = DynamicSDK.instance()

if let wallet = sdk.wallets.userWallets.first {
    let transaction = EthereumTransaction(
        from: wallet.address,
        to: "0xRecipientAddress...",
        value: BigUInt(1000000000000000),
        gas: BigUInt(21000),
        maxFeePerGas: BigUInt(20000000000),
        maxPriorityFeePerGas: BigUInt(1000000000)
    )

    let signedTx = try await sdk.evm.signTransaction(
        transaction: transaction,
        wallet: wallet
    )
    print("Signed transaction: \(signedTx)")
}
```

### writeContract

Write to a smart contract.

```swift theme={"system"}
try await sdk.evm.writeContract(
    wallet: BaseWallet,
    input: WriteContractInput
) -> String
```

#### Parameters

* **wallet** (BaseWallet) - Wallet to send from
* **input** (WriteContractInput) - Contract call input

#### Returns

* **String** - Transaction hash

#### Example

```swift theme={"system"}
let sdk = DynamicSDK.instance()

// Parse the built-in ERC-20 ABI
guard let abiData = Erc20.abi.data(using: .utf8),
      let abiArray = try JSONSerialization.jsonObject(with: abiData) as? [[String: Any]] else {
    throw DynamicSDKError.custom("Invalid Erc20 ABI")
}

// ERC20 transfer
let input = WriteContractInput(
    address: "0xTokenContract...",
    abi: abiArray,
    functionName: "transfer",
    args: ["0xRecipient...", "1000000000000000000"]
)

if let wallet = sdk.wallets.userWallets.first {
    let txHash = try await sdk.evm.writeContract(wallet: wallet, input: input)
    print("Transaction hash: \(txHash)")
}
```

## sdk.networks.evm

Get available EVM networks.

```swift theme={"system"}
let evmNetworks = sdk.networks.evm  // [GenericNetwork]
```

#### Example

```swift theme={"system"}
let sdk = DynamicSDK.instance()

for network in sdk.networks.evm {
    print("Network: \(network.name)")
    print("Chain ID: \(network.chainId.value)")
}
```

## EthereumTransaction

Transaction object for EVM chains. Requires `import SwiftBigInt`.

```swift theme={"system"}
EthereumTransaction(
    from: String,
    to: String,
    value: BigUInt,
    gas: BigUInt,
    maxFeePerGas: BigUInt,
    maxPriorityFeePerGas: BigUInt,
    data: String? = nil
)
```

### Properties

| Property               | Type    | Description                   |
| ---------------------- | ------- | ----------------------------- |
| `from`                 | String  | Sender address                |
| `to`                   | String  | Recipient address             |
| `value`                | BigUInt | Amount in Wei                 |
| `gas`                  | BigUInt | Gas limit                     |
| `maxFeePerGas`         | BigUInt | Maximum fee per gas           |
| `maxPriorityFeePerGas` | BigUInt | Priority fee per gas          |
| `data`                 | String? | Contract call data (optional) |

## WriteContractInput

Input for smart contract interactions. The ABI must be parsed from JSON string to array.

```swift theme={"system"}
WriteContractInput(
    address: String,
    abi: [[String: Any]],
    functionName: String,
    args: [Any]
)
```

### Properties

| Property       | Type              | Description                      |
| -------------- | ----------------- | -------------------------------- |
| `address`      | String            | Contract address                 |
| `abi`          | \[\[String: Any]] | Parsed contract ABI (JSON array) |
| `functionName` | String            | Function to call                 |
| `args`         | \[Any]            | Function arguments               |

### Parsing ABI

```swift theme={"system"}
// Parse ABI string to array
guard let abiData = abiString.data(using: .utf8),
      let abiArray = try JSONSerialization.jsonObject(with: abiData) as? [[String: Any]] else {
    throw DynamicSDKError.custom("Invalid ABI format")
}
```

## Complete EVM Example

```swift theme={"system"}
import DynamicSDKSwift
import SwiftBigInt

let sdk = DynamicSDK.instance()

// Get EVM wallet
guard let wallet = sdk.wallets.userWallets.first(where: {
    $0.chain.uppercased() == "EVM"
}) else {
    print("No EVM wallet found")
    return
}

// Get gas price
let chainId = 84532 // Base Sepolia
let client = sdk.evm.createPublicClient(chainId: chainId)
let gasPrice = try await client.getGasPrice()

// Create and send transaction
let transaction = EthereumTransaction(
    from: wallet.address,
    to: "0xRecipient...",
    value: BigUInt(10000000000000000),  // 0.01 ETH
    gas: BigUInt(21000),
    maxFeePerGas: gasPrice * 2,
    maxPriorityFeePerGas: gasPrice
)

let txHash = try await sdk.evm.sendTransaction(
    transaction: transaction,
    wallet: wallet
)

print("Transaction sent: \(txHash)")
```

## Next Steps

* [Send ETH Transactions](/swift/wallets/evm/send-eth) - Detailed transaction guide
* [ERC-20 Token Transfers](/swift/wallets/evm/erc20-transfers) - Send ERC-20 tokens
* [Smart Contract Interactions](/swift/wallets/evm/smart-contracts) - Call contract functions