starknet_addInvokeTransaction RPC Method

Parameters

invoke_transaction object REQUIRED: The information needed to invoke the function (or account, for version 1 transactions). Starknet JSON-RPC 0.9 only accepts v3 transactions, which contain the following fields:

type string REQUIRED: The type of declare. It can take only one value - 'INVOKE'

sender_address string REQUIRED: The sender address

calldata array REQUIRED: The parameters passed to the constructor

version string REQUIRED: The version of the transaction scheme

signature string REQUIRED: The signature associated with the transaction

nonce string REQUIRED: The nonce value

resource_bounds object REQUIRED: The resource bounds for the transaction execution

l1_gas object REQUIRED: The max amount and max price per unit of L1 gas used in this tx

max_amount string REQUIRED: The max amount of the resource that can be used in the tx

max_price_per_unit string REQUIRED: The max price per unit of this resource for this tx

l1_data_gas object REQUIRED: The max amount and max price per unit of L1 data gas used in this tx

max_amount string REQUIRED: The max amount of the resource that can be used in the tx

max_price_per_unit string REQUIRED: The max price per unit of this resource for this tx

l2_gas object REQUIRED: The max amount and max price per unit of L2 gas used in this tx

max_amount string REQUIRED: The max amount of the resource that can be used in the tx

max_price_per_unit string REQUIRED: The max price per unit of this resource for this tx

tip string REQUIRED: The tip for the transaction

paymaster_data array REQUIRED: The data needed to allow the paymaster to pay for the transaction in native tokens

account_deployment_data array REQUIRED: The data needed to deploy the account contract from which this tx will be initiated

nonce_data_availability_mode string REQUIRED: The storage domain of the account's nonce (an account has a nonce per DA mode). It can be one of 'L1' or 'L2'

fee_data_availability_mode string REQUIRED: The storage domain of the account's balance from which fee will be charged. It can be one of 'L1' or 'L2'

Returns

result object

The result of the transaction submission

transaction_hash string: The hash of the invoke transaction

Request

1
# Note: You can specify Starknet version in the URL path
2
# Example: /rpc/v0_9 for version 0.9. Versions 0.6, 0.7, and 0.8 are no longer supported
3
curl --location 'https://docs-demo.strk-mainnet.quiknode.pro/rpc/v0_9' \
4
--header 'accept: application/json' \
5
--header 'content-type: application/json' \
6
--data '{
7
    "id": 1,
8
    "jsonrpc": "2.0",
9
    "method": "starknet_addInvokeTransaction",
10
    "params": [
11
        {
12
            "type": "INVOKE",
13
            "version": "0x3",
14
            "sender_address": "0x4678eb497e96599c92b45f342c2bd284321fe219c60a9b6293d80f0fbfa61b5",
15
            "calldata": [
16
                "0x1",
17
                "0x4718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d",
18
                "0x83afd3f4caedc6eebf44246fe54e38c95e3179a5ec9ea81740eca5b482d12e",
19
                "0x3",
20
                "0x123",
21
                "0x1",
22
                "0x0"
23
            ],
24
            "signature": [
25
                "0x7cfaae050d6db02b32ddbdb85989e10012504e74b680c9807386f9a1c8807c6",
26
                "0x6e76b70ec1a32a3871516fc500c7478c02287783d075a0fdad6a659b4d2a8c4"
27
            ],
28
            "nonce": "0x1",
29
            "resource_bounds": {
30
                "l1_gas": {
31
                    "max_amount": "0x0",
32
                    "max_price_per_unit": "0x38d7ea4c68000"
33
                },
34
                "l1_data_gas": {
35
                    "max_amount": "0x1388",
36
                    "max_price_per_unit": "0x9184e72a000"
37
                },
38
                "l2_gas": {
39
                    "max_amount": "0x7270e00",
40
                    "max_price_per_unit": "0x174876e800"
41
                }
42
            },
43
            "tip": "0x0",
44
            "paymaster_data": [],
45
            "account_deployment_data": [],
46
            "nonce_data_availability_mode": "L1",
47
            "fee_data_availability_mode": "L1"
48
        }
49
    ]
50
}'

1
# Note: You can specify Starknet version in the URL path
2
# Example: /rpc/v0_9 for version 0.9. Versions 0.6, 0.7, and 0.8 are no longer supported
3
curl --location 'https://docs-demo.strk-mainnet.quiknode.pro/rpc/v0_9' \
4
--header 'accept: application/json' \
5
--header 'content-type: application/json' \
6
--data '{
7
    "id": 1,
8
    "jsonrpc": "2.0",
9
    "method": "starknet_addInvokeTransaction",
10
    "params": [
11
        {
12
            "type": "INVOKE",
13
            "version": "0x3",
14
            "sender_address": "0x4678eb497e96599c92b45f342c2bd284321fe219c60a9b6293d80f0fbfa61b5",
15
            "calldata": [
16
                "0x1",
17
                "0x4718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d",
18
                "0x83afd3f4caedc6eebf44246fe54e38c95e3179a5ec9ea81740eca5b482d12e",
19
                "0x3",
20
                "0x123",
21
                "0x1",
22
                "0x0"
23
            ],
24
            "signature": [
25
                "0x7cfaae050d6db02b32ddbdb85989e10012504e74b680c9807386f9a1c8807c6",
26
                "0x6e76b70ec1a32a3871516fc500c7478c02287783d075a0fdad6a659b4d2a8c4"
27
            ],
28
            "nonce": "0x1",
29
            "resource_bounds": {
30
                "l1_gas": {
31
                    "max_amount": "0x0",
32
                    "max_price_per_unit": "0x38d7ea4c68000"
33
                },
34
                "l1_data_gas": {
35
                    "max_amount": "0x1388",
36
                    "max_price_per_unit": "0x9184e72a000"
37
                },
38
                "l2_gas": {
39
                    "max_amount": "0x7270e00",
40
                    "max_price_per_unit": "0x174876e800"
41
                }
42
            },
43
            "tip": "0x0",
44
            "paymaster_data": [],
45
            "account_deployment_data": [],
46
            "nonce_data_availability_mode": "L1",
47
            "fee_data_availability_mode": "L1"
48
        }
49
    ]
50
}'

1
// Note: You can specify Starknet version in the URL path
2
// Example: /rpc/v0_9 for version 0.9. Versions 0.6, 0.7, and 0.8 are no longer supported
3
const myHeaders = new Headers();
4
myHeaders.append("accept", "application/json");
5
myHeaders.append("content-type", "application/json");
6

7
const raw = JSON.stringify({
8
  "id": 1,
9
  "jsonrpc": "2.0",
10
  "method": "starknet_addInvokeTransaction",
11
  "params": [
12
    {
13
      "type": "INVOKE",
14
      "version": "0x3",
15
      "sender_address": "0x4678eb497e96599c92b45f342c2bd284321fe219c60a9b6293d80f0fbfa61b5",
16
      "calldata": [
17
        "0x1",
18
        "0x4718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d",
19
        "0x83afd3f4caedc6eebf44246fe54e38c95e3179a5ec9ea81740eca5b482d12e",
20
        "0x3",
21
        "0x123",
22
        "0x1",
23
        "0x0"
24
      ],
25
      "signature": [
26
        "0x7cfaae050d6db02b32ddbdb85989e10012504e74b680c9807386f9a1c8807c6",
27
        "0x6e76b70ec1a32a3871516fc500c7478c02287783d075a0fdad6a659b4d2a8c4"
28
      ],
29
      "nonce": "0x1",
30
      "resource_bounds": {
31
        "l1_gas": {
32
          "max_amount": "0x0",
33
          "max_price_per_unit": "0x38d7ea4c68000"
34
        },
35
        "l1_data_gas": {
36
          "max_amount": "0x1388",
37
          "max_price_per_unit": "0x9184e72a000"
38
        },
39
        "l2_gas": {
40
          "max_amount": "0x7270e00",
41
          "max_price_per_unit": "0x174876e800"
42
        }
43
      },
44
      "tip": "0x0",
45
      "paymaster_data": [],
46
      "account_deployment_data": [],
47
      "nonce_data_availability_mode": "L1",
48
      "fee_data_availability_mode": "L1"
49
    }
50
  ]
51
});
52

53
const requestOptions = {
54
  method: "POST",
55
  headers: myHeaders,
56
  body: raw,
57
  redirect: "follow"
58
};
59

60
fetch("https://docs-demo.strk-mainnet.quiknode.pro/rpc/v0_9", requestOptions)
61
  .then((response) => response.text())
62
  .then((result) => console.log(result))
63
  .catch((error) => console.error(error));

1
// Note: You can specify Starknet version in the URL path
2
// Example: /rpc/v0_9 for version 0.9. Versions 0.6, 0.7, and 0.8 are no longer supported
3
const myHeaders = new Headers();
4
myHeaders.append("accept", "application/json");
5
myHeaders.append("content-type", "application/json");
6

7
const raw = JSON.stringify({
8
  "id": 1,
9
  "jsonrpc": "2.0",
10
  "method": "starknet_addInvokeTransaction",
11
  "params": [
12
    {
13
      "type": "INVOKE",
14
      "version": "0x3",
15
      "sender_address": "0x4678eb497e96599c92b45f342c2bd284321fe219c60a9b6293d80f0fbfa61b5",
16
      "calldata": [
17
        "0x1",
18
        "0x4718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d",
19
        "0x83afd3f4caedc6eebf44246fe54e38c95e3179a5ec9ea81740eca5b482d12e",
20
        "0x3",
21
        "0x123",
22
        "0x1",
23
        "0x0"
24
      ],
25
      "signature": [
26
        "0x7cfaae050d6db02b32ddbdb85989e10012504e74b680c9807386f9a1c8807c6",
27
        "0x6e76b70ec1a32a3871516fc500c7478c02287783d075a0fdad6a659b4d2a8c4"
28
      ],
29
      "nonce": "0x1",
30
      "resource_bounds": {
31
        "l1_gas": {
32
          "max_amount": "0x0",
33
          "max_price_per_unit": "0x38d7ea4c68000"
34
        },
35
        "l1_data_gas": {
36
          "max_amount": "0x1388",
37
          "max_price_per_unit": "0x9184e72a000"
38
        },
39
        "l2_gas": {
40
          "max_amount": "0x7270e00",
41
          "max_price_per_unit": "0x174876e800"
42
        }
43
      },
44
      "tip": "0x0",
45
      "paymaster_data": [],
46
      "account_deployment_data": [],
47
      "nonce_data_availability_mode": "L1",
48
      "fee_data_availability_mode": "L1"
49
    }
50
  ]
51
});
52

53
const requestOptions = {
54
  method: "POST",
55
  headers: myHeaders,
56
  body: raw,
57
  redirect: "follow"
58
};
59

60
fetch("https://docs-demo.strk-mainnet.quiknode.pro/rpc/v0_9", requestOptions)
61
  .then((response) => response.text())
62
  .then((result) => console.log(result))
63
  .catch((error) => console.error(error));

1
# Note: You can specify Starknet version in the URL path
2
# Example: /rpc/v0_9 for version 0.9. Versions 0.6, 0.7, and 0.8 are no longer supported
3
import requests
4
import json
5

6
url = "https://docs-demo.strk-mainnet.quiknode.pro/rpc/v0_9"
7

8
payload = json.dumps({
9
  "id": 1,
10
  "jsonrpc": "2.0",
11
  "method": "starknet_addInvokeTransaction",
12
  "params": [
13
    {
14
      "type": "INVOKE",
15
      "version": "0x3",
16
      "sender_address": "0x4678eb497e96599c92b45f342c2bd284321fe219c60a9b6293d80f0fbfa61b5",
17
      "calldata": [
18
        "0x1",
19
        "0x4718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d",
20
        "0x83afd3f4caedc6eebf44246fe54e38c95e3179a5ec9ea81740eca5b482d12e",
21
        "0x3",
22
        "0x123",
23
        "0x1",
24
        "0x0"
25
      ],
26
      "signature": [
27
        "0x7cfaae050d6db02b32ddbdb85989e10012504e74b680c9807386f9a1c8807c6",
28
        "0x6e76b70ec1a32a3871516fc500c7478c02287783d075a0fdad6a659b4d2a8c4"
29
      ],
30
      "nonce": "0x1",
31
      "resource_bounds": {
32
        "l1_gas": {
33
          "max_amount": "0x0",
34
          "max_price_per_unit": "0x38d7ea4c68000"
35
        },
36
        "l1_data_gas": {
37
          "max_amount": "0x1388",
38
          "max_price_per_unit": "0x9184e72a000"
39
        },
40
        "l2_gas": {
41
          "max_amount": "0x7270e00",
42
          "max_price_per_unit": "0x174876e800"
43
        }
44
      },
45
      "tip": "0x0",
46
      "paymaster_data": [],
47
      "account_deployment_data": [],
48
      "nonce_data_availability_mode": "L1",
49
      "fee_data_availability_mode": "L1"
50
    }
51
  ]
52
})
53
headers = {
54
  'accept': 'application/json',
55
  'content-type': 'application/json'
56
}
57

58
response = requests.request("POST", url, headers=headers, data=payload)
59

60
print(response.text)
61

1
# Note: You can specify Starknet version in the URL path
2
# Example: /rpc/v0_9 for version 0.9. Versions 0.6, 0.7, and 0.8 are no longer supported
3
import requests
4
import json
5

6
url = "https://docs-demo.strk-mainnet.quiknode.pro/rpc/v0_9"
7

8
payload = json.dumps({
9
  "id": 1,
10
  "jsonrpc": "2.0",
11
  "method": "starknet_addInvokeTransaction",
12
  "params": [
13
    {
14
      "type": "INVOKE",
15
      "version": "0x3",
16
      "sender_address": "0x4678eb497e96599c92b45f342c2bd284321fe219c60a9b6293d80f0fbfa61b5",
17
      "calldata": [
18
        "0x1",
19
        "0x4718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d",
20
        "0x83afd3f4caedc6eebf44246fe54e38c95e3179a5ec9ea81740eca5b482d12e",
21
        "0x3",
22
        "0x123",
23
        "0x1",
24
        "0x0"
25
      ],
26
      "signature": [
27
        "0x7cfaae050d6db02b32ddbdb85989e10012504e74b680c9807386f9a1c8807c6",
28
        "0x6e76b70ec1a32a3871516fc500c7478c02287783d075a0fdad6a659b4d2a8c4"
29
      ],
30
      "nonce": "0x1",
31
      "resource_bounds": {
32
        "l1_gas": {
33
          "max_amount": "0x0",
34
          "max_price_per_unit": "0x38d7ea4c68000"
35
        },
36
        "l1_data_gas": {
37
          "max_amount": "0x1388",
38
          "max_price_per_unit": "0x9184e72a000"
39
        },
40
        "l2_gas": {
41
          "max_amount": "0x7270e00",
42
          "max_price_per_unit": "0x174876e800"
43
        }
44
      },
45
      "tip": "0x0",
46
      "paymaster_data": [],
47
      "account_deployment_data": [],
48
      "nonce_data_availability_mode": "L1",
49
      "fee_data_availability_mode": "L1"
50
    }
51
  ]
52
})
53
headers = {
54
  'accept': 'application/json',
55
  'content-type': 'application/json'
56
}
57

58
response = requests.request("POST", url, headers=headers, data=payload)
59

60
print(response.text)
61

1
# Note: You can specify Starknet version in the URL path
2
# Example: /rpc/v0_9 for version 0.9. Versions 0.6, 0.7, and 0.8 are no longer supported
3
require "uri"
4
require "json"
5
require "net/http"
6

7
url = URI("https://docs-demo.strk-mainnet.quiknode.pro/rpc/v0_9")
8

9
http = Net::HTTP.new(url.host, url.port);
10
request = Net::HTTP::Post.new(url)
11
request["accept"] = "application/json"
12
request["content-type"] = "application/json"
13
request.body = JSON.dump({
14
  "id": 1,
15
  "jsonrpc": "2.0",
16
  "method": "starknet_addInvokeTransaction",
17
  "params": [
18
    {
19
      "type": "INVOKE",
20
      "version": "0x3",
21
      "sender_address": "0x4678eb497e96599c92b45f342c2bd284321fe219c60a9b6293d80f0fbfa61b5",
22
      "calldata": [
23
        "0x1",
24
        "0x4718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d",
25
        "0x83afd3f4caedc6eebf44246fe54e38c95e3179a5ec9ea81740eca5b482d12e",
26
        "0x3",
27
        "0x123",
28
        "0x1",
29
        "0x0"
30
      ],
31
      "signature": [
32
        "0x7cfaae050d6db02b32ddbdb85989e10012504e74b680c9807386f9a1c8807c6",
33
        "0x6e76b70ec1a32a3871516fc500c7478c02287783d075a0fdad6a659b4d2a8c4"
34
      ],
35
      "nonce": "0x1",
36
      "resource_bounds": {
37
        "l1_gas": {
38
          "max_amount": "0x0",
39
          "max_price_per_unit": "0x38d7ea4c68000"
40
        },
41
        "l1_data_gas": {
42
          "max_amount": "0x1388",
43
          "max_price_per_unit": "0x9184e72a000"
44
        },
45
        "l2_gas": {
46
          "max_amount": "0x7270e00",
47
          "max_price_per_unit": "0x174876e800"
48
        }
49
      },
50
      "tip": "0x0",
51
      "paymaster_data": [],
52
      "account_deployment_data": [],
53
      "nonce_data_availability_mode": "L1",
54
      "fee_data_availability_mode": "L1"
55
    }
56
  ]
57
})
58

59
response = http.request(request)
60
puts response.read_body
61

1
# Note: You can specify Starknet version in the URL path
2
# Example: /rpc/v0_9 for version 0.9. Versions 0.6, 0.7, and 0.8 are no longer supported
3
require "uri"
4
require "json"
5
require "net/http"
6

7
url = URI("https://docs-demo.strk-mainnet.quiknode.pro/rpc/v0_9")
8

9
http = Net::HTTP.new(url.host, url.port);
10
request = Net::HTTP::Post.new(url)
11
request["accept"] = "application/json"
12
request["content-type"] = "application/json"
13
request.body = JSON.dump({
14
  "id": 1,
15
  "jsonrpc": "2.0",
16
  "method": "starknet_addInvokeTransaction",
17
  "params": [
18
    {
19
      "type": "INVOKE",
20
      "version": "0x3",
21
      "sender_address": "0x4678eb497e96599c92b45f342c2bd284321fe219c60a9b6293d80f0fbfa61b5",
22
      "calldata": [
23
        "0x1",
24
        "0x4718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d",
25
        "0x83afd3f4caedc6eebf44246fe54e38c95e3179a5ec9ea81740eca5b482d12e",
26
        "0x3",
27
        "0x123",
28
        "0x1",
29
        "0x0"
30
      ],
31
      "signature": [
32
        "0x7cfaae050d6db02b32ddbdb85989e10012504e74b680c9807386f9a1c8807c6",
33
        "0x6e76b70ec1a32a3871516fc500c7478c02287783d075a0fdad6a659b4d2a8c4"
34
      ],
35
      "nonce": "0x1",
36
      "resource_bounds": {
37
        "l1_gas": {
38
          "max_amount": "0x0",
39
          "max_price_per_unit": "0x38d7ea4c68000"
40
        },
41
        "l1_data_gas": {
42
          "max_amount": "0x1388",
43
          "max_price_per_unit": "0x9184e72a000"
44
        },
45
        "l2_gas": {
46
          "max_amount": "0x7270e00",
47
          "max_price_per_unit": "0x174876e800"
48
        }
49
      },
50
      "tip": "0x0",
51
      "paymaster_data": [],
52
      "account_deployment_data": [],
53
      "nonce_data_availability_mode": "L1",
54
      "fee_data_availability_mode": "L1"
55
    }
56
  ]
57
})
58

59
response = http.request(request)
60
puts response.read_body
61

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free