Register a canary (operator session required)
canary_registerNeeds a Desk session (Authorization: Bearer); without one this returns 401. Register the public part of a decoy you planted: kind address|key|url|apikey|tool|x402 with exactly one target (address, url_sha256, key_sha256, tool_name or resource_path), a label, the triggers to watch (nonce, code, permit, siwe, inbound_transfer, http_hit, api_use, tool_call, x402_request) and planted_at. Needs Authorization: Bearer ; the session's wallet is the operator. Private material is refused before validation; a bait key must be fresh (nonce 0, no code). A canary is a decoy you plant where only an intruder or a misled agent would read it: a bait key that never holds a balance (its first use is the signal), an address planted as a treasury, a URL, an API key, a tool description or a paid x402 resource. Register the PUBLIC part only (address, hash, tool name, path); we refuse anything that looks like a key, a URL or an API key in clear. We read the chain every 2 minutes (nonce, code, gas funding, inbound transfers, permits) and your own channels when you push them (canary ingest). A fire is a pattern for a human to read, written to your canary log; nothing is published about a plant. Live since 1 Nov 2026 (shadow 16 Oct - 1 Nov): at most 25 live canaries per operator; fires reach you through canary_status, not by e-mail yet.
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": {
"registration": "<registration>"
},
"name": "canary_register"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| registration | Yes | {canary_id (32-64 hex), kind, label, watch[], planted_at, and one of address | url_sha256 (+url_host) | key_sha256 | tool_name (+description_sha256) | resource_path (+price)} |