prepare_vehicle_heist_launch
may change things: you confirm before it runsVehicle heist: prepare (unsigned) a heist on a vehicle held by `victim`, with a squad of 2 to 5 (you first; role 1 Driver required, 2 Hacker optional, 3 Muscle, 4 Face, 5 Inside Agent; the target is the vehicle token itself). An aircraft (helicopter or jet) brought as usedToken must be held by, or approved to, the Driver, or the launch reverts (PilotNotHolder); the air Driver bonus (+250) needs that real pilot, otherwise the Driver gets the ground +150. Role bonuses and the one-use items (itemMask) work only if the admin switches are on (city_state.switches says; the pipeline turns them on for the next testnet round, mainnet stays closed), and itemMask is refused by the contract while items are off. You pay the kit (and the scout fee if scouted); the result is a drand round about 30 s later (then prepare_vehicle_heist_resolve).
Input schema
{
"type": "object",
"properties": {
"wallet": {
"type": "string",
"description": "Your own 0x wallet address. Nothing is sent from it; it is used to read your balance and allowance and to simulate."
},
"tokenId": {
"type": "number",
"description": "The vehicle token to steal."
},
"victim": {
"type": "string",
"description": "The wallet that holds it right now."
},
"members": {
"type": "array",
"description": "Crew wallets, YOU first (each other member must have called prepare_approve_leader for you). Omit to go alone where the game allows. The size limit is per game: night_run 1-4, convoy 1-5, ledger 2-5, vehicle_heist 2-5, raid 2-4.",
"items": {
"type": "string"
}
},
"roles": {
"type": "array",
"description": "One role number per member, same order. Role ids differ per game (see this tool's description).",
"items": {
"type": "number"
}
},
"usedToken": {
"type": "number",
"description": "A vehicle of ANOTHER model one of the squad holds (bonus), or 0."
},
"scouted": {
"type": "boolean",
"description": "Pay the scout fee for better odds."
},
"itemMask": {
"type": "number",
"description": "One-use items to burn: 1 plates, 2 fare, 4 forgery (add them). Default 0. The heist items are refused (any non-zero mask) until the contract has them switched on: check city_state.switches."
},
"minOddsBps": {
"type": "number",
"description": "Revert instead of launching if the odds would be lower than this (0 = no check)."
}
},
"required": [
"wallet",
"tokenId",
"victim",
"members",
"roles"
]
}