Quickstart: submit through Hofund

In about five minutes you will discover Hofund’s tip accounts, submit a transaction through /hofund, and look up what happened to it.

Before you start

You need an access whose Bifrost or Hofund tab lists Hofund routes for a location, and a way to sign a Solana transaction. Copy the Hofund and Hofund status route URLs from Endpoints → Hofund.

export HOFUND_URL='<HOFUND_URL_COPIED_FROM_DASHBOARD>'
export HOFUND_STATUS_URL='<HOFUND_STATUS_URL_COPIED_FROM_DASHBOARD>'

Read the tip configuration

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

The result lists thorTipAccounts and thorMinTipLamports. Add a System Program transfer of at least that many lamports from the fee payer to one of those accounts, then sign and base64-encode the transaction.

Submit on the fast lane

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

The response carries the signature and an X-Hofund-Submission-ID header:

HTTP/1.1 200 OK
X-Hofund-Submission-ID: <SUBMISSION_ID>

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

Check the status

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

result.status reports processed, confirmed, or finalized once the signature is observed on-chain. Before that, it may be pending or unknown. failed indicates failure; expired applies to recent-blockhash transactions. See status semantics for durable nonces and receipt retention.

An error with "kind": "tip_too_low" means the transfer is missing or below thorMinTipLamports.

Get started

Dashboard

Operate

Before you start

Next steps

​Before you start

​Next steps

Before you start

Next steps