sendIdeal and getNonce

curl --fail-with-body "$HOFUND_URL" \
  --header 'content-type: application/json' \
  --data '{ "jsonrpc": "2.0", "id": 1, "method": "getNonce", "params": ["<NONCE_ACCOUNT_PUBKEY>"] }'

curl --fail-with-body "$HOFUND_URL" \
  --header 'content-type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendIdeal",
    "params": [["<BASE64_FAST_TRANSACTION>", "<BASE64_JITO_TRANSACTION>"]]
  }'

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "nonce": "<DURABLE_NONCE>",
    "nonceAccount": "<NONCE_ACCOUNT_PUBKEY>",
    "nonceAuthority": "<AUTHORITY_PUBKEY>"
  }
}

{ "jsonrpc": "2.0", "id": 1, "result": ["<FAST_SIGNATURE>", "<JITO_SIGNATURE>"] }

An ideal pair is two versions of the same intent: one tuned for the fast rails (priority fee), one for Jito (tip). Both use the same durable nonce, so whichever lands first cancels the other. Both methods live on /hofund. An ideal pair costs one fast-lane credit and one Jito-lane credit — see Rate limits.

getNonce

string

required

Nonce account pubkey, base-58.

object

{ "nonce": "<durable-nonce>", "nonceAccount": "<pubkey>", "nonceAuthority": "<pubkey>" }

sendIdeal

string[]

required

Exactly two fully signed transactions built on the same durable nonce: the fast-rail transaction first, the Jito transaction second. Canonical padded base64, at most 1232 bytes each. No options object.

string[]

["<FAST_SIGNATURE>", "<JITO_SIGNATURE>"]

Header: X-Hofund-Submission-ID. Poll getHofundSubmissionStatus with it; an ideal status carries per-member items (role fast or jito-bundle-only, chainState, slot, err). The member that lost the race reports err: "cancelled_by_nonce" and never lands; the status can report anomalous if both members appear to have landed.

Errors

Code	Message
`-32602`	`sendIdeal requires exactly two transactions`
`-32602`	`getNonce requires exactly one nonce account`
`-32602`	`query route controls are not supported by getNonce` / `by sendIdeal`

curl --fail-with-body "$HOFUND_URL" \
  --header 'content-type: application/json' \
  --data '{ "jsonrpc": "2.0", "id": 1, "method": "getNonce", "params": ["<NONCE_ACCOUNT_PUBKEY>"] }'

curl --fail-with-body "$HOFUND_URL" \
  --header 'content-type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendIdeal",
    "params": [["<BASE64_FAST_TRANSACTION>", "<BASE64_JITO_TRANSACTION>"]]
  }'

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "nonce": "<DURABLE_NONCE>",
    "nonceAccount": "<NONCE_ACCOUNT_PUBKEY>",
    "nonceAuthority": "<AUTHORITY_PUBKEY>"
  }
}

{ "jsonrpc": "2.0", "id": 1, "result": ["<FAST_SIGNATURE>", "<JITO_SIGNATURE>"] }

API reference

ThorEdge RPC

FastGate RPC

Yellowstone gRPC

Bifrost

Hofund

getNonce

sendIdeal

Errors

​getNonce

​sendIdeal

​Errors

getNonce

sendIdeal

Errors