Motr is Sonr's decentralized vault and identity management system. It provides secure credential and profile management with online/offline capabilities through a progressive web application architecture.

Features

Secure Identity Management: WebAuthn credential storage and verification
Progressive Web App: Works online and offline with service worker integration
WASM Architecture: Core functionality compiled to WebAssembly for cross-platform compatibility
Local-First Design: Data stored locally with sync capabilities to the Sonr blockchain
Containerized Deployment: Docker-based deployment for all components

Installation

Standard Installation

git clone https://github.com/sonr-io/motr.git
cd motr
go mod tidy

Docker Installation

git clone https://github.com/sonr-io/motr.git
cd motr
docker-compose up -d

Usage

Run Using Docker

The simplest way to run the full Motr system is with Docker Compose:

# Start all services
docker-compose up -d

# View logs
docker-compose logs -f

# Stop services
docker-compose down

Run as a Local Server

package main

import (
 "database/sql"
 "log"

 "github.com/sonr-io/motr/app"
 "github.com/sonr-io/motr/pkg/models"
 "github.com/sonr-io/motr/pkg/types"
)

func main() {
 dbq, err := setupDatabase()
 if err != nil {
  log.Fatal(err)
 }

 config := &types.Config{
  MotrToken: "your-token",
  SonrChainID: "sonr-testnet-1",
  // Other configuration options
 }

 vault, err := app.New(config, dbq)
 if err != nil {
  log.Fatal(err)
 }

 // Start the server
 vault.Start(":8080")
}

func setupDatabase() (*models.Queries, error) {
 // Initialize your database connection
 // ...
}

Compile to WebAssembly

# Build the signer as WASM
GOOS=js GOARCH=wasm go build -o build/signer.wasm ./cmd/signer/main.go

# Build the controller application as WASM
GOOS=js GOARCH=wasm go build -o build/controller.wasm ./controller/main.go

# Build the resolver application for Cloudflare Workers
GOOS=js GOARCH=wasm go build -o build/resolver.wasm ./resolver/main.go

Progressive Web App Integration

Motr can be integrated into progressive web applications, providing:

Offline functionality via service workers
Secure credential storage
Seamless blockchain account management
Cross-device synchronization

Architecture

Motr consists of several components:

Controller: Manages WebAuthn credential creation and verification
Resolver: Handles name resolution and identity lookups
Signer: WebAssembly-based cryptographic operations for secure signing
Service Worker: Handles offline capabilities and request caching
IndexedDB Storage: Local data persistence
Sonr Blockchain Integration: Identity verification and data synchronization

Component Details

Controller
- Manages user credentials and authentication
- Integrates with WebAuthn for credential storage
- Containerized for easy deployment
Resolver
- Resolves Sonr names to addresses and profiles
- Serves as a gateway to the Sonr network
- Implemented as a Cloudflare Worker
Signer
- Secure cryptographic operations
- WebAssembly-based for cross-platform compatibility
- Handles key management and signatures

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT