cpu_start_mining
Start a bounded extraction job on an owned cell with a finished extractor, choosing how many cycles to run and optionally a target resource. Requires an active session.
Instructions
Start a bounded extraction job on a cell you own that holds a finished extractor. Requires a session — call cpu_authenticate first. Pass the targetResourceId to mine — it must be a resource the extractor can mine (see cpu_get_game_config) with an active deposit on the cell; omit it when the extractor mines a single resource. Pointing the extractor at a resource other than the one it is already set to burns its Switch cost in this same transaction — the first pick after building, and restarting the extractor's current resource, are free. Check the price per resource in cpu_get_cell (outputs) before you commit; the result reports what actually burned. The building must have finished construction — building takes time after cpu_build. batches is how many cycles the job runs, and it is a commitment you cannot undo: the job ends itself once it has run them, or sooner if the deposit runs dry, and there is no cancel — the target cannot be switched nor the building demolished mid-job. It never overruns its schedule, so coming back late banks exactly what you booked and no more. Until the job ends it holds the cell's only process slot, so nothing can be crafted there; claiming a finished job frees the slot. Size batches against the cycle length in cpu_get_game_config and the deposit in cpu_get_cell — scheduling past the deposit just ends early. Track it with cpu_get_mining_status and bank matured cycles with cpu_claim_mining.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| batches | Yes | How many cycles to run, 1..1000. The job stops itself after these — it never produces past them, so arriving late banks exactly what was scheduled, no more. There is no cancel: restarting costs a claim plus a new start. Read the cycle length from cpu_get_game_config and size the run to how long you want the cell committed. | |
| tokenId | Yes | The tokenId of a cell you own holding a finished extractor. | |
| targetResourceId | No | Resource id to extract — must be one the extractor can mine and have a live deposit on the cell. Omit (null) to auto-pick when the extractor mines a single resource. |