chore: update docs

cspell.json

@@ -188,7 +188,12 @@
     "jito",
     "Jito",
     "Offramp",
-    "offramp"
+    "offramp",
+    "offramps",
+    "zkcompression",
+    "ZKCompression",
+    "Tasktool",
+    "clippy"
   ],
   "ignorePaths": [
     "node_modules",

light-token/defi/programs.mdx

@@ -3,7 +3,7 @@
 description: "Build high-performance DeFi programs with rent-free accounts"
 ---
 
 The Light-SDK pays rent-exemption for your PDAs, token accounts, and mints (98%
 cost savings). Your program logic stays the same.
 
 ## What Changes
@@ -271,7 +271,7 @@
 </Accordion>
 
 ## Step 5: Instructions
 Replace `spl_token` with `light_token` instructions as you need. The API is a superset of SPL-token so switching is straightforward.
 
 Examples include: `MintToCpi`, `TransferCpi`, `TransferInterfaceCpi`,
 `CreateTokenAccountCpi`, and `CreateTokenAtaCpi`.
@@ -488,7 +488,7 @@
 The SDK pays the rent-exemption cost. Inactive (cold) accounts auto-compress. Your program only ever interacts with hot accounts. 
 Clients can load cold accounts back when needed via `create_load_instructions`.
 
 Under the hood, clients use `AccountInterface` - a superset of Solana's `Account` that unifies hot and cold state. See [Router Integration](./routers) for details.
 
 | | Hot (active) | Cold (inactive) |
 |---|---|---|
@@ -512,10 +512,12 @@
 attacks, even if the account is currently cold. </Accordion>
 
 <Accordion title="Who triggers compression?"> Miners automatically compress when
-virtual rent is below threshold (eg 24h without write bump). </Accordion>
+virtual rent is below threshold (e.g., multiple epochs without any writes). In
+practice, cold markets should be rare. The common path (hot) has no extra
+overhead and does not increase CU or txn size. </Accordion>
 
 <Accordion title="Can active pools get compressed?">
-No. Any write bumps the virtual rent balance. Active accounts never compress.
+No. Any write bumps the virtual rent balance. Active accounts do not get compressed.
 </Accordion>
 
 <Accordion title="Do I need to run infrastructure?"> No. Helius and Triton run

light-token/defi/routers.mdx

@@ -1,16 +1,16 @@
 ---
 title: "Router Integration"
 description: "Add support for rent-free AMMs on Solana."
 ---
 
 1. Use `get_account_interface` instead of `get_account` to store `AccountInterface`.
 2. Use the AMM's LightProgramInterface trait to dynamically prepend load
    instructions if the market is cold.
 
 
 ## Step 1: Use `get_account_interface`
 
 `get_account_interface` is a new RPC endpoint that returns a superset of
 `get_account`. `AccountInterface` stores additional info `Option<ColdContext>`
 that you will need later.
 
@@ -46,7 +46,7 @@
 This trait helps you:
 
 1. Maintain a cache of `&[AccountInterface]`
 2. Load cold accounts into the onchain account space when building Swap transactions.
 
 ```rust
 // Program implements this.
@@ -143,7 +143,7 @@
 |------|--------|---------|
 | `Rpc` trait | `light-client` | RPC client with `get_account_interface` methods |
 | `AccountInterface` | `light-client` | Unified hot/cold account type |
 | `LightProgramInterface` | `light-client` | Trait that program SDKs implement |
 | `AccountSpec` | `light-client` | Specifies account load requirements |
 
 ### Reference Implementation
@@ -164,19 +164,22 @@
 | Quote | Works | Works |
 | Swap | Direct | Load first / Bundle |
 | Latency | Normal | +0-200ms* |
 | Tx size | Normal | +100-2400 bytes*|
 | CU | Normal | +15k-400k CU*|
 
 Latency, tx size, and CU depend on the number and type of cold accounts.
 
 ### When does a market go cold?
 A market is "cold" after it has been compressed by a miner. Accounts become
-eligible for compression when inactive (e.g., after 24h without lamport bumps
-from fee payers), causing the virtual rent balance to fall below threshold.
+eligible for compression only after extended inactivity (e.g., multiple epochs
+without any writes), causing the virtual rent balance to fall below threshold.
+
+**In practice, cold markets should be rare.** The common path (hot) has no extra
+overhead and does not increase CU or txn size.
 
 **To ensure swaps execute regardless of whether the market is hot or cold,
-always prepend `create_load_instructions` to the swap transaction. This no-ops
-if the market is hot.**
+always call `create_load_instructions` when building the swap instructions. It
+simply no-ops if the market is hot.**
 
 ---
 ## Error Handling