@cloak.dev/sdk 0.2.2 → 0.2.3-staging.f2d7f2a

package/README.md

@@ -5,13 +5,13 @@ per-mint pool, send privately inside the pool, withdraw to any address, or swap
 USDC/USDT with the output landing in a public token account. Groth16 proofs are generated
 client-side (snarkjs) and verified on-chain by the Cloak program.
 
-Version 0.2.0 targets the mainnet program deployed on 2026-08-24 and the ceremony-frozen
+Version 0.2.3 targets the mainnet program deployed on 2026-08-24 and the ceremony-frozen
 `cloak-transaction-0.2.0` circuit bundle. See [Version and compatibility](#version-and-compatibility).
 
 ## Installation
 
 ```bash
-npm install @cloak.dev/sdk@^0.2.0 @solana/web3.js
+npm install @cloak.dev/sdk@^0.2.3 @solana/web3.js
 # swaps and SPL pools also need:
 npm install @solana/spl-token
 ```
@@ -376,8 +376,11 @@ await transact(
 ```
 
 Minimum SPL deposit is 1.00 token. SOL deposits fit in a single v0 packet with the production
-lookup table; SPL deposits currently still create a small supplemental lookup table
-(about 0.0056 SOL rent, reclaimable by the depositor).
+lookup table; SPL deposits by default create a small depositor-signed supplemental lookup table
+(about 0.0056 SOL rent, reclaimable by the depositor), which costs a second wallet signature. Set
+`relaySupplementalAlt: true` in `TransactOptions` to ask the relay to extend its own shared lookup
+table instead, cutting an SPL deposit to one signature; off by default, and any relay-side failure
+falls back automatically to the depositor-signed path above with no caller action needed.
 
 ### Shielded swap (SOL to USDC/USDT)
 
@@ -565,7 +568,7 @@ Deposits and private sends carry no protocol fee.
 A withdrawal or swap must exceed its fee or the program rejects it; deposits below the minimum are
 rejected with `DepositTooSmall`.
 
-`shared/fees.ts` mirrors the SOL pool for estimates in the UI:
+`src/shared/fees.ts` mirrors the SOL pool for estimates in the UI:
 
 ```ts
 import { calculateFeeBigint, getDistributableAmount, isWithdrawAmountSufficient } from "@cloak.dev/sdk";
@@ -577,7 +580,8 @@ isWithdrawAmountSufficient(6_000_000n);  // true: 0.006 SOL covers the 0.005018
 
 For USDC/USDT compute `450_000n + amount * 3n / 1000n`. Treat these as estimates: the deployed
 `PoolConfig` is the source of truth. Solana transaction fees and, for SPL deposits, the supplemental
-lookup-table rent are separate.
+lookup-table rent are separate (see `relaySupplementalAlt` under [SPL pools](#spl-pools-usdc-usdt)
+for cutting that rent's signature cost).
 
 ## Circuit artifacts
 
@@ -623,12 +627,15 @@ relay endpoint and the localhost-RPC check.
 
 ## Version and compatibility
 
-- SDK 0.2.0 pairs with the mainnet program at `zh1eLd6rSphLejbFfJEneUwzHRfMKxgzrgkfwA6qRkW`
-  (deployed 2026-08-24) and the 0.2.0 circuit bundle. All flows in this README were exercised on
+- SDK 0.2.3 pairs with the mainnet program at `zh1eLd6rSphLejbFfJEneUwzHRfMKxgzrgkfwA6qRkW`
+  (deployed 2026-08-24) and the 0.2.0 circuit bundle — the program and circuit bundle are unchanged
+  since 0.2.0; only the SDK package version has moved. All flows in this README were exercised on
   mainnet on 2026-08-25: deposit, private send and withdraw on SOL, USDC and USDT; swaps SOL to
   USDC and USDT; viewing-key discovery followed by a spend; keypair-only deposit recovery.
+- 0.2.2 adds the opt-in `TransactOptions.relaySupplementalAlt` (see [SPL pools](#spl-pools-usdc-usdt)):
+  off by default, and existing behavior is unchanged when it is left unset.
 - Proofs generated with the 0.1.x circuits are rejected by the mainnet program. SDK 0.1.x builds
-  (which ship the 0.1.0 bundle) are not usable against it; upgrade to 0.2.0.
+  (which ship the 0.1.0 bundle) are not usable against it; upgrade to 0.2.x.
 - The note-based `CloakSDK` class is removed in 0.2.0. It targeted the pre-0.2.0 instruction layout
   and the unpublished 0.1.0 `withdraw_*` circuits, so it could not work against the current program.
   Use the UTXO API above: `transact`, `transfer`, `partialWithdraw`, `fullWithdraw`, `swapUtxo`.
@@ -712,8 +719,7 @@ npm run test:examples  # dry-run the examples
 ```
 
 Notes: `docs/DEPOSIT-SIZE-NOTES.md` (deposit transaction size, confirmed-tree reads,
-supplemental lookup tables), `docs/transact-split.md` (how `flows/transact.ts` is split),
-`docs/cleanup-plan.md` (the root/scripts/examples cleanup this repo is executing).
+supplemental lookup tables), `docs/transact-split.md` (how `flows/transact.ts` is split).
 
 ## Links