Developer Docs
Comprehensive guide to the OneRoad Protocol architecture, smart contracts, and encrypted marketplace mechanics.
Introduction
OneRoad is a decentralized, censorship-resistant marketplace protocol designed for the secure exchange of digital assets. Unlike traditional platforms, OneRoad utilizes a unique Paylock mechanism combined with client-side PGP/AES encryption to ensure that:
Trustless Exchange
Funds are held in escrow until the decryption key is verified on-chain.
Privacy First
Files and metadata are encrypted before ever leaving your device.
Multi-Chain
Seamlessly aggregated liquidity across DataHaven, Arc, and Arbitrum.
Resilient Storage
Content is stored on decentralized networks (IPFS/Arweave) via DataHaven.
Getting Started
To interact with OneRoad, you must have a Web3 wallet installed. We support standard EVM wallets like MetaMask, Rainbow, and Coinbase Wallet.
1. Connect Your Wallet
Click the "Connect Wallet" button in the top right corner. You can browse the marketplace without connecting, but purchasing or listing items requires an active connection.
2. Select a Network
OneRoad operates on multiple networks. Use the network selector in the navigation bar to switch between:
Testnet Only
OneRoad is currently in Alpha. All supported networks are testnets. Do not use real assets.
Core Features
Buying Assets
When you purchase an item, your funds effectively enter a smart contract "lock". The seller observes this on-chain event and must deliver the specific decryption key for your address. Once the key is delivered, the funds are released to the seller.
1. Purchase: You pay the list price + gas.
2. Wait: The seller is notified to deliver the specific key.
3. Decrypt: Once delivered, the UI automatically decrypts your file.
4. Refund: If the seller fails to deliver within 24 hours, you can reclaim your funds.
Selling & Listing
Sellers can list any digital file. The application automatically handles the encryption process. You provide the file, price, and supply cap. The protocol generates a unique key pair for the item.
Encryption Protocol
Security is paramount. OneRoad employs a hybrid encryption scheme to ensure that neither the platform nor the network validators can access your content.
Client-Side Encryption
Files are encrypted in your browser using AES-256 before upload. The AES key itself is encrypted using the protocol's master key schema, ensuring only the intended recipient can ever unlock it.
On-Chain Delivery
The decryption key is never stored in a central database. It is delivered on-chain via the deliverKey transaction, encrypted specifically for the buyer's public address.
Smart Contracts
Verify the authenticity of the OneRoad Protocol by checking our deployed contract addresses on the block explorers.