Build a multi-clause transaction ready for the wallet to sign
buildContractTransactionBuild a multi-clause VeChain transaction, simulate each clause via Thor multicall, and return the clauses for external signing, without holding private keys or broadcasting.
Instructions
Build (but never sign or broadcast) a multi-clause VeChainThor transaction. Each clause is { name, method, args, valueWei?, comment?, address? }; for erc20 / erc721 an explicit address is mandatory. Returns the array of { to, value, data, comment? } clauses ready to be passed to VeWorld, the dApp Kit or vechain-kit for signing. By default every clause is simulated via Thor multicall first (using a generic signer): reverts are surfaced in simulation.results so the agent can fix the request before asking the user to sign. The server NEVER holds private keys and NEVER broadcasts.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"clauses": "<clauses>"
},
"name": "buildContractTransaction"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clauses | Yes | Array of clauses to bundle into a single multi-clause transaction. | |
| simulate | No | When true (default) every clause is simulated via Thor multicall to surface reverts before signing. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| data | No | ||
| error | No | ||
| network | Yes |