MSA API Documentation
A powerful API for creating and managing Account Abstraction (AA) wallets with multi-signature and passkey support.
Welcome to the MSA (Multi-Signature Account) API documentation. This comprehensive API enables you to create and manage Account Abstraction (AA) wallets with advanced security features including multi-signature validation, passkey authentication, and HSM/MPC signing.
What is MSA API?
The MSA API is a robust Go-based service that provides:
- Account Abstraction Wallets: Create smart contract wallets with programmable logic
- Multiple Custody Types: Support for ECDSA, Passkey, and Multi-signature validation
- Enterprise Security: Integration with HSM/MPC signing services (Fireblocks)
- Cross-Chain Support: Works across multiple EVM-compatible networks
- Developer-Friendly: RESTful API with comprehensive SDKs
Key Features
🏦 Advanced Wallet Management
Create, predict, and manage Account Abstraction wallets with various custody options.
🔐 Multiple Authentication Methods
Support for ECDSA signatures, passkeys, and multi-signature validation.
⚡ Transaction Execution
Execute transactions with gas optimization and batch operations support.
🌐 Multi-Language Support
TypeScript SDK plus HTTP examples for JavaScript, Python, and more.
Supported Custody Types
The MSA API supports five different wallet custody configurations:
| Type | Description | Use Cases |
|---|---|---|
| ECDSA_VALIDATOR (1) | Traditional ECDSA signature validation | Standard wallet operations |
| ECDSA_PASSKEY_VALIDATOR (2) | Hybrid ECDSA + Passkey validation | Enhanced security with biometrics |
| PASSKEY_VALIDATOR (3) | Pure passkey-based validation | Passwordless authentication |
| MULTISIG_VALIDATOR (4) | Traditional multi-signature setup | Shared custody scenarios |
| MULTISIG_PASSKEY_VALIDATOR (5) | Multi-sig with passkey support | Enterprise-grade security |
Quick Start
Get started with MSA API in three simple steps:
- Set up Authentication - Configure your HSM/MPC credentials
- Create Your First Wallet - Deploy an Account Abstraction wallet
- Execute Transactions - Send your first transaction
API Overview
The MSA API provides the following main endpoint categories:
- Wallet Management: Create, predict, and check wallet status
- Transaction Execution: Execute operations with various validation methods
- Gas Management: Estimate and optimize transaction costs
- Contract Interaction: Read contract state and decode events
- Utilities: Message signing, receipt fetching, and troubleshooting
Documentation Sections
Getting Started
- Introduction - Learn Account Abstraction concepts
- Authentication - Configure HSM/MPC credentials
- Quick Start - Create your first wallet in 5 minutes
Wallet Management
- Creating Wallets - Deploy smart contract wallets
- Predicting Addresses - Calculate wallet addresses
- Checking Wallets - Verify wallet existence
- Custody Types - Understand all custody configurations
Transaction Execution
- Basic Execution - Execute standard transactions
- Encoded Execution - Execute pre-encoded UserOperations
- Passkey Execution - Sign with passkeys
- Gas Estimation - Optimize transaction costs
SDK
- TypeScript SDK - Type-safe SDK with full features
Integration Examples
- JavaScript Examples - Native browser HTTP examples
- Python Examples - Python HTTP examples
- cURL Examples - Command-line testing
Advanced Features
- Multi-Signature Wallets - Complete multisig guide
- Passkey Authentication - Passkey integration guide
- Troubleshooting - Common issues and solutions
API Reference
- API Overview - Complete API endpoint reference
- Interactive API Docs - Try endpoints in your browser
Quick Links
⚡ Quick Start Guide
🔧 Interactive API Reference
📦 TypeScript SDK
🔐 Custody Types
Technology Stack
MSA API is built with modern technologies:
- Backend: Go-based API service
- Signing: Fireblocks HSM/MPC integration
- Smart Contracts: ERC-4337 Account Abstraction
- SDK: TypeScript SDK (
@omnes/smartwallet-ts-sdk) - Examples: HTTP examples for JavaScript, Python, cURL
- Networks: Polygon, Base, Ethereum (all EVM-compatible chains)
Resources
- API Base URL:
https://api.msa.omnes.tech - Official Website: omnes.dev
- Documentation: This site
- SDK Repository: GitHub
- Examples: GitHub Examples
- Support: Discord Community
🚀 Ready to Build? Start with our Quick Start Guide or explore the Interactive API Reference to try endpoints directly in your browser.
Need a private key to get started? Contact us to request access and begin using the MSA API.
Need Help? Join our Discord community or check out the troubleshooting guide for common issues.
Built with ❤️ by the Omnes Team | Making Account Abstraction accessible to developers worldwide