docs: 0.23.x stable installs, transferInterface owner+authority, drop manual V2

- Replace @beta SDK installs with ^0.23.0; CLI installs without @beta dist-tag
- Add sdk-install-0.23.0.mdx; remove beta-tagged SDK snippet
- Update transferInterface and createTransferInterfaceInstructions examples (delegate: delegatePubkey)
- Remove Force V2 featureFlags from Anchor TS snippets; refresh migration-v1-to-v2 guidance

Made-with: Cursor

Author: SwenSchaeferjohann

api-reference/solana-to-light-comparison.mdx

@@ -549,6 +549,7 @@ const tx = await transferInterface(
   sourceAta,
   mint,
   recipient,
+  owner.publicKey,
   owner,
   amount
 );
@@ -913,11 +914,9 @@ const tx = await transferInterface(
   sourceAta,
   mint,
   recipient,
+  owner.publicKey,
   delegate,
-  amount,
-  undefined,
-  undefined,
-  { owner: owner.publicKey }
+  amount
 );
 ```
 ```typescript title="SPL"

light-token/payments/spend-permissions.mdx

@@ -41,7 +41,7 @@ When you approve a delegate, you're authorizing a specific account to transfer t
     <tr>
       <td>**Delegated Transfer**</td>
       <td>transfer() (delegate signs)</td>
-      <td>transferInterface({ owner })</td>
+      <td>transferInterface(..., ownerPubkey, delegateSigner, ...)</td>
     </tr>
     <tr>
       <td>**Revoke**</td>
@@ -124,7 +124,7 @@ console.log("Delegated amount:", account.parsed.delegatedAmount.toString());
 
 Once approved, the delegate can transfer tokens on behalf of the owner. The delegate is the transaction authority. Only the delegate and fee payer sign; the owner's signature is not required.
 
-`transferInterface` takes a recipient wallet address and creates the recipient's associated token account internally. Pass `{ owner }` to transfer as a delegate instead of the owner.
+`transferInterface` takes a recipient wallet address and creates the recipient's associated token account internally. For delegated transfers, pass the **source token-account owner** as **`owner`** (pubkey) and the **delegate** as **`authority`** (signer). Do not use removed **`InterfaceOptions.owner`** — there is no `{ owner: ... }` options bag for this flow.
 
 ```typescript
 import { transferInterface } from "@lightprotocol/compressed-token/unified";
@@ -135,11 +135,9 @@ const tx = await transferInterface(
   senderAta,
   mint,
   recipient.publicKey,   // recipient wallet (associated token account created internally)
+  owner.publicKey,       // source account owner (does not sign)
   delegate,              // delegate authority (signer)
-  200_000,               // must be within approved cap
-  undefined,
-  undefined,
-  { owner: owner.publicKey }  // owner (does not sign)
+  200_000               // must be within approved cap
 );
 
 console.log("Delegated transfer:", tx);
@@ -153,7 +151,7 @@ console.log("Delegated transfer:", tx);
 
 <Accordion title="Instruction-level builder">
 
-`createTransferInterfaceInstructions` returns `TransactionInstruction[][]` for manual transaction control. Pass `owner` to transfer as a delegate.
+`createTransferInterfaceInstructions` returns `TransactionInstruction[][]` for manual transaction control. Pass the **token-account owner** pubkey as the flat **`owner`** argument; for delegate-signed transactions, set **`options.delegatePubkey`**.
 
 ```typescript
 import {
@@ -167,10 +165,10 @@ const instructions = await createTransferInterfaceInstructions(
   payer.publicKey,
   mint,
   200_000,
-  delegate.publicKey,
+  owner.publicKey,
   recipient.publicKey,
   9, // decimals
-  { owner: owner.publicKey }
+  { delegatePubkey: delegate.publicKey }
 );
 
 for (const ixs of instructions) {

light-token/wallets/overview.mdx

@@ -248,7 +248,16 @@ import {
 const sourceAta = getAssociatedTokenAddressInterface(mint, owner.publicKey);
 
 // Handles loading, creates recipient ATA, transfers.
-await transferInterface(rpc, payer, sourceAta, mint, recipient, owner, amount);
+await transferInterface(
+  rpc,
+  payer,
+  sourceAta,
+  mint,
+  recipient,
+  owner.publicKey,
+  owner,
+  amount
+);
 ```
 
 <Accordion title="Compare to SPL">

pda/compressed-pdas/nullifier-pda.mdx

@@ -46,7 +46,7 @@ light-client = "0.23.0"
 <Tab title="TS">
 
 ```bash
-npm install @lightprotocol/nullifier-program @lightprotocol/stateless.js@beta
+npm install @lightprotocol/nullifier-program @lightprotocol/stateless.js@^0.23.0
 ```
 
 </Tab>

resources/migration-v1-to-v2.mdx

@@ -242,20 +242,14 @@ import {
     deriveAddressSeedV2,
     batchAddressTree,
     PackedAccounts,
-    featureFlags,
-    VERSION,
 } from "@lightprotocol/stateless.js";
 ```
 
-### Enable v2 mode
+### V2 mode (TypeScript)
 
-Set the feature flag before making any calls:
+Published **`@lightprotocol/stateless.js@^0.23.0`** defaults to **V2** — you do **not** need to set **`LIGHT_PROTOCOL_VERSION=V2`** in application code.
 
-```typescript
-import { featureFlags, VERSION } from "@lightprotocol/stateless.js";
-
-(featureFlags as any).version = VERSION.V2;
-```
+If you **build `stateless.js` from source** and need V1 artifacts, set **`LIGHT_PROTOCOL_VERSION=V1`** for that build. For rare runtime overrides in custom bundles, you can still assign **`featureFlags.version`** before other imports run (advanced; prefer matching published versions instead).
 
 ### Update address derivation
 

snippets/ai-prompts/toolkits/nullifiers.mdx

@@ -46,7 +46,7 @@ Key APIs:
 
 ### 5. Implement
 - For Rust: Bash \`cargo add light-nullifier-program@0.1 light-client@0.23\`
-- For TypeScript: Bash \`npm install @lightprotocol/nullifier-program @lightprotocol/stateless.js@beta\`
+- For TypeScript: Bash \`npm install @lightprotocol/nullifier-program @lightprotocol/stateless.js@^0.23.0\`
 - Follow the guide and the approved plan
 - Write/Edit to create or modify files
 - TaskUpdate to mark each step done
@@ -111,7 +111,7 @@ Key APIs:
 
 ### 5. Implement
 - For Rust: Bash `cargo add light-nullifier-program@0.1 light-client@0.23`
-- For TypeScript: Bash `npm install @lightprotocol/nullifier-program @lightprotocol/stateless.js@beta`
+- For TypeScript: Bash `npm install @lightprotocol/nullifier-program @lightprotocol/stateless.js@^0.23.0`
 - Follow the guide and the approved plan
 - Write/Edit to create or modify files
 - TaskUpdate to mark each step done

snippets/ai-prompts/toolkits/payments.mdx

@@ -18,7 +18,7 @@ SPL → Light Token API mapping:
 | Operation    | SPL                               | Light Token                              |
 | Receive      | getOrCreateAssociatedTokenAccount() | createLoadAtaInstructions() / loadAta()  |
 | Transfer     | createTransferInstruction()        | createTransferInterfaceInstructions()    |
-| Delegated Transfer | transfer() (delegate signs)  | transferInterface({ owner })             |
+| Delegated Transfer | transfer() (delegate signs)  | transferInterface(..., ownerPubkey, delegateSigner, ...) |
 | Get Balance  | getAccount()                      | getAtaInterface()                        |
 | Tx History   | getSignaturesForAddress()         | getSignaturesForOwnerInterface()         |
 | Wrap SPL     | N/A                               | createWrapInstruction() / wrap()         |
@@ -123,7 +123,7 @@ SPL → Light Token API mapping:
 | Operation    | SPL                               | Light Token                              |
 | Receive      | getOrCreateAssociatedTokenAccount() | createLoadAtaInstructions() / loadAta()  |
 | Transfer     | createTransferInstruction()        | createTransferInterfaceInstructions()    |
-| Delegated Transfer | transfer() (delegate signs)  | transferInterface({ owner })             |
+| Delegated Transfer | transfer() (delegate signs)  | transferInterface(..., ownerPubkey, delegateSigner, ...) |
 | Get Balance  | getAccount()                      | getAtaInterface()                        |
 | Tx History   | getSignaturesForAddress()         | getSignaturesForOwnerInterface()         |
 | Wrap SPL     | N/A                               | createWrapInstruction() / wrap()         |

snippets/ai-prompts/ts-cookbook/transfer-interface.mdx

@@ -13,6 +13,7 @@ Context:
 - Packages: @lightprotocol/compressed-token, @lightprotocol/stateless.js
 
 transferInterface() transfers tokens in a single call. The recipient parameter is a wallet public key.
+Pass the source token-account owner pubkey and the signing authority separately: owner-signed flows use (owner.publicKey, owner); delegated flows use (owner.publicKey, delegate). Do not use removed InterfaceOptions.owner.
 The SDK derives and creates the destination ATA internally. All transfers use transferChecked under the hood.
 - Light Token → Light Token: transfers between Light Token accounts
 - SPL → Light Token: locks SPL tokens in interface PDA, mints to Light Token account
@@ -76,6 +77,7 @@ Context:
 - Packages: @lightprotocol/compressed-token, @lightprotocol/stateless.js
 
 transferInterface() transfers tokens in a single call. The recipient parameter is a wallet public key.
+Pass the source token-account owner pubkey and the signing authority separately: owner-signed flows use (owner.publicKey, owner); delegated flows use (owner.publicKey, delegate). Do not use removed InterfaceOptions.owner.
 The SDK derives and creates the destination ATA internally. All transfers use transferChecked under the hood.
 - Light Token → Light Token: transfers between Light Token accounts
 - SPL → Light Token: locks SPL tokens in interface PDA, mints to Light Token account

snippets/code-snippets/burn/typescript-client.mdx

@@ -15,16 +15,11 @@ import {
   Rpc,
   sleep,
   SystemAccountMetaConfig,
-  featureFlags,
-  VERSION,
   selectStateTreeInfo,
   TreeInfo,
 } from "@lightprotocol/stateless.js";
 import * as assert from "assert";
 
-// Force V2 mode
-(featureFlags as any).version = VERSION.V2;
-
 const path = require("path");
 const os = require("os");
 require("dotenv").config();

snippets/code-snippets/close/typescript-client.mdx

@@ -15,16 +15,11 @@ import {
   Rpc,
   sleep,
   SystemAccountMetaConfig,
-  featureFlags,
-  VERSION,
   selectStateTreeInfo,
   TreeInfo,
 } from "@lightprotocol/stateless.js";
 import * as assert from "assert";
 
-// Force V2 mode
-(featureFlags as any).version = VERSION.V2;
-
 const path = require("path");
 const os = require("os");
 require("dotenv").config();