# eth\_getCode - TRON ## Description The 'eth\_getCode' Web3 method is a crucial component of the Tron protocol, designed to retrieve the bytecode of smart contracts deployed on the blockchain. As part of the eth\_getCode RPC protocol, this method allows developers to access the low-level code of a contract at a specified address. By sending a JSON-RPC request with the contract's address and an optional block parameter, users can obtain the exact bytecode, which is essential for verifying contract functionality and security. This method is widely used in development and auditing processes, providing a reliable and efficient way to interact with smart contracts on the Tron network. Whether you're building dApps or conducting code reviews, 'eth\_getCode' ensures you have the necessary tools to access and analyze contract code seamlessly. ## Supported Networks The eth\_getCode RPC method supports the following network types * **Mainnet** * **Testnets** ## Parameters Here is the list of parameters the eth\_getCode method needs to be executed. * **Address (required)** * **Type:** String * **Description:** The address of the account whose code is being requested. * **Example:** "0x4170082243784DCDF3042034E7B044D6D342A91360" * **Block Parameter (required)** * **Type:** String * **Description:** The block number or one of the predefined block tags ("latest", "earliest", "pending") to specify the context in which the code should be retrieved. * **Supported Values:** "latest", "earliest", "pending", or a specific block number. * **Example:** "latest" ### URL ```json https://go.getblock.io// ``` Here’s a sample cURL request using eth\_getCode Request ```json curl --location --request POST 'https://go.getblock.io//jsonrpc' --header 'Content-Type: application/json' {"jsonrpc": "2.0", "method": "eth_getCode", "params": ["0x4170082243784DCDF3042034E7B044D6D342A91360", "latest"], "id": "getblock.io"} ``` Response ```json { "jsonrpc": "2.0", "id": "getblock.io", "result": "0x6080604052600436106101535763ffffffff7c010000000000000000000000000000000000000000000000000000000060003504166306fdde03811461015857806307da68f5146101fc578063095ea7b31461022d57806313af40351461027f57806318160ddd146102ba57806323b872dd146102fb578063313ce5671461033f57806340c10f191461036e57806342966c68146103ac57806370a08231146103de57806375f12b21146104195780637a9e5e4b146104485780638da5cb5b1461048357806395d89b41146104ce5780639dc29fac146104fd578063a0712d681461053b578063a9059cbb1461056d578063b753a98c146105ab578063b84c8246146105e9578063bb35783b1461065c578063be9a6555146106a0578063bf7e214f146106cf578063c47f0027146106fe578063daea85c514610771578063dd62ed3e146107ac578063f2d5d56b146107ed575b600080fd5b34801561016457600080fd5b50d3801561017157600080fd5b50d2801561017e57600080fd5b5061018761082b565b6040805160208082528351818301528351919283929083019185019080838360005b838110156101c15781810151838201526020016101a9565b50505050905090810190601f1680156101ee5780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b34801561020857600080fd5b50d3801561021557600080fd5b50d2801561022257600080fd5b5061022b6108b9565b005b34801561023957600080fd5b50d3801561024657600080fd5b50d2801561025357600080fd5b5061026b600160a060020a0360043516602435610990565b604080519115158252519081900360200190f35b34801561028b57600080fd5b50d3801561029857600080fd5b50d280156102a557600080fd5b5061022b600160a060020a03600435166109f6565b3480156102c657600080fd5b50d380156102d357600080fd5b50d280156102e057600080fd5b506102e9610aad565b60408051918252519081900360200190f35b34801561030757600080fd5b50d3801561031457600080fd5b50d2801561032157600080fd5b5061026b600160a060020a0360043581169060243516604435610ab4565b34801561034b57600080fd5b50d3801561035857600080fd5b50d2801561036557600080fd5b506102e9610d3b565b34801561037a57600080fd5b50d3801561038757600080fd5b50d2801561039457600080fd5b5061022b600160a060020a0360043516602435610d41565b3480156103b857600080fd5b50d380156103c557600080fd5b50d280156103d257600080fd5b5061022b600435610e7b565b3480156103ea57600080fd5b50d380156103f757600080fd5b50d2801561040457600080fd5b506102e9600160a060020a0360043516610e88565b34801561042557600080fd5b50d3801561043257600080fd5b50d2801561043f57600080fd5b5061026b610ea3565b34801561045457600080fd5b50d3801561046157600080fd5b50d2801561046e57600080fd5b5061026b600160a060020a0360043516610eb3565b34801561048f57600080fd5b50d3801561049c57600080fd5b50d280156104a957600080fd5b506104b2610f71565b60408051600160a060020a039092168252519081900360200190f35b3480156104da57600080fd5b50d380156104e757600080fd5b50d280156104f457600080fd5b50610187610f80565b34801561050957600080fd5b50d3801561051657600080fd5b50d2801561052357600080fd5b5061022b600160a060020a0360043516602435610fdb565b34801561054757600080fd5b50d3801561055457600080fd5b50d2801561056157600080fd5b5061022b600435611296565b34801561057957600080fd5b50d3801561058657600080fd5b50d2801561059357600080fd5b5061026b600160a060020a03600435166024356112a0565b3480156105b757600080fd5b50d380156105c457600080fd5b50d280156105d157600080fd5b5061022b600160a060020a03600435166024356112ad565b3480156105f557600080fd5b50d3801561060257600080fd5b50d2801561060f57600080fd5b506040805160206004803580820135601f810184900484028501840190955284845261022b9436949293602493928401919081908401838280828437509497506112bd9650505050505050565b34801561066857600080fd5b50d3801561067557600080fd5b50d2801561068257600080fd5b5061022b600160a060020a036004358116906024351660443561132e565b3480156106ac57600080fd5b50d380156106b957600080fd5b50d280156106c657600080fd5b5061022b61133f565b3480156106db57600080fd5b50d380156106e857600080fd5b50d280156106f557600080fd5b506104b2611410565b34801561070a57600080fd5b50d3801561071757600080fd5b50d2801561072457600080fd5b506040805160206004803580820135601f810184900484028501840190955284845261022b94369492936024939284019190819084018382808284375094975061141f9650505050505050565b34801561077d57600080fd5b50d3801561078a57600080fd5b50d2801561079757600080fd5b5061026b600160a060020a036004351661148c565b3480156107b857600080fd5b50d380156107c557600080fd5b50d280156107d257600080fd5b506102e9600160a060020a03600435811690602435166114eb565b3480156107f957600080fd5b50d3801561080657600080fd5b50d2801561081357600080fd5b5061022b600160a060020a0360043516602435611516565b6007805460408051602060026001851615610100026000190190941693909304601f810184900484028201840190925281815292918301828280156108b15780601f10610886576101008083540402835291602001916108b1565b820191906000526020600020905b81548152906001019060200180831161089457829003601f168201915b505050505081565b6108cf33600035600160e060020a031916611521565b1515610913576040805160e560020a62461bcd02815260206004820152601460248201526000805160206117fa833981519152604482015290519081900360640190fd5b60408051348082526020820183815236938301849052600435936024359384928692339260008035600160e060020a031916938893919290606082018484808284376040519201829003965090945050505050a450506004805474ff0000000000000000000000000000000000000000191660a060020a17905550565b60045460009060a060020a900460ff16156109e3576040805160e560020a62461bcd02815260206004820152601260248201526000805160206117da833981519152604482015290519081900360640190fd5b6109ed8383611625565b90505b92915050565b610a0c33600035600160e060020a031916611521565b1515610a50576040805160e560020a62461bcd02815260206004820152601460248201526000805160206117fa833981519152604482015290519081900360640190fd5b6004805473ffffffffffffffffffffffffffffffffffffffff1916600160a060020a0383811691909117918290556040519116907fce241d7ca1f669fee44b6fc00b8eba2df3bb514eed0f6f668f8f89096e81ed9490600090a250565b6000545b90565b60045460009060a060020a900460ff1615610b07576040805160e560020a62461bcd02815260206004820152601260248201526000805160206117da833981519152604482015290519081900360640190fd5b600160a060020a0384163314801590610b455750600160a060020a038416600090815260026020908152604080832033845290915290205460001914155b15610c1857600160a060020a0384166000908152600260209081526040808320338452909152902054821115610bc5576040805160e560020a62461bcd02815260206004820152601e60248201527f64732d746f6b656e2d696e73756666696369656e742d617070726f76616c0000604482015290519081900360640190fd5b600160a060020a0384166000908152600260209081526040808320338452909152902054610bf3908361168b565b600160a060020a03851660009081526002602090815260408083203384529091529020555b600160a060020a038416600090815260016020526040902054821115610c88576040805160e560020a62461bcd02815260206004820152601d60248201527f64732d746f6b656e2d696e73756666696369656e742d62616c616e6365000000604482015290519081900360640190fd5b600160a060020a038416600090815260016020526040902054610cab908361168b565b600160a060020a038086166000908152600160205260408082209390935590851681522054610cda90836116e6565b600160a060020a0380851660008181526001602090815260409182902094909455805186815290519193928816927fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef92918290030190a35060019392505050565b60065481565b610d5733600035600160e060020a031916611521565b1515610d9b576040805160e560020a62461bcd02815260206004820152601460248201526000805160206117fa833981519152604482015290519081900360640190fd5b60045460a060020a900460ff1615610deb576040805160e560020a62461bcd02815260206004820152601260248201526000805160206117da833981519152604482015290519081900360640190fd5b600160a060020a038216600090815260016020526040902054610e0e90826116e6565b600160a060020a03831660009081526001602052604081209190915554610e3590826116e6565b600055604080518281529051600160a060020a038416917f0f6798a560793a54c3bcfe86a93cde1e73087d944c0ea20544137d4121396885919081900360200190a25050565b610e853382610fdb565b50565b600160a060020a031660009081526001602052604090205490565b60045460a060020a900460ff1681565b6000610ecb33600035600160e060020a031916611521565b1515610f0f576040805160e560020a62461bcd02815260206004820152601460248201526000805160206117fa833981519152604482015290519081900360640190fd5b6003805473ffffffffffffffffffffffffffffffffffffffff1916600160a060020a0384811691909117918290556040519116907f1abebea81bfa2637f28358c371278fb15ede7ea8dd28d2e03b112ff6d936ada490600090a2506001919050565b600454600160a060020a031681565b6005805460408051602060026001851615610100026000190190941693909304601f810184900484028201840190925281815292918301828280156108b15780601f10610886576101008083540402835291602001916108b1565b610ff133600035600160e060020a031916611521565b1515611035576040805160e560020a62461bcd02815260206004820152601460248201526000805160206117fa833981519152604482015290519081900360640190fd5b60045460a060020a900460ff1615611085576040805160e560020a62461bcd02815260206004820152601260248201526000805160206117da833981519152604482015290519081900360640190fd5b600160a060020a03821633148015906110c35750600160a060020a038216600090815260026020908152604080832033845290915290205460001914155b1561119657600160a060020a0382166000908152600260209081526040808320338452909152902054811115611143576040805160e560020a62461bcd02815260206004820152601e60248201527f64732d746f6b656e2d696e73756666696369656e742d617070726f76616c0000604482015290519081900360640190fd5b600160a060020a0382166000908152600260209081526040808320338452909152902054611171908261168b565b600160a060020a03831660009081526002602090815260408083203384529091529020555b600160a060020a038216600090815260016020526040902054811115611206576040805160e560020a62461bcd02815260206004820152601d60248201527f64732d746f6b656e2d696e73756666696369656e742d62616c616e6365000000604482015290519081900360640190fd5b600160a060020a038216600090815260016020526040902054611229908261168b565b600160a060020a03831660009081526001602052604081209190915554611250908261168b565b600055604080518281529051600160a060020a038416917fcc16f5dbb4873280815c1ee09dbd06736cffcc184412cf7a71a0fdb75d397ca5919081900360200190a25050565b610e853382610d41565b60006109ed338484610ab4565b6112b8338383610ab4565b505050565b6112d333600035600160e060020a031916611521565b1515611317576040805160e560020a62461bcd02815260206004820152601460248201526000805160206117fa833981519152604482015290519081900360640190fd5b805161132a906005906020840190611741565b5050565b611339838383610ab4565b50505050565b61135533600035600160e060020a031916611521565b1515611399576040805160e560020a62461bcd02815260206004820152601460248201526000805160206117fa833981519152604482015290519081900360640190fd5b60408051348082526020820183815236938301849052600435936024359384928692339260008035600160e060020a031916938893919290606082018484808284376040519201829003965090945050505050a450506004805474ff00000000000000000000000000000000000000001916905550565b600354600160a060020a031681565b61143533600035600160e060020a031916611521565b1515611479576040805160e560020a62461bcd02815260206004820152601460248201526000805160206117fa833981519152604482015290519081900360640190fd5b805161132a906007906020840190611741565b60045460009060a060020a900460ff16156114df576040805160e560020a62461bcd02815260206004820152601260248201526000805160206117da833981519152604482015290519081900360640190fd5b6109f082600019611625565b600160a060020a03918216600090815260026020908152604080832093909416825291909152205490565b6112b8823383610ab4565b6000600160a060020a03831630141561153c575060016109f0565b600454600160a060020a038481169116141561155a575060016109f0565b600354600160a060020a03161515611574575060006109f0565b600354604080517fb7009613000000000000000000000000000000000000000000000000000000008152600160a060020a038681166004830152306024830152600160e060020a0319861660448301529151919092169163b70096139160648083019260209291908290030181600087803b1580156115f257600080fd5b505af1158015611606573d6000803e3d6000fd5b505050506040513d602081101561161c57600080fd5b505190506109f0565b336000818152600260209081526040808320600160a060020a038716808552908352818420869055815186815291519394909390927f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925928290030190a350600192915050565b808203828111156109f0576040805160e560020a62461bcd02815260206004820152601560248201527f64732d6d6174682d7375622d756e646572666c6f770000000000000000000000604482015290519081900360640190fd5b808201828110156109f0576040805160e560020a62461bcd02815260206004820152601460248201527f64732d6d6174682d6164642d6f766572666c6f77000000000000000000000000604482015290519081900360640190fd5b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f1061178257805160ff19168380011785556117af565b828001600101855582156117af579182015b828111156117af578251825591602001919060010190611794565b506117bb9291506117bf565b5090565b610ab191905b808211156117bb57600081556001016117c5560064732d73746f702d69732d73746f70706564000000000000000000000000000064732d617574682d756e617574686f72697a6564000000000000000000000000a165627a7a7230582080f4dc7c5063fe7c1e054000b60d914ef20d2516252b241f032583773564851b0029" } ``` ## Body Parameters Here is the list of body parameters for the `eth_getCode` method: 1. **jsonrpc**: The version of the JSON-RPC protocol used. In this case, it is `"2.0"`. 2. **id**: A unique identifier for the request. This is typically a string or a number. In the given example, it is `"getblock.io"`. 3. **result**: The bytecode of the contract at the specified address. In this example, it is a long hexadecimal string that represents the smart contract's bytecode. ## Use Case Here are some use-cases for the `eth_getCode` method: 1. **Smart Contract Verification**: One of the primary uses of the `eth_getCode` method is to verify whether a specific Ethereum address contains a smart contract. By calling this method, developers can retrieve the bytecode stored at an address. If the returned bytecode is not empty, it indicates that the address hosts a smart contract. This is particularly useful for applications that need to differentiate between regular wallet addresses and smart contract addresses. 2. **Security Audits and Analysis**: In Web3 programming, security is paramount. The `eth_getCode` method can be used as part of security audits and analysis to fetch the deployed bytecode of a smart contract. Auditors can then analyze this bytecode to ensure that it matches the expected code, check for known vulnerabilities, or confirm that the deployed version has not been tampered with. 3. **Dynamic Contract Interaction**: Some decentralized applications (dApps) may need to interact with a variety of smart contracts dynamically. By using `eth_getCode`, these applications can programmatically determine the presence and type of contract at a given address before executing specific interactions. This ensures that the dApp only attempts to call functions on valid smart contracts, reducing the risk of errors and improving the overall user experience. ## Code for eth\_getCode ```python import requests import json url = "https://go.getblock.io//" headers = { "Content-Type": "application/json" } payload = {"jsonrpc": "2.0", "method": "eth_getCode", "params": ["0x4170082243784DCDF3042034E7B044D6D342A91360", "latest"], "id": "getblock.io"} response = requests.post(url, headers=headers, data=json.dumps(payload)) # Check the response and print the result if response.status_code == 200: print("Result:", response.json().get("result")) else: print("Error:", response.status_code, response.text) ``` ## Common Errors Common Errors\ When using the eth\_getCode RPC Tron method, the following issues may occur: * **Invalid Address Format**: If the address provided is not in a valid hexadecimal format, the request will fail. Ensure the address is a properly formatted hexadecimal string starting with '0x'. * **Nonexistent Contract Address**: Requesting the code of an address with no associated contract will return an empty result. Verify that the address is indeed a smart contract on the Tron network. * **Network Latency or Unavailability**: Temporary network issues may cause timeouts or failed requests. Check your network connection and try again, or ensure the Tron node you are querying is operational. * **Incorrect Block Parameter**: Using an invalid block parameter, such as a nonexistent block number, can lead to errors. Always use 'latest' or a valid block number to avoid this issue. Using the eth\_getCode method in Web3 applications provides a powerful way to verify and interact with smart contracts by retrieving their bytecode. This functionality is essential for developers who need to ensure contract integrity and perform on-chain analysis, enhancing the security and reliability of decentralized applications. ### conclusion The `eth_getCode` RPC method is used to retrieve the bytecode of a smart contract deployed on the Ethereum blockchain at a specified address. This function is crucial for developers and users who need to verify the code of a contract or interact with it programmatically. While `eth_getCode` is specific to Ethereum, similar functionalities exist in other blockchain ecosystems like Tron, highlighting the universal need for accessing smart contract code across different platforms. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.getblock.io/api-reference/tron-trx/json-rpc_api/eth_getcode.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.