Registry / devops / solana-survivor

solana-survivor

library0.1.8jsnpmunverified

Automated migration engine from @solana/web3.js to @solana/kit. Version 0.1.8, built with TypeScript, requires Node >= 20. Combines deterministic AST codemods with an AI agent (Claude) to automate up to 90% of Solana SDK migration work. Unlike manual migration guides or simple find-and-replace scripts, it handles complex patterns like Keypair generation, transaction building, and LAMPORTS_PER_SOL arithmetic, inserting todo markers for unsupported patterns. Reports are JSON-saved for reproducibility.

devops

npm install solana-survivor

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · SOLANA-SURVIVOR

solana-survivor

devopsjavascriptv0.1.8

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default (the CLI tool)

✓ npx solana-survivor migrate

✗ "npx @solana/survivor" or "npx solana-kit-migration"

Package is used as a CLI tool via npx; no programmatic API exposed yet.

npx solana-survivor scan

✓ npx solana-survivor scan

✗ npx solana-survivor scan .

Path defaults to current directory if not provided.

npx solana-survivor report

✓ npx solana-survivor report

✗ npx solana-survivor report --json

Report output is always formatted; use --json flag not supported yet.

Run the migration pipeline in dry-run mode first, then apply changes, and view the migration report.

npx solana-survivor migrate ./my-solana-project --dry-run npx solana-survivor migrate ./my-solana-project npx solana-survivor report ./my-solana-project

Debug

Known issues

breakingRequires Node.js >= 20.0.0, engines.node specified as >=20.

fix

Upgrade Node.js to version 20 or higher using nvm or your package manager.

affects: >=0.1.0

breakingThis tool transforms your codebase irreversibly; always run with --dry-run first.

fix

Use `npx solana-survivor migrate --dry-run` before committing changes.

affects: >=0.1.0

deprecatedThe `@solana/kit` package is required after migration; not installed automatically.

fix

Install `@solana/kit` manually after migration: npm install @solana/kit

affects: >=0.1.0

gotchaCodemod coverage is ~78%; AI agent coverage ~12%; ~10% requires manual review.

fix

Always inspect the generated report and agent-diffs/ directory for required manual steps.

affects: >=0.1.0 <0.2.0

gotchaWebSocket subscriptions are not automated; they are flagged with todo markers.

fix

Manually migrate subscription patterns to async iterators as described in @solana/kit docs.

affects: >=0.1.0

Errors

Common errors & fixes

Error: Cannot find module '@solana/kit'

The migration engine does not install @solana/kit automatically.

fix

Run: npm install @solana/kit

TypeError: (0, solanaSurvivor_migrate) is not a function

Attempting to import solana Survivor programmatically from JavaScript without the proper default export.

fix

Use CLI via npx instead of programmatic import; package is not designed for programmatic use.

solana-survivor: Command failed with exit code 1: tsc --noEmit

TypeScript compilation failed after migration because some transforms are incomplete.

fix

Review the migration report for flagged files and manually fix type errors. Run `npx solana-survivor verify` to rerun checks.

Upgrade

Version history

0.1.8latest on npm

Audit

Dependencies

typescriptrequiredUsed for AST parsing and type checking during migration verification

Agent activity

6 hits · last 30 days

node

Resources

githubhttps://github.com/uhiene/solana-survivor ↗

packagesolana-survivor ↗

homepagehttps://github.com/uhiene/solana-survivor#readme ↗