sendTransaction

curl --fail-with-body "$HOFUND_URL" \
  --header 'content-type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendTransaction",
    "params": [
      "<BASE64_SIGNED_TRANSACTION>",
      { "encoding": "base64", "skipPreflight": true, "maxRetries": 0 }
    ]
  }'

curl --fail-with-body "$HOFUND_URL" \
  --header 'content-type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendTransaction",
    "params": [
      "<BASE64_SIGNED_TRANSACTION>",
      { "encoding": "base64", "skipPreflight": true },
      { "mevProtect": true }
    ]
  }'

curl --fail-with-body "$HOFUND_JITO_BUNDLE_ONLY_URL" \
  --header 'content-type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendTransaction",
    "params": [
      "<BASE64_SIGNED_TRANSACTION>",
      { "encoding": "base64", "skipPreflight": true }
    ]
  }'

{ "jsonrpc": "2.0", "id": 1, "result": "<TRANSACTION_SIGNATURE>" }

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Thor tip is below the configured floor",
    "data": { "kind": "tip_too_low" }
  }
}

curl --fail-with-body "$HOFUND_URL" \
  --header 'content-type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendTransaction",
    "params": [
      "<BASE64_SIGNED_TRANSACTION>",
      { "encoding": "base64", "skipPreflight": true, "maxRetries": 0 }
    ]
  }'

curl --fail-with-body "$HOFUND_URL" \
  --header 'content-type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendTransaction",
    "params": [
      "<BASE64_SIGNED_TRANSACTION>",
      { "encoding": "base64", "skipPreflight": true },
      { "mevProtect": true }
    ]
  }'

curl --fail-with-body "$HOFUND_JITO_BUNDLE_ONLY_URL" \
  --header 'content-type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendTransaction",
    "params": [
      "<BASE64_SIGNED_TRANSACTION>",
      { "encoding": "base64", "skipPreflight": true }
    ]
  }'

{ "jsonrpc": "2.0", "id": 1, "result": "<TRANSACTION_SIGNATURE>" }

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Thor tip is below the configured floor",
    "data": { "kind": "tip_too_low" }
  }
}

sendTransaction submits one transaction. On /hofund you choose the lane per request; on a lane route the URL fixes it.

Route	Rail	Options accepted
`/hofund`	Fast (both rails); `?swqos-only=true` for SWQoS only; `?mev-protect=true` or `params[2]` for Jito	Fast option set below; Jito accepts only `encoding` and `skipPreflight`
`/hofund-fast`	Direct TPU and SWQoS at once; the first verified acknowledgement wins	Fast option set
`/hofund-direct-tpu`	Direct TPU only	Fast option set
`/hofund-swqos`	SWQoS only	Fast option set
`/hofund-jito-bundle-only`	Jito, bundle-only, no fallback	Exactly `{ "encoding": "base64", "skipPreflight": true }`

The transaction must pay the Thor tip floor to a Thor tip account (fast rails), and additionally the Jito tip floor to a Jito tip account (protected). Read both sets from getFastTipConfig and getThorTipConfig. Every sendTransaction route accepts recent blockhash or caller-owned durable nonce transactions through the same request format.

Durable nonce

Build and fully sign the transaction with your nonce value in recentBlockhash. Instruction 0 must be the only AdvanceNonceAccount instruction, using a writable nonce account, the readonly recent-blockhashes sysvar, and a signing nonce authority. These accounts and the System Program must be static message keys. Legacy and v0 transactions are supported. Hofund verifies signatures, instruction structure, and the selected lane’s tip requirements locally. It forwards the signed bytes unchanged with skipPreflight: true; validators check the live nonce value and authority. Acceptance does not prove the nonce is still usable or the transaction landed. Exact retries retain the existing signature-based replay rules. Different signed variants may share one nonce account and value. sendIdeal is available when you want Hofund to verify and submit a fast/Jito pair together. Atomic sendBundle requests still require recent blockhash transactions.

Parameters

string

required

Fully signed transaction, canonical padded base64, at most 1232 bytes decoded.

object

required

Send configuration.

Show properties

string

required

Must be "base64".

boolean

required

Must be true. Hofund does not simulate.

integer

Fast rails only. 0–5, forwarded to the rail.

string

Fast rails only. processed, confirmed, or finalized; accepted for SDK compatibility, has no effect.

integer

Fast rails only. Bounds the whole dispatch, from 100 up to the maximum reported by getFastTipConfig.

string

Fast rails only. "auto" or the exact region reported by getFastTipConfig; fails closed if it does not match the instance you reached.

minContextSlot is rejected: -32602 minContextSlot is unsupported and is not enforced by Hofund sender rails.

object

/hofund only. Exactly { "mevProtect": true } routes the transaction through Jito instead of the fast rails. Do not combine with ?mev-protect=true.

On the lane routes /hofund-fast, /hofund-direct-tpu, and /hofund-swqos you can send deadlineMs and region as headers instead: Hofund-Deadline-Ms and Hofund-Expected-Region. Sending both the header and the body field is rejected.

Response

string

The transaction signature, once one selected rail returned a verified acknowledgement (fast) or Jito accepted the transaction (protected).

Headers: X-Hofund-Submission-ID; X-Bundle-ID on the Jito path. Nonce transaction status follows its signature. An unobserved signature is unknown; a receipt deadline or blockhash validity check cannot prove nonce expiry. Acknowledged is not landed. Track the signature through ThorEdge RPC, or poll getHofundSubmissionStatus with the submission id.

Errors

HTTP	Code	Message	Meaning
`200`	`-32602`	`Thor tip is below the configured floor`	No qualifying tip transfer, or too small.
`200`	`-32602`	`transaction must pay at least N Thor and M Jito tip lamports`	Protected path tip check failed.
`400`	`-32602`	`AdvanceNonceAccount must occur exactly once at instruction 0`	Put the nonce advance first and remove additional advances.
`200`	`-32006`	`transaction rejected by all selected rails`	Every rail returned a deterministic rejection.
`200`	`-32007`	`transaction outcome is ambiguous`	A rail timed out or answered malformed. Check status before resubmitting.
`409`	`-32005`	`transaction signature is already reserved`	Same signature already submitted, possibly on another lane.
`429`	`-32003`	`fast submission rate limit exceeded`	Retry after `Retry-After`. One per-key limiter across all fast surfaces, sized by your pass tier — see Rate limits.

curl --fail-with-body "$HOFUND_URL" \
  --header 'content-type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendTransaction",
    "params": [
      "<BASE64_SIGNED_TRANSACTION>",
      { "encoding": "base64", "skipPreflight": true, "maxRetries": 0 }
    ]
  }'

curl --fail-with-body "$HOFUND_URL" \
  --header 'content-type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendTransaction",
    "params": [
      "<BASE64_SIGNED_TRANSACTION>",
      { "encoding": "base64", "skipPreflight": true },
      { "mevProtect": true }
    ]
  }'

curl --fail-with-body "$HOFUND_JITO_BUNDLE_ONLY_URL" \
  --header 'content-type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendTransaction",
    "params": [
      "<BASE64_SIGNED_TRANSACTION>",
      { "encoding": "base64", "skipPreflight": true }
    ]
  }'

{ "jsonrpc": "2.0", "id": 1, "result": "<TRANSACTION_SIGNATURE>" }

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Thor tip is below the configured floor",
    "data": { "kind": "tip_too_low" }
  }
}

API reference

ThorEdge RPC

FastGate RPC

Yellowstone gRPC

Bifrost

Hofund

Durable nonce

Parameters

Response

Errors

​Durable nonce

​Parameters

​Response

​Errors

Durable nonce

Parameters

Response

Errors