Skip to main content

Transaction Builder

By default, all transactions initiated using the SDK perform every step of the process for a transaction; From preparing and building the transaction all the way to waiting until it has been mined, and the data is available to be read from the blockchain.

To gain more granular control over the transaction process, all Contract objects come with a Prepare function that returns a Transaction object, which can be used to build, fine-tune, and execute the transaction.

Usage​

string connectedAddress = await ThirdwebManager.Instance.SDK.wallet.GetAddress();
Transaction transaction = await contract.Prepare(
    functionName: "claim",
    from: connectedAddress, // optional, defaults to connected address
    args: new object[] { connectedAddress, 0, 1 }
);
// transaction.SetValue("0.00000000001");
// transaction.SetGasLimit("100000");

try
{
    var data = await transaction.Simulate();
    Debugger.Instance.Log("[Custom Call] Simulate Successful", "Data: " + data.ToString()");
}
catch (System.Exception e)
{
    Debugger.Instance.Log("[Custom Call] Simulate Error", e.Message);
    return;
}

await transaction.EstimateAndSetGasLimitAsync();

var gasPrice = await transaction.GetGasPrice();
Debug.Log($"Gas Price: {gasPrice}");

var gasCosts = await transaction.EstimateGasCosts();
Debug.Log($"Gas Cost: {gasCosts.wei} WEI");

Debugger.Instance.Log("[Custom Call] Transaction Preview", transaction.ToString());

try
{
    string transactionResult = await transaction.Send(gasless: false);
    Debugger.Instance.Log("[Custom Call] Send Successful", "Tx Hash: " + transactionResult);
}
catch (System.Exception e)
{
    Debugger.Instance.Log("[Custom Call] Send Error", e.ToString());
}
}

EstimateGasCost​

Estimate the gas cost for a transaction.

var gasCost = await tx.EstimateGasCosts();
Configuration

Return Value​

Returns the gas cost for this transaction in both ether and wei.

GasCosts;

EstimateGasLimit​

Estimate the gas limit for a transaction.

var gasLimit = await tx.EstimateGasLimit();
Configuration

Return Value​

Returns the gas limit for this transaction.

BigInteger;

Send​

Send the transaction without waiting for it to be mined. This is useful for when you want the transaction to be executed, but don’t need the data returned.

string txHash = await tx.Send();
Configuration

Return Value​

Returns the transaction hash as a string.

string;

Execute​

Send the transaction and wait for it to be mined. This is useful for when you want the transaction to be executed, and need the data returned.

TransactionResult result = await tx.SendAndWaitForTransactionResult();
Configuration

Return Value​

Returns the transaction result as a object.

TransactionResult;

Static Methods​

Useful static methods for working with transactions.

string txHash = "your_tx_hash";
TransactionResult result = await Transaction.WaitForTransactionResult(txHash);
Configuration

Return Value​

Returns the transaction result as a object.

TransactionResult;