# starknet_traceTransaction > For the complete documentation index, see [llms.txt](/docs/llms.txt). POST https://starknet-mainnet.g.alchemy.com/v2/{apiKey} Returns the trace of a specific transaction, including internal calls and execution details. Reference: https://www.alchemy.com/docs/chains/starknet/starknet-api-endpoints/starknet-trace-transaction ## Parameters | Name | Type | Required | Description | |------|------|----------|-------------| | transaction_hash | string | Yes | The hash of the transaction to trace | ## Result **result** (object): The execution trace of the transaction ## Code Examples ### cURL ```bash curl --request POST \ --url https://starknet-mainnet.g.alchemy.com/v2/docs-demo \ --header 'Content-Type: application/json' \ --data '{ "jsonrpc": "2.0", "id": 1, "method": "starknet_traceTransaction", "params": [ "string" ] }' ``` ### JavaScript ```javascript const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify({jsonrpc: '2.0', id: 1, method: 'starknet_traceTransaction', params: ['string']}) }; fetch('https://starknet-mainnet.g.alchemy.com/v2/docs-demo', options) .then(res => res.json()) .then(res => console.log(res)) .catch(err => console.error(err)); ``` ### Python ```python import requests url = "https://starknet-mainnet.g.alchemy.com/v2/docs-demo" payload = { "jsonrpc": "2.0", "id": 1, "method": "starknet_traceTransaction", "params": ["string"] } headers = {"Content-Type": "application/json"} response = requests.post(url, json=payload, headers=headers) print(response.text) ``` ### Go ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://starknet-mainnet.g.alchemy.com/v2/docs-demo" payload := strings.NewReader("{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"starknet_traceTransaction\",\n \"params\": [\n \"string\"\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body)) } ``` ### Java ```java HttpResponse response = Unirest.post("https://starknet-mainnet.g.alchemy.com/v2/docs-demo") .header("Content-Type", "application/json") .body("{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"starknet_traceTransaction\",\n \"params\": [\n \"string\"\n ]\n}") .asString(); ``` ### C# ```csharp using RestSharp; var options = new RestClientOptions("https://starknet-mainnet.g.alchemy.com/v2/docs-demo"); var client = new RestClient(options); var request = new RestRequest(""); request.AddJsonBody("{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"starknet_traceTransaction\",\n \"params\": [\n \"string\"\n ]\n}", false); var response = await client.PostAsync(request); Console.WriteLine("{0}", response.Content); ``` ## OpenRPC Method Specification ```yaml name: starknet_traceTransaction description: Returns the trace of a specific transaction, including internal calls and execution details. paramStructure: by-name params: - name: transaction_hash description: The hash of the transaction to trace required: true schema: title: Transaction hash description: The transaction hash, as assigned in StarkNet type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ result: name: result description: The execution trace of the transaction schema: title: Transaction Trace type: object required: - type - execute_invocation - execution_resources properties: type: title: Transaction type type: string description: The type of transaction (e.g., "INVOKE") enum: - INVOKE - DECLARE - DEPLOY_ACCOUNT - L1_HANDLER execute_invocation: title: Invocation trace type: object required: - call_type - calldata - caller_address - calls - class_hash - contract_address - entry_point_selector - entry_point_type - events - execution_resources - is_reverted - messages - result properties: call_type: title: Call type type: string calldata: title: Calldata type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ caller_address: title: Caller address description: A contract address type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ calls: title: Internal calls type: array items: title: Nested call trace type: object required: - call_type - calldata - caller_address - calls - class_hash - contract_address - entry_point_selector - entry_point_type - events - execution_resources - is_reverted - messages - result properties: call_type: title: Call type type: string calldata: title: Calldata type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ caller_address: title: Caller address description: A contract address type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ calls: title: Nested calls description: Array of nested contract calls. Each call has the same structure as its parent, allowing for recursive calls. type: array items: type: object class_hash: title: Class hash description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ contract_address: title: Contract address description: A contract address type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ entry_point_selector: title: Entry point selector description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ entry_point_type: title: Entry point type type: string enum: - EXTERNAL - L1_HANDLER - CONSTRUCTOR events: title: Events type: array items: title: Event type: object required: - data - keys - order properties: data: title: Event data type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ keys: title: Event keys type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ order: title: Event order type: integer execution_resources: title: Execution resources type: object required: - l1_gas - l2_gas properties: l1_gas: title: L1 gas type: integer l2_gas: title: L2 gas type: integer is_reverted: title: Is reverted type: boolean messages: title: Messages type: array items: title: Message to L1 type: object required: - from_address - to_address - payload properties: from_address: title: Field element description: The address of the L2 contract sending the message type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ to_address: title: To address description: The target L1 address the message is sent to type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ payload: title: Payload description: The payload of the message type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ result: title: Result type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ class_hash: title: Class hash description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ contract_address: title: Contract address description: A contract address type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ entry_point_selector: title: Entry point selector description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ entry_point_type: title: Entry point type type: string enum: - EXTERNAL - L1_HANDLER - CONSTRUCTOR events: title: Events type: array items: title: Event type: object required: - data - keys - order properties: data: title: Event data type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ keys: title: Event keys type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ order: title: Event order type: integer execution_resources: title: Execution resources type: object required: - l1_gas - l2_gas properties: l1_gas: title: L1 gas type: integer l2_gas: title: L2 gas type: integer is_reverted: title: Is reverted type: boolean messages: title: Messages type: array items: title: Message to L1 type: object required: - from_address - to_address - payload properties: from_address: title: Field element description: The address of the L2 contract sending the message type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ to_address: title: To address description: The target L1 address the message is sent to type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ payload: title: Payload description: The payload of the message type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ result: title: Result type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ validate_invocation: title: Invocation trace type: object required: - call_type - calldata - caller_address - calls - class_hash - contract_address - entry_point_selector - entry_point_type - events - execution_resources - is_reverted - messages - result properties: call_type: title: Call type type: string calldata: title: Calldata type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ caller_address: title: Caller address description: A contract address type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ calls: title: Internal calls type: array items: title: Nested call trace type: object required: - call_type - calldata - caller_address - calls - class_hash - contract_address - entry_point_selector - entry_point_type - events - execution_resources - is_reverted - messages - result properties: call_type: title: Call type type: string calldata: title: Calldata type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ caller_address: title: Caller address description: A contract address type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ calls: title: Nested calls description: Array of nested contract calls. Each call has the same structure as its parent, allowing for recursive calls. type: array items: type: object class_hash: title: Class hash description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ contract_address: title: Contract address description: A contract address type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ entry_point_selector: title: Entry point selector description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ entry_point_type: title: Entry point type type: string enum: - EXTERNAL - L1_HANDLER - CONSTRUCTOR events: title: Events type: array items: title: Event type: object required: - data - keys - order properties: data: title: Event data type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ keys: title: Event keys type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ order: title: Event order type: integer execution_resources: title: Execution resources type: object required: - l1_gas - l2_gas properties: l1_gas: title: L1 gas type: integer l2_gas: title: L2 gas type: integer is_reverted: title: Is reverted type: boolean messages: title: Messages type: array items: title: Message to L1 type: object required: - from_address - to_address - payload properties: from_address: title: Field element description: The address of the L2 contract sending the message type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ to_address: title: To address description: The target L1 address the message is sent to type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ payload: title: Payload description: The payload of the message type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ result: title: Result type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ class_hash: title: Class hash description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ contract_address: title: Contract address description: A contract address type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ entry_point_selector: title: Entry point selector description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ entry_point_type: title: Entry point type type: string enum: - EXTERNAL - L1_HANDLER - CONSTRUCTOR events: title: Events type: array items: title: Event type: object required: - data - keys - order properties: data: title: Event data type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ keys: title: Event keys type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ order: title: Event order type: integer execution_resources: title: Execution resources type: object required: - l1_gas - l2_gas properties: l1_gas: title: L1 gas type: integer l2_gas: title: L2 gas type: integer is_reverted: title: Is reverted type: boolean messages: title: Messages type: array items: title: Message to L1 type: object required: - from_address - to_address - payload properties: from_address: title: Field element description: The address of the L2 contract sending the message type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ to_address: title: To address description: The target L1 address the message is sent to type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ payload: title: Payload description: The payload of the message type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ result: title: Result type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ fee_transfer_invocation: title: Invocation trace type: object required: - call_type - calldata - caller_address - calls - class_hash - contract_address - entry_point_selector - entry_point_type - events - execution_resources - is_reverted - messages - result properties: call_type: title: Call type type: string calldata: title: Calldata type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ caller_address: title: Caller address description: A contract address type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ calls: title: Internal calls type: array items: title: Nested call trace type: object required: - call_type - calldata - caller_address - calls - class_hash - contract_address - entry_point_selector - entry_point_type - events - execution_resources - is_reverted - messages - result properties: call_type: title: Call type type: string calldata: title: Calldata type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ caller_address: title: Caller address description: A contract address type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ calls: title: Nested calls description: Array of nested contract calls. Each call has the same structure as its parent, allowing for recursive calls. type: array items: type: object class_hash: title: Class hash description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ contract_address: title: Contract address description: A contract address type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ entry_point_selector: title: Entry point selector description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ entry_point_type: title: Entry point type type: string enum: - EXTERNAL - L1_HANDLER - CONSTRUCTOR events: title: Events type: array items: title: Event type: object required: - data - keys - order properties: data: title: Event data type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ keys: title: Event keys type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ order: title: Event order type: integer execution_resources: title: Execution resources type: object required: - l1_gas - l2_gas properties: l1_gas: title: L1 gas type: integer l2_gas: title: L2 gas type: integer is_reverted: title: Is reverted type: boolean messages: title: Messages type: array items: title: Message to L1 type: object required: - from_address - to_address - payload properties: from_address: title: Field element description: The address of the L2 contract sending the message type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ to_address: title: To address description: The target L1 address the message is sent to type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ payload: title: Payload description: The payload of the message type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ result: title: Result type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ class_hash: title: Class hash description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ contract_address: title: Contract address description: A contract address type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ entry_point_selector: title: Entry point selector description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ entry_point_type: title: Entry point type type: string enum: - EXTERNAL - L1_HANDLER - CONSTRUCTOR events: title: Events type: array items: title: Event type: object required: - data - keys - order properties: data: title: Event data type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ keys: title: Event keys type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ order: title: Event order type: integer execution_resources: title: Execution resources type: object required: - l1_gas - l2_gas properties: l1_gas: title: L1 gas type: integer l2_gas: title: L2 gas type: integer is_reverted: title: Is reverted type: boolean messages: title: Messages type: array items: title: Message to L1 type: object required: - from_address - to_address - payload properties: from_address: title: Field element description: The address of the L2 contract sending the message type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ to_address: title: To address description: The target L1 address the message is sent to type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ payload: title: Payload description: The payload of the message type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ result: title: Result type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ execution_resources: title: Overall execution resources type: object required: - l1_gas - l2_gas - l1_data_gas properties: l1_gas: title: L1 gas type: integer l2_gas: title: L2 gas type: integer l1_data_gas: title: L1 data gas type: integer ```