Skip to main content
POST
Submit Raw Transaction

Authorizations

Authorization
string
header
required

Bearer authentication with an API token

Body

application/json
request_id
string<uuid>
required

Request identifier in a UUID format. Serves as an idempotency key.

Pattern: [a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}
account_id
string
required

Account whose wallet signs the transaction

chain
enum<string>
required

Testnet chain the transaction is for. The chain ID in the signed transaction is derived from this value.

Available options:
CHAIN_UNSPECIFIED,
ETHEREUM_MAINNET,
POLYGON_MAINNET,
ETHEREUM_TESTNET,
OPTIMISM_SEPOLIA,
BASE_MAINNET,
BASE_SEPOLIA,
OPTIMISM_MAINNET,
POLYGON_AMOY,
SOLANA_MAINNET,
SOLANA_DEVNET
Example:

"ETHEREUM_MAINNET"

mode
enum<string>
required

What Bastion does with the transaction. Only SIGN_ONLY is supported in the sandbox preview.

Available options:
MODE_UNSPECIFIED,
SIGN_ONLY
Example:

"SIGN_ONLY"

eip1559_transaction
eip1559_transaction · object

Response

Success

eip1559_transaction
eip1559_transaction · object
id
string
read-only

Unique identifier of the raw transaction

request_id
string

Request identifier supplied at creation

account_id
string

Account whose wallet signs the transaction

chain
enum<string>

Chain the transaction is for

Available options:
CHAIN_UNSPECIFIED,
ETHEREUM_MAINNET,
POLYGON_MAINNET,
ETHEREUM_TESTNET,
OPTIMISM_SEPOLIA,
BASE_MAINNET,
BASE_SEPOLIA,
OPTIMISM_MAINNET,
POLYGON_AMOY,
SOLANA_MAINNET,
SOLANA_DEVNET
Example:

"ETHEREUM_MAINNET"

status
enum<string>

Status of a raw transaction.

  • STATUS_UNSPECIFIED: Not known yet; keep polling.
  • CREATED: Stored, but signing did not complete. Retry the request with the same request_id.
  • SIGNED: Signed. In sign-only mode Bastion does not broadcast, so the transaction stays SIGNED.

New statuses may be added; treat an unknown value as not yet final.

Available options:
STATUS_UNSPECIFIED,
CREATED,
SIGNED
Example:

"CREATED"

preview
preview · object

What the transaction is expected to do, estimated from the account's address before signing. Informational only: it never blocks signing.

from_address
string
read-only

Address that signs and sends the transaction

nonce
string
read-only

Nonce the transaction was signed at, as a decimal string

transaction_hash
string
read-only

Hash of the signed transaction; empty until signed

created_at
string
read-only
updated_at
string
read-only
signed_transaction
string
read-only

Signed transaction, 0x-prefixed, ready for eth_sendRawTransaction. Returned by Submit Raw Transaction.