{
  "openapi": "3.2.0",
  "info": {
    "title": "sendTransaction",
    "version": "1",
    "description": "Submit one signed transaction with sendTransaction, choose encoding and preflight options, and handle refusals."
  },
  "servers": [
    {
      "url": "https://ams.tpu.supanode.xyz"
    },
    {
      "url": "https://fra.tpu.supanode.xyz"
    },
    {
      "url": "https://la.tpu.supanode.xyz"
    },
    {
      "url": "https://lon.tpu.supanode.xyz"
    },
    {
      "url": "https://ny.tpu.supanode.xyz"
    },
    {
      "url": "https://toy.tpu.supanode.xyz"
    }
  ],
  "security": [
    {
      "apiKeyHeader": []
    },
    {
      "apiKeyQuery": []
    },
    {
      "bearer": []
    }
  ],
  "components": {
    "securitySchemes": {
      "apiKeyHeader": {
        "$ref": "#/x-ext/b08d7c8/components/securitySchemes/apiKeyHeader"
      },
      "apiKeyQuery": {
        "$ref": "#/x-ext/b08d7c8/components/securitySchemes/apiKeyQuery"
      },
      "bearer": {
        "$ref": "#/x-ext/b08d7c8/components/securitySchemes/bearer"
      }
    }
  },
  "paths": {
    "/": {
      "post": {
        "operationId": "sendTransaction",
        "summary": "sendTransaction",
        "description": "Submit one signed transaction with sendTransaction, choose encoding and preflight options, and handle refusals.",
        "requestBody": {
          "required": true,
          "description": "One JSON object using the [shared request conventions](https://supanode.xyz/docs/solana/sender/reference/json-rpc#request). The transaction must meet the size limits and your key's [tip requirement](https://supanode.xyz/docs/solana/sender/tips); each submission counts against the [send rate](https://supanode.xyz/docs/solana/sender/limits#send-rate). Read the blockhash from your Solana RPC provider.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "jsonrpc",
                  "method",
                  "params"
                ],
                "properties": {
                  "jsonrpc": {
                    "$ref": "#/x-ext/b08d7c8/components/schemas/JsonRpcVersion"
                  },
                  "id": {
                    "$ref": "#/x-ext/b08d7c8/components/schemas/JsonRpcId"
                  },
                  "method": {
                    "type": "string",
                    "enum": [
                      "sendTransaction"
                    ]
                  },
                  "params": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 2,
                    "description": "The signed transaction followed by optional options.",
                    "prefixItems": [
                      {
                        "title": "Transaction",
                        "type": "string",
                        "maxLength": 5464,
                        "description": "One fully signed wire transaction: base58 allows 1,683 characters and 1,232 bytes for any version; base64 allows 1,644 characters and 1,232 bytes for legacy or v0, or 5,464 characters and 4,096 bytes for v1. A v1 transaction over 1,232 bytes needs base64 here, or raw bytes through [/binary](https://supanode.xyz/docs/solana/sender/reference/http/binary) or [QUIC](https://supanode.xyz/docs/solana/sender/reference/quic); see [Transactions](https://supanode.xyz/docs/solana/sender/send)."
                      },
                      {
                        "title": "Options",
                        "type": "object",
                        "properties": {
                          "encoding": {
                            "type": "string",
                            "enum": [
                              "base58",
                              "base64"
                            ],
                            "default": "base58",
                            "description": "Transaction encoding. Any other value is refused as `malformed`, problem `unknown_encoding`."
                          },
                          "skipPreflight": {
                            "type": "boolean",
                            "default": true,
                            "description": "`false` simulates on Supanode's RPC infrastructure provider before sending. Solana RPC defaults to `false`; SWQoS does not."
                          },
                          "preflightCommitment": {
                            "type": "string",
                            "enum": [
                              "processed",
                              "confirmed",
                              "finalized"
                            ],
                            "default": "finalized",
                            "description": "Read only when `skipPreflight` is `false`."
                          },
                          "minContextSlot": {
                            "type": "integer",
                            "minimum": 0,
                            "description": "Passed to simulation. Read only when `skipPreflight` is `false`."
                          },
                          "maxRetries": {
                            "type": "integer",
                            "minimum": 0,
                            "description": "Accepted and ignored. SWQoS does not periodically resubmit."
                          },
                          "tip": {
                            "type": "integer",
                            "minimum": 0,
                            "description": "A [declared tip](/account/billing#declared-tips) in lamports. Used when the transaction's own tip is below your minimum and your key may declare tips. Partner keys reject this option even when the transaction already pays a tip."
                          }
                        },
                        "description": "Optional. Fields not listed are ignored. A listed field of the wrong type is refused as `invalid_request`, problem `invalid_options`."
                      }
                    ],
                    "items": {
                      "anyOf": [
                        {
                          "title": "Transaction",
                          "type": "string",
                          "maxLength": 5464,
                          "description": "One fully signed wire transaction: base58 allows 1,683 characters and 1,232 bytes for any version; base64 allows 1,644 characters and 1,232 bytes for legacy or v0, or 5,464 characters and 4,096 bytes for v1. A v1 transaction over 1,232 bytes needs base64 here, or raw bytes through [/binary](https://supanode.xyz/docs/solana/sender/reference/http/binary) or [QUIC](https://supanode.xyz/docs/solana/sender/reference/quic); see [Transactions](https://supanode.xyz/docs/solana/sender/send)."
                        },
                        {
                          "title": "Options",
                          "type": "object",
                          "properties": {
                            "encoding": {
                              "type": "string",
                              "enum": [
                                "base58",
                                "base64"
                              ],
                              "default": "base58",
                              "description": "Transaction encoding. Any other value is refused as `malformed`, problem `unknown_encoding`."
                            },
                            "skipPreflight": {
                              "type": "boolean",
                              "default": true,
                              "description": "`false` simulates on Supanode's RPC infrastructure provider before sending. Solana RPC defaults to `false`; SWQoS does not."
                            },
                            "preflightCommitment": {
                              "type": "string",
                              "enum": [
                                "processed",
                                "confirmed",
                                "finalized"
                              ],
                              "default": "finalized",
                              "description": "Read only when `skipPreflight` is `false`."
                            },
                            "minContextSlot": {
                              "type": "integer",
                              "minimum": 0,
                              "description": "Passed to simulation. Read only when `skipPreflight` is `false`."
                            },
                            "maxRetries": {
                              "type": "integer",
                              "minimum": 0,
                              "description": "Accepted and ignored. SWQoS does not periodically resubmit."
                            },
                            "tip": {
                              "type": "integer",
                              "minimum": 0,
                              "description": "A [declared tip](/account/billing#declared-tips) in lamports. Used when the transaction's own tip is below your minimum and your key may declare tips. Partner keys reject this option even when the transaction already pays a tip."
                            }
                          },
                          "description": "Optional. Fields not listed are ignored. A listed field of the wrong type is refused as `invalid_request`, problem `invalid_options`."
                        }
                      ]
                    }
                  }
                }
              },
              "examples": {
                "standard": {
                  "summary": "Standard",
                  "value": {
                    "jsonrpc": "2.0",
                    "id": 1,
                    "method": "sendTransaction",
                    "params": [
                      "SIGNED_TRANSACTION",
                      {
                        "encoding": "base64"
                      }
                    ]
                  }
                },
                "preflight": {
                  "summary": "With preflight",
                  "description": "Simulates before sending. Read `error.data` for structured refusals and simulation logs.",
                  "value": {
                    "jsonrpc": "2.0",
                    "id": 1,
                    "method": "sendTransaction",
                    "params": [
                      "SIGNED_TRANSACTION",
                      {
                        "encoding": "base64",
                        "skipPreflight": false,
                        "preflightCommitment": "confirmed"
                      }
                    ]
                  }
                },
                "declared-tip": {
                  "summary": "With a declared tip",
                  "description": "Requires declared tips enabled for your key and enough [credit](/account/billing#declared-tips). Replace the example `tip` with your positive safe-integer amount in lamports.",
                  "value": {
                    "jsonrpc": "2.0",
                    "id": 1,
                    "method": "sendTransaction",
                    "params": [
                      "SIGNED_TRANSACTION",
                      {
                        "encoding": "base64",
                        "tip": 1000000
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns the transaction's first signature in base58. Confirm landing through your Solana RPC provider. A [duplicate](https://supanode.xyz/docs/solana/sender/confirmation#duplicates) can return the same signature without being sent again.\n\nRefusals with HTTP 200, by `error.data.reason`:\n\n- [`invalid_request`](https://supanode.xyz/docs/solana/sender/reference/errors#invalid_request): invalid call; `problem` names the cause.\n- [`malformed`](https://supanode.xyz/docs/solana/sender/reference/errors#malformed): invalid transaction, tip sum overflow (`tip_overflow`) or paid tip above 2 SOL (`tip_too_large`); `problem` names the cause.\n- [`too_large`](https://supanode.xyz/docs/solana/sender/reference/errors#too_large): size limit exceeded; `limit` and `size` are bytes.\n- [`unsigned`](https://supanode.xyz/docs/solana/sender/reference/errors#unsigned): first signature is all zeros.\n- [`signature_count`](https://supanode.xyz/docs/solana/sender/reference/errors#signature_count): signatures do not match required signers.\n- [`missing_tip`](https://supanode.xyz/docs/solana/sender/reference/errors#missing_tip): tip below the minimum without a usable declaration.\n- [`credit_exhausted`](https://supanode.xyz/docs/solana/sender/reference/errors#credit_exhausted): declared tip credit unavailable.\n- [`simulation_failed`](https://supanode.xyz/docs/solana/sender/reference/errors#simulation_failed): preflight returned an error; Solana's fields are in `data`.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "required": [
                        "jsonrpc",
                        "result",
                        "id"
                      ],
                      "properties": {
                        "jsonrpc": {
                          "$ref": "#/x-ext/b08d7c8/components/schemas/JsonRpcVersion"
                        },
                        "result": {
                          "type": "string",
                          "description": "The base58 encoding of the transaction's first signature."
                        },
                        "id": {
                          "$ref": "#/x-ext/b08d7c8/components/schemas/JsonRpcId"
                        }
                      },
                      "additionalProperties": false
                    },
                    {
                      "$ref": "#/x-ext/b08d7c8/components/schemas/JsonRpcErrorEnvelope"
                    }
                  ]
                },
                "examples": {
                  "Success": {
                    "summary": "Success",
                    "value": {
                      "jsonrpc": "2.0",
                      "result": "BASE58_SIGNATURE",
                      "id": 1
                    }
                  },
                  "ParseError": {
                    "$ref": "#/x-ext/b08d7c8/components/examples/ParseError"
                  },
                  "MissingTip": {
                    "$ref": "#/x-ext/b08d7c8/components/examples/MissingTip"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/x-ext/b08d7c8/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/x-ext/b08d7c8/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/x-ext/b08d7c8/components/responses/PartnerDeclaredTipsForbidden"
          },
          "421": {
            "$ref": "#/x-ext/b08d7c8/components/responses/MisdirectedRequest"
          },
          "429": {
            "$ref": "#/x-ext/b08d7c8/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/x-ext/b08d7c8/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "rust",
            "id": "rust",
            "label": "Rust",
            "source": "// Builds on the example project (https://supanode.xyz/docs/solana/sender/reference/json-rpc#example-project).\nuse base64::{Engine, prelude::BASE64_STANDARD};\nuse serde_json::json;\nuse solana_transaction::versioned::VersionedTransaction;\nuse swqos_examples::swqos::{Result, call, required};\n\n#[tokio::main]\nasync fn main() -> Result<()> {\n    // A fully signed transaction in wire format, from your signing flow.\n    let bytes = tokio::fs::read(required(\"SIGNED_TX_FILE\")?).await?;\n    let transaction: VersionedTransaction = wincode::deserialize(&bytes)?;\n    let signature: String = call(\n        \"sendTransaction\",\n        Some(json!([\n            BASE64_STANDARD.encode(wincode::serialize(&transaction)?),\n            { \"encoding\": \"base64\" }\n        ])),\n    )\n    .await?;\n    println!(\"{signature}\");\n    Ok(())\n}"
          },
          {
            "lang": "rust",
            "id": "rust-preflight",
            "label": "Rust (preflight)",
            "source": "// Builds on the example project (https://supanode.xyz/docs/solana/sender/reference/json-rpc#example-project).\nuse base64::{Engine, prelude::BASE64_STANDARD};\nuse serde_json::json;\nuse swqos_examples::swqos::{Result, SwqosError, call, required};\n\n#[tokio::main]\nasync fn main() -> Result<()> {\n    let transaction =\n        BASE64_STANDARD.encode(tokio::fs::read(required(\"SIGNED_TX_FILE\")?).await?);\n    match call::<String>(\n        \"sendTransaction\",\n        Some(json!([\n            transaction,\n            { \"encoding\": \"base64\", \"skipPreflight\": false, \"preflightCommitment\": \"confirmed\" }\n        ])),\n    )\n    .await\n    {\n        Ok(signature) => println!(\"accepted {signature}\"),\n        Err(error) => {\n            let Some(swqos) = error.downcast_ref::<SwqosError>() else {\n                return Err(error);\n            };\n            let Some(rejection) = swqos.rejection.as_ref() else {\n                return Err(error);\n            };\n            eprintln!(\n                \"{} {} {} {}\",\n                swqos.status, rejection.reason, rejection.retryable, rejection.message\n            );\n            if rejection.reason == \"simulation_failed\"\n                && let Some(logs) = rejection.fields.get(\"logs\")\n            {\n                eprintln!(\"{logs}\");\n            }\n        }\n    }\n    Ok(())\n}"
          },
          {
            "lang": "rust",
            "id": "rust-declared-tip",
            "label": "Rust (declared tip)",
            "source": "// Builds on the example project (https://supanode.xyz/docs/solana/sender/reference/json-rpc#example-project).\nuse base64::{Engine, prelude::BASE64_STANDARD};\nuse serde_json::json;\nuse swqos_examples::swqos::{Result, call, required};\n\n#[tokio::main]\nasync fn main() -> Result<()> {\n    let transaction =\n        BASE64_STANDARD.encode(tokio::fs::read(required(\"SIGNED_TX_FILE\")?).await?);\n    let tip = required(\"DECLARED_TIP_LAMPORTS\")?\n        .parse::<u64>()\n        .map_err(|_| \"tip must be a positive safe integer\")?;\n    if tip == 0 || tip > 9_007_199_254_740_991 {\n        return Err(\"tip must be a positive safe integer\".into());\n    }\n    let signature: String = call(\n        \"sendTransaction\",\n        Some(json!([transaction, { \"encoding\": \"base64\", \"tip\": tip }])),\n    )\n    .await?;\n    println!(\"{signature}\");\n    Ok(())\n}"
          },
          {
            "lang": "go",
            "id": "go",
            "label": "Go",
            "source": "// Builds on the example project (https://supanode.xyz/docs/solana/sender/reference/json-rpc#example-project).\npackage swqos\n\nimport (\n\t\"context\"\n\t\"encoding/base64\"\n\t\"fmt\"\n\t\"os\"\n\n\t\"github.com/gagliardetto/solana-go\"\n)\n\nfunc SendWithSolanaGo(ctx context.Context) error {\n\t// A fully signed transaction in wire format, from your signing flow.\n\tpath, err := Required(\"SIGNED_TX_FILE\")\n\tif err != nil {\n\t\treturn err\n\t}\n\twire, err := os.ReadFile(path)\n\tif err != nil {\n\t\treturn err\n\t}\n\ttransaction, err := solana.TransactionFromBytes(wire)\n\tif err != nil {\n\t\treturn err\n\t}\n\tencoded, err := transaction.MarshalBinary()\n\tif err != nil {\n\t\treturn err\n\t}\n\tsignature, err := Call[string](ctx, \"sendTransaction\", base64.StdEncoding.EncodeToString(encoded),\n\t\tmap[string]any{\"encoding\": \"base64\"})\n\tif err != nil {\n\t\treturn err\n\t}\n\tfmt.Println(signature)\n\treturn nil\n}"
          },
          {
            "lang": "go",
            "id": "go-preflight",
            "label": "Go (preflight)",
            "source": "// Builds on the example project (https://supanode.xyz/docs/solana/sender/reference/json-rpc#example-project).\npackage swqos\n\nimport (\n\t\"context\"\n\t\"encoding/base64\"\n\t\"errors\"\n\t\"fmt\"\n\t\"os\"\n)\n\nfunc SendWithPreflight(ctx context.Context) error {\n\tpath, err := Required(\"SIGNED_TX_FILE\")\n\tif err != nil {\n\t\treturn err\n\t}\n\twire, err := os.ReadFile(path)\n\tif err != nil {\n\t\treturn err\n\t}\n\tsignature, err := Call[string](ctx, \"sendTransaction\", base64.StdEncoding.EncodeToString(wire),\n\t\tmap[string]any{\"encoding\": \"base64\", \"skipPreflight\": false, \"preflightCommitment\": \"confirmed\"})\n\tif err != nil {\n\t\tvar refusal *SwqosError\n\t\tif !errors.As(err, &refusal) || refusal.Rejection == nil {\n\t\t\treturn err\n\t\t}\n\t\trejection := refusal.Rejection\n\t\tfmt.Fprintln(os.Stderr, refusal.Status, rejection.Reason, rejection.Retryable, rejection.Message)\n\t\tif rejection.Reason == \"simulation_failed\" {\n\t\t\tfmt.Fprintln(os.Stderr, string(rejection.Fields[\"logs\"]))\n\t\t}\n\t\treturn nil\n\t}\n\tfmt.Println(\"accepted\", signature)\n\treturn nil\n}"
          },
          {
            "lang": "go",
            "id": "go-declared-tip",
            "label": "Go (declared tip)",
            "source": "// Builds on the example project (https://supanode.xyz/docs/solana/sender/reference/json-rpc#example-project).\npackage swqos\n\nimport (\n\t\"context\"\n\t\"encoding/base64\"\n\t\"errors\"\n\t\"fmt\"\n\t\"os\"\n\t\"strconv\"\n)\n\nfunc SendDeclared(ctx context.Context) error {\n\tpath, err := Required(\"SIGNED_TX_FILE\")\n\tif err != nil {\n\t\treturn err\n\t}\n\twire, err := os.ReadFile(path)\n\tif err != nil {\n\t\treturn err\n\t}\n\tvalue, err := Required(\"DECLARED_TIP_LAMPORTS\")\n\tif err != nil {\n\t\treturn err\n\t}\n\ttip, err := strconv.ParseUint(value, 10, 64)\n\tif err != nil || tip == 0 || tip > 9_007_199_254_740_991 {\n\t\treturn errors.New(\"tip must be a positive safe integer\")\n\t}\n\tsignature, err := Call[string](ctx, \"sendTransaction\", base64.StdEncoding.EncodeToString(wire),\n\t\tmap[string]any{\"encoding\": \"base64\", \"tip\": tip})\n\tif err != nil {\n\t\treturn err\n\t}\n\tfmt.Println(signature)\n\treturn nil\n}"
          },
          {
            "lang": "ts",
            "id": "ts-declared-tip",
            "label": "TypeScript (declared tip)",
            "source": "// Builds on the example project (https://supanode.xyz/docs/solana/sender/reference/json-rpc#example-project).\nimport { readFile } from 'node:fs/promises'\nimport { call, required } from './swqos.ts'\n\nconst transaction = (await readFile(required('SIGNED_TX_FILE'))).toString('base64')\nconst tip = Number(required('DECLARED_TIP_LAMPORTS'))\nif (!Number.isSafeInteger(tip) || tip <= 0) throw new Error('tip must be a positive safe integer')\nconst signature = await call<string>('sendTransaction', [\n  transaction,\n  { encoding: 'base64', tip },\n])\nconsole.log(signature)"
          },
          {
            "lang": "ts",
            "id": "ts",
            "label": "TypeScript",
            "source": "// Builds on the example project (https://supanode.xyz/docs/solana/sender/reference/json-rpc#example-project).\nimport { readFile } from 'node:fs/promises'\nimport {\n  createSolanaRpc,\n  getBase64EncodedWireTransaction,\n  getTransactionDecoder,\n} from '@solana/kit'\nimport { required, url } from './swqos.ts'\n\n// A fully signed transaction in wire format, from your signing flow.\nconst transaction = getTransactionDecoder().decode(await readFile(required('SIGNED_TX_FILE')))\n\nconst swqos = createSolanaRpc(url, { headers: { 'x-api-key': required('SWQOS_API_KEY') } })\nconst signature = await swqos\n  .sendTransaction(getBase64EncodedWireTransaction(transaction), { encoding: 'base64' })\n  .send()\nconsole.log(signature)"
          },
          {
            "lang": "ts",
            "id": "ts-preflight",
            "label": "TypeScript (preflight)",
            "source": "// Builds on the example project (https://supanode.xyz/docs/solana/sender/reference/json-rpc#example-project).\nimport { readFile } from 'node:fs/promises'\nimport { call, required, SwqosError } from './swqos.ts'\n\nconst transaction = (await readFile(required('SIGNED_TX_FILE'))).toString('base64')\n\ntry {\n  const signature = await call<string>('sendTransaction', [\n    transaction,\n    { encoding: 'base64', skipPreflight: false, preflightCommitment: 'confirmed' },\n  ])\n  console.log('accepted', signature)\n} catch (error) {\n  if (!(error instanceof SwqosError) || !error.rejection) throw error\n  const { reason, retryable, message } = error.rejection\n  console.error(error.status, reason, retryable, message)\n  if (reason === 'simulation_failed') console.error(error.rejection.logs)\n}"
          }
        ]
      }
    }
  },
  "x-ext": {
    "b08d7c8": {
      "components": {
        "schemas": {
          "Rejection": {
            "type": "object",
            "required": [
              "reason",
              "message",
              "retryable"
            ],
            "properties": {
              "reason": {
                "type": "string",
                "description": "Stable snake_case reason. Match on this; `message` wording can change, and the numeric codes are shared with Solana's RPC.",
                "examples": [
                  "missing_tip"
                ]
              },
              "message": {
                "type": "string",
                "description": "What happened and what to change. Wording can change.",
                "examples": [
                  "tip too small: the tip transfers add up to 123 lamports, the minimum is 1,000,000; raise the transfer to one of the tip accounts to at least 1,000,000 lamports"
                ]
              },
              "retryable": {
                "type": "boolean",
                "description": "Whether the unchanged request can succeed later. Wait before retrying, and check that the transaction has not expired.",
                "examples": [
                  false
                ]
              },
              "docs": {
                "type": "string",
                "format": "uri",
                "description": "Optional error documentation URL followed by the reason anchor. Supanode endpoints omit this field.",
                "examples": [
                  "https://supanode.xyz/docs/solana/sender/reference/errors#missing_tip"
                ]
              }
            },
            "additionalProperties": true,
            "description": "Reason-specific fields are included alongside these members, such as minimum, found, declared, available, unpaid_lamports, index, per_second and retry_after_ms. Failed preflight also includes Solana simulation fields such as err, logs and unitsConsumed.",
            "examples": [
              {
                "reason": "missing_tip",
                "minimum": 1000000,
                "found": 123,
                "message": "tip too small: the tip transfers add up to 123 lamports, the minimum is 1,000,000; raise the transfer to one of the tip accounts to at least 1,000,000 lamports",
                "retryable": false,
                "docs": "https://supanode.xyz/docs/solana/sender/reference/errors#missing_tip"
              }
            ]
          },
          "JsonRpcVersion": {
            "type": "string",
            "enum": [
              "2.0"
            ],
            "examples": [
              "2.0"
            ]
          },
          "JsonRpcError": {
            "type": "object",
            "required": [
              "code",
              "message",
              "data"
            ],
            "properties": {
              "code": {
                "type": "integer",
                "enum": [
                  -32700,
                  -32600,
                  -32601,
                  -32602,
                  -32603,
                  -32000,
                  -32001,
                  -32002,
                  -32003
                ],
                "description": "[Status codes](https://supanode.xyz/docs/solana/sender/reference/json-rpc#status-codes) maps reasons and problems to codes. Match on `data.reason`.",
                "examples": [
                  -32602
                ]
              },
              "message": {
                "type": "string",
                "description": "The same sentence as data.message."
              },
              "data": {
                "$ref": "#/x-ext/b08d7c8/components/schemas/Rejection"
              }
            },
            "additionalProperties": false
          },
          "JsonRpcId": {
            "type": [
              "string",
              "number",
              "null"
            ],
            "description": "Optional request id, echoed exactly in the response. Null when absent or refused before the id could be read.",
            "examples": [
              1,
              "request-1",
              null
            ]
          },
          "JsonRpcErrorEnvelope": {
            "type": "object",
            "required": [
              "jsonrpc",
              "error",
              "id"
            ],
            "properties": {
              "jsonrpc": {
                "$ref": "#/x-ext/b08d7c8/components/schemas/JsonRpcVersion"
              },
              "error": {
                "$ref": "#/x-ext/b08d7c8/components/schemas/JsonRpcError"
              },
              "id": {
                "$ref": "#/x-ext/b08d7c8/components/schemas/JsonRpcId"
              }
            },
            "additionalProperties": false
          }
        },
        "securitySchemes": {
          "apiKeyHeader": {
            "type": "apiKey",
            "in": "header",
            "name": "x-api-key",
            "description": "Send the SWQoS API key in this header. See the [authentication reference](https://supanode.xyz/docs/solana/sender/reference/json-rpc#authentication) for compatibility forms and precedence."
          },
          "apiKeyQuery": {
            "type": "apiKey",
            "in": "query",
            "name": "api-key",
            "description": "Compatibility authentication. See the [authentication reference](https://supanode.xyz/docs/solana/sender/reference/json-rpc#authentication) for precedence and the URL logging warning. Prefer x-api-key."
          },
          "bearer": {
            "type": "http",
            "scheme": "bearer",
            "description": "SWQoS API key sent as Authorization: Bearer YOUR_KEY. The prefix `Bearer ` is case-sensitive. Prefer x-api-key. See the [authentication reference](https://supanode.xyz/docs/solana/sender/reference/json-rpc#authentication) for precedence."
          }
        },
        "examples": {
          "ParseError": {
            "summary": "Invalid JSON",
            "value": {
              "jsonrpc": "2.0",
              "error": {
                "code": -32700,
                "message": "the body is not valid JSON",
                "data": {
                  "reason": "invalid_request",
                  "problem": "parse_error",
                  "message": "the body is not valid JSON",
                  "retryable": false,
                  "docs": "https://supanode.xyz/docs/solana/sender/reference/errors#invalid_request"
                }
              },
              "id": null
            }
          },
          "MissingTip": {
            "summary": "Missing tip",
            "value": {
              "jsonrpc": "2.0",
              "error": {
                "code": -32602,
                "message": "tip missing: add a System transfer of at least 1,000,000 lamports to a Supanode tip account, or declare a tip",
                "data": {
                  "reason": "missing_tip",
                  "minimum": 1000000,
                  "found": 0,
                  "message": "tip missing: add a System transfer of at least 1,000,000 lamports to a Supanode tip account, or declare a tip",
                  "retryable": false,
                  "docs": "https://supanode.xyz/docs/solana/sender/reference/errors#missing_tip"
                }
              },
              "id": 1
            }
          }
        },
        "responses": {
          "Unauthorized": {
            "description": "[`unauthorized`](https://supanode.xyz/docs/solana/sender/reference/errors#unauthorized): missing, unknown or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/x-ext/b08d7c8/components/schemas/JsonRpcErrorEnvelope"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "jsonrpc": "2.0",
                      "error": {
                        "code": -32000,
                        "message": "API key missing or not recognized; pass it as the api-key query parameter, an x-api-key header or Authorization: Bearer",
                        "data": {
                          "reason": "unauthorized",
                          "message": "API key missing or not recognized; pass it as the api-key query parameter, an x-api-key header or Authorization: Bearer",
                          "retryable": false,
                          "docs": "https://supanode.xyz/docs/solana/sender/reference/errors#unauthorized"
                        }
                      },
                      "id": null
                    }
                  }
                }
              }
            }
          },
          "PaymentRequired": {
            "description": "[`payment_required`](https://supanode.xyz/docs/solana/sender/reference/errors#payment_required): sending is suspended until the overdue invoice is paid; `unpaid_lamports` is outstanding.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/x-ext/b08d7c8/components/schemas/JsonRpcErrorEnvelope"
                },
                "examples": {
                  "payment_required": {
                    "value": {
                      "jsonrpc": "2.0",
                      "error": {
                        "code": -32003,
                        "message": "The key is suspended until its overdue invoice is paid.",
                        "data": {
                          "reason": "payment_required",
                          "unpaid_lamports": 1000000,
                          "message": "The key is suspended until its overdue invoice is paid.",
                          "retryable": false,
                          "docs": "https://supanode.xyz/docs/solana/sender/reference/errors#payment_required"
                        }
                      },
                      "id": 1
                    }
                  }
                }
              }
            }
          },
          "PartnerDeclaredTipsForbidden": {
            "description": "[`unsupported`](https://supanode.xyz/docs/solana/sender/reference/errors#unsupported): `feature: partner_declared_tips`; remove the declaration and send an on-chain tip to a [Supanode tip account](https://supanode.xyz/docs/solana/sender/tips#tip-accounts).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/x-ext/b08d7c8/components/schemas/JsonRpcErrorEnvelope"
                },
                "examples": {
                  "partner_declared_tips": {
                    "value": {
                      "jsonrpc": "2.0",
                      "error": {
                        "code": -32601,
                        "message": "declared tips are not available for this key; send an on-chain tip to a Supanode tip account",
                        "data": {
                          "reason": "unsupported",
                          "feature": "partner_declared_tips",
                          "message": "declared tips are not available for this key; send an on-chain tip to a Supanode tip account",
                          "retryable": false,
                          "docs": "https://supanode.xyz/docs/solana/sender/reference/errors#unsupported"
                        }
                      },
                      "id": 1
                    }
                  }
                }
              }
            }
          },
          "MisdirectedRequest": {
            "description": "Unknown or removed TLS SNI or HTTP Host/:authority. Returns plain text without a JSON-RPC envelope or rejection object. The current hostname policy also applies to existing connections and resumed TLS sessions.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "examples": {
                  "UnknownHost": {
                    "value": "This hostname is not served here. Check the endpoint address"
                  }
                }
              }
            }
          },
          "RateLimited": {
            "description": "[`rate_limited`](https://supanode.xyz/docs/solana/sender/reference/errors#rate_limited): over the send rate, with `per_second` and `retry_after_ms`, or, without numbers, while a request with the same signature is still being processed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/x-ext/b08d7c8/components/schemas/JsonRpcErrorEnvelope"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "jsonrpc": "2.0",
                      "error": {
                        "code": -32001,
                        "message": "rate limited: too many transactions from this key; retry shortly",
                        "data": {
                          "reason": "rate_limited",
                          "limit": "transactions",
                          "message": "rate limited: too many transactions from this key; retry shortly",
                          "retryable": true,
                          "docs": "https://supanode.xyz/docs/solana/sender/reference/errors#rate_limited"
                        }
                      },
                      "id": 1
                    }
                  }
                }
              }
            }
          },
          "Unavailable": {
            "description": "Submission is temporarily unavailable.\n- [`not_ready`](https://supanode.xyz/docs/solana/sender/reference/errors#not_ready): waiting for `tip_vaults`, `declared_tips` or `leader_route`.\n- [`preflight_unavailable`](https://supanode.xyz/docs/solana/sender/reference/errors#preflight_unavailable): simulation unavailable.\n- [`overloaded`](https://supanode.xyz/docs/solana/sender/reference/errors#overloaded): edge temporarily busy.\n- [`forward_failed`](https://supanode.xyz/docs/solana/sender/reference/errors#forward_failed): transaction could not be dispatched.\n- [`internal`](https://supanode.xyz/docs/solana/sender/reference/errors#internal): internal error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/x-ext/b08d7c8/components/schemas/JsonRpcErrorEnvelope"
                },
                "examples": {
                  "not_ready": {
                    "value": {
                      "jsonrpc": "2.0",
                      "error": {
                        "code": -32603,
                        "message": "the region is not ready to send yet; retry in a moment",
                        "data": {
                          "reason": "not_ready",
                          "waiting_for": "leader_route",
                          "message": "the region is not ready to send yet; retry in a moment",
                          "retryable": true,
                          "docs": "https://supanode.xyz/docs/solana/sender/reference/errors#not_ready"
                        }
                      },
                      "id": 1
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
