✨ feat: bootstrap aelf rust sdk alpha workspace

Author: aelf-hzz780

.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: ci
+
+on:
+  push:
+    branches:
+      - "**"
+  pull_request:
+
+jobs:
+  msrv:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@1.85.0
+      - uses: Swatinem/rust-cache@v2
+      - name: msrv
+        run: cargo check --workspace --all-targets --all-features --locked
+
+  test:
+    runs-on: ubuntu-latest
+    needs: msrv
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - name: install cargo-audit
+        run: cargo install cargo-audit --locked
+      - name: fmt
+        run: cargo fmt --all -- --check
+      - name: clippy
+        run: cargo clippy --workspace --all-targets --all-features -- -D warnings
+      - name: audit
+        run: cargo audit
+      - name: examples
+        run: cargo check --workspace --examples
+      - name: test
+        run: cargo test --workspace --all-targets

.github/workflows/publish.yml

@@ -0,0 +1,29 @@
+name: publish
+
+on:
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: "Run cargo publish in dry-run mode"
+        required: true
+        default: true
+        type: boolean
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - name: verify workspace publish
+        if: inputs.dry_run
+        run: cargo publish --workspace --dry-run --locked
+      - name: publish workspace crates
+        if: ${{ !inputs.dry_run }}
+        env:
+          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
+        run: cargo publish --workspace --locked --token "$CARGO_REGISTRY_TOKEN"

.gitignore

@@ -0,0 +1,2 @@
+/target
+.DS_Store

CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+All notable changes to `aelf-sdk.rust` will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0-alpha.0] - 2026-03-10
+
+### Added
+
+- Workspace-based Rust SDK layout with `aelf-sdk`, `aelf-client`, `aelf-contract`, `aelf-crypto`, `aelf-keystore`, and `aelf-proto`
+- Typed wrappers for Zero, Token, Election, Vote, CrossChain, and AEDPoS contracts
+- Dynamic contract calls backed by on-chain descriptor loading
+- JS-compatible keystore import/export with fixture compatibility
+- Public-node examples and verification flows for readonly calls and raw transactions
+- Provider mock support and offline network-layer regression tests
+- A manual GitHub Actions publish workflow for crates.io dry-runs and releases
+
+### Changed
+
+- Sensitive key material now uses zeroization and redacted `Debug` output
+- `HttpProvider` now retries transient `5xx` and transport failures with configurable exponential backoff
+- Dynamic contract descriptor cache now uses a bounded 64-entry LRU cache
+- Public DTOs and contract APIs now include rustdoc coverage
+- The workspace now declares Rust `1.85` as its MSRV and CI enforces it with a dedicated toolchain job
+
+### Fixed
+
+- Public-node compatibility for `send_transaction`, `create_raw_transaction`, and dynamic JSON address/hash normalization
+- Null-safe deserialization for transaction result payloads returned by public nodes
+- JS / C# keystore compatibility edge cases, including `dkLen` alias handling
+- `wiremock` is pinned to the latest pre-`let-chain` release so test-only dependencies do not inflate the SDK MSRV

CONTRIBUTING.md

@@ -0,0 +1,52 @@
+# Contributing
+
+## Development Setup
+
+1. Install Rust `1.85` or newer.
+2. Clone the repository and fetch submodules if your workflow requires them.
+3. Build the workspace:
+
+```bash
+cargo check --workspace
+```
+
+## Required Checks
+
+Run these commands before opening a PR:
+
+```bash
+cargo fmt --all
+cargo +1.85.0 check --workspace --all-targets --all-features --locked
+cargo clippy --workspace --all-targets --all-features -- -D warnings
+cargo audit
+cargo check --workspace --examples
+cargo test --workspace
+```
+
+Optional local-node validation:
+
+```bash
+cargo test -p aelf-sdk --test local_node -- --ignored
+```
+
+## Repository Layout
+
+- `crates/aelf-sdk`: public facade crate
+- `crates/aelf-client`: HTTP client, DTOs, transaction builder
+- `crates/aelf-contract`: typed and dynamic contract bindings
+- `crates/aelf-crypto`: wallet, signing, address utilities
+- `crates/aelf-keystore`: JS-compatible keystore support
+- `crates/aelf-proto`: generated protobuf bindings
+- `examples/`: runnable examples wired into `aelf-sdk`
+
+## Pull Requests
+
+- Keep changes scoped to one problem or feature.
+- Add or update tests for every behavior change.
+- Document public API additions with rustdoc.
+- Update `README.md`, `README.zh.md`, or `CHANGELOG.md` when user-facing behavior changes.
+- Keep the documented MSRV at Rust `1.85` and preserve the hard `cargo +1.85.0 check --workspace --all-targets --all-features --locked` CI gate.
+
+## Commit Style
+
+Use Conventional Commit / `git-cz` style messages in English and keep the matching emoji prefix used by the repository workflow.