Block Street 백서 전문

earlier and longer-held stake without separate participation modes Future protocol modules can connect to the same staking layer through published epoch rules and proposal selection processes See BlockStreet Staking for the full structure. Network Effects More Users ← Better Prices ← More Competition ← More Issuers ↓ ↑ ↓ ↑ More Volume → More Data → Better Algorithms → Better UX ↓ ↑ ↓ ↑ More Value ← Innovation ← Developer Interest ← Success Stories As the ecosystem grows, each component reinforces the others, creating powerful network effects that benefit all participants. User Journey Examples Individual Investor Journey Discovers tokenized assets through Aqua's best-price execution Supplies stablecoins to Everst Protocol to earn yield Borrows AAPL tokens with confidence of competitive pricing Benefits from Aqua automatically finding best rates across issuers Scales strategy across multiple tokenized assets seamlessly DeFi Application Builder Journey Integrates Aqua APIs for tokenized asset functionality Accesses deep liquidity from multiple issuers immediately Builds innovative products without infrastructure burden Scales application using proven tokenized asset infrastructure Expands to new assets as they're added to the ecosystem Asset Issuer Journey Joins Aqua aggregation to reach DeFi users Competes transparently for order flow through better pricing Scales operations through shared infrastructure Integrates with Everst Protocol for lending use cases Benefits from ecosystem growth and innovation Ecosystem Participants Core Infrastructure Everst Protocol Team : Maintaining lending infrastructure and expanding asset support Aqua Infrastructure Team : Developing aggregation technology and issuer integrations Security & Compliance : Ensuring enterprise-grade safety across all operations Business Development : Onboarding issuers and expanding ecosystem partnerships Issuer Network Primary Issuers : Established tokenized asset providers (Backed, Swarm, etc.) Emerging Issuers : New players entering tokenized asset markets Traditional Finance Partners : Banks and brokers exploring tokenization Market Makers : Providing liquidity and competitive pricing Developer Ecosystem Application Builders : Creating user-facing tokenized asset applications Integration Partners : Wallets and platforms adding tokenized asset support Analytics Providers : Building data and insights layers Infrastructure Contributors : Open source developers and auditors User Community Individual Users : Accessing tokenized assets for the first time Professional Traders : Executing sophisticated strategies Institutions : Professional asset managers and funds Educators : Teaching and promoting tokenized asset adoption Competitive Advantages Ecosystem Moat 🏗️ Infrastructure Depth First-mover advantage in both lending and aggregation Deep technical expertise in tokenized asset operations Proven ability to attract and integrate multiple issuers Professional-grade security and compliance frameworks 🌐 Network Effects More users attract more issuers, creating better prices More issuers create more competition, benefiting users Developer ecosystem builds on proven infrastructure Success stories attract institutional adoption 🔒 Trust and Security Battle-tested security with institutional users Comprehensive audit history and professional operations Regulatory-compliant approach to tokenized assets Transparent, verifiable infrastructure ⚡ Technical Innovation Hybrid architecture optimizing for performance and security Advanced aggregation algorithms driving best execution Continuous innovation in tokenized asset infrastructure Open-source approach enabling community contributions Future Ecosystem Growth Product Expansion 📊 Analytics & Intelligence Real-time tokenized asset market data Professional portfolio analytics and insights Market intelligence and research capabilities Performance tracking and optimization tools 🛡️ Risk Management Suite Advanced risk modeling for tokenized assets Portfolio optimization and hedging tools Compliance monitoring and reporting Institutional-grade risk controls 🌍 Global Market Access International tokenized asset support Cross-border compliance and regulatory frameworks Local market expertise and partnerships Multi-currency and multi-jurisdiction capabilities Ecosystem Development 👥 Partner Program Incentive structures for new issuer onboarding Technical support and integration assistance Co-marketing and growth partnerships Revenue sharing models 💰 Developer Grants Funding for innovative tokenized asset applications Technical mentorship and support programs Open source contribution rewards Community building and education initiatives 🎓 Education & Research Tokenized asset education and training programs Industry research and thought leadership Best practices development and sharing Regulatory advocacy and engagement Ecosystem Value Creation BlockStreet's ecosystem creates value through network effects and infrastructure sharing: 🔄 Network Effects : More participants create better prices, deeper liquidity, and increased innovation opportunities for everyone. 🏗️ Shared Infrastructure : Common security, compliance, and technical frameworks reduce costs and accelerate development for all participants. 📈 Competitive Marketplace : Transparent competition drives innovation and ensures users benefit from the best available services. 🌱 Innovation Foundation : Proven infrastructure enables rapid experimentation and development of new tokenized asset applications. Join Our Ecosystem 🚀 Ready to Start? Users : Get Started with Everst Protocol Builders : Integrate with Aqua Infrastructure Issuers : Join Our Aggregation Network 🤝 Partnership Opportunities Strategic Partnerships : Collaborate on tokenized asset innovation Technical Integration : Build deeper ecosystem connections Business Development : Expand market reach and capabilities Investment : Participate in the tokenized asset revolution BlockStreet: The Unified Liquidity Layer for On-Chain Capital Markets "Aqua handles the flow, Everst drives the leverage." Ready to be part of the tokenized asset ecosystem? Explore Our Products → | See Our Vision → | Get Started → ## /docs/smart-contracts/overview Smart contracts Overview Architecture Overview Aqua's smart contract infrastructure consists of five core components that work together to enable multi-issuer tokenized asset aggregation. The system implements a hub-and-spoke architecture with the Manager Contract as the central coordinator and specialized registry and executor contracts handling specific responsibilities. Contract Architecture Diagram Contract Relationships Central Coordination Manager Contract (Hub) Serves as the single entry point for all trade execution Coordinates between registries and executors Implements EIP-712 signature verification for quotes Maintains upgradeability through UUPS pattern Registry Layer Token Registry Maps token symbols to contract addresses and issuers Implements role-based access control (ISSUER_ROLE) Supports multi-issuer tokens for the same underlying asset Provides token validation and issuer lookup services Executor Registry Maps issuer addresses to their executor contracts Maintains simple address-to-address mapping Enables dynamic executor updates and hot-swapping Supports system expansion with new issuers Execution Layer Executor Contracts Implement standardized IExecutor interface Adapt between Manager Contract and issuer-specific protocols Handle issuer-specific business logic and authentication Enable support for diverse issuer architectures Data Flow Architecture Trade Execution Flow Security and Upgrade Framework Access Control Matrix Contract Upgrade Authorization Admin Functions Special Roles Manager Owner only Signer updates, registry addresses Owner Token Registry DEFAULT_ADMIN_ROLE Token management ISSUER_ROLE Executor Registry Owner only Executor registration Owner Executors Varies by implementation Issuer-specific Implementation-dependent UUPS Upgradeability Consistent Pattern Across All Core Contracts function _authorizeUpgrade ( address newImplementation ) internal override onlyOwner {} Upgrade Safety Measures Storage layout preservation requirements Initialize pattern for proxy compatibility Version control and rollback capabilities Emergency upgrade procedures for security incidents Contract Interactions Manager ↔ Registry Integration Token Registry Queries getIssuerForToken(address) - Resolve token to issuer isTokenActive(address) - Verify token availability Executor Registry Queries getExecutor(address) - Resolve issuer to executor contract Manager ↔ Executor Integration Standardized Interface Calls executeBuy(address, address, uint256, uint256) - Process buy orders executeSell(address, address, uint256, uint256) - Process sell orders Parameter Flow User address for token delivery/collection Token contract for asset identification Amount for quantity specification Payment/payout for value transfer System Evolution Adding New Issuers Deploy Executor Contract - Implement IExecutor interface for new issuer Register in Executor Registry - Map issuer address to executor Configure Token Registry - Register issuer's tokens with ISSUER_ROLE Integration Testing - Validate end-to-end functionality Contract Upgrades Implementation Development - Create new contract version Security Audit - Comprehensive security review Staging Validation - Test on staging environment Production Upgrade - Deploy with proper authorization Post-Upgrade Monitoring - Verify successful operation Gas Optimization Strategy Efficient Query Patterns Single external calls for registry lookups Minimal state changes during execution Optimized storage layouts across contracts Event indexing for off-chain efficiency Transaction Cost Management Batch operations where possible Storage slot packing for related variables Reduced validation logic in hot paths Pre-computed values for frequent operations This smart contract architecture provides a robust, scalable, and secure foundation for Aqua's multi-issuer tokenized asset aggregation platform, enabling efficient trade execution while maintaining operational flexibility and system evolution capabilities. ## /docs/architecture/system-components Architecture System Components Architecture Overview Aqua's hybrid architecture consists of six core components that work together to provide seamless liquidity aggregation for tokenized assets. The system combines off-chain price discovery with on-chain execution to optimize both performance and security. Off-Chain Components Off-Chain Backend Purpose : Handles quote aggregation and price discovery Technology : API server with RFQ (Request for Quote) engine The off-chain backend serves as the intelligence layer of Aqua: Quote Aggregation : Collects prices from multiple issuers and market makers Best Price Selection : Analyzes all available quotes to determine optimal execution Signed Quote Generation : Creates cryptographically signed quotes using EIP-712 standard Trade Initiation : Provides endpoints for users to request quotes and initiate trades Key Features : Real-time price aggregation from multiple sources EIP-712 signature generation for on-chain verification RESTful API interface for seamless integration High-performance quote processing and caching On-Chain Components Manager Contract Type : Upgradeable Solidity contract Role : Primary entry point for all trade execution The Manager Contract orchestrates the entire on-chain execution flow: Quote Verification : Validates EIP-712 signatures from the off-chain backend Routing Logic : Determines which executor contract to use for each trade Trade Coordination : Manages the complete trade execution process Security Enforcement : Implements access controls and safety checks Core Functions : function executeQuote ( SignedQuote quote ) external function verifyQuoteSignature ( SignedQuote quote ) internal function routeToExecutor ( address issuer , TradeParams params ) internal Token Registry Type : Upgradeable on-chain registry contract Purpose : Central repository of all supported tokenized assets The Token Registry maintains a comprehensive mapping of available assets: Asset Mapping : Links stock symbols to token contract addresses Issuer Association : Associates each token with its respective issuer Multi-Issuer Support : Enables multiple issuers to list the same asset Access Control : Role-based permissions for token registration Registry Structure : struct TokenInfo { address tokenContract; address issuer; string symbol; bool isActive; } mapping ( string => TokenInfo[]) public tokensBySymbol; mapping ( address => TokenInfo) public tokensByContract; Access Controls : Issuers can register their own tokens System admin can manage registry settings Users have read-only access for price discovery Executor Registry Type : Upgradeable registry contract Purpose : Maps issuers to their specific executor contracts The Executor Registry enables modular integration of different issuer protocols: Issuer-Executor Mapping : Links each issuer to their custom executor contract Protocol Adaptation : Enables support for different token standards and trading interfaces Administrative Control : Only system owner can register or update executors Upgrade Safety : Supports safe upgrades of executor implementations Registry Functions : function registerExecutor ( address issuer , address executor ) external onlyOwner function getExecutor ( address issuer ) external view returns ( address ) function updateExecutor ( address issuer , address newExecutor ) external onlyOwner Executor Contracts Type : Issuer-specific adaptor contracts Purpose : Handle actual token transfers and payments Executor contracts serve as protocol adaptors for each issuer: Protocol Abstraction : Standardizes interaction with diverse issuer protocols Trade Execution : Performs actual token transfers and payment processing Custom Logic : Implements issuer-specific trading rules and requirements Safety Mechanisms : Includes validation and error handling for each issuer's protocol Standard Interface : interface IExecutor { function executeBuy ( address user , string symbol , uint256 amount , uint256 price ) external ; function executeSell ( address user , string symbol , uint256 amount , uint256 price ) external ; function validateTrade ( TradeParams params ) external view returns ( bool ); } Executor Types : Mint/Burn Executors : For issuers using mint/burn mechanisms Transfer Executors : For issuers using token transfer models Marketplace Executors : For issuers with marketplace-based trading Issuer Token Contracts Type : External contracts owned by individual issuers Purpose : Actual tokenized asset implementation These are the external contracts that Aqua integrates with: Token Implementation : The actual tokenized stock contracts Payment Handling : Processes payments for token purchases/sales Compliance Logic : Implements issuer-specific compliance requirements Asset Backing : Manages the underlying asset representation Integration Patterns : Direct Token Contracts : Simple ERC-20 style tokenized stocks Marketplace Contracts : Full trading platforms with order books Custodial Contracts : Contracts managing underlying asset custody Component Interactions Trade Execution Flow User Request : User requests quote through frontend or API Quote Aggregation : Off-chain backend queries all registered issuers Best Quote Selection : Backend selects optimal quote and signs it On-Chain Execution : User submits signed quote to Manager Contract Verification : Manager Contract verifies quote signature and validity Routing : Manager queries Executor Registry to find appropriate executor Execution : Executor contract interacts with issuer's token contract Settlement : Tokens and payments are transferred according to trade terms Registry Management Token Registration : Issuers register their tokens in Token Registry Executor Deployment : System admin deploys and registers executor contracts Updates : Registries support upgrades for new features and improvements Security Model Access Controls Registry Permissions : Role-based access for different registry operations Executor Authorization : Only authorized executors can perform trades Signature Verification : All quotes must be cryptographically signed Safety Mechanisms Quote Expiration : Time-limited quotes prevent stale price execution Trade Validation : Multiple validation layers before execution Circuit Breakers : Emergency stops for unusual market conditions Scalability Considerations Off-Chain Optimization Parallel Quote Processing : Simultaneous requests to multiple issuers Caching Mechanisms : Efficient price data caching and updates Load Balancing : Distributed backend infrastructure On-Chain Efficiency Gas Optimization : Minimal on-chain computation and storage Batch Processing : Support for multiple trade execution in single transaction Upgradeable Contracts : Future improvements without migration costs ## /docs/introduction/executive-summary Introduction Executive Summary Vision BlockStreet is building the Unified Liquidity Layer for On-Chain Capital Markets . Aqua, our Cross-Protocol Liquidity Network, unifies fragmented tokenized asset markets by connecting multiple issuers and market makers through a single, intelligent interface. By solving the fundamental problem of price discovery and execution across disparate tokenized asset providers, Aqua enables users to access the best available prices while maintaining the security and transparency of decentralized finance. The Tokenized Asset Market Opportunity The tokenized real-world asset (RWA) market is experiencing explosive growth: $25B+ in on-chain RWA assets by mid-2025 $800M average monthly transaction volume for tokenized equities (since June 2025) ~$370M aggregate market cap for tokenized U.S. stocks Source: CoinGecko, rwa.xyz, DeFi Llama The Fragmentation Tax The tokenized asset ecosystem faces a critical fragmentation problem that we call the fragmentation tax . Multiple issuers offer similar assets - such as tokenized stocks, commodities, or real-world assets - but each operates in isolation with their own pricing mechanisms, liquidity pools, and trading interfaces. This fragmentation imposes real costs on traders: Tracking Error (0.6-0.9%) : Price discrepancies between tokenized assets and their underlying create significant tracking error for portfolios. Basis Tail Spread (1.2-1.8%) : During volatile periods, the spread between tokenized and underlying assets can widen dramatically. Integration Complexity : Each issuer requires separate integration work, making it difficult for applications to support multiple tokenized asset providers. Liquidity Fragmentation : Limited cross-issuer arbitrage opportunities result in persistent price differences and reduced overall market efficiency. Aqua's Solution: The Cross-Protocol Liquidity Network Aqua addresses these challenges through a hybrid architecture that combines off-chain intelligence with on-chain security, creating the plumbing that connects fragmented tokenized asset markets. Multi-Layered Architecture 1. Unified Liquidity Pool (Foundation) The base layer that aggregates liquidity from multiple sources into a single, deep pool accessible across protocols. 2. Hybrid Liquidity Engine (Risk Management) Combines off-chain broker-dealer networks with on-chain liquidity pools for optimal execution and