/sendTransactionToStarknetContractWithContractInfo

1 min

POST

Sends a transaction to a Starknet smart contract using structured contract information including function name and typed parameters. This function handles the execution of write operations on Starknet contracts, processing the transaction through the network's validation and execution phases. The transaction undergoes Starknet's multi-stage lifecycle including mempool validation, sequencer validation, execution, and eventual L1 proof verification. This function supports transaction validation to catch potential failures before submission, saving gas costs and providing better user experience.

Starknet uses the Cairo programming language for smart contracts and follows a unique account abstraction model where all transactions are INVOKE transactions processed by account contracts. Read more about Starknet transactions: https://docs.starknet.io/architecture-and-concepts/network-architecture/transaction-life-cycle/

return: Transaction submission result with approval status and transaction details.

    -------------------- Request --------------------
    sendTransactionToStarknetContractWithContractInfo(
           account_id=1,
           contract_address="0x0471...938D",
           resource_bounds_mapping=ResourceBoundsMapping(l1_gas=ResourceBounds(10000, 50000), l2_gas=ResourceBounds(1000, 3000), l1_data=ResourceBounds(8000, 10000)),
           function_name="transfer",
           parameters_fields_types_and_values=[["ContractAddress", "0x0175...A767"], ["u256", "1000"]],
           validate_transaction=True,
           description="testing description"
   )

 -------------------- Response --------------------
      {
         "FunctionData": {
             "ApprovalRequestStatus": 3,
             "CoinType": "STRK",
             "Transactions": [
                 {
                     "AmountToTransfer": "0",
                     "DestinationAddress": "0x0471...938D"
                 }
         ]
     },
     "Meta": {
             "AccessToken": "a640...5477",
             "Destination": "0421...e936",
            "Source": "99bf...c264",
            "Time": "2025-05-21 17:53:55.827"
        }
   }

account_idintegerThe account ID to use in this operation.

contact_addressstringThe Starknet contract address to send the transaction to.

resource_bounds_mappingobjectMapping of ResourceBounds objects to set up a smart contract transaction. with list of l1 gas.

function_namestringThe name of the contract function to call.

parameters_fields_types_and_valuesarray<p>List of parameter type-value pairs in the format [["type", "value"], ["type", "value"]]. Types must be valid Starknet/Cairo types.</p>

validate_transactionboolean<p>When true, performs transaction validation before submission to check if the transaction is likely to succeed.</p>

descriptionstringInternal description for transaction records. Not sent to blockchain.

specific_from_addressstringThe specific address to send from. Optional parameter.

acceptstringGenerated from available response content types

bodyobject

200success

curl --request POST \
     --url '/sendTransactionToStarknetContractWithContractInfo?account_id=None&contact_address=None%20yet.&resource_bounds_mapping=resource_bounds_mapping%3DResourceBoundsMapping(l1_gas%3DResourceBounds(10000%2C%2050000)%2Cl2_gas%3DResourceBounds(1000%2C%203000)%2Cl1_data%3DResourceBounds(8000%2C%2010000))&function_name=None%20yet.&parameters_fields_types_and_values=array&validate_transaction=true&description=None%20yet.&specific_from_address=None' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "FunctionData": {
     "AccountId": 1
     },
     "Meta": {
     "FunctionName": "getEthValidatorsSummary",
     "RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
     "Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
     "Time": "2021-02-07T18:37:46.948Z",
     "Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
     "AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
     }
     }'