Status and tip configuration

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

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

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

{ "jsonrpc": "2.0", "id": 1, "result": "ok" }

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

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

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

{ "jsonrpc": "2.0", "id": 1, "result": "ok" }

getHofundSubmissionStatus

POST /hofund-status. Returns the current state of one submission you made. Lookup is scoped to your key; another key’s submission id returns 404, -32004 submission not found.

string

required

The X-Hofund-Submission-ID value from the submission response: 64 lowercase hex characters.

object

Show properties

string

Lane the submission used, for example fast, direct-tpu, swqos, jito-bundle-only, bundle, ideal, protected-batch.

string

pending, processed, confirmed, finalized, failed, expired, unknown; anomalous for an ideal pair where both members landed.

string | null

First signature.

string[]

All signatures.

object | null

Rail result, when recorded.

string | null

Jito bundle id on protected submissions.

string | null

Direct-TPU rail outcome; not_selected on SWQoS-only.

string | null

SWQoS rail outcome; not_selected on direct-TPU-only.

integer | null

string

When Hofund drops the record; about 10 minutes after creation.

array

ideal and protected-batch only. One entry per member: index, role, signature, dispatchState, chainState, slot, err, result, detail, updatedAt. dispatchState is queued, sending, sent_unconfirmed, verified_ack, rejected, or ambiguous; chainState is unobserved, processed, confirmed, finalized, or dropped.

An accepted durable nonce submission with an unobserved signature has status unknown. expiresAt controls receipt retention and does not establish nonce expiry. The record lives about 10 minutes. After that, or for WebSocket and QUIC submissions (which return no submission id), reconcile the signature through ThorEdge RPC.

getFastTipConfig

POST /hofund-status, params: []. Returns the fast-lane contract for the instance you reached.

object

Show properties

string

fast

string

Region slug for region / Hofund-Expected-Region.

string[]

Pay the tip to one of these.

integer

Minimum tip on the fast rails.

string[]

["fast", "direct-tpu", "swqos"]

object

{ "min": 0, "max": 5 }

object

{ "min": 100, "max": <dispatch timeout> }

string

Hofund-Deadline-Ms

string

Hofund-Expected-Region

integer

1232

getThorTipConfig

POST /hofund-bundle, params: []. Returns the protected-lane contract.

object

Show properties

string

jito-bundle-only

string[]

integer

string[]

integer

5 on /hofund-bundle.

integer

1232

integer

Ceiling for a protected sendBatch.

integer

Per-member timeout of a protected batch.

getHealth

/hofund with params absent or []. Result is the string "ok".

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

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

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

{ "jsonrpc": "2.0", "id": 1, "result": "ok" }

API reference

ThorEdge RPC

FastGate RPC

Yellowstone gRPC

Bifrost

Hofund

getHofundSubmissionStatus

getFastTipConfig

getThorTipConfig

getHealth

​getHofundSubmissionStatus

​getFastTipConfig

​getThorTipConfig

​getHealth

getHofundSubmissionStatus

getFastTipConfig

getThorTipConfig

getHealth