# /lightspeed

{% hint style="info" %}
A minimum tip of 0.001 SOL (1,000,000 lamports) is required for this endpoint.
{% endhint %}

## Lightspeed Transactions

> Submits a signed transaction with priority processing through the Lightspeed  validator network. This endpoint provides accelerated transaction landing times  through a tip-based priority system.\
> \
> \*\*Requirements:\*\*\
> 1\. Transaction must include a system transfer instruction sending at least  0.001 SOL (1,000,000 lamports) to one of the Lightspeed tip addresses\
> 2\. Must set \`skipPreflight: true\` in the configuration options\
> 3\. Transaction must be fully signed and serialized\
> \
> \*\*Lightspeed Tip Addresses:\*\*\
> \- \`svsMoWJBwLcs8JgfN8VaF111tAc199KpYeTKRwxRtip\`\
> \
> \*\*Keep-Alive:\*\*\
> Use the \`getHealth\` RPC call to maintain your connection to the Lightspeed endpoint.<br>

````json
{"openapi":"3.0.3","info":{"title":"Solana RPC API - Lightspeed Transactions","version":"1.0.0"},"tags":[{"name":"Lightspeed Transaction Processing","description":"Accelerated transaction submission through the Lightspeed validator network. \nThis tip-based priority system provides faster transaction landing times by \nrouting transactions through a large pool of validators.\n\n**Key Features:**\n- Minimum tip: 0.001 SOL (1,000,000 lamports)\n- Larger tips = faster processing under higher load\n- Available on all RPC and SWQoS tiers\n- Requires skipPreflight: true\n\n**Implementation Examples:** \nhttps://github.com/Solana-Vibe-Station/lightspeed-examples\n\n**Real-time Metrics:**\nhttps://discord.com/channels/1241508519190986752/1316576906962796574\n"}],"servers":[{"url":"https://basic.rpc.solanavibestation.com/lightspeed","description":"Basic RPC Tier with Lightspeed"},{"url":"https://ultra.rpc.solanavibestation.com/lightspeed","description":"Ultra RPC Tier with Lightspeed"},{"url":"https://elite.rpc.solanavibestation.com/lightspeed","description":"Elite RPC Tier with Lightspeed"},{"url":"https://epic.rpc.solanavibestation.com/lightspeed","description":"Epic RPC Tier with Lightspeed"},{"url":"https://basic.swqos.solanavibestation.com/lightspeed","description":"Basic SWQoS Tier with Lightspeed"},{"url":"https://ultra.swqos.solanavibestation.com/lightspeed","description":"Ultra SWQoS Tier with Lightspeed"},{"url":"https://elite.swqos.solanavibestation.com/lightspeed","description":"Elite SWQoS Tier with Lightspeed"}],"security":[{"AuthHeader":[]},{"URLParameter":[]}],"components":{"securitySchemes":{"AuthHeader":{"type":"apiKey","in":"header","name":"Authorization","description":"Authorization header for API key authentication.\n\n**Example:**\n```\nAuthorization: your-api-key-here\n```\n"},"URLParameter":{"type":"apiKey","in":"query","name":"api_key","description":"API key passed as a URL parameter for authentication.\n\n**Example:**\n```\nhttps://basic.swqos.solanavibestation.com/lightspeed?api_key=your-api-key-here\n```\n"}},"schemas":{"LightspeedSendTransactionRequest":{"type":"object","required":["jsonrpc","id","method","params"],"properties":{"jsonrpc":{"type":"string","description":"JSON-RPC protocol version","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Request identifier that will be returned in the response"},"method":{"type":"string","description":"The RPC method name (always \"sendTransaction\" for Lightspeed)","enum":["sendTransaction"]},"params":{"type":"array","description":"Method parameters for Lightspeed transactions:\n\n1. Signed transaction data (base58 or base64 encoded string) containing:\n   - Your transaction instructions\n   - A system transfer instruction of at least 0.001 SOL to a Lightspeed tip address\n\n2. Configuration object (required) with skipPreflight set to true\n","minItems":2,"maxItems":2,"items":{"oneOf":[{"type":"string","description":"Fully signed transaction data (base58 or base64 encoded) that MUST include  a system transfer instruction sending at least 0.001 SOL (1,000,000 lamports)  to one of the Lightspeed tip addresses: - svsMoWJBwLcs8JgfN8VaF111tAc199KpYeTKRwxRtip\n"},{"$ref":"#/components/schemas/LightspeedSendTransactionOptions"}]}}}},"LightspeedSendTransactionOptions":{"type":"object","description":"Configuration options for Lightspeed transaction requests.\n**IMPORTANT:** The `skipPreflight` parameter MUST be set to `true` for all  Lightspeed transactions. This is a mandatory requirement for the service.\n","required":["skipPreflight"],"properties":{"encoding":{"type":"string","description":"Encoding format used for the transaction data:\n- `base58`: Default encoding format, compact and human-readable - `base64`: Alternative encoding format, more efficient for large transactions\n","enum":["base58","base64"],"default":"base58"},"skipPreflight":{"type":"boolean","description":"**REQUIRED: Must be set to true for Lightspeed transactions.**\nLightspeed requires skipping preflight checks to maximize transaction  processing speed. The tip-based priority system and validator network  handle transaction validation and processing efficiently.\n","enum":[true],"default":true},"maxRetries":{"type":"integer","description":"Maximum number of times for the RPC node to retry sending the transaction to the leader. For Lightspeed, it's recommended to set  this to 0 to prevent duplicate submissions with multiple tips.\n","minimum":0,"maximum":10,"default":0},"minContextSlot":{"type":"integer","description":"Set the minimum slot that the request can be evaluated at. This can be useful for ensuring consistency when making multiple related requests.\n","minimum":0}}},"LightspeedSendTransactionResponse":{"type":"object","description":"RPC response containing the transaction signature or error information","required":["jsonrpc","id"],"properties":{"jsonrpc":{"type":"string","description":"JSON-RPC protocol version","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Request identifier matching the original request"},"result":{"type":"string","description":"Transaction signature (base58 encoded) that uniquely identifies the submitted transaction. This signature can be used to track the transaction status and retrieve transaction details. Lightspeed transactions typically land faster than standard transactions.\n","pattern":"^[1-9A-HJ-NP-Za-km-z]{87,88}$"},"error":{"$ref":"#/components/schemas/RpcError"}}},"RpcError":{"type":"object","description":"Standard JSON-RPC error object with Lightspeed-specific error codes","required":["code","message"],"properties":{"code":{"type":"integer","description":"Numeric error code following JSON-RPC 2.0 specification:\n- `-32700`: Parse error\n- `-32600`: Invalid request  \n- `-32601`: Method not found\n- `-32602`: Invalid params\n- `-32603`: Internal error\n- `-32005`: Too Many Requests\n- `-32003`: Transaction validation failure (tip-related or signature issues)\n"},"message":{"type":"string","description":"Human-readable error message"},"data":{"type":"object","description":"Additional structured error information containing specific transaction failure details. For Lightspeed transactions, this may include: - InsufficientTipAmount: Tip is below the required minimum - MissingTipInstruction: No tip transfer instruction found - InsufficientFundsForFee: Account lacks funds for transaction + tip - SignatureFailure: Invalid transaction signature\n","additionalProperties":true,"properties":{"err":{"type":"string","description":"Specific error type that caused the transaction to fail","enum":["InsufficientTipAmount","MissingTipInstruction","InsufficientFundsForFee","SignatureFailure"]},"details":{"type":"string","description":"Additional human-readable details about the error"}}}}}}},"paths":{"/":{"post":{"summary":"Lightspeed Transactions","description":"Submits a signed transaction with priority processing through the Lightspeed  validator network. This endpoint provides accelerated transaction landing times  through a tip-based priority system.\n\n**Requirements:**\n1. Transaction must include a system transfer instruction sending at least  0.001 SOL (1,000,000 lamports) to one of the Lightspeed tip addresses\n2. Must set `skipPreflight: true` in the configuration options\n3. Transaction must be fully signed and serialized\n\n**Lightspeed Tip Addresses:**\n- `svsMoWJBwLcs8JgfN8VaF111tAc199KpYeTKRwxRtip`\n\n**Keep-Alive:**\nUse the `getHealth` RPC call to maintain your connection to the Lightspeed endpoint.\n","operationId":"lightspeedSendTransaction","tags":["Lightspeed Transaction Processing"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LightspeedSendTransactionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LightspeedSendTransactionResponse"}}}},"401":{"description":"Unauthorized","content":{"text/plain":{"schema":{"type":"string"}}}},"403":{"description":"Forbidden","content":{"text/plain":{"schema":{"type":"string"}}}},"429":{"description":"Too Many Requests","content":{"text/plain":{"schema":{"type":"string"}}}},"500":{"description":"Internal Server Error","content":{"text/plain":{"schema":{"type":"string"}}}}}}}}}
````