Push delivery for teams that do not want to poll. Events are signed, retried with exponential backoff for 24 hours, and delivered at least once.
| event | payload | fires when |
|---|---|---|
| object.minted | object, tx, height | a mint is included in a block |
| object.transferred | object, from, to | ownership leaf changes |
| object.sold | object, price, royalty | the market module settles a fill |
| object.listed | object, price, escrow | a listing enters escrow |
| object.burned | object, tx | the leaf is cleared |
| collection.deployed | collection, creator | a new contract is deployed |
| block.finalized | height, objectRoot | two blocks build on a height |
Verify the signature before trusting a payload: HMAC the raw body with your endpoint secret and compare against v1. Reject anything older than five minutes.
POST /your-endpoint
x-gifchain-signature: t=1739812,v1=6f2c...9ab1
{
"event": "object.sold",
"height": 4128733,
"data": {
"object": "gifcats#128",
"from": "0x7f3a...",
"to": "0x1c08...",
"price": "12.40",
"royalty": "0.62"
}
}