Smart contract functionality via revive pallet

.github/env

@@ -3,3 +3,5 @@ POLKADOT_SDK_VERSION=polkadot-stable2603
 ZOMBIENET_VERSION=v0.4.11
 CI_IMAGE=docker.io/paritytech/ci-unified:bullseye-1.93.0-2026-01-27-v202603042356
 NODE_VERSION=22
+SOLC_VERSION=0.8.34
+RESOLC_VERSION=1.1.0

.github/workflows/integration-tests.yml

@@ -201,6 +201,31 @@ jobs:
       - name: Run PAPI drive-lifecycle demo
         run: just drain-tx-pool-then papi-drive-lifecycle "http://127.0.0.1:3333" "//Alice" "//Bob" "//Ferdie"
 
+      - name: Install solc and resolc for smart-contract demo
+        run: |
+          curl -L -o /usr/local/bin/solc \
+            "https://github.com/ethereum/solidity/releases/download/v${SOLC_VERSION}/solc-static-linux"
+          curl -L -o /usr/local/bin/resolc \
+            "https://github.com/paritytech/revive/releases/download/v${RESOLC_VERSION}/resolc-x86_64-unknown-linux-musl"
+          chmod +x /usr/local/bin/solc /usr/local/bin/resolc
+          solc --version
+          resolc --version
+
+      - name: Build example marketplace contract
+        run: just build-contracts
+
+      - name: Run smart-contract end-to-end demo
+        run: just drain-tx-pool-then sc-demo "http://127.0.0.1:3333" "//Alice" "//Bob"
+
+      - name: Run smart-contract precompile-coverage e2e
+        run: just drain-tx-pool-then sc-coverage "http://127.0.0.1:3333" "//Alice" "//Bob"
+
+      - name: Run SharedTeamDrive dApp e2e
+        run: just drain-tx-pool-then sc-team-drive "http://127.0.0.1:3333" "//Alice" "//Bob"
+
+      - name: Run TokenGatedDrive dApp e2e
+        run: just drain-tx-pool-then sc-token-gated "http://127.0.0.1:3333" "//Alice" "//Bob"
+
       - name: Stop services
         if: always()
         run: |

CLAUDE.md

@@ -220,6 +220,10 @@ web3-storage/
 ├── primitives/                 # Layer 0 shared types and utilities
 │   ├── src/lib.rs            # Common types
 │   └── Cargo.toml            # Primitive dependencies
+├── precompiles/                # pallet_revive precompiles (Solidity → pallets)
+│   ├── storage-provider-precompile/  # 0x…0901 — bucket lifecycle
+│   └── drive-registry-precompile/    # 0x…0902 — drive lifecycle
+├── examples/contracts/         # Example Solidity dApps (StorageMarketplace.sol)
 ├── storage-interfaces/         # Layer 1 - High-level interfaces
 │   └── file-system/           # File System Interface
 │       ├── primitives/        # File system types (DriveInfo, CommitStrategy, etc.)
@@ -274,6 +278,8 @@ web3-storage/
 
 **Primitives (`primitives/`)**: Shared types used across pallet, provider node, and client.
 
+**Smart Contracts (`precompiles/`, `examples/contracts/`)**: `pallet_revive` (PolkaVM-based smart contracts) is wired into both runtimes. Two custom precompiles expose the client-side bucket lifecycle and drive registry to Solidity contracts. The `StorageMarketplace.sol` example shows how a dApp buys storage on behalf of its users; `just sc-demo` runs the end-to-end PAPI test. Full design in [docs/design/smart-contracts.md](docs/design/smart-contracts.md).
+
 #### Layer 1 (File System Interface)
 
 **File System Primitives (`storage-interfaces/file-system/primitives/`)**: High-level types for file system: