sc_mining_v1.state

out.size must cover 40 bytes. Copy owner requested/active, refusal block and process cells/promoted/faults; successful observation can report refusal. Output size becomes 40; unknown tail untouched. OFF=0 is disabled or active without block; promoted counts forwarded bits, not spawned/harvested entities.

Signature

sco_result (*)(sco_plugin *, sc_mining_state *)

Service and availability

Service index

Property	Value
Symbol	`sc_mining_v1.state`
Record ID	`sc-mining-v1-state`
Service	game.mining
Table	sc_mining_v1
Version macro	SC_MINING_SERVICE_VERSION
Packed table version	65536
Since / availability	`size >= 24`; 1.0
Complete member extent (x64 bytes)	24
Table size (x64 bytes)	24

Header source

Parameters and buffers

sco_result (*state)(sco_plugin* self, sc_mining_state* out);
out.size must cover 40 bytes. Copy owner requested/active, refusal block and process cells/promoted/faults; successful observation can report refusal. Output size becomes 40; unknown tail untouched. OFF=0 is disabled or active without block; promoted counts forwarded bits, not spawned/harvested entities.

Results and failures

OK copied observation; BAD_ARG invalid/released self or null/short output; WRONG_THREAD; UNAVAILABLE stopped/runtime-stopping or reentrant call.

Absent capability

game.mining remains false by default. Accepted request intent does not imply an available or active engine adapter.

Ownership

Up to 64 live owners retain independent intent; worker sees only aggregate count. Caller owns copied output; no native pointer or allocation transfer.

Thread affinity

Game thread only; WRONG_THREAD before owner/state access. Worker promotion never calls plugins.

Callback context

No plugin callback; worker invokes host-owned process-retained backend only.

Reentrancy

Public calls during backend admission/install are refused with UNAVAILABLE.

Cleanup and cancellation

Disable/unload removes only that owner intent. Stop clears all intent and withdraws the service; detour, trampoline and callbacks remain process-retained in pass-through mode. Fault latch requires restart.

Language mappings

Status labels are copied verbatim from the catalogue: direct is native access; typed-wrapper is wrapper-backed; restricted is a subset/adaptation; unsupported means no supported route is established. No status implies universal safety.

Language	Catalogue status	Source evidence / wrapper tokens
c	direct	include/sc_mining.h `(*state)`
cpp	direct	include/sc_mining.h `(*state)`
csharp	unsupported	docs/contracts.md `C# and Lua game.mining routes are unsupported.`
lua	unsupported	docs/contracts.md `C# and Lua game.mining routes are unsupported.`

Examples

None identified in the catalogue; this is not proof none can exist.

Tests

ABI pins prove layout, not semantic behavior or a live game session.