Skip to main content
These tools are available when [chain] is enabled and the device is claimed, except the SOP tools, which load with the SOP engine. The model calls them. You can also ask for them in the paired Telegram chat. shell, file_write, file_edit, and vault_pay raise an approval card on a chat channel. The others in this list do not.

​
monad_identity

Reads the chain and reports this device. Unclaimed, the result is the device address and the claim text kinetic:<address>. Claimed, it is the agent id, owner, device address, both caps, and whether spending is paused. The runtime does not answer from a cached agent id.

​
vault_status

Reads limitsOf, balanceOf, and spentToday for this agent. The result is the balance, spend in the current window, both caps, and the pause flag, in MON.

​
vault_pay

Pays a recipient from the vault. Arguments: The vault still enforces pause, the allowlist, both caps, and the balance. This tool always asks for approval on a chat channel before it runs. A payment that the vault rejects comes back as a chain error, not as a spent balance.

​
monad_attest

Records a completed operation. Arguments: When [records] has fields, the host canonicalizes params into one line, signs those bytes, submits the attestation, and appends the line only after the transaction succeeds. The tool result includes the transaction hash and the request hash. With no schema, it signs params as given and stores nothing. Actuator tools gpio_write, gpio_rpi_write, gpio_rpi_blink, and set_device are attested automatically after they succeed, with request_uri kinetic://actuator/<tool>. Plugin tools are not.

​
sell_data

Lists attested operation records on the marketplace. Arguments: title, summary, description, machine_type, license, and price_mon. The rules and the file checks are in Data listing. The model is told to ask the owner for any field it is not sure of, and not to guess the price. The tool requires a claimed device on chain id 10143 and a marketplace.key. It returns the public listing URL.

​
Procedures

Hardware tools (gpio_read, gpio_write, and the Raspberry Pi variants) are documented in Hardware and firmware.