feat: add program runtime crate

Cargo.toml

@@ -1,5 +1,10 @@
 [workspace]
-members = ["solana/account", "solana/transaction-context", "solana/transaction-view"]
+members = [
+    "solana/account",
+    "solana/program-runtime",
+    "solana/transaction-context",
+    "solana/transaction-view",
+]
 resolver = "3"
 
 [workspace.package]
@@ -15,16 +20,22 @@ version = "0.1.0"
 magic-root-interface = { path = "programs/magic-root-interface" }
 magic-root-program = { path = "programs/magic-root-program" }
 solana-account = { path = "solana/account" }
+solana-program-runtime = { path = "solana/program-runtime" }
 solana-transaction-context = { path = "solana/transaction-context" }
 
 ahash = "0.8.12"
 arc-swap = "1.9.1"
+assert_matches = "1.5.0"
+base64 = "0.22.1"
 bincode = "1.3.3"
 bitflags = "2.11.1"
 blake3 = "1.8.5"
+cfg-if = "1.0.4"
 criterion = "0.8.2"
+derive_more = "2.1.1"
+itertools = "0.13.0"
 qualifier_attr = "0.2.2"
-rand = "0.8.5"
+rand = "0.9.2"
 rustix = { version = "1.1.4" }
 serde = "1.0.228"
 serde_bytes = "0.11.19"
@@ -45,20 +56,44 @@ solana-account-info = "3.1.1"
 solana-clock = "3.1.0"
 solana-compute-budget-instruction = "=4.1.1"
 solana-cpi = "3.1.0"
+solana-epoch-rewards = "3.0.1"
+solana-epoch-schedule = "3.1.0"
+solana-feature-gate-interface = { version = "4.0.0", features = ["bincode"] }
+solana-fee-structure = "3.0.0"
 solana-hash = "4.3.0"
 solana-instruction = "3.4.0"
 solana-instruction-error = "2.3.0"
 solana-instructions-sysvar = "4.0.0"
+solana-keypair = "3.1.2"
+solana-last-restart-slot = "3.0.0"
+solana-loader-v3-interface = "6.1.0"
 solana-program-entrypoint = "3.1.1"
 solana-program-error = "3.0.1"
 solana-pubkey = "4.2.0"
-solana-rent = "4.0.0-rc.1"
-solana-sbpf = "0.13.1"
+solana-rent = "4.2.0"
+solana-sbpf = "=0.21.0"
 solana-sdk-ids = "3.1.0"
 solana-short-vec = "=3.2.2"
 solana-signature = "=3.4.1"
-solana-sysvar = "4.0.0"
-solana-system-interface = "3.2.0"
+solana-signer = "3.0.1"
+solana-slot-hashes = "3.0.1"
+solana-stable-layout = "3.0.0"
+solana-sysvar = "3.1.1"
+solana-sysvar-id = "3.1.0"
+solana-system-interface = ">=3.0.0, <3.2.0"
+solana-svm-callback = "4.0.0-rc.1"
+solana-svm-feature-set = "4.0.0-rc.1"
+solana-svm-log-collector = "4.0.0-rc.1"
+solana-svm-measure = "4.0.0-rc.1"
+solana-svm-timings = "4.0.0-rc.1"
+solana-svm-transaction = "4.0.0-rc.1"
+solana-svm-type-overrides = "4.0.0-rc.1"
+solana-system-interface = ">=3.0.0, <3.2.0"
+solana-system-program = "4.0.0-rc.0"
+solana-system-transaction = "3.0.0"
+solana-sysvar = "3.1.1"
+solana-sysvar-id = "3.1.0"
+solana-transaction = "4.1.1"
 solana-transaction-error = "3.2.0"
 
 [patch.crates-io]

solana/program-runtime/Cargo.toml

@@ -1,13 +1,16 @@
 [package]
 name = "solana-program-runtime"
+
+authors = { workspace = true }
 description = "Solana program runtime"
 documentation = "https://docs.rs/solana-program-runtime"
 version = { workspace = true }
 authors = { workspace = true }
 repository = { workspace = true }
 homepage = { workspace = true }
 license = { workspace = true }
-edition = "2024"
+repository = { workspace = true }
+version = "4.1.1"
 
 [package.metadata.docs.rs]
 targets = ["x86_64-unknown-linux-gnu"]
@@ -17,9 +20,12 @@ crate-type = ["lib"]
 name = "solana_program_runtime"
 
 [features]
+# No-op stub retained only so external (patched-in) crates that reference
+# `solana-program-runtime/agave-unstable-api` still resolve; the lib is no
+# longer gated on it, and the upstream svm-* deps enable their unstable API
+# unconditionally below.
 agave-unstable-api = []
-conf-stack-frame-size = ["solana-sbpf/conf-stack-frame-size"]
-dev-context-only-utils = ["dep:solana-message"]
+dev-context-only-utils = []
 dummy-for-ci-check = ["metrics"]
 # Compatibility stub: this fork does not derive or consume frozen ABI metadata.
 frozen-abi = []
@@ -33,41 +39,33 @@ base64 = { workspace = true }
 bincode = { workspace = true }
 cfg-if = { workspace = true }
 itertools = { workspace = true }
-percentage = { workspace = true }
 qualifier_attr = { workspace = true, optional = true }
+scc = { workspace = true }
 serde = { workspace = true }
 solana-account = { workspace = true, features = ["bincode"] }
 solana-account-info = { workspace = true }
 solana-clock = { workspace = true }
 solana-epoch-rewards = { workspace = true }
 solana-epoch-schedule = { workspace = true }
 solana-fee-structure = { workspace = true }
-solana-frozen-abi = { workspace = true, optional = true, features = [
-    "frozen-abi",
-] }
-solana-frozen-abi-macro = { workspace = true, optional = true, features = [
-    "frozen-abi",
-] }
 solana-hash = { workspace = true }
 solana-instruction = { workspace = true }
 solana-last-restart-slot = { workspace = true }
 solana-loader-v3-interface = { workspace = true }
-solana-message = { workspace = true, optional = true }
 solana-program-entrypoint = { workspace = true }
 solana-pubkey = { workspace = true }
 solana-rent = { workspace = true }
 solana-sbpf = { workspace = true, features = ["jit"] }
 solana-sdk-ids = { workspace = true }
 solana-slot-hashes = { workspace = true }
 solana-stable-layout = { workspace = true }
-solana-stake-interface = { workspace = true, features = ["bincode", "sysvar"] }
-solana-svm-callback = { workspace = true }
-solana-svm-feature-set = { workspace = true }
-solana-svm-log-collector = { workspace = true }
-solana-svm-measure = { workspace = true }
-solana-svm-timings = { workspace = true }
-solana-svm-transaction = { workspace = true }
-solana-svm-type-overrides = { workspace = true }
+solana-svm-callback = { workspace = true, features = ["agave-unstable-api"] }
+solana-svm-feature-set = { workspace = true, features = ["agave-unstable-api"] }
+solana-svm-log-collector = { workspace = true, features = ["agave-unstable-api"] }
+solana-svm-measure = { workspace = true, features = ["agave-unstable-api"] }
+solana-svm-timings = { workspace = true, features = ["agave-unstable-api"] }
+solana-svm-transaction = { workspace = true, features = ["agave-unstable-api"] }
+solana-svm-type-overrides = { workspace = true, features = ["agave-unstable-api"] }
 solana-system-interface = { workspace = true }
 solana-sysvar = { workspace = true, features = ["bincode"] }
 solana-sysvar-id = { workspace = true }
@@ -83,12 +81,11 @@ solana-program-runtime = { path = ".", features = ["dev-context-only-utils"] }
 solana-pubkey = { workspace = true, features = ["rand"] }
 solana-signer = { workspace = true }
 solana-transaction = { workspace = true, features = ["dev-context-only-utils"] }
-solana-transaction-context = { path = "../transaction-context", features = [
-    "agave-unstable-api",
-    "bincode",
-    "dev-context-only-utils",
-] }
-test-case = { workspace = true }
+solana-transaction-context = { workspace = true, features = ["dev-context-only-utils"] }
+test-case = "3.3.1"
+
+[lints.rust]
+unexpected_cfgs = "allow"
 
-[lints]
-workspace = true
+[lints.clippy]
+too_many_arguments = "allow"

solana/program-runtime/README.md

@@ -0,0 +1,16 @@
+# `solana-program-runtime`
+
+This Agave fork implements invocation state, CPI translation, SBF VM setup,
+sysvar access, logging, serialization, and program-cache primitives. Workspace
+`[patch.crates-io]` entries force the dependency graph to use this copy.
+
+Account loading and transaction-level policy belong to `solana-svm`. The
+engine-specific direct account mapping, access-violation growth, and CPI
+synchronization contracts are documented in [`../README.md`](../README.md).
+
+Changes to `serialization`, CPI account-region replacement, or `vm` error
+mapping must remain synchronized with the transaction-context access-violation
+handler.
+
+The `frozen-abi` feature is retained as a no-op compatibility stub; this fork
+does not derive or consume frozen ABI metadata.