Submit a Gasless Transaction

Authentication is mandatory — provide either a Relayer API Key or L2 (HMAC) credentials. Once accepted, the transaction enters a processing pipeline: it is queued, broadcast to the chain, and tracked through a state machine until it reaches a terminal state.

Endpoint

POST /submit

Server: https://api.openfish.fun

Authentication: Relayer API Key (preferred) or L2 (HMAC) required

---

Authentication Headers

Option 1: Relayer API Key

Header	Description
RELAYER_API_KEY	Relayer API key
RELAYER_API_KEY_ADDRESS	Associated address

Option 2: L2 HMAC

Header	Description
OPENFISH_API_KEY	API key (UUID)
OPENFISH_TIMESTAMP	Unix timestamp
OPENFISH_PASSPHRASE	API passphrase
OPENFISH_SIGNATURE	HMAC-SHA256 signature

---

Request Body

Content-Type: application/json

Field	Type	Required	Description
from	string	Yes	Sender address
to	string	Yes	Target contract address
proxyWallet	string	No	Proxy wallet address (if applicable)
data	string	Yes	Hex-encoded calldata (e.g. "0xa9059cbb...")
nonce	string	No	Transaction nonce
signature	string	No	EIP-712 signature
signatureParams	string	No	Additional signature parameters
type	string	No	Relay type: "PROXY" or "SAFE"

Sample Request Body

{
  "from": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
  "to": "0xA642f9165D192Ff13b1D43a0Ef56B3BD074614bB",
  "data": "0xa9059cbb000000000000000000000000...",
  "type": "PROXY"
}

---

Responses

200 — Transaction accepted for processing

Field	Type	Description
transactionID	string	Transaction UUID
state	string	"STATE_NEW" — progresses to STATE_EXECUTED then STATE_CONFIRMED or STATE_FAILED
nonce	integer	Meta-transaction nonce used

{
  "transactionID": "0190b317-a1d3-7bec-9b91-eeb6dcd3a620",
  "state": "STATE_NEW",
  "nonce": 61
}

Transaction State Machine

STATE_NEW -> STATE_EXECUTED -> STATE_CONFIRMED
                            -> STATE_FAILED

State	Description
STATE_NEW	Received and queued, not yet broadcast
STATE_EXECUTED	Sent to the chain, waiting for block confirmation
STATE_CONFIRMED	Successfully included in a confirmed block
STATE_FAILED	Execution reverted or submission error occurred

400 — Bad Request

{ "error": "invalid JSON: ..." }

401 — Unauthorized

{ "error": "invalid authorization" }

500 — Server Error

{ "error": "Internal server error" }