resolve_ens_name
Convert Ethereum Name Service (ENS) domains into their corresponding Ethereum addresses for blockchain interactions.
Instructions
Resolve an ENS name to its Ethereum address.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes |
Implementation Reference
- main.py:150-160 (handler)The core handler function for the 'resolve_ens_name' tool. It queries domain data using the helper function and extracts the Ethereum address, preferring resolvedAddress or falling back to resolver.addr.
async def resolve_ens_name(domain: str) -> str: """Resolve an ENS name to its Ethereum address.""" domain_data = await query_ens_domain(domain) if not domain_data: return f"No data found for ENS domain: {domain}" # Prefer resolvedAddress, fallback to resolver.addr address = (domain_data["resolvedAddress"]["id"] if domain_data["resolvedAddress"] else domain_data["resolver"]["addr"]["id"] if domain_data["resolver"] and domain_data["resolver"]["addr"] else "None") return address - main.py:149-149 (registration)The @mcp.tool() decorator registers the resolve_ens_name function as an MCP tool.
@mcp.tool() - main.py:27-82 (helper)Supporting helper function that performs a GraphQL query to fetch detailed ENS domain data from the subgraph, used by resolve_ens_name and other tools.
async def query_ens_domain(name: str) -> Optional[Dict[str, Any]]: """Query the ENS Subgraph for domain details.""" query = gql(""" query GetDomain($name: String!) { domains(where: { name: $name }) { id name labelName labelhash subdomainCount resolvedAddress { id } resolver { address addr { id } contentHash texts } ttl isMigrated createdAt owner { id } registrant { id } wrappedOwner { id } expiryDate registration { registrationDate expiryDate cost registrant { id } labelName } wrappedDomain { expiryDate fuses owner { id } name } } } """) result = await graphql_client.execute_async(query, variable_values={"name": name}) return result["domains"][0] if result["domains"] else None