offsets__buy_offset
Retire verified carbon offset credits with cheapest-first matching and idempotent purchase. Returns a cost-detailed certificate and settles payment via escrow; use dry_run to preview fills without mutation.
Instructions
[offsets — verified-credit carbon offset clearinghouse] Retire mass_g of verified credits for a buyer: cheapest-first matching, exactly-once (idempotent on purchase_id), returns a content-addressed offset certificate with per-fill costs. Payment settles via escrow. dry_run=true previews the exact fills/cost without mutating the book.
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": {
"buyer": "<buyer>",
"purchase_id": "<purchase_id>",
"mass_g": "<mass_g>"
},
"name": "offsets__buy_offset"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| buyer | Yes | ||
| mass_g | Yes | ||
| dry_run | No | ||
| purchase_id | Yes |