Eth To Sol Skill — Security skill for Claude Code

eth-to-sol

A Claude skill that ports Ethereum/Solidity contracts to production-grade Solana programs and teaches the developer what changed and why.

What it does

Given a Solidity contract, the skill produces:

1. A faithful Anchor port — semantically identical, deliberately un-Solana.
2. A Solana-native refactor — restructured around SPL programs, PDAs, the account model, and Sealevel parallelism. Production-ready.
3. A structured diff between the two ports.
4. An explanation log — a per-change record of what / why / benefit / tradeoff. This is the teaching artifact.

The two-pass structure is the point. The faithful port is the baseline that makes the refactor's value legible. A developer who reads only the optimized version learns what production Solana looks like; a developer who reads both learns *why*.

Invoking the skill

Inside Claude Code with this directory available as a skill:

Run the eth-to-sol skill on this contract: 

The skill reads `SKILL.md`, traverses its decision tree to load only the sub-files relevant to the input, runs the pre-flight checklist, and emits the four artifacts.

For the reference example, the inputs and outputs are pre-built under `examples/token-fundraiser/` (Solidity ERC-20 crowdfund → canonical `tokens/token-fundraiser` shape from solana-developers/program-examples).

Directory layout

eth-to-sol/
├── README.md                   # this file
├── SKILL.md                    # router — loaded on every invocation; lean
├── translation/                # mechanical Solidity → Anchor mapping
│   ├── mental-model.md
│   ├── type-mapping.md
│   ├── pattern-mapping.md
│   └── stdlib-mapping.md
├── optimization/               # Solana-native restructuring guidance
│   ├── account-model.md
│   ├── pdas.md
│   ├── parallelism.md
│   ├── compute-budget.md
│   ├── transactions-and-commitment.md
│   ├── rent-and-size.md
│   └── program-splitting.md
├── security/