record_execution_completion
Record a supported terminal venue result observed by the submitting client.
| Field | Meaning |
|---|---|
| Side effects | Annotates an existing signed receipt for dashboard display. It does not prove, sign, submit, change replay eligibility, or independently reconcile venue state. |
| Next step | Read the completed receipt in the dashboard. Do not use this call as independent proof of settlement. |
Arguments
| Argument | Type | Required |
|---|---|---|
completion | object | yes |
pakt_root | string | yes |
receipt_id | string | yes |
Exact bounds, accepted values, and nested fields are in Full JSON Schema below.
Example
signed is the exact signed result, and observedCompletion is a supported terminal result verified by the submitting client—not an estimate or a pending order. See the schema for venue-specific completion variants.
With an authenticated MCP client:
await client.callTool({
name: "record_execution_completion",
arguments: {
pakt_root: selectedPakt.pakt_root,
receipt_id: signed.receipt_id,
completion: observedCompletion
},
});Returns
Important fields in the decoded result; this is not a complete response schema.
| Field | Meaning |
|---|---|
status | COMPLETED means the annotation was stored, not independently proved. |
receipt_id / venue / venue_reference | The receipt and client-reported terminal venue reference. |
effects.completion_recorded | true; no new signature or submission is produced. |
For error handling and retry rules, see Statuses and Errors.
Record one terminal venue result observed by the submitting client for an exact signed receipt. Hyperliquid supports a fill, definite no-fill, confirmed cancellation, or deadline-passed result whose earlier venue outcome remains unreconciled. Ethereum supports exact-transaction confirmed success or revert, or a finalized account nonce beyond the durable transaction's nonce. Pakt checks the stored Hyperliquid deadline, exact Ethereum transaction hash, or exact Ethereum nonce as applicable. This display-only annotation cannot authorize, sign, submit, or change replay eligibility. Account identity is server-derived.
From tools/list, MCP protocol revision 2026-07-28.
{
"additionalProperties": false,
"properties": {
"completion": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "hyperliquid_filled"
},
"oid": {
"maximum": 18446744073709551615,
"minimum": 1,
"type": "integer"
}
},
"required": [
"kind",
"oid"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "hyperliquid_no_fill"
}
},
"required": [
"kind"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "hyperliquid_cancelled"
},
"oid": {
"maximum": 18446744073709551615,
"minimum": 1,
"type": "integer"
}
},
"required": [
"kind",
"oid"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "hyperliquid_expired_unreconciled"
}
},
"required": [
"kind"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "ethereum_transaction_confirmed_success"
},
"tx_hash": {
"maxLength": 66,
"minLength": 66,
"pattern": "^0x[0-9a-f]{64}$",
"type": "string"
}
},
"required": [
"kind",
"tx_hash"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "ethereum_transaction_confirmed_revert"
},
"tx_hash": {
"maxLength": 66,
"minLength": 66,
"pattern": "^0x[0-9a-f]{64}$",
"type": "string"
}
},
"required": [
"kind",
"tx_hash"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"finalized_nonce": {
"maximum": 18446744073709551615,
"minimum": 1,
"type": "integer"
},
"kind": {
"const": "ethereum_transaction_nonce_superseded"
}
},
"required": [
"kind",
"finalized_nonce"
],
"type": "object"
}
]
},
"pakt_root": {
"maxLength": 64,
"minLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"receipt_id": {
"maxLength": 81,
"minLength": 67,
"pattern": "^(hl-[0-9a-f]{64}|gateway-(approval|order)-[0-9a-f]{64})$",
"type": "string"
}
},
"required": [
"pakt_root",
"receipt_id",
"completion"
],
"type": "object"
}