Merge origin/main into order-book branch

Resolves the PR #66 conflict caused by main renaming defi/ -> finance/.
Git rename detection carried the order-book changes (base_lot_size,
quote_lot_size, README critbit wording) into finance/order-book/ cleanly;
verified cargo check passes at the new path.

https://claude.ai/code/session_01G6iaAjzg8aoFwe8ZWWG9VR

Author: claude

.github/.ghaignore

@@ -1,73 +0,0 @@
-# build and test error
-basics/realloc/native
-basics/cross-program-invocation/native
-
-# uses generated client from shank, can't rewrite to solana-bankrun
-tools/shank-and-solita/native
-
-# can't test on localnet
-tokens/pda-mint-authority/native
-tokens/nft-minter/native
-tokens/transfer-tokens/native
-tokens/token-minter/native
-tokens/create-token/native
-
-tokens/token-swap/anchor
-
-# not building
-oracles/pyth/anchor
-
-# not building
-compression/cutils/anchor
-compression/cnft-vault/anchor
-# builds but need to test on localhost
-compression/cnft-burn/anchor
-
-# test failing
-# https://github.com/solana-developers/helpers/issues/40
-tokens/escrow/anchor
-
-# not live
-tokens/token-extensions/group/anchor
-tokens/token-extensions/group/quasar
-
-# CPI quasar project uses subdirectories (hand/ and lever/) instead of a root Quasar.toml
-basics/cross-program-invocation/quasar
-
-
-
-# error in tests
-tokens/external-delegate-token-master/anchor
-
-# build failed - program outdated
-tokens/token-extensions/metadata/anchor
-
-# dependency issues
-tokens/token-extensions/nft-meta-data-pointer/anchor-example/anchor
-
-tokens/token-extensions/mint-close-authority/native
-tokens/token-extensions/transfer-fee/native
-tokens/token-extensions/non-transferable/native
-
-# all steel projects
-
-basics/account-data/steel
-basics/checking-accounts/steel
-basics/close-account/steel
-basics/counter/steel
-basics/create-account/steel
-basics/cross-program-invocation/steel
-basics/favorites/steel
-basics/pda-rent-payer/steel
-basics/processing-instructions/steel
-basics/program-derived-addresses/steel
-basics/realloc/steel
-basics/rent/steel
-basics/transfer-sol/steel
-
-tokens/escrow/steel
-
-tokens/pda-mint-authority/steel
-tokens/token-minter/steel
-tokens/token-swap/steel
-tokens/transfer-tokens/steel

.github/workflows/quasar.yml

@@ -171,22 +171,49 @@ jobs:
             echo "Building and Testing $project with Solana $solana_version"
             cd "$project" || return 1
 
-            # Build with quasar CLI
-            if ! quasar build; then
-              echo "::error::quasar build failed for $project"
-              echo "$project: quasar build failed with $solana_version" >> $GITHUB_WORKSPACE/failed_projects.txt
-              cd - > /dev/null
-              return 1
+            # Determine the quasar program directories for this project. Normally
+            # the project dir itself holds the Quasar.toml. Some examples (e.g. the
+            # cross-program-invocation CPI demo) instead contain several program
+            # subdirectories (hand/, lever/), each its own Quasar project. In that
+            # case build them all *first*, then test them all, so a program whose
+            # tests load a sibling program's compiled .so (the CPI callee) has it
+            # available regardless of directory order.
+            local prog_dirs=()
+            if [ -f Quasar.toml ]; then
+              prog_dirs=(".")
+            else
+              for d in */; do
+                [ -f "${d}Quasar.toml" ] && prog_dirs+=("${d%/}")
+              done
             fi
 
-            # Run Rust tests (quasar examples use cargo test with quasar-svm)
-            if ! cargo test; then
-              echo "::error::cargo test failed for $project"
-              echo "$project: cargo test failed with $solana_version" >> $GITHUB_WORKSPACE/failed_projects.txt
+            if [ ${#prog_dirs[@]} -eq 0 ]; then
+              echo "::error::no Quasar.toml found for $project"
+              echo "$project: no Quasar.toml found with $solana_version" >> $GITHUB_WORKSPACE/failed_projects.txt
               cd - > /dev/null
               return 1
             fi
 
+            # Build every program first.
+            for d in "${prog_dirs[@]}"; do
+              if ! ( cd "$d" && quasar build ); then
+                echo "::error::quasar build failed for $project ($d)"
+                echo "$project: quasar build failed with $solana_version" >> $GITHUB_WORKSPACE/failed_projects.txt
+                cd - > /dev/null
+                return 1
+              fi
+            done
+
+            # Then run Rust tests (quasar examples use cargo test with quasar-svm).
+            for d in "${prog_dirs[@]}"; do
+              if ! ( cd "$d" && cargo test ); then
+                echo "::error::cargo test failed for $project ($d)"
+                echo "$project: cargo test failed with $solana_version" >> $GITHUB_WORKSPACE/failed_projects.txt
+                cd - > /dev/null
+                return 1
+              fi
+            done
+
             echo "Build and tests succeeded for $project with $solana_version version."
             cd - > /dev/null
             return 0

.gitignore

@@ -8,8 +8,11 @@ node_modules/
 **/*/node_modules
 **/*/package-lock.json
 **/*/Cargo.lock
-# Exception: escrow native needs Cargo.lock to pin blake3 (see tokens/escrow/native/Cargo.toml)
-!tokens/escrow/native/Cargo.lock
+# Exception: escrow native is a standalone (non-workspace) crate, so it keeps
+# its Cargo.lock tracked for reproducible builds.
+!finance/escrow/native/Cargo.lock
+# Exception: shank-and-codama native is also a standalone (non-workspace) crate.
+!tools/shank-and-codama/native/program/Cargo.lock
 
 **/*/.anchor
 **/*/.DS_Store
@@ -23,6 +26,4 @@ node_modules/
 /target
 deploy
 .claude/*
-# Exception: skills are shared team resources
-!.claude/skills/
-!.claude/skills/**
+!.claude/skills/

.husky/pre-commit

@@ -1 +1,20 @@
-npx lint-staged
+#!/usr/bin/env sh
+
+# GUI git clients (Fork, SourceTree, etc.) often omit nvm/fnm from PATH.
+export PATH="/opt/homebrew/bin:/usr/local/bin:$PATH"
+
+if [ -s "$HOME/.nvm/nvm.sh" ]; then
+  # shellcheck disable=SC1090
+  . "$HOME/.nvm/nvm.sh"
+elif [ -d "$HOME/.fnm" ]; then
+  export PATH="$HOME/.fnm/current/bin:$PATH"
+fi
+
+cd "$(dirname "$0")/.." || exit 1
+
+if ! command -v pnpm >/dev/null 2>&1; then
+  echo "husky: pnpm not found. Open a terminal in this repo and run: pnpm install"
+  exit 1
+fi
+
+pnpm exec lint-staged

CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+All notable changes to this repository are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## [2026-04-08] — Quicknode fork modernization (Mike MacCana)
+
+Mike MacCana led the Quicknode fork of the [Solana Foundation program examples](https://github.com/solana-developers/program-examples) from late 2025. The first commits on this repository lineage are dated **8 April 2026**; the summary below covers that work through the initial merge.
+
+### What changed (high level)
+
+**Toolchain and frameworks.** The tree had accumulated examples from several years of Solana development (including Anchor releases going back to the ~0.26 era in 2022 and many intermediate versions). The fork brought the Anchor examples up to **Anchor 1.0.0** stable (from 1.0.0-rc.5), refreshed Agave/Solana CLI pins, standardized on **pnpm**, and added parallel implementations in **[Quasar](https://quasar-lang.com/docs)**, **Pinocchio**, **Native Rust**, and **ASM** where applicable. Token-2022 examples were renamed to **`token-extensions`**.
+
+**Testing.** Replaced the old pattern of local validators, Bankrun, and scattered TypeScript `anchor test` flows with **LiteSVM in-process tests** for most Anchor programs — matching current Anchor defaults (`cargo test` wired through `Anchor.toml` / `pnpm test`). Fixed broken or flaky tests across Native, Pinocchio, and Anchor; added missing harnesses (e.g. block-list Pinocchio). CI was reworked for a repo this size: path filtering, caching, matrix sharding, and reliable detection of framework roots.
+
+**Programs and layout.** Broke large monolithic `lib.rs` files into **instruction handler modules**; adopted **`InitSpace`** and explicit PDA bumps instead of magic account sizes; corrected several logic bugs (escrow, token swap invariant, counter authority checks, compression Bubblegum program id, and more). Expanded finance and token-extension coverage; reorganized transfer-hook examples (including block-list under Pinocchio).
+
+**Documentation.** Rewrote the root README (framework badges, clearer example blurbs, ASM links), ran a style and **truth audit** on READMEs, and linked canonical [Solana terminology](https://solana.com/docs/references/terminology) on first mention. Added this changelog, `CONTRIBUTING.md` (aligned with LiteSVM testing), README templates, per-example Anchor and Quasar READMEs, fixed Husky for GUI git clients, removed unused maintainer scripts (`sync-package-json`, `cicd.sh`, local-validator helpers for the allow/block-list UI), dropped the orphan `tokens/spl-token-minter/` tree, and removed legacy root `package.json` dependencies (web3.js, Bankrun, chai).
+
+**Removed / deferred.** Dropped duplicate or WIP trees (duplicate block-list Pinocchio copy, Quasar metadata example blocked on `sol_realloc`, root `yarn.lock`). Some examples remain excluded from CI via `.ghaignore` until they build cleanly again (compression, escrow, pyth, and others — see that file for the live list).
+
+## Before June 2026
+
+There was **no changelog** before June 2026. Older history lives in git only.