Onchain Sequencing Modules
Modular smart contracts for customizable transaction ordering, permissions, auctions, and cross-chain coordination
Syndicate transforms blockchain sequencing by bringing it onchain through smart contracts deployed on a separate blockchain. This modular approach enables unprecedented control, transparency, and community ownership of the transaction ordering process.
How Onchain Sequencing Works
- Users submit transactions to the appchain's mempool
- Sequencing modules on the sequencing chain control permissions, ordering, auctions, and atomic execution
- The execution engine processes transactions in the determined order
- The settlement layer finalizes state with periodic commitments
This architecture decouples transaction ordering from execution, enabling innovation in sequencing while maintaining compatibility with existing execution environments.
Sequencing Module Components
Metabased sequencing modules are comprised of several key components that can be independently configured to meet your specific application needs.
Permission Modules
Control who can sequence transactions through mechanisms like allowlists and token holdings
Ordering Modules
Define how transactions are ordered and batched for optimal processing
Auction Modules
Enable competitive sequencing rights through mechanisms like sealed-bid auctions
Atomic Modules
Allow coordinated sequencing across multiple chains for complex operations
Permission Modules
Permission modules control who can sequence transactions on your appchain. They implement a simple interface with an isAllowed
function that returns whether an address can sequence:
Available Modules
- Allowlist: Simple admin-controlled list of allowed sequencers
- Token Balance: Require sequencers to hold a minimum amount of tokens
- Sealed Bid Auction: Competitive bidding for sequencing rights
Example: Token Balance Module
Here's a simple example that requires sequencers to hold tokens:
Ordering Modules
The ordering of transactions is currently handled by the base MetabasedSequencerChain
contract, which processes transactions in the order they are submitted. This provides a simple and predictable transaction ordering mechanism.
Available Features
- Single Transaction Processing: Process individual transactions through
processTransaction
- Bulk Transaction Processing: Process multiple transactions at once with
processBulkTransactions
- Raw Transaction Support: Handle compressed transactions with
processTransactionRaw
Example: Transaction Processing
Auction Modules
Auction modules enable competitive sequencing rights through sealed-bid auctions, where bidders submit encrypted bids to ensure fairness.
Available Modules
- Sealed Bid Auction: A two-phase auction where bidders first submit encrypted bids and later reveal them
Example: Sealed Bid Auction
Atomic Modules
Atomic modules enable coordinated transaction processing across multiple chains, ensuring all transactions are processed together or none at all.
Available Modules
- Atomic Sequencer: Process transactions across multiple chains atomically
Example: Atomic Sequencer
The atomic sequencer ensures that either all transactions are processed successfully across all specified chains, or none are processed at all. This is useful for cross-chain operations that need to maintain consistency.
Working with Modules
Select Existing Modules
Choose from our production-ready modules:
Category | Module | Description | Best For |
---|---|---|---|
Permission | Allowlist | Admin-controlled access list | Testing, private networks, controlled rollouts |
Permission | Token Balance | Permission based on token holdings | Token-gated sequencing, economic security |
Permission | Always Allowed | Open access for testing | Development and testing |
Auction | Sealed Bid | Competitive bidding for sequencing rights | Market-based sequencer selection |
Atomic | Atomic Sequencer | Cross-chain transaction coordination | Complex multi-chain operations |
Build Custom Modules
Here are modules you can build using our interfaces:
Category | Module | Description | Best For |
---|---|---|---|
Permission | DAO Voting | Community-governed sequencer selection | Decentralized governance |
Permission | Multi-Sig | Multiple approval requirements | High-security applications |
Permission | Reputation | Permission based on past performance | Quality-focused networks |
Permission | Time-Lock | Scheduled sequencing rights | Predictable rotation |
Ordering | Fee Priority | Order by gas price | Revenue optimization |
Ordering | Random | Randomized transaction ordering | MEV protection |
Ordering | Batch Auction | Time-window based ordering | Fair price discovery |
Ordering | Dynamic Size | Adaptive batch sizing | Network optimization |
Auction | Dutch | Decreasing price auctions | Quick price discovery |
Auction | English | Increasing price auctions | Maximum value extraction |
Auction | Continuous | Rolling auction periods | Constant availability |
Compose Modules
Combine modules to create sophisticated sequencing solutions using our factory contract:
Composition Features
- RequireAll: All checks must pass (AND logic)
- RequireAny: At least one check must pass (OR logic)
- Linked List Structure: Checks are stored in an ordered list
- Dynamic Updates: Add or remove checks at runtime
- Admin Control: Only admin can modify composition
Getting Started
-
Choose Your Modules: Review the available modules and select those that match your security, fairness, and performance requirements. If needed, plan custom modules to meet specific needs.
-
Implement Custom Logic: Build new modules by implementing our interfaces and test them thoroughly using our development tools.
-
Configure Your Chain: Deploy and initialize your chain with the selected modules.
-
Monitor and Upgrade: Track performance metrics and upgrade modules as needed using our modular architecture to ensure optimal chain operation.