/sendStarknetTokenAsSmartContract

Sends ERC20-compatible tokens on Starknet by interacting with token smart contracts. This function provides a convenient interface for transferring tokens that follow the ERC20 standard on Starknet, automatically handling the smart contract interaction by calling the token contract's transfer function.

Internally, this function calls sendTransactionToStarknetContractWithContractInfo with the transfer function and properly formatted parameters, simplifying token transfers for developers. The transaction undergoes Starknet's standard validation and execution phases, with the added benefit of smart contract interaction validation when enabled.

Starknet token contracts are implemented in Cairo and follow similar patterns to Ethereum ERC20 tokens but with Starknet-specific optimizations and features. The function handles the conversion of parameters to the appropriate Cairo types automatically.

Read more about Starknet ERC20 tokens at https://docs.starknet.io/documentation/developing/smart-contracts/erc20/

NOTE: This function is a convenience wrapper around sendTransactionToStarknetContractWithContractInfo. It automatically formats the parameters for the standard ERC20 transfer function call

• Function name - "transfer"
• Parameters - [["ContractAddress", destination], ["u256", amount]]

Success or failure in this API call does not necessarily mean success or failure in the transaction itself. For example, the transaction may succeed, but the "success" response to the client can be lost if the client's internet connection is down. To verify the status of the transaction

1. Call getCurrentToken and store the returned token.
2. Send your transaction. The transaction will use the token from step 1.
3. Call getTransactionByToken using the stored token to track the status of the transaction.

This function is part of the transaction flow detailed at https://docs.gk8.io/api-v19/sending-transactions-from-the-api.

Return: Transaction submission result with approval status and contract interaction details.

Input Example: sendStarknetTokenAsSmartContract( 1, "0x0471...938d", "0x0225...a7b9", "5000000000000000000", 10000000000, 15000, True, "Token transfer to partner wallet" )

Response Example:

    {
        "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"
        }
    }