@0block.io/sdk 0.1.0 → 0.3.0

package/dist/idl/tenantWrapper.js

@@ -1,7 +1,9 @@
 // Vendored from the tenant-wrapper build of nyx-solana-dex-router (target/idl/zeroblock_tenant_wrapper.json).
 // The instruction layout is identical for every tenant wrapper deployment; the program
 // address is per-tenant and intentionally stripped — pass wrapperProgramId at init.
-// tenant_authority is not an account: the wrapper_config PDA signs the router CPI.
+// swap: order_marker replay gate (server-authoritative non-zero order_id); the
+// wrapper_config PDA signs the router CPI; native-SOL wrap/fee-headroom/unwrap/
+// ATA-cleanup are PROGRAM-MANAGED — clients add no wSOL instructions.
 export const TENANT_WRAPPER_IDL = {
     "address": "11111111111111111111111111111111",
     "metadata": {
@@ -201,6 +203,30 @@ export const TENANT_WRAPPER_IDL = {
         },
         {
             "name": "swap",
+            "docs": [
+                "Tenant swap with a hard, exactly-once-SUCCESS replay gate (R-6 / H1).",
+                "",
+                "The `order_marker` account is created with Anchor `init` (NOT",
+                "`init_if_needed`) ATOMICALLY in this same instruction, BEFORE the router",
+                "CPI runs. A second instruction with the same `(payer, order_id)` fails at",
+                "`create_account` (\"account already in use\") and reverts the WHOLE",
+                "instruction — including the router CPI — so a duplicate business order can",
+                "never execute (and never pays fees) twice.",
+                "",
+                "INVARIANTS (off-chain encoder MUST uphold):",
+                "- `order_id` is SERVER-AUTHORITATIVE. It is minted by the backend per",
+                "business order and is NEVER a client-supplied value. A client that could",
+                "choose `order_id` could grief a victim only inside its own `payer`",
+                "namespace (see namespacing note below), but a server-authoritative id",
+                "also guarantees that all per-gate provider-variants (0block / Jito /",
+                "Helius / ...) of ONE business order reuse the SAME `(payer, order_id)`,",
+                "so at most one variant can ever succeed.",
+                "- On land-but-revert (the tx is included on-chain but the instruction",
+                "reverts for any reason), the `init` is rolled back: the marker does NOT",
+                "persist, the `order_id` is reclaimable, and the order may be retried with",
+                "a FRESH durable nonce. (Durable-nonce dedup is at-most-one-LAND; this",
+                "marker is exactly-once-SUCCESS — complementary, not redundant.)"
+            ],
             "discriminator": [
                 248,
                 198,
@@ -253,6 +279,48 @@ export const TENANT_WRAPPER_IDL = {
                         ]
                     }
                 },
+                {
+                    "name": "order_marker",
+                    "docs": [
+                        "Per-order replay marker (R-6 / H1). `init` (NOT `init_if_needed`) makes a",
+                        "duplicate `(payer, order_id)` fail at `create_account` → the whole",
+                        "instruction (router CPI included) reverts.",
+                        "",
+                        "Namespaced by `payer` for griefing isolation: a third party can only ever",
+                        "init markers inside its OWN payer namespace, so it cannot pre-burn another",
+                        "user's `order_id`.",
+                        "",
+                        "ALTERNATIVE NAMESPACING: keying by `tenant_authority` instead of `payer`",
+                        "would dedup per business tenant (so the same logical order is unique across",
+                        "all of a tenant's relayer payers). We choose `payer` here because the RAX",
+                        "flow has one user-payer per order and `payer`-namespacing gives the",
+                        "strongest third-party griefing isolation; revisit if a single business",
+                        "order can legitimately arrive under multiple distinct payers."
+                    ],
+                    "writable": true,
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const",
+                                "value": [
+                                    111,
+                                    114,
+                                    100,
+                                    101,
+                                    114
+                                ]
+                            },
+                            {
+                                "kind": "account",
+                                "path": "payer"
+                            },
+                            {
+                                "kind": "arg",
+                                "path": "order_id"
+                            }
+                        ]
+                    }
+                },
                 {
                     "name": "router_program",
                     "docs": [
@@ -263,14 +331,19 @@ export const TENANT_WRAPPER_IDL = {
                 {
                     "name": "source_token_account",
                     "docs": [
-                        "SOURCE token account (authority = payer)"
+                        "SOURCE token account (authority = payer).",
+                        "buys (Anchor deserializes typed accounts before the handler runs, which",
+                        "would reject a not-yet-existing ATA). The router CPI re-validates",
+                        "`token::mint = source_mint, token::authority = payer` on this account."
                     ],
                     "writable": true
                 },
                 {
                     "name": "destination_token_account",
                     "docs": [
-                        "DESTINATION token account (receives the swap output)"
+                        "DESTINATION token account (receives the swap output).",
+                        "M2: authority must be `payer` so output cannot be routed to an arbitrary",
+                        "same-mint account — enforced by the ROUTER's account constraints."
                     ],
                     "writable": true
                 },
@@ -283,13 +356,16 @@ export const TENANT_WRAPPER_IDL = {
                 {
                     "name": "global_cfg",
                     "docs": [
-                        "Global config (router PDA)"
+                        "Global config (router PDA; owner/discriminator checked here, PDA seeds",
+                        "re-validated by the router). Typed so the wrapper can read the 0Block",
+                        "fee bps for exact wSOL fee-headroom sizing."
                     ]
                 },
                 {
                     "name": "tenant_cfg",
                     "docs": [
-                        "Tenant config (router PDA)"
+                        "Tenant config (router PDA; owner/discriminator checked here, PDA seeds",
+                        "re-validated by the router)."
                     ]
                 },
                 {
@@ -335,7 +411,10 @@ export const TENANT_WRAPPER_IDL = {
                 },
                 {
                     "name": "system_program",
-                    "optional": true,
+                    "docs": [
+                        "REQUIRED (was optional): the `order_marker` `init` needs the System",
+                        "program, and it is also forwarded to the router for fee-ATA creation."
+                    ],
                     "address": "11111111111111111111111111111111"
                 },
                 {
@@ -363,6 +442,45 @@ export const TENANT_WRAPPER_IDL = {
         }
     ],
     "accounts": [
+        {
+            "name": "GlobalConfig",
+            "discriminator": [
+                149,
+                8,
+                156,
+                202,
+                160,
+                252,
+                176,
+                217
+            ]
+        },
+        {
+            "name": "OrderMarker",
+            "discriminator": [
+                221,
+                221,
+                169,
+                152,
+                245,
+                69,
+                110,
+                108
+            ]
+        },
+        {
+            "name": "TenantConfig",
+            "discriminator": [
+                195,
+                252,
+                97,
+                104,
+                160,
+                30,
+                231,
+                112
+            ]
+        },
         {
             "name": "TenantWrapperConfig",
             "discriminator": [
@@ -387,6 +505,31 @@ export const TENANT_WRAPPER_IDL = {
             "code": 6001,
             "name": "InvalidAdmin",
             "msg": "Admin cannot be the default pubkey"
+        },
+        {
+            "code": 6002,
+            "name": "ZeroOrderId",
+            "msg": "order_id must be non-zero"
+        },
+        {
+            "code": 6003,
+            "name": "MissingTokenProgram",
+            "msg": "token program account is required for native-SOL handling"
+        },
+        {
+            "code": 6004,
+            "name": "MissingAssociatedTokenProgram",
+            "msg": "associated token program account is required for native-SOL handling"
+        },
+        {
+            "code": 6005,
+            "name": "AmountOverflow",
+            "msg": "amount_in plus fees overflows u64"
+        },
+        {
+            "code": 6006,
+            "name": "InvalidTokenAccount",
+            "msg": "account is not a valid SPL token account"
         }
     ],
     "types": [
@@ -596,6 +739,156 @@ export const TENANT_WRAPPER_IDL = {
                 ]
             }
         },
+        {
+            "name": "GlobalConfig",
+            "serialization": "bytemuckunsafe",
+            "repr": {
+                "kind": "c"
+            },
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "bump",
+                        "docs": [
+                            "PDA bump"
+                        ],
+                        "type": "u8"
+                    },
+                    {
+                        "name": "admin",
+                        "docs": [
+                            "Program admin (controls global/tenant settings)"
+                        ],
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "zeroblock_fee_bps",
+                        "docs": [
+                            "0BLOCK platform fee default (bps out of 10_000)"
+                        ],
+                        "type": "u16"
+                    },
+                    {
+                        "name": "zeroblock_fee_vault",
+                        "docs": [
+                            "Fee authority that owns 0BLOCK fee token accounts"
+                        ],
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "paused",
+                        "docs": [
+                            "A2 (remediation-2026-07-02): global instant-halt switch. `0` = not",
+                            "paused (default; matches the zeroed tail of every already-deployed",
+                            "account), `1` = paused. Plain `u8` rather than `bool` — zero_copy/Pod",
+                            "requires every byte pattern to be valid, which `bool` does not",
+                            "guarantee. Use `is_paused()`/`set_paused()`, never the raw field."
+                        ],
+                        "type": "u8"
+                    },
+                    {
+                        "name": "spl_token_swap_allowlist",
+                        "docs": [
+                            "A1 (remediation-2026-07-02): admin-provisioned CPI-target allowlist",
+                            "for the `SplTokenSwap` (Dex=0) adapter — the router invokes",
+                            "`swap_accounts.dex_program_id` with the `0block_sa` PDA as signer on",
+                            "hop ≥ 1, so an unconstrained target is a confused-deputy sweep of any",
+                            "PDA-held funds. Unlike the other ~60 adapters this venue has no",
+                            "single hardcoded upstream program id (multiple live forks share the",
+                            "same instruction interface), so the allowed set is admin-configured",
+                            "instead of a compile-time const. Unset slots are `Pubkey::default()`",
+                            "and never match; an all-default allowlist rejects every CPI (fail",
+                            "closed) until an admin provisions it via `set_spl_token_swap_allowlist`",
+                            "(see `// TODO(remediation-2026-07-02):` in `adapters/spl_token_swap.rs`",
+                            "— provisioning real venue ids is a deploy-config/operator action, out",
+                            "of scope for this remediation pass, same as the plan's other",
+                            "\"provisioning\" items)."
+                        ],
+                        "type": {
+                            "array": [
+                                "pubkey",
+                                2
+                            ]
+                        }
+                    },
+                    {
+                        "name": "stable_swap_allowlist",
+                        "docs": [
+                            "A1 (remediation-2026-07-02): same contract as",
+                            "`spl_token_swap_allowlist`, for the `StableSwap` (Dex=1) adapter."
+                        ],
+                        "type": {
+                            "array": [
+                                "pubkey",
+                                2
+                            ]
+                        }
+                    },
+                    {
+                        "name": "padding",
+                        "docs": [
+                            "Reserved to keep struct size stable for future upgrades. Shrunk from",
+                            "the original 160 bytes by exactly the width of the fields above (see",
+                            "`REMAINING_PADDING_BYTES`) so total account size is unchanged."
+                        ],
+                        "type": {
+                            "array": [
+                                "u8",
+                                31
+                            ]
+                        }
+                    }
+                ]
+            }
+        },
+        {
+            "name": "OrderMarker",
+            "docs": [
+                "Per-order replay marker (R-6 / H1). Audit-only fields — the account's",
+                "EXISTENCE under seeds `[b\"order\", payer, order_id_le]` IS the dedup signal."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "order_id",
+                        "docs": [
+                            "The server-authoritative business order id this marker pins."
+                        ],
+                        "type": "u128"
+                    },
+                    {
+                        "name": "authority",
+                        "docs": [
+                            "The payer namespace this marker was created under (== `payer`)."
+                        ],
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "slot",
+                        "docs": [
+                            "Slot at creation (forensics only)."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "unix_timestamp",
+                        "docs": [
+                            "Unix timestamp at creation (forensics only)."
+                        ],
+                        "type": "i64"
+                    },
+                    {
+                        "name": "bump",
+                        "docs": [
+                            "PDA bump."
+                        ],
+                        "type": "u8"
+                    }
+                ]
+            }
+        },
         {
             "name": "Route",
             "type": {
@@ -707,6 +1000,78 @@ export const TENANT_WRAPPER_IDL = {
                 ]
             }
         },
+        {
+            "name": "TenantConfig",
+            "docs": [
+                "----------------------------------------------------------------------------",
+                "TenantConfig (+ strict wrapper enforcement)",
+                "----------------------------------------------------------------------------"
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "bump",
+                        "type": "u8"
+                    },
+                    {
+                        "name": "tenant_authority",
+                        "docs": [
+                            "Signer (EOA or PDA) authorized to act for this tenant"
+                        ],
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "tenant_wrapper_program",
+                        "docs": [
+                            "Wrapper program id used to validate tenant-mode calls."
+                        ],
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "zeroblock_fee_bps",
+                        "docs": [
+                            "0BLOCK fee (bps out of 10_000) for this tenant. Use 0 to fall back to global default."
+                        ],
+                        "type": "u16"
+                    },
+                    {
+                        "name": "tenant_fee_vault",
+                        "docs": [
+                            "Fee authority that owns tenant fee token accounts"
+                        ],
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "whitelisted",
+                        "docs": [
+                            "Whether this tenant is active/whitelisted"
+                        ],
+                        "type": "bool"
+                    },
+                    {
+                        "name": "max_total_fee_bps",
+                        "docs": [
+                            "Optional per-tenant cap: (tenant_fee_bps + zeroblock_fee_bps) must be <= this if > 0.",
+                            "tenant_fee_bps is supplied per swap."
+                        ],
+                        "type": "u16"
+                    },
+                    {
+                        "name": "_reserved",
+                        "docs": [
+                            "Reserved for upgrades (fixed size)"
+                        ],
+                        "type": {
+                            "array": [
+                                "u8",
+                                64
+                            ]
+                        }
+                    }
+                ]
+            }
+        },
         {
             "name": "TenantWrapperConfig",
             "type": {

package/dist/index.d.ts

@@ -1,14 +1,15 @@
 export * from "./constants.js";
 export * from "./types.js";
 export { createContext, type CreateContextParams, type TenantInit, type ZeroBlockContext, } from "./context.js";
-export { toPk, deriveAta, deriveWrapperConfig, deriveRouterGlobalConfig, deriveRouterTenantConfig, derivePumpfunGlobal, derivePumpfunBondingCurve, derivePumpfunBondingCurveV2, derivePumpfunEventAuthority, derivePumpfunCreatorVault, derivePumpfunGlobalVolumeAccumulator, derivePumpfunUserVolumeAccumulator, derivePumpfunFeeConfig, } from "./pda.js";
+export { buildSendTransactionRequest, createLandingClient, withLandingTip, type LandingClient, type LandingServiceConfig, type SendTransactionOptions, } from "./landing.js";
+export { toPk, deriveAta, deriveOrderMarker, deriveWrapperConfig, deriveRouterGlobalConfig, deriveRouterTenantConfig, derivePumpfunGlobal, derivePumpfunBondingCurve, derivePumpfunBondingCurveV2, derivePumpfunEventAuthority, derivePumpfunCreatorVault, derivePumpfunGlobalVolumeAccumulator, derivePumpfunUserVolumeAccumulator, derivePumpfunFeeConfig, } from "./pda.js";
 export { type AccountFetcher, connectionFetcher, resolveTokenProgram, resolvePumpfunMarketContext, fetchPumpfunGlobalFeeRecipient, fetchPumpfunBondingCurveCreator, fetchPumpfunBuybackFeeRecipients, } from "./fetch.js";
 export { buildPumpfunRemainingAccounts, type PumpfunRemainingAccountsParams, } from "./venues/pumpfun.js";
 export { buildPumpfunSwapInstruction, decodeSwapData, randomOrderId, resolveFeeMint, type SwapInstructionResult, } from "./swap.js";
 export { buildTipInstruction, maskTipAccountInTables } from "./tip.js";
 export { buildComputeBudgetInstructions } from "./computeBudget.js";
 export { createAtaIdempotentInstruction, syncNativeInstruction, closeAccountInstruction, wrapSolInstructions, unwrapWsolInstruction, } from "./wsol.js";
-export { buildPumpfunSwapTransaction, serializeWithSignatures, toLookupTableAccount, } from "./transaction.js";
+export { buildPumpfunSwapTransaction, serializeWithSignatures, buildSubmitTemplate, toLookupTableAccount, type SubmitTemplate, } from "./transaction.js";
 export { buildLookupTableAddresses, buildInitLookupTableInstructions, type InitLookupTableResult, } from "./alt.js";
 export { applyPreset, slippagePctToBps, solToLamports, type PresetSwapInputs, type PresetSwapOutputs, } from "./presets.js";
 export { decodeSwapResultEvents } from "./events.js";

package/dist/index.js

@@ -1,25 +1,28 @@
-// @0block/sdk — browser-first transaction builder for the 0Block DEX router.
+// @0block.io/sdk — SDK for 0Block's two independent products:
 //
-// Initialize with createContext(): pass a tenant (wrapper program + fee vault)
-// to route through that tenant's wrapper, or nothing to invoke the 0Block
-// router directly with 0Block fee accounts.
+//   1. DEX SMART ROUTER — build swap transactions (tenant-wrapped or direct).
+//      createContext, applyPreset, buildPumpfunSwapTransaction,
+//      resolvePumpfunMarketContext, ALT helpers, decodeSwapResultEvents.
 //
-// Split of responsibilities:
-//   server-side (near an RPC):  resolvePumpfunMarketContext, buildLookupTableAddresses,
-//                               buildInitLookupTableInstructions
-//   client-side (fully offline): createContext, applyPreset, buildPumpfunSwapTransaction
-//   indexer-side:                decodeSwapResultEvents
+//   2. LANDING SERVICE — land ANY fully-signed Solana transaction (tip-gated
+//      submission to staked infra + leader TPUs). createLandingClient,
+//      withLandingTip, buildTipInstruction, maskTipAccountInTables.
+//
+// Neither depends on the other: router transactions can be submitted through
+// any RPC, and the landing service accepts any transaction. They compose
+// naturally when used together.
 export * from "./constants.js";
 export * from "./types.js";
 export { createContext, } from "./context.js";
-export { toPk, deriveAta, deriveWrapperConfig, deriveRouterGlobalConfig, deriveRouterTenantConfig, derivePumpfunGlobal, derivePumpfunBondingCurve, derivePumpfunBondingCurveV2, derivePumpfunEventAuthority, derivePumpfunCreatorVault, derivePumpfunGlobalVolumeAccumulator, derivePumpfunUserVolumeAccumulator, derivePumpfunFeeConfig, } from "./pda.js";
+export { buildSendTransactionRequest, createLandingClient, withLandingTip, } from "./landing.js";
+export { toPk, deriveAta, deriveOrderMarker, deriveWrapperConfig, deriveRouterGlobalConfig, deriveRouterTenantConfig, derivePumpfunGlobal, derivePumpfunBondingCurve, derivePumpfunBondingCurveV2, derivePumpfunEventAuthority, derivePumpfunCreatorVault, derivePumpfunGlobalVolumeAccumulator, derivePumpfunUserVolumeAccumulator, derivePumpfunFeeConfig, } from "./pda.js";
 export { connectionFetcher, resolveTokenProgram, resolvePumpfunMarketContext, fetchPumpfunGlobalFeeRecipient, fetchPumpfunBondingCurveCreator, fetchPumpfunBuybackFeeRecipients, } from "./fetch.js";
 export { buildPumpfunRemainingAccounts, } from "./venues/pumpfun.js";
 export { buildPumpfunSwapInstruction, decodeSwapData, randomOrderId, resolveFeeMint, } from "./swap.js";
 export { buildTipInstruction, maskTipAccountInTables } from "./tip.js";
 export { buildComputeBudgetInstructions } from "./computeBudget.js";
 export { createAtaIdempotentInstruction, syncNativeInstruction, closeAccountInstruction, wrapSolInstructions, unwrapWsolInstruction, } from "./wsol.js";
-export { buildPumpfunSwapTransaction, serializeWithSignatures, toLookupTableAccount, } from "./transaction.js";
+export { buildPumpfunSwapTransaction, serializeWithSignatures, buildSubmitTemplate, toLookupTableAccount, } from "./transaction.js";
 export { buildLookupTableAddresses, buildInitLookupTableInstructions, } from "./alt.js";
 export { applyPreset, slippagePctToBps, solToLamports, } from "./presets.js";
 export { decodeSwapResultEvents } from "./events.js";

package/dist/landing.d.ts

@@ -0,0 +1,66 @@
+import * as web3 from "@solana/web3.js";
+import type { Address, TipParams } from "./types.js";
+/**
+ * 0Block Landing service — a standalone product, independent of the DEX
+ * router. It lands ANY fully-signed Solana transaction: JSON-RPC
+ * `sendTransaction` gated by a tip transfer, forwarded to staked
+ * infrastructure and current/next leader TPUs.
+ *
+ * Contract (independent of what the transaction does):
+ *  - include a SystemProgram transfer ≥ the minimum tip to an allowlisted tip
+ *    account, kept as a STATIC message key (never behind an address lookup
+ *    table — the service verifies raw bytes; see maskTipAccountInTables),
+ *  - use a FINALIZED blockhash (the service submits via different nodes than
+ *    the one you read from),
+ *  - confirm by polling: the service does not serve websockets.
+ */
+export interface LandingServiceConfig {
+    /** Landing service endpoint, e.g. "https://gateway.0block.io". */
+    url: string;
+    /** API key, sent as X-API-Key. */
+    apiKey?: string;
+    /** Injectable fetch (testing / non-standard runtimes). Defaults to global fetch. */
+    fetchImpl?: typeof fetch;
+}
+export interface SendTransactionOptions {
+    /**
+     * Skip the upstream's preflight simulation (default true — the low-latency
+     * path; a still-propagating blockhash can fail simulation spuriously).
+     */
+    skipPreflight?: boolean;
+}
+/** The exact HTTP request the Landing service expects (pure; useful for tests and custom transports). */
+export declare function buildSendTransactionRequest(config: Pick<LandingServiceConfig, "url" | "apiKey">, wireTransaction: Uint8Array, options?: SendTransactionOptions): {
+    url: string;
+    method: "POST";
+    headers: Record<string, string>;
+    body: string;
+};
+/**
+ * Prepend the landing tip to an instruction list for ANY transaction (router
+ * swap or otherwise). The swap builder does this internally when given `tip`;
+ * use this for arbitrary transactions you land through the service.
+ */
+export declare function withLandingTip(instructions: web3.TransactionInstruction[], payer: Address, tip: TipParams | {
+    account: Address;
+    lamports?: bigint;
+}): web3.TransactionInstruction[];
+export interface LandingClient {
+    /** Submit wire bytes (fully signed). Resolves to the transaction signature (submission ack, NOT confirmation). */
+    sendTransaction(wireTransaction: Uint8Array, options?: SendTransactionOptions): Promise<string>;
+    /**
+     * Submit, then poll the given read connection until the signature confirms,
+     * errors, or the blockhash lapses. The read RPC is separate from the
+     * landing endpoint by design.
+     */
+    submitAndConfirm(wireTransaction: Uint8Array, readConnection: web3.Connection, params: {
+        lastValidBlockHeight: number;
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+    }, options?: SendTransactionOptions): Promise<{
+        signature: string;
+        slot: number;
+    }>;
+}
+/** Client for the Landing service. Usable with or without the DEX router. */
+export declare function createLandingClient(config: LandingServiceConfig): LandingClient;

package/dist/landing.js

@@ -0,0 +1,78 @@
+import { DEFAULT_TIP_LAMPORTS } from "./constants.js";
+import { buildTipInstruction } from "./tip.js";
+import { toPk } from "./pda.js";
+/** The exact HTTP request the Landing service expects (pure; useful for tests and custom transports). */
+export function buildSendTransactionRequest(config, wireTransaction, options) {
+    const headers = { "Content-Type": "application/json" };
+    if (config.apiKey)
+        headers["X-API-Key"] = config.apiKey;
+    return {
+        url: config.url,
+        method: "POST",
+        headers,
+        body: JSON.stringify({
+            jsonrpc: "2.0",
+            id: 1,
+            method: "sendTransaction",
+            params: [
+                Buffer.from(wireTransaction).toString("base64"),
+                { encoding: "base64", skipPreflight: options?.skipPreflight ?? true },
+            ],
+        }),
+    };
+}
+/**
+ * Prepend the landing tip to an instruction list for ANY transaction (router
+ * swap or otherwise). The swap builder does this internally when given `tip`;
+ * use this for arbitrary transactions you land through the service.
+ */
+export function withLandingTip(instructions, payer, tip) {
+    const lamports = tip.lamports ?? DEFAULT_TIP_LAMPORTS;
+    return [
+        buildTipInstruction(toPk(payer), { account: tip.account, lamports }),
+        ...instructions,
+    ];
+}
+/** Client for the Landing service. Usable with or without the DEX router. */
+export function createLandingClient(config) {
+    const fetchImpl = config.fetchImpl ?? fetch;
+    async function sendTransaction(wireTransaction, options) {
+        const req = buildSendTransactionRequest(config, wireTransaction, options);
+        const res = await fetchImpl(req.url, {
+            method: req.method,
+            headers: req.headers,
+            body: req.body,
+        });
+        const body = (await res.json().catch(() => ({})));
+        if (body.error) {
+            throw new Error(`landing service rejected the transaction (HTTP ${res.status}): ${JSON.stringify(body.error)}`);
+        }
+        if (!body.result) {
+            throw new Error(`unexpected landing service response (HTTP ${res.status}): ${JSON.stringify(body)}`);
+        }
+        return body.result;
+    }
+    async function submitAndConfirm(wireTransaction, readConnection, params, options) {
+        const signature = await sendTransaction(wireTransaction, options);
+        const timeoutMs = params.timeoutMs ?? 90_000;
+        const pollIntervalMs = params.pollIntervalMs ?? 1_000;
+        const deadline = Date.now() + timeoutMs;
+        for (;;) {
+            const { value } = await readConnection.getSignatureStatuses([signature]);
+            const status = value?.[0];
+            if (status &&
+                (status.confirmationStatus === "confirmed" || status.confirmationStatus === "finalized")) {
+                if (status.err) {
+                    throw new Error(`transaction landed but FAILED on-chain: ${JSON.stringify(status.err)} (${signature})`);
+                }
+                return { signature, slot: status.slot };
+            }
+            const height = await readConnection.getBlockHeight("confirmed");
+            if (height > params.lastValidBlockHeight || Date.now() > deadline) {
+                throw new Error(`transaction expired without confirming (${signature})`);
+            }
+            await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+        }
+    }
+    return { sendTransaction, submitAndConfirm };
+}