Submit a transaction

Authorization

apiKey

api-key<token>

Tachyon API key.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

to*string

Destination account or contract address for the relayed transaction.

Length1 <= length

callData*string

Encoded transaction calldata. Use 0x when the transaction does not call a contract function.

chainId*number

Numeric chain ID where Tachyon should execute the transaction.

value?string

Native token value to send, encoded as a base-10 integer string in the chain smallest unit. Defaults to 0.

Default"0"

shouldBatchInMulticall?boolean

Whether Tachyon may include this transaction in a supported multicall batch.

gasPrice?string

Legacy gas price override encoded as a base-10 integer string. Do not combine with EIP-1559 fee fields.

maxPriorityFeePerGas?string

EIP-1559 priority fee override encoded as a base-10 integer string. Provide together with maxFeePerGas.

maxFeePerGas?string

EIP-1559 maximum fee override encoded as a base-10 integer string. Provide together with maxPriorityFeePerGas.

gasLimit?string

Maximum gas units Tachyon may use for the transaction, encoded as a base-10 integer string.

maxUSD?number

Maximum execution cost in USD that the caller permits for this transaction.

label?string

Optional application-defined label used to identify or group the transaction.

retries?number

Number of retry attempts already assigned to the transaction. Defaults to 0.

Default0

authorizationList?array<>

Optional signed EIP-7702 authorization list applied when submitting the transaction.

isAuthenticatedTx?boolean

Marks the request as an authenticated transaction flow. Defaults to false.

Defaultfalse

derivationPath?string

Optional derivation path used when Tachyon selects a derived relayer account.

transactionType?string

Execution mode. Use flash by default, flash-blocks for supported Base flashblock execution, or the specialized authenticated and funding modes when required.

Default"flash"

Value in"flash" | "authenticated" | "funding-signed" | "flash-blocks"

extraData?

Optional chain-specific execution parameters. Currently used for Starknet gas settings.

Response Body

`application/json`

curl -X POST "https://tachyon.rath.fi/api/submit-tx" \  -H "Content-Type: application/json" \  -d '{    "to": "",    "callData": "",    "chainId": 0  }'

{
  "success": true,
  "data": {
    "txId": "string",
    "estimatedCostUSD": 0,
    "x402Payment": {
      "type": "x402-gateway",
      "amount": "string",
      "amountUsd": 0,
      "network": "string",
      "transaction": "string",
      "settledAt": "2019-08-24T14:15:22Z",
      "payer": "string"
    }
  },
  "timestamp": "2019-08-24T14:15:22Z"
}

{
  "success": false,
  "error": {
    "code": "string",
    "message": "string",
    "category": "string",
    "details": null,
    "traceId": "string"
  },
  "timestamp": "2019-08-24T14:15:22Z"
}

{
  "success": false,
  "error": {
    "code": "string",
    "message": "string",
    "category": "string",
    "details": null,
    "traceId": "string"
  },
  "timestamp": "2019-08-24T14:15:22Z"
}

{
  "success": false,
  "error": {
    "code": "PAYMENT_REQUIRED",
    "message": "string",
    "category": "PAYMENT",
    "details": {
      "estimatedExecutionCostUsd": 0,
      "paymentAmountUsd": 0,
      "paymentAmount": "string",
      "asset": "USDC",
      "gasLimit": "string",
      "networks": [
        "string"
      ]
    }
  },
  "timestamp": "2019-08-24T14:15:22Z"
}

{
  "success": false,
  "error": {
    "code": "string",
    "message": "string",
    "category": "string",
    "details": null,
    "traceId": "string"
  },
  "timestamp": "2019-08-24T14:15:22Z"
}

Submit a transaction

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

402application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`