{
  "openapi": "3.2.0",
  "info": {
    "title": "sendBundle",
    "version": "1",
    "description": "Submit one to four signed transactions as one bundle for delivery through block engines."
  },
  "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": "sendBundle",
        "summary": "sendBundle",
        "description": "Submit one to four signed transactions as one bundle for delivery through block engines.",
        "requestBody": {
          "required": true,
          "description": "One JSON object using the [shared request conventions](https://supanode.xyz/docs/solana/sender/reference/json-rpc#request). Submit one to four fully signed transactions in execution order, each with a distinct first signature. Each member must meet the size limits; the bundle must satisfy the [tip](https://supanode.xyz/docs/solana/sender/tips) and [rate](https://supanode.xyz/docs/solana/sender/limits#send-rate) rules. Bundles have no preflight simulation.\n\n### Control accounts\n\nSWQoS recognizes these base58 address prefixes among a transaction's static keys:\n\n| Control | Recognized when |\n| --- | --- |\n| `jitodontfront` | Any static account address starts with it, or the first account of the first Compute Budget instruction starts with it |\n| `dontfront` | The first account of the first Compute Budget instruction starts with it |\n| `dontbund1e` | The first account of the first Compute Budget instruction starts with it |\n\nA transaction carrying any recognized control must be first, and at most one member may carry controls. With `dontbund1e`, later members may call only the System, Compute Budget and Memo programs.\n\nA violation returns [`bundle_control`](https://supanode.xyz/docs/solana/sender/reference/errors#bundle_control) with a zero based `index` and a `rule` of `first_only`, `one_only` or `default_programs_only`. Controls can narrow which engines can accept the bundle and raise the minimum tip. SWQoS checks them at admission only; they do not govern transactions submitted outside your bundle.",
          "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": [
                      "sendBundle"
                    ]
                  },
                  "params": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 2,
                    "description": "The array of transactions followed by optional options.",
                    "prefixItems": [
                      {
                        "title": "Transactions",
                        "type": "array",
                        "minItems": 1,
                        "maxItems": 4,
                        "items": {
                          "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."
                        },
                        "description": "One to four fully signed wire transactions in execution order, with a distinct first signature per member."
                      },
                      {
                        "title": "Options",
                        "type": "object",
                        "properties": {
                          "encoding": {
                            "type": "string",
                            "enum": [
                              "base58",
                              "base64"
                            ],
                            "default": "base58",
                            "description": "Encoding used for every transaction of the bundle."
                          },
                          "tip": {
                            "type": "integer",
                            "minimum": 0,
                            "description": "One [declared tip](/account/billing#declared-tips) in lamports for the whole bundle. Used when the bundle's own tips are below your minimum and your key may declare tips. Partner keys reject this option even when the bundle already pays a tip."
                          }
                        },
                        "description": "Optional. Other fields, including `skipPreflight`, are ignored. Bundles are never simulated."
                      }
                    ],
                    "items": {
                      "anyOf": [
                        {
                          "title": "Transactions",
                          "type": "array",
                          "minItems": 1,
                          "maxItems": 4,
                          "items": {
                            "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."
                          },
                          "description": "One to four fully signed wire transactions in execution order, with a distinct first signature per member."
                        },
                        {
                          "title": "Options",
                          "type": "object",
                          "properties": {
                            "encoding": {
                              "type": "string",
                              "enum": [
                                "base58",
                                "base64"
                              ],
                              "default": "base58",
                              "description": "Encoding used for every transaction of the bundle."
                            },
                            "tip": {
                              "type": "integer",
                              "minimum": 0,
                              "description": "One [declared tip](/account/billing#declared-tips) in lamports for the whole bundle. Used when the bundle's own tips are below your minimum and your key may declare tips. Partner keys reject this option even when the bundle already pays a tip."
                            }
                          },
                          "description": "Optional. Other fields, including `skipPreflight`, are ignored. Bundles are never simulated."
                        }
                      ]
                    }
                  }
                }
              },
              "examples": {
                "Request": {
                  "value": {
                    "jsonrpc": "2.0",
                    "id": 1,
                    "method": "sendBundle",
                    "params": [
                      [
                        "SIGNED_TRANSACTION_1",
                        "SIGNED_TRANSACTION_2"
                      ],
                      {
                        "encoding": "base64"
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns a 64 character lowercase hex bundle ID after accepting the bundle for delivery. Confirm each signature through your Solana RPC provider. SWQoS has no bundle status method, and its bundle ID cannot query a block engine's status.\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.\n- [`bundle_size`](https://supanode.xyz/docs/solana/sender/reference/errors#bundle_size): outside 1 to 4 transactions; `count` and `limit`.\n- [`malformed`](https://supanode.xyz/docs/solana/sender/reference/errors#malformed): invalid member, repeated signature (`duplicate_signature`), tip sum overflow (`tip_overflow`) or paid tip above 2 SOL (`tip_too_large`); `index` identifies a repeated or invalid member.\n- [`too_large`](https://supanode.xyz/docs/solana/sender/reference/errors#too_large): member exceeds a size limit; `index` identifies it.\n- [`unsigned`](https://supanode.xyz/docs/solana/sender/reference/errors#unsigned): member is unsigned; `index` identifies it.\n- [`signature_count`](https://supanode.xyz/docs/solana/sender/reference/errors#signature_count): member signature mismatch; `index` identifies it.\n- [`bundle_control`](https://supanode.xyz/docs/solana/sender/reference/errors#bundle_control): control account rule broken; `index` and `rule`.\n- [`missing_tip`](https://supanode.xyz/docs/solana/sender/reference/errors#missing_tip): below your or the engine minimum; `minimum` applies.\n- [`credit_exhausted`](https://supanode.xyz/docs/solana/sender/reference/errors#credit_exhausted): declared tip credit unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "required": [
                        "jsonrpc",
                        "result",
                        "id"
                      ],
                      "properties": {
                        "jsonrpc": {
                          "$ref": "#/x-ext/b08d7c8/components/schemas/JsonRpcVersion"
                        },
                        "result": {
                          "type": "string",
                          "minLength": 64,
                          "maxLength": 64,
                          "pattern": "^[0-9a-f]{64}$",
                          "description": "SHA-256 of the members' first signatures, concatenated in order as raw 64-byte values. Not a block engine's status id."
                        },
                        "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": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
                      "id": 1
                    }
                  },
                  "MissingTip": {
                    "$ref": "#/x-ext/b08d7c8/components/examples/MissingTip"
                  },
                  "BundleSize": {
                    "summary": "Bundle size",
                    "value": {
                      "jsonrpc": "2.0",
                      "error": {
                        "code": -32602,
                        "message": "Submit between one and four transactions.",
                        "data": {
                          "reason": "bundle_size",
                          "count": 0,
                          "limit": 4,
                          "message": "Submit between one and four transactions.",
                          "retryable": false,
                          "docs": "https://supanode.xyz/docs/solana/sender/reference/errors#bundle_size"
                        }
                      },
                      "id": 1
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/x-ext/b08d7c8/components/responses/Unauthorized"
          },
          "402": {
            "$ref": "#/x-ext/b08d7c8/components/responses/PaymentRequired"
          },
          "403": {
            "$ref": "#/x-ext/b08d7c8/components/responses/BundlesForbidden"
          },
          "421": {
            "$ref": "#/x-ext/b08d7c8/components/responses/MisdirectedRequest"
          },
          "429": {
            "$ref": "#/x-ext/b08d7c8/components/responses/BundleRateLimited"
          },
          "503": {
            "$ref": "#/x-ext/b08d7c8/components/responses/BundleUnavailable"
          }
        },
        "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 swqos_examples::swqos::{Result, SwqosError, call};\n\n#[tokio::main]\nasync fn main() -> Result<()> {\n    let mut transactions = Vec::new();\n    for file in std::env::args().skip(1) {\n        transactions.push(BASE64_STANDARD.encode(tokio::fs::read(file).await?));\n    }\n    match call::<String>(\n        \"sendBundle\",\n        Some(json!([transactions, { \"encoding\": \"base64\" }])),\n    )\n    .await\n    {\n        Ok(bundle_id) => println!(\"accepted {bundle_id}\"),\n        Err(error) => {\n            let rejection = error\n                .downcast_ref::<SwqosError>()\n                .and_then(|error| error.rejection.as_ref());\n            if let Some(rejection) = rejection {\n                eprintln!(\"{} {}\", rejection.reason, rejection.message);\n            } else {\n                return Err(error);\n            }\n        }\n    }\n    Ok(())\n}"
          },
          {
            "lang": "rust",
            "id": "rust-bundle-id",
            "label": "Rust (bundle ID)",
            "source": "// Builds on the example project (https://supanode.xyz/docs/solana/sender/reference/json-rpc#example-project).\nuse std::fmt::Write;\n\nuse sha2::{Digest, Sha256};\nuse solana_transaction::versioned::VersionedTransaction;\n\nuse crate::swqos::Result;\n\npub fn bundle_id(wire_transactions: &[Vec<u8>]) -> Result<String> {\n    let mut hash = Sha256::new();\n    for wire in wire_transactions {\n        let transaction: VersionedTransaction = wincode::deserialize(wire)?;\n        let signature = transaction\n            .signatures\n            .first()\n            .ok_or(\"transaction has no signature\")?;\n        hash.update(signature.as_ref());\n    }\n    let mut id = String::with_capacity(64);\n    for byte in hash.finalize() {\n        write!(&mut id, \"{byte:02x}\")?;\n    }\n    Ok(id)\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\"errors\"\n\t\"fmt\"\n\t\"os\"\n)\n\nfunc SendBundle(ctx context.Context) error {\n\ttransactions := make([]string, 0, len(os.Args)-1)\n\tfor _, file := range os.Args[1:] {\n\t\twire, err := os.ReadFile(file)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\ttransactions = append(transactions, base64.StdEncoding.EncodeToString(wire))\n\t}\n\tbundleID, err := Call[string](ctx, \"sendBundle\", transactions, map[string]any{\"encoding\": \"base64\"})\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\tfmt.Fprintln(os.Stderr, refusal.Rejection.Reason, refusal.Rejection.Message)\n\t\treturn nil\n\t}\n\tfmt.Println(\"accepted\", bundleID)\n\treturn nil\n}"
          },
          {
            "lang": "go",
            "id": "go-bundle-id",
            "label": "Go (bundle ID)",
            "source": "package swqos\n\nimport (\n\t\"crypto/sha256\"\n\t\"encoding/hex\"\n\t\"errors\"\n\n\t\"github.com/gagliardetto/solana-go\"\n)\n\nfunc BundleID(wireTransactions [][]byte) (string, error) {\n\thash := sha256.New()\n\tfor _, wire := range wireTransactions {\n\t\ttransaction, err := solana.TransactionFromBytes(wire)\n\t\tif err != nil {\n\t\t\treturn \"\", err\n\t\t}\n\t\tif len(transaction.Signatures) == 0 {\n\t\t\treturn \"\", errors.New(\"transaction has no first signature\")\n\t\t}\n\t\t_, _ = hash.Write(transaction.Signatures[0][:])\n\t}\n\treturn hex.EncodeToString(hash.Sum(nil)), nil\n}"
          },
          {
            "lang": "ts",
            "id": "ts-bundle-id",
            "label": "TypeScript (bundle ID)",
            "source": "import { createHash } from 'node:crypto'\nimport {\n  getBase58Encoder,\n  getSignatureFromTransaction,\n  getTransactionDecoder,\n} from '@solana/kit'\n\nexport function bundleId(wireTransactions: Uint8Array[]): string {\n  const hash = createHash('sha256')\n  for (const wire of wireTransactions) {\n    const signature = getSignatureFromTransaction(getTransactionDecoder().decode(wire))\n    hash.update(Uint8Array.from(getBase58Encoder().encode(signature)))\n  }\n  return hash.digest('hex')\n}"
          },
          {
            "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 { call, SwqosError } from './swqos.ts'\n\nconst files = process.argv.slice(2)\nconst transactions = await Promise.all(\n  files.map(async (file) => (await readFile(file)).toString('base64')),\n)\n\ntry {\n  const bundleId = await call<string>('sendBundle', [transactions, { encoding: 'base64' }])\n  console.log('accepted', bundleId)\n} catch (error) {\n  if (!(error instanceof SwqosError) || !error.rejection) throw error\n  console.error(error.rejection.reason, error.rejection.message)\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": {
          "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
                    }
                  }
                }
              }
            }
          },
          "BundlesForbidden": {
            "description": "[`unsupported`](https://supanode.xyz/docs/solana/sender/reference/errors#unsupported): `feature: bundles` when bundles are disabled, or `feature: partner_declared_tips` when a partner key declares a tip.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/x-ext/b08d7c8/components/schemas/JsonRpcErrorEnvelope"
                },
                "examples": {
                  "unsupported": {
                    "value": {
                      "jsonrpc": "2.0",
                      "error": {
                        "code": -32601,
                        "message": "bundles are not enabled for this key; ask Supanode to enable them",
                        "data": {
                          "reason": "unsupported",
                          "feature": "bundles",
                          "message": "bundles are not enabled for this key; ask Supanode to enable them",
                          "retryable": false,
                          "docs": "https://supanode.xyz/docs/solana/sender/reference/errors#unsupported"
                        }
                      },
                      "id": 1
                    }
                  },
                  "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"
                  }
                }
              }
            }
          },
          "BundleRateLimited": {
            "description": "[`rate_limited`](https://supanode.xyz/docs/solana/sender/reference/errors#rate_limited): `limit: bundles`; over your key's [bundle rate](https://supanode.xyz/docs/solana/sender/bundles#rates). Wait for `retry_after_ms` when supplied. If the edge cannot take another bundle, it returns this reason without `per_second` or `retry_after_ms`.",
            "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 bundles from this key; retry shortly",
                        "data": {
                          "reason": "rate_limited",
                          "limit": "bundles",
                          "message": "rate limited: too many bundles from this key; retry shortly",
                          "retryable": true,
                          "docs": "https://supanode.xyz/docs/solana/sender/reference/errors#rate_limited"
                        }
                      },
                      "id": 1
                    }
                  }
                }
              }
            }
          },
          "BundleUnavailable": {
            "description": "Wait and retry while the signed transactions remain valid. Do not submit members separately if they must execute together.\n- [`not_ready`](https://supanode.xyz/docs/solana/sender/reference/errors#not_ready): waiting for `block_engine`, `blockhash`, `tip_vaults` or `declared_tips`.\n- [`overloaded`](https://supanode.xyz/docs/solana/sender/reference/errors#overloaded): edge temporarily busy.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/x-ext/b08d7c8/components/schemas/JsonRpcErrorEnvelope"
                },
                "examples": {
                  "not_ready": {
                    "value": {
                      "jsonrpc": "2.0",
                      "error": {
                        "code": -32603,
                        "message": "No block engine can take bundles right now; retry while the signed transactions remain valid.",
                        "data": {
                          "reason": "not_ready",
                          "waiting_for": "block_engine",
                          "message": "No block engine can take bundles right now; retry while the signed transactions remain valid.",
                          "retryable": true,
                          "docs": "https://supanode.xyz/docs/solana/sender/reference/errors#not_ready"
                        }
                      },
                      "id": 1
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
