feat: complete Kit SDK instruction builders and fix build pipeline

Implement the 5 missing instruction builders (transfer2, create-token-account,
mint-action, claim, withdraw-funding-pool) and their codec, fixing the token-sdk
build pipeline end-to-end.

Changes:
- Fix Codama IDL: add prefixedCountNode for array types, update renderVisitor import
- Fix CI workflow: add Codama generation step before token-sdk build
- Implement transfer2.ts with Path A/B/C routing and compression factory helpers
- Implement create-token-account.ts with compressible/non-compressible modes
- Implement mint-action.ts with full account layout
- Implement claim.ts for rent recovery
- Implement withdraw-funding-pool.ts for pool withdrawals
- Implement codecs/mint-action.ts with full Borsh encoding
- Add legacy SDK devDeps to token-client for e2e test setup
- Add .gitignore for Codama-generated code (build artifact)

All 350 unit tests pass (286 token-sdk + 64 token-client).

Refs: #2280, #2289

Author: tilo-14

.github/workflows/token-kit.yml

@@ -56,6 +56,9 @@ jobs:
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
+      - name: Generate token-sdk clients from IDL
+        run: cd js/token-idl && pnpm run generate
+
       - name: Build token-sdk
         run: cd js/token-sdk && pnpm build
 

js/token-client/package.json

@@ -32,6 +32,8 @@
         "@solana/instructions": "^2.1.0"
     },
     "devDependencies": {
+        "@lightprotocol/stateless.js": "workspace:*",
+        "@lightprotocol/compressed-token": "workspace:*",
         "typescript": "^5.7.3",
         "vitest": "^2.1.8"
     },

js/token-idl/scripts/generate-clients.ts

@@ -3,7 +3,7 @@
  */
 
 import { createFromRoot } from 'codama';
-import { renderJavaScriptVisitor } from '@codama/renderers-js';
+import { renderVisitor } from '@codama/renderers-js';
 import { setInstructionAccountDefaultValuesVisitor } from '@codama/visitors';
 import { publicKeyValueNode } from 'codama';
 import path from 'path';
@@ -45,7 +45,7 @@ codama.update(
 // Generate TypeScript client
 console.log(`Generating TypeScript client to ${typescriptOutputDir}...`);
 codama.accept(
-    renderJavaScriptVisitor(typescriptOutputDir, {
+    renderVisitor(typescriptOutputDir, {
         formatCode: true,
         dependencyMap: {
             // Map codama codecs to @solana/codecs

js/token-idl/src/idl.ts

@@ -30,6 +30,7 @@ import {
     structFieldTypeNode,
     arrayTypeNode,
     fixedSizeTypeNode,
+    prefixedCountNode,
 } from 'codama';
 
 // ============================================================================
@@ -167,7 +168,7 @@ const compressibleExtensionDataType = structTypeNode([
                 }),
                 structFieldTypeNode({
                     name: 'seeds',
-                    type: arrayTypeNode(bytesTypeNode()),
+                    type: arrayTypeNode(bytesTypeNode(), prefixedCountNode(numberTypeNode('u32'))),
                 }),
             ]),
         ),
@@ -1097,7 +1098,7 @@ export const lightTokenIdl = rootNode(
                     instructionArgumentNode({
                         name: 'compressions',
                         type: optionTypeNode(
-                            arrayTypeNode(compressionStructType),
+                            arrayTypeNode(compressionStructType, prefixedCountNode(numberTypeNode('u32'))),
                         ),
                     }),
                     // Note: proof, inTokenData, outTokenData, inLamports, outLamports, inTlv, outTlv