diff --git a/Clarinet.toml b/Clarinet.toml
index 9228965..bca28fb 100644
--- a/Clarinet.toml
+++ b/Clarinet.toml
@@ -1,21 +1,19 @@
 [project]
-name = "AssetBridge"
-description = ""
+name = 'AssetBridge'
+description = ''
 authors = []
 telemetry = true
-cache_dir = "./.cache"
-
-# [contracts.counter]
-# path = "contracts/counter.clar"
-
+cache_dir = './.cache'
+requirements = []
+[contracts.asset-tokenization]
+path = 'contracts/asset-tokenization.clar'
+clarity_version = 3
+epoch = 3.1
 [repl.analysis]
-passes = ["check_checker"]
-check_checker = { trusted_sender = false, trusted_caller = false, callee_filter = false }
+passes = ['check_checker']
 
-# Check-checker settings:
-# trusted_sender: if true, inputs are trusted after tx_sender has been checked.
-# trusted_caller: if true, inputs are trusted after contract-caller has been checked.
-# callee_filter: if true, untrusted data may be passed into a private function without a
-# warning, if it gets checked inside. This check will also propagate up to the
-# caller.
-# More informations: https://www.hiro.so/blog/new-safety-checks-in-clarinet
+[repl.analysis.check_checker]
+strict = false
+trusted_sender = false
+trusted_caller = false
+callee_filter = false
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..71bc137
--- /dev/null
+++ b/README.md
@@ -0,0 +1,173 @@
+# AssetBridge: Advanced Real-World Asset Tokenization Protocol
+
+![Platform: Stacks](https://img.shields.io/badge/Platform-Stacks-5546FF)
+![Bitcoin: L2](https://img.shields.io/badge/Bitcoin-L2-orange)
+
+AssetBridge is a sophisticated smart contract protocol built on Stacks that enables the tokenization of real-world assets with secure fractional ownership capabilities. Leveraging Bitcoin's security through Stacks' PoX consensus, it provides a robust framework for creating, managing, and trading tokenized assets while maintaining regulatory compliance.
+
+## Key Features
+
+### Asset Tokenization
+
+- **Asset Creation**: Create digital representations of real-world assets with configurable supply and metadata
+- **Fractional Ownership**: Enable multiple investors to own shares of high-value assets
+- **Metadata Management**: Store and manage comprehensive asset information using IPFS/Arweave URIs
+- **Supply Configuration**: Flexible total supply and fractional share settings
+
+### Security & Compliance
+
+- **Bitcoin-Anchored Security**: Utilizes Stacks' PoX consensus for Bitcoin-level security
+- **Built-in Compliance**: Automated KYC/AML checks for all transfers
+- **Granular Access Control**: Administrative controls for compliance management
+- **Event Logging**: Comprehensive transaction and state change tracking
+
+### Ownership Management
+
+- **Secure Transfers**: Atomic ownership transfers with Bitcoin finality
+- **Share Management**: Efficient tracking of fractional ownership
+- **Compliance Verification**: Pre-transfer compliance checks
+- **NFT Integration**: Non-fungible tokens representing primary ownership
+
+## Technical Architecture
+
+### Core Components
+
+1. **Asset Registry**
+
+   - Tracks asset details and ownership
+   - Stores metadata URIs and configuration
+   - Manages transferability settings
+
+2. **Compliance System**
+
+   - Maintains user compliance status
+   - Tracks approval history
+   - Enforces transfer restrictions
+
+3. **Share Management**
+
+   - Handles fractional ownership accounting
+   - Manages share transfers
+   - Tracks individual balances
+
+4. **Event System**
+   - Logs all contract interactions
+   - Maintains audit trail
+   - Enables external monitoring
+
+## Smart Contract Interface
+
+### Public Functions
+
+#### Asset Management
+
+```clarity
+(create-asset
+  (total-supply uint)
+  (fractional-shares uint)
+  (metadata-uri (string-utf8 256))
+)
+```
+
+Creates a new tokenized asset with specified supply and share configuration.
+
+#### Ownership Transfer
+
+```clarity
+(transfer-fractional-ownership
+  (asset-id uint)
+  (to-principal principal)
+  (amount uint)
+)
+```
+
+Transfers fractional ownership shares between parties.
+
+#### Compliance Management
+
+```clarity
+(set-compliance-status
+  (asset-id uint)
+  (user principal)
+  (is-approved bool)
+)
+```
+
+Updates compliance status for users.
+
+### Read-Only Functions
+
+```clarity
+(get-asset-details (asset-id uint))
+(get-owner-shares (asset-id uint) (owner principal))
+(get-compliance-details (asset-id uint) (user principal))
+(get-event (event-id uint))
+```
+
+## Error Handling
+
+The contract defines several error constants for proper error handling:
+
+- `ERR-UNAUTHORIZED` (u1): Access control violation
+- `ERR-INSUFFICIENT-FUNDS` (u2): Insufficient balance for operation
+- `ERR-INVALID-ASSET` (u3): Invalid asset ID or reference
+- `ERR-TRANSFER-FAILED` (u4): Transfer operation failure
+- `ERR-COMPLIANCE-CHECK-FAILED` (u5): Failed compliance verification
+- `ERR-INVALID-INPUT` (u6): Invalid input parameters
+- `ERR-INSUFFICIENT-SHARES` (u7): Insufficient shares for transfer
+- `ERR-EVENT-LOGGING` (u8): Event logging failure
+
+## Security Considerations
+
+1. **Access Control**
+
+   - Contract owner privileges
+   - Compliance officer roles
+   - Transfer restrictions
+
+2. **Data Validation**
+
+   - Input parameter validation
+   - Asset existence checks
+   - Share balance verification
+
+3. **Compliance Enforcement**
+   - Automated compliance checks
+   - Transfer restrictions
+   - Administrative controls
+
+## Usage Examples
+
+### Creating a New Asset
+
+```clarity
+;; Create a new asset with 1000 total shares
+(contract-call? .asset-bridge create-asset
+  u1000 ;; total-supply
+  u10   ;; fractional-shares (minimum transfer amount)
+  "ipfs://QmXgZAUWd8Ua9vQMPLetPQb6DrwzYhUPJoYJewdYgQwYk2" ;; metadata-uri
+)
+```
+
+### Transferring Shares
+
+```clarity
+;; Transfer 100 shares to another user
+(contract-call? .asset-bridge transfer-fractional-ownership
+  u1    ;; asset-id
+  'ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM  ;; to-principal
+  u100  ;; amount
+)
+```
+
+## Development Setup
+
+1. Install Clarinet for local development
+2. Clone the repository
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Commit changes
+4. Submit a pull request
diff --git a/contracts/asset-tokenization.clar b/contracts/asset-tokenization.clar
new file mode 100644
index 0000000..7acf865
--- /dev/null
+++ b/contracts/asset-tokenization.clar
@@ -0,0 +1,258 @@
+;; AssetBridge: Advanced Real-World Asset Tokenization Protocol for Stacks
+;;
+;; A Bitcoin L2-native protocol enabling compliant tokenization of real-world assets
+;; with secure fractional ownership capabilities. Built on Stacks for enhanced
+;; security through Bitcoin settlement and PoX consensus.
+;;
+;; Core Technical Features:
+;; - Bitcoin-anchored security through Stacks' PoX consensus
+;; - Atomic ownership transfers with Bitcoin finality
+;; - Compliant fractional ownership with built-in KYC/AML hooks
+;; - Immutable asset provenance tracking
+;; - Advanced compliance controls for institutional requirements
+;;
+;; Security & Compliance:
+;; - Multi-layered security leveraging Bitcoin's hash power
+;; - Automated compliance checks for regulatory adherence
+;; - Granular transfer controls for institutional requirements
+;; - Event logging with Bitcoin block anchoring
+
+;; Constants
+(define-constant CONTRACT-OWNER tx-sender)
+(define-constant CONTRACT-ADMIN CONTRACT-OWNER)
+(define-constant ERR-UNAUTHORIZED (err u1))
+(define-constant ERR-INSUFFICIENT-FUNDS (err u2))
+(define-constant ERR-INVALID-ASSET (err u3))
+(define-constant ERR-TRANSFER-FAILED (err u4))
+(define-constant ERR-COMPLIANCE-CHECK-FAILED (err u5))
+(define-constant ERR-INVALID-INPUT (err u6))
+(define-constant ERR-INSUFFICIENT-SHARES (err u7))
+(define-constant ERR-EVENT-LOGGING (err u8))
+
+;; Data Variables
+(define-data-var next-asset-id uint u1)
+
+;; Data Maps
+(define-map asset-registry 
+  {asset-id: uint} 
+  {
+    owner: principal,
+    total-supply: uint,
+    fractional-shares: uint,
+    metadata-uri: (string-utf8 256),
+    is-transferable: bool,
+    created-at: uint
+  }
+)
+
+(define-map compliance-status 
+  {asset-id: uint, user: principal} 
+  {
+    is-approved: bool,
+    last-updated: uint,
+    approved-by: principal
+  }
+)
+
+(define-map share-ownership
+  {asset-id: uint, owner: principal}
+  {shares: uint}
+)
+
+;; NFT Definition
+(define-non-fungible-token asset-ownership-token uint)
+
+;; Events
+(define-data-var last-event-id uint u0)
+
+(define-map events
+  {event-id: uint}
+  {
+    event-type: (string-utf8 24),
+    asset-id: uint,
+    principal1: principal,
+    timestamp: uint
+  }
+)
+
+;; Private Functions - Event Logging
+(define-private (log-event 
+  (event-type (string-utf8 24))
+  (asset-id uint)
+  (principal1 principal)
+) 
+  (begin
+    (let ((event-id (+ (var-get last-event-id) u1)))
+      (map-set events
+        {event-id: event-id}
+        {
+          event-type: event-type,
+          asset-id: asset-id,
+          principal1: principal1,
+          timestamp: stacks-block-height
+        }
+      )
+      (var-set last-event-id event-id)
+      (ok event-id)
+    )
+  )
+)
+
+;; Private Functions - Validation
+(define-private (is-valid-metadata-uri (uri (string-utf8 256)))
+  (and 
+    (> (len uri) u0)
+    (<= (len uri) u256)
+    (> (len uri) u5)
+  )
+)
+
+(define-private (is-valid-asset-id (asset-id uint))
+  (and
+    (> asset-id u0)
+    (< asset-id (var-get next-asset-id))
+  )
+)
+
+(define-private (is-valid-principal (user principal))
+  (and
+    (not (is-eq user CONTRACT-OWNER))
+    (not (is-eq user (as-contract tx-sender)))
+  )
+)
+
+(define-private (is-compliance-check-passed 
+  (asset-id uint) 
+  (user principal)
+) 
+  (match (map-get? compliance-status {asset-id: asset-id, user: user})
+    compliance-data (get is-approved compliance-data)
+    false
+  )
+)
+
+;; Private Functions - Share Management
+(define-private (get-shares (asset-id uint) (owner principal))
+  (default-to u0 
+    (get shares 
+      (map-get? share-ownership {asset-id: asset-id, owner: owner})
+    )
+  )
+)
+
+(define-private (set-shares (asset-id uint) (owner principal) (amount uint))
+  (map-set share-ownership 
+    {asset-id: asset-id, owner: owner}
+    {shares: amount}
+  )
+)
+
+;; Public Functions - Asset Management
+(define-public (create-asset 
+  (total-supply uint) 
+  (fractional-shares uint)
+  (metadata-uri (string-utf8 256))
+)
+  (begin 
+    (asserts! (> total-supply u0) ERR-INVALID-INPUT)
+    (asserts! (> fractional-shares u0) ERR-INVALID-INPUT)
+    (asserts! (<= fractional-shares total-supply) ERR-INVALID-INPUT)
+    (asserts! (is-valid-metadata-uri metadata-uri) ERR-INVALID-INPUT)
+    
+    (let ((asset-id (var-get next-asset-id)))
+      (map-set asset-registry 
+        {asset-id: asset-id}
+        {
+          owner: tx-sender,
+          total-supply: total-supply,
+          fractional-shares: fractional-shares,
+          metadata-uri: metadata-uri,
+          is-transferable: true,
+          created-at: stacks-block-height
+        }
+      )
+      
+      ;; Initialize share ownership
+      (set-shares asset-id tx-sender total-supply)
+      
+      (unwrap! (nft-mint? asset-ownership-token asset-id tx-sender) ERR-TRANSFER-FAILED)
+      (unwrap! (log-event u"ASSET_CREATED" asset-id tx-sender) ERR-EVENT-LOGGING)
+      
+      (var-set next-asset-id (+ asset-id u1))
+      (ok asset-id)
+    )
+  )
+)
+
+(define-public (transfer-fractional-ownership 
+  (asset-id uint) 
+  (to-principal principal) 
+  (amount uint)
+)
+  (let (
+    (asset (unwrap! (map-get? asset-registry {asset-id: asset-id}) ERR-INVALID-ASSET))
+    (sender tx-sender)
+    (sender-shares (get-shares asset-id sender))
+  )
+    (asserts! (is-valid-asset-id asset-id) ERR-INVALID-INPUT)
+    (asserts! (is-valid-principal to-principal) ERR-INVALID-INPUT)
+    (asserts! (get is-transferable asset) ERR-UNAUTHORIZED)
+    (asserts! (is-compliance-check-passed asset-id to-principal) ERR-COMPLIANCE-CHECK-FAILED)
+    (asserts! (>= sender-shares amount) ERR-INSUFFICIENT-SHARES)
+    
+    ;; Update share balances
+    (set-shares asset-id sender (- sender-shares amount))
+    (set-shares asset-id to-principal (+ (get-shares asset-id to-principal) amount))
+    
+    (unwrap! (log-event u"TRANSFER" asset-id sender) ERR-EVENT-LOGGING)
+    
+    (if (is-eq sender-shares amount)
+      (unwrap! (nft-transfer? asset-ownership-token asset-id sender to-principal) ERR-TRANSFER-FAILED)
+      true
+    )
+    
+    (ok true)
+  )
+)
+
+(define-public (set-compliance-status 
+  (asset-id uint) 
+  (user principal) 
+  (is-approved bool)
+)
+  (begin
+    (asserts! (is-valid-asset-id asset-id) ERR-INVALID-INPUT)
+    (asserts! (is-valid-principal user) ERR-INVALID-INPUT)
+    (asserts! (is-eq tx-sender CONTRACT-OWNER) ERR-UNAUTHORIZED)
+    
+    (map-set compliance-status 
+      {asset-id: asset-id, user: user} 
+      {
+        is-approved: is-approved,
+        last-updated: stacks-block-height,
+        approved-by: tx-sender
+      }
+    )
+    
+    (unwrap! (log-event u"COMPLIANCE_UPDATE" asset-id user) ERR-EVENT-LOGGING)
+    
+    (ok is-approved)
+  )
+)
+
+;; Read-only Functions
+(define-read-only (get-asset-details (asset-id uint))
+  (map-get? asset-registry {asset-id: asset-id})
+)
+
+(define-read-only (get-owner-shares (asset-id uint) (owner principal))
+  (ok (get-shares asset-id owner))
+)
+
+(define-read-only (get-compliance-details (asset-id uint) (user principal))
+  (map-get? compliance-status {asset-id: asset-id, user: user})
+)
+
+(define-read-only (get-event (event-id uint))
+  (map-get? events {event-id: event-id})
+)
\ No newline at end of file
diff --git a/tests/asset-tokenization.test.ts b/tests/asset-tokenization.test.ts
new file mode 100644
index 0000000..4bb9cf3
--- /dev/null
+++ b/tests/asset-tokenization.test.ts
@@ -0,0 +1,21 @@
+
+import { describe, expect, it } from "vitest";
+
+const accounts = simnet.getAccounts();
+const address1 = accounts.get("wallet_1")!;
+
+/*
+  The test below is an example. To learn more, read the testing documentation here:
+  https://docs.hiro.so/stacks/clarinet-js-sdk
+*/
+
+describe("example tests", () => {
+  it("ensures simnet is well initalised", () => {
+    expect(simnet.blockHeight).toBeDefined();
+  });
+
+  // it("shows an example", () => {
+  //   const { result } = simnet.callReadOnlyFn("counter", "get-counter", [], address1);
+  //   expect(result).toBeUint(0);
+  // });
+});