get_coin_record_by_name
Retrieve a Chia coin record by its coin ID to view creation and spent block heights, verify whether it is spent, and obtain the height needed for get_puzzle_and_solution.
Instructions
Get a specific coin record by its coin ID (also called 'name'). The coin ID is the sha256 hash of (parent_coin_id + puzzle_hash + amount). Returns the coin's details including confirmed_block_index (creation height) and spent_block_index (spend height; 0 if unspent — use spent_block_index > 0 to test spent status; the 'spent' boolean exists via a compat shim but prefer spent_block_index as the canonical field). Pass spent_block_index as the height argument to get_puzzle_and_solution.
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": {
"name": "<name>"
},
"name": "get_coin_record_by_name"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The coin ID / name (0x-prefixed, 32 bytes hex). This is sha256(parent_id || puzzle_hash || amount). |