Installation Guide
Choose your platform to get started with MetaMUI Crypto Primitives. All implementations are built from source – there are no published packages on public registries.
Prerequisites
Clone the repository first:
git clone https://github.com/SovereignWallet-Network/metamui-crypto-primitives.git
cd metamui-crypto-primitives
Build from Source
Python
cd metamui-crypto-python
pip install -e .
Requirements:
- Python 3.8 or higher
- pip package manager
Rust
cd metamui-crypto-rust
cargo build --release
Requirements:
- Rust 1.70 or higher
- Cargo package manager
TypeScript/JavaScript
cd metamui-crypto-typescript
npm install
npm run build
Requirements:
- Node.js 16 or higher
- npm package manager
Swift
cd metamui-crypto-swift
swift build
Requirements:
- Swift 5.7 or higher
- Swift Package Manager
Kotlin
cd metamui-crypto-kotlin
./gradlew build
Requirements:
- Kotlin 1.8 or higher
- Gradle
Go
cd metamui-crypto-go
go build ./...
Requirements:
- Go 1.20 or higher
Java
cd metamui-crypto-java
mvn compile
Requirements:
- Java 8 or higher
- Maven
C#
cd metamui-crypto-csharp
dotnet build
Requirements:
- .NET 6.0 or higher
C
cd metamui-crypto-c
make
Requirements:
- C compiler (GCC, Clang, or MSVC)
- Make or CMake
WASM
cd metamui-crypto-typescript/packages/falcon
npm install
npm run build
Requirements:
- Node.js 16 or higher
- Modern browser with WebAssembly support (for browser usage)
Verify Build
Python
cd metamui-crypto-python
python3 -m pytest tests/ -v
Rust
cd metamui-crypto-rust
cargo test
Go
cd metamui-crypto-go
go test ./...
Platform-Specific Notes
Python
- Pure Python implementation
- Type hints included for better IDE support
Rust
- Feature flags for algorithm selection
no_stdsupport for embedded systems
TypeScript/JavaScript
- Full TypeScript definitions included
- Works in both Node.js and browsers
Swift
- Supports iOS 13+, macOS 10.15+
Kotlin
- JVM and Android support
- Java interoperability
WASM
- Uses non-NIST encoding (896-byte PK, 666-byte fixed sig)
- Crypto correctness verified via Rust backend
Troubleshooting
Common Issues
Python: ImportError
# Ensure you have the latest pip
pip install --upgrade pip
# Then reinstall
cd metamui-crypto-python && pip install -e .
Rust: Build errors
# Clean and rebuild
cargo clean
cargo build --release
TypeScript: Type errors
# Ensure TypeScript is updated
npm install --save-dev typescript@latest
WASM: Module not found
// For webpack, add to config:
experiments: {
asyncWebAssembly: true
}