propose_execution
Start authorization of a root-first account proposal when the hosted sign-only service is configured.
Start One Authorization Job
Use this tool to start proof-gated authorization for one exact action under one active root.
At a Glance
| Field | Meaning |
|---|---|
| Side effects | Starts an asynchronous authorization job. Venue submission remains with the client. |
| Next step | Keep polling the returned operation_id with get_execution_status. |
Protocol Behavior
Start authorization of a root-first account proposal when the hosted sign-only service is configured. Hyperliquid carries one exact unsigned IOC order. Gateway uses two separately proved phases through this same queue; both carry the identical complete finite-approval + create-order plan, while the phase selects the one transaction that may be signed. Pakt validates but never repairs, re-plans, broadcasts, or registers a request. Account identity, wallet, active pakt, authenticated venue evidence and combined fee economics, proving, and authorization remain server-owned. This short call returns an operation_id; poll get_execution_status for the proof-gated result. An unconfigured deployment fails closed with execution_not_integrated.
Arguments
| Argument | Type | Required | Constraints |
|---|---|---|---|
intent | object (prepared_gateway_plan) or object (prepared_hyperliquid_order) | yes | See schema below |
pakt_root | string | yes | minimum length 64; maximum length 64; pattern ^[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": {
"intent": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "prepared_gateway_plan"
},
"phase": {
"enum": [
"approval",
"order"
]
},
"plan": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": false,
"properties": {
"amount": {
"maximum": 18446744073709552000,
"minimum": 1,
"type": "integer"
},
"gasLimit": {
"maximum": 18446744073709552000,
"minimum": 1,
"type": "integer"
},
"maxFeePerGas": {
"maximum": 18446744073709552000,
"minimum": 0,
"type": "integer"
},
"maxPriorityFeePerGas": {
"maximum": 18446744073709552000,
"minimum": 0,
"type": "integer"
},
"nonce": {
"maximum": 18446744073709552000,
"minimum": 0,
"type": "integer"
}
},
"required": [
"amount",
"nonce",
"gasLimit",
"maxFeePerGas",
"maxPriorityFeePerGas"
],
"type": "object"
},
"order": {
"additionalProperties": false,
"properties": {
"order_id": {
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"transaction": {
"additionalProperties": false,
"properties": {
"gasLimit": {
"maximum": 18446744073709552000,
"minimum": 1,
"type": "integer"
},
"maxFeePerGas": {
"maximum": 18446744073709552000,
"minimum": 0,
"type": "integer"
},
"maxPriorityFeePerGas": {
"maximum": 18446744073709552000,
"minimum": 0,
"type": "integer"
},
"nonce": {
"maximum": 18446744073709552000,
"minimum": 0,
"type": "integer"
},
"tx": {
"additionalProperties": false,
"properties": {
"chain": {
"minLength": 1,
"type": "string"
},
"data": {
"minLength": 1,
"type": "string"
},
"to": {
"minLength": 1,
"type": "string"
},
"value": {
"pattern": "^[0-9]+$",
"type": "string"
}
},
"required": [
"to",
"data",
"value",
"chain"
],
"type": "object"
}
},
"required": [
"tx",
"nonce",
"gasLimit",
"maxFeePerGas",
"maxPriorityFeePerGas"
],
"type": "object"
}
},
"required": [
"order_id",
"transaction"
],
"type": "object"
}
},
"required": [
"approval",
"order"
],
"type": "object"
}
},
"required": [
"kind",
"phase",
"plan"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "prepared_hyperliquid_order"
},
"order": {
"additionalProperties": false,
"properties": {
"expires_after_ms": {
"maximum": 18446744073709552000,
"minimum": 1,
"type": "integer"
},
"grouping": {
"const": "na"
},
"legs": {
"items": {
"additionalProperties": false,
"properties": {
"asset": {
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"is_buy": {
"type": "boolean"
},
"limit_px": {
"pattern": "^[0-9]+(\\.[0-9]{1,8})?$",
"type": "string"
},
"order_type": {
"additionalProperties": false,
"properties": {
"limit": {
"additionalProperties": false,
"properties": {
"tif": {
"const": "ioc"
}
},
"required": [
"tif"
],
"type": "object"
}
},
"required": [
"limit"
],
"type": "object"
},
"reduce_only": {
"type": "boolean"
},
"sz": {
"pattern": "^[0-9]+(\\.[0-9]{1,8})?$",
"type": "string"
}
},
"required": [
"asset",
"is_buy",
"limit_px",
"sz",
"reduce_only",
"order_type"
],
"type": "object"
},
"maxItems": 1,
"minItems": 1,
"type": "array"
},
"nonce": {
"maximum": 18446744073709552000,
"minimum": 1,
"type": "integer"
},
"vault_address": {
"type": "null"
}
},
"required": [
"legs",
"grouping",
"nonce",
"vault_address",
"expires_after_ms"
],
"type": "object"
}
},
"required": [
"kind",
"order"
],
"type": "object"
}
]
},
"pakt_root": {
"maxLength": 64,
"minLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
}
},
"required": [
"pakt_root",
"intent"
],
"type": "object"
}