feat(fuzzer): add valid-address generator for G, M, and C kinds

.github/workflows/ci-rust.yml

@@ -0,0 +1,43 @@
+name: ci-rust
+
+on:
+  pull_request:
+    paths:
+      - "examples/prism-core/**"
+      - "examples/rust-address-fuzzer/**"
+      - "spec/vectors.json"
+      - ".github/workflows/ci-rust.yml"
+
+concurrency:
+  group: ci-rust-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  test:
+    name: Rust tests & build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions-rust-lang/setup-rust-toolchain@v1
+        with:
+          toolchain: stable
+          cache: false
+
+      - name: Test prism-core (lib)
+        run: cargo test -p prism-core
+
+      - name: Test rust-address-fuzzer
+        run: cargo test -p rust-address-fuzzer
+
+      - name: Build prism-diff binary
+        run: cargo build -p prism-core --features diff --bin prism-diff
+
+      - name: Run prism-diff smoke test (1k random inputs)
+        run: cargo run -p prism-core --features diff --bin prism-diff -- --random 1000 --seed 42

.github/workflows/fuzz.yml

@@ -0,0 +1,28 @@
+name: Fuzz
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+
+jobs:
+  fuzz:
+    name: Run rust-address-fuzzer
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Run Fuzzer
+        run: |
+          cd examples/rust-address-fuzzer
+          cargo run --release -- --random 100000 --max-iterations 100000
+
+      - name: Upload Reproducer
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: fuzzer-reproducer
+          path: examples/rust-address-fuzzer/reproducer.txt

README.md

@@ -65,10 +65,6 @@ console.log(result.routingId); // "123"
 - **Warning System**: Discriminated unions (TS) or structured objects (Go/Dart) to catch edge cases like numeric `MEMO_TEXT`.
 - **Zero Dependencies**: Core logic is lightweight and has zero external dependencies beyond standard library features.
 
-## Maintainers
-
-- **codeZeus** - [GitHub](https://github.com/codeZe-us)
-
 ## License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

examples/prism-core/Cargo.toml

@@ -2,9 +2,24 @@
 name = "prism-core"
 version = "0.1.0"
 edition = "2021"
+rust-version = "1.87.0"
 description = "Rust implementation of the stellar-address-kit Stellar address parser"
 license = "MIT"
 
 [lib]
 name = "prism_core"
 path = "src/lib.rs"
+
+[[bin]]
+name = "prism-diff"
+path = "src/diff.rs"
+required-features = ["diff"]
+
+[features]
+default = []
+diff = ["dep:stellar-strkey", "dep:clap", "dep:rand"]
+
+[dependencies]
+stellar-strkey = { version = "0.0.18", optional = true }
+clap = { version = "4", features = ["derive"], optional = true }
+rand = { version = "0.8", optional = true }

examples/prism-core/src/address.rs

@@ -134,16 +134,25 @@ pub fn parse(input: &str) -> Result<Address, ParseError> {
         if payload.len() < 41 {
             return Err(ParseError::InvalidMuxedPayload);
         }
-        let id_bytes: [u8; 8] = payload[1..9].try_into().map_err(|_| ParseError::InvalidMuxedPayload)?;
+        // SEP-0023 MuxedAccount payload layout:
+        //   version_byte || ed25519_pubkey(32) || muxed_id(8, big-endian)
+        let base_g = encode_g_address(&payload[1..33])?;
+        let id_bytes: [u8; 8] = payload[33..41]
+            .try_into()
+            .map_err(|_| ParseError::InvalidMuxedPayload)?;
         let muxed_id = u64::from_be_bytes(id_bytes);
-        let base_g = encode_g_address(&payload[9..41])?;
-        return Ok(Address { kind, raw: upper, base_g: Some(base_g), muxed_id: Some(muxed_id) });
+        return Ok(Address {
+            kind,
+            raw: upper,
+            base_g: Some(base_g),
+            muxed_id: Some(muxed_id),
+        });
     }
 
     Ok(Address { kind, raw: upper, base_g: None, muxed_id: None })
 }
 
-fn encode_g_address(key: &[u8]) -> Result<String, ParseError> {
+pub fn encode_g_address(key: &[u8]) -> Result<String, ParseError> {
     if key.len() != 32 {
         return Err(ParseError::InvalidMuxedPayload);
     }
@@ -195,16 +204,18 @@ mod tests {
 
     #[test]
     fn invalid_base32_character() {
+        // 56-char G-prefix string with a '0' at position 1.
         assert!(matches!(
-            parse("G0HJJJKMOKYE4RVPZEWZTKH5FVI4PA3VL7GK2LFNUBSGBV3PR5T4Q"),
+            parse("G0HJJJKMOKYE4RVPZEWZTKH5FVI4PA3VL7GK2LFNUBSGBV3PR5T4QABC"),
             Err(ParseError::InvalidBase32 { .. })
         ));
     }
 
     #[test]
     fn valid_g_address_parses() {
-        let result = parse("GAHJJJKMOKYE4RVPZEWZTKH5FVI4PA3VL7GK2LFNUBSGBV3PR5T4Q");
-        assert!(result.is_ok());
+        // Verified against the stellar-strkey reference decoder (0.0.18).
+        let result = parse("GAYCUYT553C5LHVE2XPW5GMEJT4BXGM7AHMJWLAPZP53KJO7EIQADRSI");
+        assert!(result.is_ok(), "unexpected error: {result:?}");
         let parsed = result.unwrap();
         assert_eq!(parsed.kind(), AddressKind::G);
         assert_eq!(parsed.base_g(), None);
@@ -213,8 +224,8 @@ mod tests {
 
     #[test]
     fn lowercase_normalised_correctly() {
-        let r_lower = parse("gahjjjkmokye4rvpzewztkh5fvi4pa3vl7gk2lfnubsgbv3pr5t4q");
-        let r_upper = parse("GAHJJJKMOKYE4RVPZEWZTKH5FVI4PA3VL7GK2LFNUBSGBV3PR5T4Q");
+        let r_lower = parse("gaycuyt553c5lhve2xpw5gmejt4bxgm7ahmjwlapzp53kjo7eiqadrsi");
+        let r_upper = parse("GAYCUYT553C5LHVE2XPW5GMEJT4BXGM7AHMJWLAPZP53KJO7EIQADRSI");
         assert_eq!(r_lower.is_ok(), r_upper.is_ok());
     }