Pakt Docs
MCP Tools

record_execution_completion

Record the terminal venue result observed by the submitting client for one exact signed receipt.

Record a Client-Observed Terminal Result

Use this tool only after the submitting client observes the exact signed operation reach its supported terminal venue result.

At a Glance

FieldMeaning
Side effectsAnnotates an existing signed receipt for dashboard display. It does not prove, sign, submit, or independently reconcile venue state.
Next stepRead the completed receipt in the dashboard. Do not use this call as independent proof of settlement.

Protocol Behavior

Record the terminal venue result observed by the submitting client for one exact signed receipt. This call cannot authorize, sign, or submit anything. The Hyperliquid client reports the positive filled order id it read from /exchange. For Ethereum, Pakt additionally recomputes the transaction hash from the exact durable signed raw transaction before recording the client-reported confirmation. Account identity is server-derived.

Arguments

ArgumentTypeRequiredConstraints
completionobject (hyperliquid_filled) or object (ethereum_transaction_confirmed)yesSee schema below
pakt_rootstringyesminimum length 64; maximum length 64; pattern ^[0-9a-f]{64}$
receipt_idstringyesminimum length 67; maximum length 86; pattern `^(hl-[0-9a-f]{64}

Input Schema

The JSON schema below is emitted by the hosted server's real tools/list catalogue for MCP protocol revision 2025-06-18.

{
  "additionalProperties": false,
  "properties": {
    "completion": {
      "oneOf": [
        {
          "additionalProperties": false,
          "properties": {
            "kind": {
              "const": "hyperliquid_filled"
            },
            "oid": {
              "maximum": 18446744073709552000,
              "minimum": 1,
              "type": "integer"
            }
          },
          "required": [
            "kind",
            "oid"
          ],
          "type": "object"
        },
        {
          "additionalProperties": false,
          "properties": {
            "kind": {
              "const": "ethereum_transaction_confirmed"
            },
            "tx_hash": {
              "maxLength": 66,
              "minLength": 66,
              "pattern": "^0x[0-9a-f]{64}$",
              "type": "string"
            }
          },
          "required": [
            "kind",
            "tx_hash"
          ],
          "type": "object"
        }
      ]
    },
    "pakt_root": {
      "maxLength": 64,
      "minLength": 64,
      "pattern": "^[0-9a-f]{64}$",
      "type": "string"
    },
    "receipt_id": {
      "maxLength": 86,
      "minLength": 67,
      "pattern": "^(hl-[0-9a-f]{64}|gateway-plan-[0-9a-f]{64}-(approval|order))$",
      "type": "string"
    }
  },
  "required": [
    "pakt_root",
    "receipt_id",
    "completion"
  ],
  "type": "object"
}

On this page