feat: add crank example

[sporicle]

Summary by CodeRabbit

• New Features

  • Introduced Crank Counter example project with counter initialization, increment operations (wrapping at 1000), and scheduling capabilities on Ephemeral Rollup.
  • Added delegation and undelegation between Solana and Ephemeral Rollup environments.

• Documentation

  • Added comprehensive setup and testing documentation for local development.

• Tests

  • Added test suite validating counter operations and delegation flows.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

A new Crank Counter project is introduced to the repository. The project includes Solana Anchor program implementation for a counter PDA with delegation, increment scheduling via CPI to a Magic Block program, ephemeral rollup integration, comprehensive test coverage, and deployment/configuration setup across Rust and TypeScript toolchains.

Changes

Cohort / File(s)	Summary
Root Configuration Anchor.toml, Cargo.toml, rust-toolchain.toml	Adds Anchor and Cargo workspace configuration for the Crank Counter project with Yarn toolchain, program addresses for localnet/devnet, Rust 1.89.0 toolchain, release profile optimization settings, and test script configuration
Project Metadata & Build Config package.json, tsconfig.json, .prettierignore, .gitignore	Introduces TypeScript project manifest with Anchor and ephemeral rollups SDK dependencies, lint scripts, TypeScript compiler configuration targeting ES6/CommonJS, and ignore patterns for build artifacts, dependencies, and Prettier formatting
Solana Program Implementation programs/crank-counter/Cargo.toml, programs/crank-counter/src/lib.rs	Adds Rust Anchor program crate with Counter PDA initialization, increment logic, CPI-based scheduled increment via Magic Block program, delegation/undelegation support for ephemeral rollups, and integration with ephemeral-rollups-sdk and magic-program-api
Deployment & Testing migrations/deploy.ts, tests/crank-counter.ts	Introduces placeholder deployment routine and comprehensive test suite covering counter initialization, delegation to ephemeral rollup, scheduled increment scheduling with task configuration, and undelegation workflows with multi-connection setup
Documentation README.md	Adds comprehensive project README with setup instructions, build/test workflows, local development guidance for Solana validator and MagicBlock validator, environment configuration, and program deployment steps; updates anchor-counter/README.md with new example entry

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~60–90 minutes

• lib.rs program logic: Dense Solana/Anchor integration with CPI to Magic Block program, serialization of ScheduleTaskArgs, and stateful delegation/undelegation flows require careful validation of account constraints and cross-program invocation correctness
• Test suite design: Multi-step workflows involving base cluster and ephemeral rollup connections, PDA computation, and transaction signing patterns need verification for correctness and coverage
• External SDK integration: Ephemeral rollups SDK and magic-program-api usage patterns should be validated for proper initialization and invocation semantics
• Configuration alignment: Anchor.toml and Cargo.toml release profile settings warrant review for performance and correctness implications

Possibly related PRs

• overwrite anchor test to spin up magic validator #43: Modifies the same Anchor.toml provider.cluster setting (changing from "devnet" to "localnet"), indicating parallel configuration updates across examples
• fix: update to new pattern #48: Implements delegation pattern improvements by moving delegation arguments into remainingAccounts; the current PR's delegate/undelegate functions follow similar account handling patterns

Suggested reviewers

• GabrielePicco
• jonasXchen

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch crank-wip

---

📜 Recent review details

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 913cd72 and 0867772.

⛔ Files ignored due to path filters (3)

• crank-counter/Cargo.lock is excluded by !**/*.lock
• crank-counter/yarn.lock is excluded by !**/yarn.lock, !**/*.lock
• ephemeral-validator.log is excluded by !**/*.log

📒 Files selected for processing (14)

• README.md (1 hunks)
• anchor-counter/Anchor.toml (1 hunks)
• crank-counter/.gitignore (1 hunks)
• crank-counter/.prettierignore (1 hunks)
• crank-counter/Anchor.toml (1 hunks)
• crank-counter/Cargo.toml (1 hunks)
• crank-counter/README.md (1 hunks)
• crank-counter/migrations/deploy.ts (1 hunks)
• crank-counter/package.json (1 hunks)
• crank-counter/programs/crank-counter/Cargo.toml (1 hunks)
• crank-counter/programs/crank-counter/src/lib.rs (1 hunks)
• crank-counter/rust-toolchain.toml (1 hunks)
• crank-counter/tests/crank-counter.ts (1 hunks)
• crank-counter/tsconfig.json (1 hunks)

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}