chore: backport breaking api changes to v1 js SDKs (#1661)

* stateless.js add treeinfos

* wip

* add getTokenPoolInfos

* wip

* wip

* wip - storageoptions

* wip

* wip

* wip

* wip - known bug in rpc-interop.test.ts if using random trees

* debugged test-rpc in ctoken

* all ctoken tests working

* rm logs

* clean

* ctxs to infos, removed redundant getMintProgramId calls

* rm deadcode, storageoptions

* fix cli getMindProgramId use

* fix tokenpool

* fix test

stateless.js add treeinfos

wip

add getTokenPoolInfos

wip

wip

wip - storageoptions

wip

wip

wip

wip - known bug in rpc-interop.test.ts if using random trees

debugged test-rpc in ctoken

all ctoken tests working

rm logs

clean

ctxs to infos, removed redundant getMintProgramId calls

rm deadcode, storageoptions

fix cli getMindProgramId use

fix tokenpool

fix test

update CHANGELOG.md files

update changelog

update CHANGELOG.md

export get-token-pool-infos.ts

wip

clean

wip

refactor merklecontext

refactor StateTreeInfo

wip

wip

debug test-rpc getCompressedTokenAccountsByOwner

fix unit test

wip

wip

wip

debug .readUIntLE

wip

wip

wip

fix buffer conversion at test-rpc decode

wip

tests working

compressedProof -> validityProof

update changelog

wip

refactor: do not allow output trees for decompress, transfer

fmt

wip

rename getCachedStateTreeInfos

upd changelog

use with getCachedStateTreeInfos

getStateTreeInfos

wip

wip

delegate test

wip

added transfer-delegated.test.ts

added transfer-delegated test cases. all green

add tests for decompress-delegated

fix

rm logs from program

update changelog

update err msg

fix state-tree-luts

wip

getActiveStateTreeInfos -> getAllStateTreeInfos

wip

fix sigs for nullifyStateTree

wip

wip

cleanup

add getCachedActiveStateTreeInfos mock

revert to compressedProof

add tokenpools tests

update comment

update CHANGELOG.md

update changelog

0.21.0

update changelog

fix

fix event parsing post rebase

stateless js refactor

dedupe types

link to computebudgetprogram

wip

fix DX for instructions: add docstrings to call signatures

wip

dont break mergeTokenAccounts

wip

wip

add v2 trees to test-rpc

v1 mergeable

test-rpc tests working

rpc-interop tests working with v2

all stateless.js tests working with v2

compressed-token tests working

Author: SwenSchaeferjohann

Cargo.lock

@@ -52,7 +52,7 @@ class CompressSplCommand extends Command {
       const toPublicKey = new PublicKey(to);
       const mintPublicKey = new PublicKey(mint);
       const payer = defaultSolanaWalletKeypair();
-      const tokenProgramId = await CompressedTokenProgram.get_mint_program_id(
+      const tokenProgramId = await CompressedTokenProgram.getMintProgramId(
         mintPublicKey,
         rpc(),
       );
@@ -75,7 +75,7 @@ class CompressSplCommand extends Command {
         toPublicKey,
         undefined,
         undefined,
-        tokenProgramId,
+        undefined,
       );
 
       loader.stop(false);

cli/src/commands/compress-spl/index.ts

@@ -52,7 +52,7 @@ class DecompressSplCommand extends Command {
       const toPublicKey = new PublicKey(to);
       const mintPublicKey = new PublicKey(mint);
       const payer = defaultSolanaWalletKeypair();
-      const tokenProgramId = await CompressedTokenProgram.get_mint_program_id(
+      const tokenProgramId = await CompressedTokenProgram.getMintProgramId(
         mintPublicKey,
         rpc(),
       );
@@ -75,9 +75,6 @@ class DecompressSplCommand extends Command {
         amount,
         payer,
         recipientAta.address,
-        undefined,
-        undefined,
-        tokenProgramId,
       );
 
       loader.stop(false);

cli/src/commands/decompress-spl/index.ts

@@ -29,7 +29,7 @@ import {
   kebabCase,
   snakeCase,
 } from "case-anything";
-import { execSync } from "child_process";
+
 export default class InitCommand extends Command {
   static description = "Initialize a compressed account project.";
 

cli/src/commands/init/index.ts

@@ -24,9 +24,9 @@ import {
     bn,
     buildTx,
     confirmTx,
-    defaultTestStateTreeAccounts,
     selectMinCompressedSolAccountsForTransfer,
     createRpc,
+    selectStateTreeInfo,
 } from '@lightprotocol/stateless.js';
 
 // Default styles that can be overridden by your app
@@ -36,7 +36,10 @@ const SendButton: FC = () => {
     const { publicKey, sendTransaction } = useWallet();
 
     const onClick = useCallback(async () => {
-        const connection = await createRpc();
+        const connection = createRpc();
+        const stateTreeInfo = selectStateTreeInfo(
+            await connection.getStateTreeInfos(),
+        );
 
         if (!publicKey) throw new WalletNotConnectedError();
 
@@ -51,7 +54,7 @@ const SendButton: FC = () => {
             payer: publicKey,
             toAddress: publicKey,
             lamports: 1e8,
-            outputStateTree: defaultTestStateTreeAccounts().merkleTree,
+            outputStateTreeInfo: stateTreeInfo,
         });
         const compressInstructions = [
             ComputeBudgetProgram.setComputeUnitLimit({ units: 1_000_000 }),
@@ -109,7 +112,6 @@ const SendButton: FC = () => {
             toAddress: recipient,
             lamports: 1e7,
             inputCompressedAccounts: selectedAccounts,
-            outputStateTrees: [defaultTestStateTreeAccounts().merkleTree],
             recentValidityProof: compressedProof,
             recentInputStateRootIndices: rootIndices,
         });

examples/browser/nextjs/src/app/page.tsx

@@ -1,3 +1,97 @@
+## [0.22.0]
+
+-   `CreateMint` action now allows passing a non-payer mint and freeze authority.
+-   More efficient computebudgets for actions.
+-   Better DX: Parameter lookup in call signatures of CompressedTokenProgram instructions
+-   QoL: improved typedocs.
+
+## [0.21.0]
+
+#### Breaking Changes
+
+This release has several breaking changes which improve protocol
+scalability. Please reach out to the [team](https://t.me/swen_light) if you need help migrating.
+
+### Migration guide: Compress
+
+**Old Code** (remove this)
+
+```typescript
+const activeStateTrees = await connection.getCachedActiveStateTreeInfo();
+const { tree } = pickRandomTreeAndQueue(activeStateTrees);
+// ...
+```
+
+**New Code**
+
+```typescript
+// ...
+const treeInfos = await rpc.getStateTreeInfos();
+const treeInfo = selectStateTreeInfo(treeInfos);
+
+const infos = await getTokenPoolInfos(rpc, mint);
+const info = selectTokenPoolInfo(infos);
+
+const compressIx = await CompressedTokenProgram.compress({
+    // ...
+    outputStateTreeInfo,
+    tokenPoolInfo,
+});
+```
+
+### Migration guide: Decompress
+
+```typescript
+// ...
+// new code:
+const infos = await getTokenPoolInfos(rpc, mint);
+const selectedInfos = selectTokenPoolInfosForDecompression(
+    tokenPoolInfos,
+    amount,
+);
+
+const ix = await CompressedTokenProgram.decompress({
+    // ...
+    tokenPoolInfos: selectedTokenPoolInfos,
+});
+```
+
+### Overview
+
+-   new type: TokenPoolInfo
+-   Instruction Changes:
+
+    -   `compress`, `mintTo`, `approveAndMintTo`, `compressSplTokenAccount` now require valid TokenPoolInfo
+    -   `decompress` now requires an array of one or more TokenPoolInfos.
+    -   `decompress`, `transfer` now do not allow state tree overrides.
+
+-   Action Changes:
+
+    -   Removed optional tokenProgramId: PublicKey
+    -   removed optional merkleTree: PublicKey
+    -   removed optional outputStateTree: PublicKey
+    -   added optional stateTreeInfo: StateTreeInfo
+    -   added optional tokenPoolInfo: TokenPoolInfo
+
+-   new instructions:
+    -   `approve`, `revoke`: delegated transfer support.
+    -   `addTokenPools`: you can now register additional token pool pdas. Use
+        this if you need very high concurrency.
+
+### Why the Changes are helpful
+
+`getStateTreeInfos()` retrieves relevant info about all active state trees.
+
+When building a transaction you can now pick a random treeInfo via `selectStateTreeInfo(infos)`.
+
+This lets you and other apps execute more transactions within Solana's write lock
+limits.
+
+The same applies to `getTokenPoolInfos`. When you compress or decompress SPL
+tokens, a tokenpool gets write-locked. If you need additional per-block write
+lock capacity, you can register and sample additional (up to 4) tokenpool
+accounts.
+
 ## [0.20.5-0.20.9] - 2025-02-24
 
 ### Changed
@@ -17,7 +111,7 @@
 ### Added
 
 -   `selectSmartCompressedTokenAccountsForTransfer` and
-    `selectSmartCompressedTokenAccountsForTransferorPartial`
+    `selectSmartCompressedTokenAccountsForTransferOrPartial`
 
 ### Changed
 

js/compressed-token/CHANGELOG.md

@@ -1,6 +1,6 @@
 {
     "name": "@lightprotocol/compressed-token",
-    "version": "0.20.9",
+    "version": "0.21.0",
     "description": "JS client to interact with the compressed-token program",
     "sideEffects": false,
     "main": "dist/cjs/node/index.cjs",
@@ -83,19 +83,23 @@
         "test-all:verbose": "vitest run --reporter=verbose",
         "test-validator": "./../../cli/test_bin/run test-validator --prover-run-mode rpc",
         "test:e2e:create-mint": "pnpm test-validator && NODE_OPTIONS='--trace-deprecation' vitest run tests/e2e/create-mint.test.ts --reporter=verbose",
-        "test:e2e:layout": "vitest run tests/e2e/layout.test.ts --reporter=verbose",
+        "test:e2e:layout": "vitest run tests/e2e/layout.test.ts --reporter=verbose --bail=1",
         "test:e2e:select-accounts": "vitest run tests/e2e/select-accounts.test.ts --reporter=verbose",
         "test:e2e:create-token-pool": "pnpm test-validator && vitest run tests/e2e/create-token-pool.test.ts",
-        "test:e2e:mint-to": "pnpm test-validator && vitest run tests/e2e/mint-to.test.ts --reporter=verbose",
-        "test:e2e:approve-and-mint-to": "pnpm test-validator && vitest run tests/e2e/approve-and-mint-to.test.ts --reporter=verbose",
+        "test:e2e:mint-to": "pnpm test-validator && vitest run tests/e2e/mint-to.test.ts --reporter=verbose --bail=1",
+        "test:e2e:approve-and-mint-to": "pnpm test-validator && vitest run tests/e2e/approve-and-mint-to.test.ts --reporter=verbose --bail=1",
         "test:e2e:merge-token-accounts": "pnpm test-validator && vitest run tests/e2e/merge-token-accounts.test.ts --reporter=verbose",
-        "test:e2e:transfer": "pnpm test-validator && vitest run tests/e2e/transfer.test.ts --reporter=verbose",
+        "test:e2e:transfer": "pnpm test-validator && vitest run tests/e2e/transfer.test.ts --reporter=verbose --bail=1",
+        "test:e2e:delegate": "pnpm test-validator && vitest run tests/e2e/delegate.test.ts --reporter=verbose --bail=1",
+        "test:e2e:transfer-delegated": "pnpm test-validator && vitest run tests/e2e/transfer-delegated.test.ts --reporter=verbose --bail=1",
         "test:e2e:compress": "pnpm test-validator && vitest run tests/e2e/compress.test.ts --reporter=verbose",
         "test:e2e:compress-spl-token-account": "pnpm test-validator && vitest run tests/e2e/compress-spl-token-account.test.ts --reporter=verbose",
         "test:e2e:decompress": "pnpm test-validator && vitest run tests/e2e/decompress.test.ts --reporter=verbose",
+        "test:e2e:decompress-delegated": "pnpm test-validator && vitest run tests/e2e/decompress-delegated.test.ts --reporter=verbose",
         "test:e2e:rpc-token-interop": "pnpm test-validator && vitest run tests/e2e/rpc-token-interop.test.ts --reporter=verbose",
         "test:e2e:rpc-multi-trees": "pnpm test-validator && vitest run tests/e2e/rpc-multi-trees.test.ts --reporter=verbose",
-        "test:e2e:all": "pnpm test-validator && vitest run tests/e2e/create-mint.test.ts && vitest run tests/e2e/mint-to.test.ts && vitest run tests/e2e/transfer.test.ts && vitest run tests/e2e/compress.test.ts && vitest run tests/e2e/compress-spl-token-account.test.ts && vitest run tests/e2e/decompress.test.ts && vitest run tests/e2e/create-token-pool.test.ts && vitest run tests/e2e/approve-and-mint-to.test.ts && vitest run tests/e2e/rpc-token-interop.test.ts && vitest run tests/e2e/rpc-multi-trees.test.ts && vitest run tests/e2e/layout.test.ts && vitest run tests/e2e/select-accounts.test.ts",
+        "test:e2e:multi-pool": "pnpm test-validator && vitest run tests/e2e/multi-pool.test.ts --reporter=verbose",
+        "test:e2e:all": "pnpm test-validator && vitest run tests/e2e/create-mint.test.ts && vitest run tests/e2e/mint-to.test.ts && vitest run tests/e2e/transfer.test.ts && vitest run tests/e2e/delegate.test.ts && vitest run tests/e2e/transfer-delegated.test.ts && vitest run tests/e2e/multi-pool.test.ts && vitest run tests/e2e/decompress-delegated.test.ts && pnpm test-validator &&vitest run tests/e2e/compress.test.ts && vitest run tests/e2e/compress-spl-token-account.test.ts && vitest run tests/e2e/decompress.test.ts && vitest run tests/e2e/create-token-pool.test.ts && vitest run tests/e2e/approve-and-mint-to.test.ts && vitest run tests/e2e/rpc-token-interop.test.ts && vitest run tests/e2e/rpc-multi-trees.test.ts && vitest run tests/e2e/layout.test.ts && vitest run tests/e2e/select-accounts.test.ts",
         "pull-idl": "../../scripts/push-compressed-token-idl.sh",
         "build": "rimraf dist && pnpm build:bundle",
         "build:bundle": "rollup -c",

js/compressed-token/package.json

@@ -47,10 +47,9 @@ const rolls = (fmt, env) => ({
         env === 'browser' ? nodePolyfills() : undefined,
         terser({
             compress: {
-                drop_console: true,
+                drop_console: false,
                 drop_debugger: true,
                 passes: 3,
-                pure_funcs: ['console.log', 'console.error', 'console.warn'],
                 booleans_as_integers: true,
                 keep_fargs: false,
                 keep_fnames: false,

js/compressed-token/rollup.config.js

@@ -11,40 +11,53 @@ import {
     buildAndSignTx,
     Rpc,
     dedupeSigner,
-    pickRandomTreeAndQueue,
+    StateTreeInfo,
+    selectStateTreeInfo,
+    toArray,
 } from '@lightprotocol/stateless.js';
 import { CompressedTokenProgram } from '../program';
 import { getOrCreateAssociatedTokenAccount } from '@solana/spl-token';
 
+import {
+    getTokenPoolInfos,
+    selectTokenPoolInfo,
+    TokenPoolInfo,
+} from '../utils/get-token-pool-infos';
+
 /**
  * Mint compressed tokens to a solana address from an external mint authority
  *
- * @param rpc            Rpc to use
- * @param payer          Payer of the transaction fees
- * @param mint           Mint for the account
- * @param destination    Address of the account to mint to
- * @param authority      Minting authority
- * @param amount         Amount to mint
- * @param merkleTree     State tree account that the compressed tokens should be
- *                       part of. Defaults to random public state tree account.
- * @param confirmOptions Options for confirming the transaction
+ * @param rpc                   Rpc to use
+ * @param payer                 Fee payer
+ * @param mint                  SPL Mint address
+ * @param toPubkey              Address of the account to mint to
+ * @param authority             Minting authority
+ * @param amount                Amount to mint
+ * @param outputStateTreeInfo   Optional: State tree account that the compressed
+ *                              tokens should be inserted into. Defaults to a
+ *                              shared state tree account.
+ * @param tokenPoolInfo         Optional: Token pool info.
+ * @param confirmOptions        Options for confirming the transaction
  *
  * @return Signature of the confirmed transaction
  */
 export async function approveAndMintTo(
     rpc: Rpc,
     payer: Signer,
     mint: PublicKey,
-    destination: PublicKey,
+    toPubkey: PublicKey,
     authority: Signer,
     amount: number | BN,
-    merkleTree?: PublicKey,
+    outputStateTreeInfo?: StateTreeInfo,
+    tokenPoolInfo?: TokenPoolInfo,
     confirmOptions?: ConfirmOptions,
-    tokenProgramId?: PublicKey,
 ): Promise<TransactionSignature> {
-    tokenProgramId = tokenProgramId
-        ? tokenProgramId
-        : await CompressedTokenProgram.get_mint_program_id(mint, rpc);
+    outputStateTreeInfo =
+        outputStateTreeInfo ??
+        selectStateTreeInfo(await rpc.getStateTreeInfos());
+    tokenPoolInfo =
+        tokenPoolInfo ??
+        selectTokenPoolInfo(await getTokenPoolInfos(rpc, mint));
 
     const authorityTokenAccount = await getOrCreateAssociatedTokenAccount(
         rpc,
@@ -54,40 +67,34 @@ export async function approveAndMintTo(
         undefined,
         undefined,
         confirmOptions,
-        tokenProgramId,
+        tokenPoolInfo.tokenProgram,
     );
 
-    if (!merkleTree) {
-        const stateTreeInfo = await rpc.getCachedActiveStateTreeInfo();
-        const { tree } = pickRandomTreeAndQueue(stateTreeInfo);
-        merkleTree = tree;
-    }
-
     const ixs = await CompressedTokenProgram.approveAndMintTo({
         feePayer: payer.publicKey,
         mint,
         authority: authority.publicKey,
         authorityTokenAccount: authorityTokenAccount.address,
         amount,
-        toPubkey: destination,
-        merkleTree,
-        tokenProgramId,
+        toPubkey,
+        outputStateTreeInfo,
+        tokenPoolInfo,
     });
 
     const { blockhash } = await rpc.getLatestBlockhash();
     const additionalSigners = dedupeSigner(payer, [authority]);
 
     const tx = buildAndSignTx(
         [
-            ComputeBudgetProgram.setComputeUnitLimit({ units: 1_000_000 }),
+            ComputeBudgetProgram.setComputeUnitLimit({
+                units: 150_000 + toArray(amount).length * 20_000,
+            }),
             ...ixs,
         ],
         payer,
         blockhash,
         additionalSigners,
     );
 
-    const txId = await sendAndConfirmTx(rpc, tx, confirmOptions);
-
-    return txId;
+    return await sendAndConfirmTx(rpc, tx, confirmOptions);
 }