interface: Split out instructions, state, errors from program (#616)

* interface: Split out instructions, state, errors from program

#### Problem

The token-2022 program has some heavy dependencies that most users of
the crate don't care about. This causes dependency issues and long
compilation times.

Also, the program uses Agave dependencies, which creates circular
dependencies and makes it impossible to upgrade to SDK v3 without some
complicated gymnastics.

#### Summary of changes

Similar to the ATA's interface crate, split out everything need by Agave
into a separate crate, which can also be used by on-chain programs as an
rlib, and thus allow for LTO in program builds.

* Rename serde-traits -> serde, remove repeated funcs

* Cleanup deps, remove repeated functions, run format

* Fix spelling issues and client generation

* Address nits

Author: joncinque

.github/workflows/main.yml

@@ -109,6 +109,27 @@ jobs:
       - name: Lint Client Rust
         run: pnpm clients:rust:lint
 
+  format_and_lint_interface:
+    name: Format & Lint Interface
+    runs-on: ubuntu-latest
+    steps:
+      - name: Git Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Environment
+        uses: ./.github/actions/setup
+        with:
+          clippy: true
+          rustfmt: true
+          cargo-cache-key: cargo-interface-lint
+          cargo-cache-fallback-key: cargo-interface
+
+      - name: Format
+        run: pnpm interface:format
+
+      - name: Lint
+        run: pnpm interface:lint
+
   format_and_lint_client_rust_legacy:
     name: Format & Lint Client Rust Legacy
     runs-on: ubuntu-latest
@@ -171,6 +192,22 @@ jobs:
       - name: Lint Proof Tests
         run: pnpm confidential-transfer:proof-tests:lint
 
+  test_interface:
+    name: Test Interface
+    runs-on: ubuntu-latest
+    steps:
+      - name: Git Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Environment
+        uses: ./.github/actions/setup
+        with:
+          cargo-cache-key: cargo-interface-test
+          cargo-cache-fallback-key: cargo-interface
+
+      - name: Test
+        run: pnpm interface:test
+
   test_confidential_transfer_proofs:
     name: Test Confidential Transfer Proofs
     runs-on: ubuntu-latest

Cargo.lock

@@ -19,6 +19,7 @@ members = [
   "confidential-transfer/proof-extraction",
   "confidential-transfer/proof-generation",
   "confidential-transfer/proof-tests",
+  "interface",
   "program",
 ]
 

Cargo.toml

@@ -0,0 +1,62 @@
+[package]
+name = "spl-token-2022-interface"
+version = "1.0.0"
+description = "Solana Program Library Token 2022 Interface"
+documentation = "https://docs.rs/spl-token-2022-interface"
+readme = "README.md"
+authors = { workspace = true }
+repository = { workspace = true }
+homepage = { workspace = true }
+license = { workspace = true }
+edition = { workspace = true }
+
+[features]
+serde = ["dep:serde", "dep:serde_with", "dep:base64", "spl-pod/serde-traits"]
+
+[dependencies]
+arrayref = "0.3.9"
+bytemuck = { version = "1.23.1", features = ["derive"] }
+num-derive = "0.4"
+num-traits = "0.2"
+num_enum = "0.7.4"
+solana-account-info = "2.3.0"
+solana-decode-error = "2.2.1"
+solana-instruction = "2.2.1"
+solana-msg = "2.2.1"
+solana-program-error = "2.2.1"
+solana-program-option = "2.2.1"
+solana-program-pack = "2.2.1"
+solana-pubkey = "2.2.1"
+solana-sdk-ids = "2.2.1"
+solana-zk-sdk = "2.3.4"
+spl-token-confidential-transfer-proof-extraction = { version = "0.4.0", path = "../confidential-transfer/proof-extraction" }
+spl-token-group-interface = { version = "0.6.0" }
+spl-token-metadata-interface = { version = "0.7.0" }
+spl-type-length-value = { version = "0.8.0" }
+spl-pod = { version = "0.5.1" }
+thiserror = "2.0"
+serde = { version = "1.0.219", optional = true }
+serde_with = { version = "3.14.0", optional = true }
+base64 = { version = "0.22.1", optional = true }
+
+[target.'cfg(not(target_os = "solana"))'.dependencies]
+spl-token-confidential-transfer-proof-generation = { version = "0.4.0", path = "../confidential-transfer/proof-generation" }
+
+[dev-dependencies]
+proptest = "1.7"
+solana-pubkey = { version = "2.2.1", features = ["curve25519"] }
+spl-token = { version = "8.0", features = ["no-entrypoint"] }
+spl-token-2022-interface = { path = ".", features = ["serde"] }
+serde_json = "1.0.141"
+
+[lib]
+crate-type = ["lib"]
+
+[package.metadata.docs.rs]
+targets = ["x86_64-unknown-linux-gnu"]
+
+[lints]
+workspace = true
+
+[package.metadata.solana]
+program-id = "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"

interface/Cargo.toml

@@ -0,0 +1,14 @@
+# Token-2022 Interface
+
+A token program interface on the Solana blockchain, usable for fungible and
+non-fungible tokens.
+
+This crate provides an interface that third parties can utilize to create and
+use their tokens.
+
+Full documentation is available at [https://www.solana-program.com/docs/token-2022](https://www.solana-program.com/docs/token-2022)
+
+## Audit
+
+The repository [README](https://github.com/solana-labs/solana-program-library#audits)
+contains information about program audits.