Seed contracts repo scaffold and interface notes

README.md

@@ -0,0 +1,14 @@
+# EDUT Contracts
+
+On-chain contracts and deployment artifacts for membership and entitlements.
+
+## Scope
+
+1. Membership contract (soulbound utility access).
+2. Offer registry contract interfaces.
+3. Entitlement contract interfaces.
+4. ABI and deployment artifact publication.
+
+## Boundary
+
+Contracts are settlement primitives. Runtime execution remains off-chain and fail-closed by entitlement state.

docs/contract-roadmap.md

@@ -0,0 +1,14 @@
+# Contracts Roadmap
+
+## Scope
+
+1. Membership contract (soulbound).
+2. Offer registry contract.
+3. Entitlement contract.
+
+## Requirements
+
+1. One ownership wallet can hold membership + multiple entitlements.
+2. Membership contract supports deterministic pricing policy inputs.
+3. Entitlement minting records recipient ownership wallet.
+4. Contract events are sufficient for backend reconciliation.

docs/deployment-checklist.md

@@ -0,0 +1,8 @@
+# Contracts Deployment Checklist
+
+1. Compile and verify bytecode reproducibility.
+2. Deploy contracts to target chain.
+3. Publish contract addresses and ABI.
+4. Verify source on block explorer.
+5. Record deployment evidence and policy hash snapshot.
+6. Update dependent repos with versioned addresses.

docs/interfaces.md

@@ -0,0 +1,19 @@
+# Contracts Interface Notes
+
+## Core Contracts
+
+1. Membership contract (soulbound utility access).
+2. Offer registry contract.
+3. Entitlement contract.
+
+## Required Events
+
+1. `MembershipMinted`
+2. `MembershipStatusUpdated`
+3. `OfferUpserted`
+4. `EntitlementMinted`
+5. `EntitlementStateChanged`
+
+## Backend Dependency
+
+Backend must reconcile on-chain events into deterministic membership/entitlement status for runtime gates.