Skip to main content

Contract Metadata

Returns contract information including ABI, proxy history, and token data.

Returns

  • Basic Info - Contract name, compiler version, verification status
  • ABI - Complete Application Binary Interface with function signatures
  • Proxy Information - Implementation addresses for upgradeable contracts
  • Deployment History - When and how the contract was deployed
  • Token Details - If it’s a token: price, volume, market cap, holders (via CoinGecko)

Example Queries

What is the contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?
Give me an overview of the Uniswap V3 Router contract
What functions does AAVE's lending pool have?

Parameters

ParameterRequiredDescription
contractAddressYesThe contract address (0x…)
blockchainNoethereum (default) or base

Sample Output

For 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2:
  • Contract name: Wrapped Ether (WETH)
  • Verified: Yes
  • Compiler: Solidity 0.4.18
  • Functions: deposit, withdraw, approve, transfer
  • Token data: price, market cap, holders

What You Get Back

Contract Information

Name: Wrapped Ether
Address: 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2
Verified: true
Compiler: v0.4.18+commit.9cf6e910

ABI Summary

The tool provides function and event summaries: Functions:
NameTypeDescription
depositwriteWrap ETH into WETH
withdrawwriteUnwrap WETH to ETH
transferwriteTransfer WETH to another address
approvewriteApprove spender allowance
balanceOfreadCheck WETH balance
Events:
NameDescription
TransferEmitted on transfers
ApprovalEmitted on approvals
DepositEmitted when ETH is wrapped
WithdrawalEmitted when WETH is unwrapped

Token Data (if applicable)

Symbol: WETH
Decimals: 18
Price: $3,245.67
Market Cap: $4.2B
24h Volume: $1.8B
Holders: 845,231

Proxy Information

For upgradeable contracts:
Proxy Type: TransparentUpgradeableProxy
Current Implementation: 0x1234...
Previous Implementations:
  - 0xabcd... (upgraded at block 15000000)
  - 0x5678... (original)

Proxy Support

For upgradeable contracts, the tool:
  1. Detects proxy type
  2. Identifies current implementation
  3. Returns implementation history
  4. Provides the implementation ABI
  1. Get overviewcontractMetadataTool
  2. Search coderegexCodeAnalysisTool for specific functions
  3. Check upgradesdiffContractVersions for change history
  4. See usagegetLatestTransactionsTool for recent activity

Tips

Be specific: “what are the main functions” is better than “tell me about this contract”
Specify chain for non-Ethereum: “on Base”

Common Use Cases

“Give me an overview of [protocol] contract. What functions will I be calling to deposit/withdraw?”
“Is this token contract verified? Does it have any unusual functions like blacklist or pause?”
“What’s the minting function for this NFT? Are there any limits or requirements?”
“What are all the contracts in the [protocol] system and how do they relate to each other?”

Next Steps