TXResponses

TXResponse frames are JSON text messages serialized as:

{
  "msg_type": "ingress_ack",
  "body": {}
}

This page lists every TXResponse variant emitted by the socket and the fields you can expect in body.

Shared body fields

These fields are reused across multiple TXResponse variants.

Field	Type	Notes
`identifier`	`string`	Your request id. Main correlation key.
`session_key`	`string`	Server-side session identifier for the connection.
`sub_id`	`string`	Optional child id for bundled or sub-transaction flows.
`timing`	`object`	Optional timing object. Currently `{ "server_unix_ms": number }`.
`confirmation_detection_method`	`poll \| stream`	Optional confirmation source on terminal or near-terminal responses.

The socket also injects request context onto many responses when it can resolve the originating request:

Field	Type	Notes
`platform`	`string`	Request platform such as `pump_fun` or `four_meme`.
`envelope_type`	`string`	Request type such as `buy` or `create_with_image_url`.
`display_title`	`string`	Human-readable label for UI display.
`display_subtitle`	`string`	Human-readable subtitle for UI display.
`display`	`object`	Structured display payload with `kind`, `title`, optional `subtitle`, and optional `fields`.

display.fields entries use this shape:

{
  "label": "Wallet",
  "value": "7abc...9xyz",
  "copy_value": "7abc1234...optional"
}

All TXResponses

`ingress_ack`

The request envelope was parsed and accepted by the socket.

Field	Type	Notes
`identifier`	`string`	Request id.
`session_key`	`string`	Session key.
`platform`	`string`	Usually present.
`envelope_type`	`string`	Optional.
`timing`	`object`	Optional timing object.
`display_title`	`string`	Optional request context field.
`display_subtitle`	`string`	Optional request context field.
`display`	`object`	Optional request context field.

Example:

{
  "msg_type": "ingress_ack",
  "body": {
    "identifier": "req_123",
    "session_key": "USER_PUBKEY:SERVER_CONNECTION_ID",
    "platform": "pump_fun",
    "envelope_type": "create_with_image_url",
    "timing": {
      "server_unix_ms": 1760000000000
    }
  }
}

`dispatch`

The request was dispatched to a handler or proxy route.

Field	Type	Notes
`identifier`	`string`	Request id.
`session_key`	`string`	Session key.
`timing`	`object`	Optional timing object.
`platform`	`string`	Optional request context field.
`envelope_type`	`string`	Optional request context field.
`display_title`	`string`	Optional request context field.
`display_subtitle`	`string`	Optional request context field.
`display`	`object`	Optional request context field.

`mint`

The created token mint is known.

Field	Type	Notes
`identifier`	`string`	Request id.
`session_key`	`string`	Session key.
`mint`	`string`	Created token mint address.
`lp`	`string`	Liquidity pool or related address from the backend create flow.
`force_open`	`string`	Optional backend-supplied hint or follow-up target.
`timing`	`object`	Optional timing object.
`platform`	`string`	Optional request context field.
`envelope_type`	`string`	Optional request context field.
`display_title`	`string`	Optional request context field.
`display_subtitle`	`string`	Optional request context field.
`display`	`object`	Optional request context field.

`metadata`

Metadata was uploaded and the URI is available.

Field	Type	Notes
`identifier`	`string`	Request id.
`session_key`	`string`	Session key.
`metadata_uri`	`string`	Metadata URI.
`timing`	`object`	Optional timing object.
`platform`	`string`	Optional request context field.
`envelope_type`	`string`	Optional request context field.
`display_title`	`string`	Optional request context field.
`display_subtitle`	`string`	Optional request context field.
`display`	`object`	Optional request context field.

`sell`

Sell-specific progress event. The body only carries correlation fields.

Field	Type	Notes
`identifier`	`string`	Request id.
`session_key`	`string`	Session key.
`timing`	`object`	Optional timing object.
`platform`	`string`	Optional request context field.
`envelope_type`	`string`	Optional request context field.
`display_title`	`string`	Optional request context field.
`display_subtitle`	`string`	Optional request context field.
`display`	`object`	Optional request context field.

`submit`

The backend submitted a transaction upstream.

Field	Type	Notes
`identifier`	`string`	Request id.
`sub_id`	`string`	Optional child id.
`session_key`	`string`	Session key.
`signature`	`string`	Submitted transaction hash or signature.
`nonce`	`number`	Optional nonce. Used on some Clanker/Base flows.
`timing`	`object`	Optional timing object.
`platform`	`string`	Optional request context field.
`envelope_type`	`string`	Optional request context field.
`display_title`	`string`	Optional request context field.
`display_subtitle`	`string`	Optional request context field.
`display`	`object`	Optional request context field.

`confirmed`

The transaction confirmed. This is terminal.

Field	Type	Notes
`identifier`	`string`	Request id.
`sub_id`	`string`	Optional child id.
`session_key`	`string`	Session key.
`signature`	`string`	Confirmed transaction hash or signature.
`confirmation_detection_method`	`poll \| stream`	Optional confirmation source.
`timing`	`object`	Optional timing object.
`platform`	`string`	Optional request context field.
`envelope_type`	`string`	Optional request context field.
`display_title`	`string`	Optional request context field.
`display_subtitle`	`string`	Optional request context field.
`display`	`object`	Optional request context field.

`success`

The request succeeded. This is terminal.

Field	Type	Notes
`identifier`	`string`	Request id.
`sub_id`	`string`	Optional child id.
`session_key`	`string`	Session key.
`signature`	`string`	Successful transaction hash or signature.
`confirmation_detection_method`	`poll \| stream`	Optional confirmation source.
`timing`	`object`	Optional timing object.
`platform`	`string`	Optional request context field.
`envelope_type`	`string`	Optional request context field.
`display_title`	`string`	Optional request context field.
`display_subtitle`	`string`	Optional request context field.
`display`	`object`	Optional request context field.

`failure`

Submission happened, but the request failed to confirm successfully. This is terminal.

Field	Type	Notes
`identifier`	`string`	Request id.
`sub_id`	`string`	Optional child id.
`session_key`	`string`	Session key.
`signature`	`string`	Submitted transaction hash or signature.
`rpc`	`string`	Optional RPC lane/provider associated with the failure.
`confirmation_detection_method`	`poll \| stream`	Optional confirmation source.
`timing`	`object`	Optional timing object.
`platform`	`string`	Optional request context field.
`envelope_type`	`string`	Optional request context field.
`display_title`	`string`	Optional request context field.
`display_subtitle`	`string`	Optional request context field.
`display`	`object`	Optional request context field.

`error`

The request failed before success. This is terminal.

Field	Type	Notes
`identifier`	`string`	Request id.
`sub_id`	`string`	Optional child id.
`session_key`	`string`	Session key.
`error`	`string`	Error string.
`confirmation_detection_method`	`poll \| stream`	Optional confirmation source.
`timing`	`object`	Optional timing object.
`platform`	`string`	Optional request context field.
`envelope_type`	`string`	Optional request context field.
`display_title`	`string`	Optional request context field.
`display_subtitle`	`string`	Optional request context field.
`display`	`object`	Optional request context field.

`simulation`

Simulation-only result. This can be terminal when the request was run in simulation mode.

Field	Type	Notes
`identifier`	`string`	Request id.
`sub_id`	`string`	Optional child id.
`session_key`	`string`	Session key.
`success`	`boolean`	Whether simulation succeeded.
`result`	`object`	Optional simulation result payload. Arbitrary JSON.
`error`	`string`	Optional simulation error string.
`timing`	`object`	Optional timing object.
`platform`	`string`	Optional request context field.
`envelope_type`	`string`	Optional request context field.
`display_title`	`string`	Optional request context field.
`display_subtitle`	`string`	Optional request context field.
`display`	`object`	Optional request context field.

`four_meme_token`

Four.meme access token update for a wallet.

Field	Type	Notes
`identifier`	`string`	Request id.
`session_key`	`string`	Session key.
`wallet`	`string`	Wallet the access token belongs to.
`access_token`	`string`	Four.meme access token.
`timing`	`object`	Optional timing object.

Non-TXResponse frame

rate_limit_hit is sent by the socket, but it is not part of the TXResponse enum. It uses the same outer JSON shape:

{
  "msg_type": "rate_limit_hit",
  "body": {}
}

Treat confirmed, success, failure, error, and terminal simulation responses as the end of a request.

Introduction

Getting Started

Dashboard

Features

Scrapist

Customization

API

Shared body fields

All TXResponses

`ingress_ack`

`dispatch`

`mint`

`metadata`

`sell`

`submit`

`confirmed`

`success`

`failure`

`error`

`simulation`

`four_meme_token`

Non-TXResponse frame

Introduction

Getting Started

Dashboard

Features

Scrapist

Customization

API

​Shared body fields

​All TXResponses

​ingress_ack

​dispatch

​mint

​metadata

​sell

​submit

​confirmed

​success

​failure

​error

​simulation

​four_meme_token

​Non-TXResponse frame

Shared body fields

All TXResponses

`ingress_ack`

`dispatch`

`mint`

`metadata`

`sell`

`submit`

`confirmed`

`success`

`failure`

`error`

`simulation`

`four_meme_token`

Non-TXResponse frame