Scaffold ledgerlens-score Soroban contract and project docs

Adds the on-chain risk score registry contract (submit_score/get_score
plus admin/service management), workspace tooling (CI, rustfmt,
clippy), and consolidates project docs into a single README covering
the contract and the org-wide architecture.

Author: Inkman007

.github/workflows/ci.yml

@@ -0,0 +1,48 @@
+name: Contract CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  fmt:
+    name: Format check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt
+      - run: cargo fmt --all -- --check
+
+  clippy:
+    name: Clippy
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy
+      - run: cargo clippy --all-targets -- -D warnings
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - run: cargo test
+
+  build:
+    name: Build (wasm32)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: wasm32-unknown-unknown
+      - run: cargo build --target wasm32-unknown-unknown --release

.gitignore

@@ -0,0 +1,5 @@
+/target
+**/*.rs.bk
+.soroban
+*.wasm
+.env

CONTRIBUTING.md

@@ -0,0 +1,36 @@
+# Contributing to LedgerLens Contract
+
+Thanks for your interest in improving the LedgerLens on-chain risk score registry.
+
+## Getting Started
+
+1. Install the Rust toolchain (stable) and the `wasm32-unknown-unknown` target:
+   ```bash
+   rustup target add wasm32-unknown-unknown
+   ```
+2. Fork the repo and create a feature branch off `main`.
+3. Make your changes inside `contracts/ledgerlens-score/`.
+
+## Before Opening a Pull Request
+
+Run the same checks CI runs:
+
+```bash
+cargo fmt --all -- --check
+cargo clippy --all-targets -- -D warnings
+cargo test
+cargo build --target wasm32-unknown-unknown --release
+```
+
+## Guidelines
+
+- Keep `contracts/ledgerlens-score/src/types.rs` changes minimal and deliberate — `RiskScore` and `DataKey` are shared, cross-repo data contracts (see [README.md § Organization Architecture](README.md#organization-architecture)). Any field/shape change is breaking for the `api`, `core`, and `dashboard` repos and must be coordinated.
+- Add or update tests in `src/test.rs` for any behavioral change.
+- Keep error codes in `errors.rs` stable; append new variants rather than reordering or removing existing ones, since their numeric values are part of the deployed contract's ABI.
+- Update `README.md` if you change contract function signatures, events, or the deployment flow in `deploy.sh`.
+
+## Submitting a Pull Request
+
+- Describe what changed and why.
+- Note any cross-repo coordination needed (e.g. "requires `api` to update its `RiskScore` schema").
+- Ensure all CI checks pass.