diff --git a/docs/legacy/_category_.json b/docs/legacy/_category_.json deleted file mode 100644 index 40969b6..0000000 --- a/docs/legacy/_category_.json +++ /dev/null @@ -1,8 +0,0 @@ -{ - "label": "Legacy", - "position": 7, - "link": { - "type": "doc", - "id": "legacy/index" - } -} \ No newline at end of file diff --git a/docs/legacy/about/business-model.md b/docs/legacy/about/business-model.md deleted file mode 100644 index a388a48..0000000 --- a/docs/legacy/about/business-model.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -sidebar_position: 6 -description: >- - Unlock the most cost-efficient and user-friendly framework to run any crypto - exchange ---- - -# 🏛️ Business Model - -:::info -Yellow Network is a project in development. Not all solutions presented in the following (sub)sections are implemented at this stage. The current, and all subsequent sub-pages, are subject to change. - -For more information, visit the [Roadmap](roadmap.md) -::: - -Yellow Network is a non-profit project that seeks to solve the problem of truly decentralized trading by allowing participants to swap assets across different exchanges without having to rely on block creation. This brings all parties, exchanges, blockchains, and trading firms together, creating a network of brokerages and allowing for a more efficient trading infrastructure. Additionally, it unifies all chains into a virtual ledger layer to allow instant settlement and trade information exchange. - -[Cost-Revenue Optimization](business-model.md#_8iwurl3m1rx8)[​](https://www.yellow.org/docs/litepaper/business-model#cost-revenue-structure-for-brokers)​ - -[Sustainable Token Ecosystem](business-model.md#sustainable-token-ecosystem) - -_**Our global strategy is to have 1,000+ participants operating globally on the network by 2028.**_ - -## Cost-Revenue Optimization[​](https://www.yellow.org/docs/litepaper/business-model#cost-revenue-structure-for-brokers)​ - -Our solutions suggest significant cost reduction in R\&D as well as infrastructure maintenance costs, allowing businesses inside the Yellow Network ecosystem to focus on their core operations and growth while at the same time enabling new revenue streams. - -| Solution | Benefits | Cost | -| ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------- | -|

NeoDAX
Open source exchange software

| | Free | -|

Yellow Network
P2P liquidity aggregation

| |

Free
(requires $YELLOW tokens)

| - -## Sustainable Token Ecosystem - -Our [$YELLOW](../resources/tokenomics.md) token serves as the gateway to Yellow Network. Participant must lock $YELLOW to access the state-channel infrastructure. - -Participant collateral amount can be slashed in case of online dispute loss. Any participant can file a dispute against another participant for a filing fee. An independent arbitration board consult the audit trails available and enforce the outcome of the dispute which may result in a reputation fault, but also a token slash. Reputation and dispute are recorded on-chain in a participant registry. - -Transaction fees are collected from clearing and trading fees and collected into the Yellow Treasury Vault which implements buy-back mechanism of the YELLOW token to stabilize it's value throught liquidity provision. - -## Key Stakeholders - -* **Existing Customers**\ - Over 50 exchanges are ready to engage with the beta launch of our native trading NeoDAX v4 trading platform with immediate effect. -* **Fintech Entrepreneurs**\ - For those interested in opening an exchange, our new solution fits every budget and is radically more simple than a standard centralized exchange. Head to [www.yellow.org](https://www.yellow.org/) for more information. -* **Financial Institutions**\ - Become part of our ecosystem, co-invest with us, and sell your services through Yellow Network. -* **Crypto-Enthusiasts, Miners, and Traders**\ - Quickly deploy our node software on any cloud and start liquidity-mining with your exchange accounts. diff --git a/docs/legacy/about/core-team.md b/docs/legacy/about/core-team.md deleted file mode 100644 index 5ab6ead..0000000 --- a/docs/legacy/about/core-team.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -sidebar_position: 8 -description: The leadership behind the Yellow Network project ---- - -# 🍿 Core Team - -## **Alexis Yellow, Executive Chairman** - -*[Photo coming soon]* - -[LinkedIn](https://www.linkedin.com/in/sirkia/) [Twitter](https://x.com/AlexisYellow) - -Alexis started his career in avionics before moving to the European Space Center, where he worked on software surrounding Ariane space rockets. He later co-founded market maker GSR and became a crypto investor and blockchain opinion leader. For the last few years, Alexis has made it his mission to support emerging crypto and blockchain projects, founding Yellow to bring the blockchain communities together. - -## **Louis Bellet, Co-Founder and Chief Architect** - -*[Photo: Bellet Louis]* - -[LinkedIn](https://www.linkedin.com/in/louisbellet/) [Twitter](https://twitter.com/0xYellow) - -Louis is a software architect and serial entrepreneur in the fintech, crypto & blockchain spaces. For the past ten years, he has been hands-on in the crypto industry, founding Openware, the world's leading crypto exchange software provider. Now, with Yellow, Louis plans to solve the problem of fragmented liquidity and make blockchain more accessible and secure for the public. - -## **Camille Meulien, CTO, Architect** - -*[Photo coming soon]* - -[LinkedIn](https://www.linkedin.com/in/camillemeulien/) [Twitter](https://x.com/camille_yellow) - -As a software architect, Camille is a known authority in the FinTech development circles. He has over 20 years of experience in FinTech security, distributed systems, Big Data, and high-traffic systems. He is a problem-solver and highly skilled in aligning technical solutions with business goals. - -## **Bakhtiyar Mamedov, CFO** - -*[Photo coming soon]* - -[LinkedIn](https://www.linkedin.com/in/bakhtiyar-mamedov-2175329/) [Twitter](https://x.com/Bakhtiyar_Yel) - -A financial expert and manager with a strong background at Big 4, powering more than 18 years in PwC. He has extensive experience in banking and treasury management, which he has leveraged in the blockchain industry. Bakhtiyar was at the forefront of the Yellow & Openware merger, designing and implementing financial processes into the new structure. - -## **Hongtao J, CTO, Ecosystem** - -*[Photo coming soon]* - -[LinkedIn](https://www.linkedin.com/in/hongtao2049/) [Twitter](https://x.com/ht_showmore) - -Former Head of Exchange Tech at BybitX and m2.com, expert in scaling, secure, real-time financial infrastructure. - -## **Alessio Treglia, CTO, Protocol** - -*[Photo coming soon]* - -[LinkedIn](https://www.linkedin.com/in/alessiotreglia/) [Twitter](https://x.com/alessiotreglia) - -Ex CTO at Tendermint, the company that created the core infrastructure that powers the Cosmos ecosystem, including Tendermint Core and the Cosmos SDK. - -## **Shyla Khan, CMO** - -*[Photo coming soon]* - -[LinkedIn](https://www.linkedin.com/in/shyla-bkhan/) [Twitter](https://x.com/DeFi_Pop) - -Veteran Web3 marketer who has shaped global strategy and storytelling for Polkadot, Kusama and DappRadar, bringing clarity to complex tech across markets. - -## **Neil Meintjes, COO** - -*[Photo coming soon]* - -[LinkedIn](https://www.linkedin.com/in/neil-meintjes-147347a/) [Twitter](https://x.com/neilmeintjes) - -Web3 professional with over 25 years in the ITC space, launched over 50 Gaming and DeFi projects. diff --git a/docs/legacy/about/glossary.md b/docs/legacy/about/glossary.md deleted file mode 100644 index 268f4cf..0000000 --- a/docs/legacy/about/glossary.md +++ /dev/null @@ -1,394 +0,0 @@ ---- -sidebar_position: 10 -description: >- - Not familiar with a term or need further information? Look no further, welcome - to the Glossary. ---- - -# 📚 Glossary - - -## A - -[Adjudicator](glossary.md#adjudicator) - -[Atomic Swap](glossary.md#atomic-swap) - -[Automated Market Making (AMM)](glossary.md#automated-market-making) - - -## B - -[Broker](glossary.md#broker) - -[B2B (Broker to Broker) liquidity channel](glossary.md#b2b-broker-to-broker-liquidity-channel) - - -## C - -[Centralized Exchange (CEX)](glossary.md#centralized-exchange-cex) - -[Clearing / Smart Clearing](glossary.md#clearing) - -[Collateral](glossary.md#collateral) - -[Custodians](glossary.md#custodians) - - -## D - -[Decentralized Exchange (DEX)](glossary.md#decentralized-exchange-dex) - - -## E - -[Exchanges](glossary.md#exchanges) - - -## F - -[FAQ](glossary.md#faq) - -[Fees](glossary.md#fees) - - -## G - - - -## H - -[Hash Time Locked Contract (HTLC)](glossary.md#hash-time-lock-contract-htlc) - -[High Frequency Trading (HFT)](glossary.md#high-frequency-trading-hft) - - -## I - - - -## J - - - -## K - -[Know Your Customer (KYC)](glossary.md#know-your-customer-kyc) - - -## L - -[Layer (0-3)](glossary.md#layer-0-3) - -[Liquidity Aggregation](glossary.md#liquidity-aggregation) - - -## M - -[Market Makers](glossary.md#market-makers) - -[Multi-Chain & Multi-Custody Support](glossary.md#multi-chain-and-multi-custody-support) - - -## N - -[Yellow Network](glossary.md#yellow-network) - - -## O - -[NeoDAX](glossary.md#neodax) - - -## P - -[Policies](glossary.md#policies) - -[Protocol](glossary.md#protocol) - - -## Q - - - -## R - -[Remote Order Matching](glossary.md#remote-order-matching) - -[Reserve Vault](glossary.md#reserve-vault) - -[Retail Broker](glossary.md#retail-brokers) - - -## S - -[Settlement](glossary.md#settlement) - -[State Channel](glossary.md#state-channel) - - -## T - -[Tokenomics](glossary.md#tokenomics) - -[Tiers](glossary.md#tiers) - -[Trading Channel](glossary.md#trading-channel) - - -## U - - - -## V - - - -## W - -[Whitepaper](glossary.md#whitepaper) - - -## X - - - -## Y - -[$YELLOW](glossary.md#usdyellow) - - -## Z - - - - -## A - -#### Adjudicator - -Our state channel smart contract is called the [Adjudicator](../architecture/smart-clearing-protocol.md#adjudicator-smart-contract). Its role is to hold the [collateral](../architecture/risk-management.md#collateral) of each participant while the channel is open. In case of a [settlement](glossary.md#settlement)issue, the Adjudicator is also able to manage collateral to overcome the dispute. - -#### Atomic Swap - -An [atomic swap](https://www.investopedia.com/terms/a/atomic-swaps.asp) is an exchange of cryptocurrencies from separate blockchains. The swap is conducted between two entities without a third party's involvement. The idea is to remove centralized intermediaries like regulated exchanges and give token owners total control. - -#### Automated Market Making - -[Automated market makers](https://www.gemini.com/cryptopedia/glossary#automated-market-maker-amm) (AMMs) allow digital assets to be traded without permission and automatically by using [liquidity pools](https://www.gemini.com/cryptopedia/glossary#liquidity-pool) instead of a traditional market of buyers and sellers. On a [traditional exchange platform](https://www.gemini.com/cryptopedia/centralized-exchanges-crypto), buyers and sellers offer up different prices for an asset. - -## B - -#### Broker - -Cryptocurrency brokers can be a platform, firm, or individual that acts as an intermediary between the cryptocurrency markets and an end client and facilitates the buying and selling of cryptocurrencies. See also [Retail Broker.](glossary.md#retail-brokers) - -#### B2B (Broker to Broker) Liquidity Channel - -Brokers use a state channel protocol \[@perun2] to keep track of assets owned from one broker to another. This technology allows a secure track of funds without the need for on-chain transactions for every trade. It makes the trading process between two brokers fast and secure. - -To open a state channel, brokers need to agree on a specific amount of YELLOW tokens to be used as collateral. Once they have an agreement on the amount and they both deposited the tokens, the state channel is activated and they can start trading. - -| Field | Protobuf Type | Description | -| ------------------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | -| chain\_id | uint64 | Identifier of the blockchain on which the application is deployed | -| participants | repeated string | Brokers' addresses | -| channel\_nonce | uint64 | Unique identifier of the channel for all participants | -| app\_definition | string | Address of the smart contract of the adjudicator application | -| challenge\_duration | uint64 | | -| app\_data | bytes | See below the definition of the app\_data for Yellow Network liquidity channel | -| outcome | bytes | | -| turn\_num | uint64 | Turn number: incrementing at every turn, this allows the easy identification of the latest version of a state | -| is\_final | bool | Once true and signed by all participants the channel is closed and the final outcome can be applied on the blockchain safely by any participant | - -## C - -#### Centralized Exchange (CEX) - -Centralized cryptocurrency exchanges act as an intermediary between a buyer and a seller and make money through commissions and transaction fees. Imagine a [CEX](../../about/the-problem.md#centralized-exchanges-cex)as similar to a stock exchange but for digital assets. Generally, a [CEX](../../about/the-problem.md#centralized-exchanges-cex)not only acts as a marketplace but also requires users to custody assets. - -#### Clearing / Smart Clearing - -Clearing is the correct and timely transfer of funds to the seller and securities to the buyer. - -[Smart Clearing](../architecture/smart-clearing-protocol.md) is a term we derived from traditional finance. The "smart" component indicates that instead of a trusted intermediary, the clearing process is conducted by a fully automated digital protocol. - -#### Collateral - -Brokers have to lock collateral in order to guarantee their solvency for the other peer. - -We define two types of collateral that have to be provided: - -* [Network Access Collateral:](glossary.md#network-access-collateral) required to open state channels and become an accredited Yellow Network participant. It acts as a last resort for disputes between brokers. -* [Trading Collateral:](glossary.md#trading-collateral) Agreed on a P2P level when a state channel is opened. Secures day-to-day trading activities between brokers and prevents overexposure. It acts as the first line of defense in disputes between brokers. - -#### Custodians - -[Custodians](../architecture/custodial-layer.md) are in charge of holding customers' funds securely. They can be an external provider or a smart contract. Custodians use a set of rules to release funds, whereby each party can provide a different set of features to increase security and to make sure the user requesting a withdrawal is the real initiator of the request and free of fraud. Additionally, they allow the broker to easily connect to multiple blockchains, depending on their current supported blockchains. - -## D - -#### Decentralized Exchange (DEX) - -A decentralized exchange is another type of exchange that allows peer-to-peer transactions directly from your digital wallet without going through an intermediary. Examples of [DEX](../../about/the-problem.md#decentralized-exchanges-dex)s include Uniswap, PancakeSwap, dYdX, and Kyber. - -These decentralized exchanges rely on smart contracts, self-executing pieces of code on a blockchain. These smart contracts allow for more privacy and less slippage (another term for transaction costs) than a centralized cryptocurrency exchange. - -## E - -#### Exchanges - -Exchanges are big players in the network; they usually target a global audience and are regulated in many different countries. They can list exclusive tokens to the network and bring in some market makers. They can also manage the platform custody. In short, those actors incorporate all the roles of network participants, thus they don't necessarily need to connect to other brokers. However, using Yellow Network can bring additional benefits for their customers, like better liquidity and additional token pairings. - -## F - -#### FAQ - -[Here](faq.md)you can find answers to the most frequently asked questions from our community. - -#### Fees - -Yellow Network will charge fees and reward participants based on their activity. However, fees are not charged for profit; all collected fees are either redistributed to network participants or used to fund the [Reserve Vault](../finance/yellow-reserve-vault.md). - -The first layer [(Layer 1)](#) is a **Liquidity Fee** - -The second layer [(Layer 2)](../finance/fee-structure/layer-2-clearing-fee.md) is a **Clearing Fee** - -## G - -## H - -#### Hash Time Lock Contract (HTLC) - -The term [Hashed Time Lock Contract (HTLC)](https://academy.binance.com/en/glossary/hashed-timelock-contract) refers to a special feature used to create [smart contracts](https://academy.binance.com/en/glossary/smart-contract) that are able to modify payment channels. Technically, the HTLC feature enables the implementation of time-bound transactions between two users. In practice, the recipient of a HTLC transaction has to acknowledge the payment by submitting a cryptographic proof within a specified timeframe (number of blocks). If the recipient forfeits or fails to claim the payment, the funds will be returned to the original sender. - -At Yellow Network we use [HTLC](../architecture/README.md#how-p2p-trading-works)to settle trades off-chain. - -#### High Frequency Trading (HFT) - -High-frequency trading, also known as HFT, is a method of trading that uses powerful computer programs to transact a large number of orders in fractions of a second. It uses complex [algorithms](https://www.investopedia.com/terms/a/algorithm.asp) to analyze multiple markets and execute orders based on market conditions. - -## I - -## J - -## K - -#### Know Your Customer (KYC) - -Know Your Customer (KYC) is a standard in the investment industry that ensures [advisors](https://www.investopedia.com/terms/f/financial-advisor.asp) can verify a client's identity and know their client's investment knowledge and financial profile. For participants in Yellow Network, the end-user[KYC](../architecture/supported-technologies.md#kyc-know-your-customer) is the responsibility of each broker. Yellow Network will allow brokers to integrate their own third-party KYC provider. - -## L - -#### Layer (0-3) - -Layers in the blockchain space refer to scaling solutions that aim to solve the trilemma of Decentralization, Security, and Scalability. - -Layer-0 = Technical components (Hardware, Internet, etc.) - -Layer-1 = Foundation layer and main blockchain (e.g. Bitcoin, Ethereum) - -Layer-2 = Overlapping networks on Layer-1 to increase scalability (e.g. Bitcoin Lightning Network) - -Layer-3 = Application layer, acts as user interface (UI) - -#### Liquidity Aggregation - -Liquidity aggregation refers to technology that allows participants to simultaneously obtain streamed prices from several liquidity providers/pools. - -## M - -#### Market Makers - -Market makers provide liquidity to the network, and create and maintain open orders to allow users to access the best offers possible. They receive fees from trades. - -#### Multi-Chain & Multi-Custody Support - -A broker may connect to multiple custody solutions, whereby each solution has a different list of supported blockchains. Brokers benefit from the supported blockchains of their custodians. Once a broker is connected to multiple custodians, end-users will be able to deposit and withdraw funds from all supported blockchains. - -## N - -#### Yellow Network - -Yellow Network embodies a decentralized Layer-3 peer-to-peer mesh network allowing brokers to communicate, trade, and aggregate the liquidity of connected nodes. - -## O - -#### NeoDAX - -[NeoDAX™](https://www.openware.com/product/neodax) cryptocurrency exchange software is a modular platform for building crypto exchanges, NFT marketplaces, and digital banking with built-in liquidity. - -## P - -#### Policies - -Our policies set the foundation of our work and are readily available to everyone. They can be found under the [Legal](#) section. - -#### Protocol - -Yellow Network allows brokers to pair liquidity from one to another. A broker pairing with another broker in the market will display orders from the counterparty in his own order book. This extends the broker's offering and increases the overall liquidity available to his users. When a user takes an offer coming from another broker, brokers exchange liabilities using the state channel protocol to ensure both agree on the accounting change. Later a settlement process is initiated by either broker to lower their risk and move owed funds from one to the other. - -## Q - -## R - -#### Remote Order Matching - -When a user's order matches an order from a peer-broker, the platform will use the active state-channel with the peer to perform the trade and account the liabilities of one broker to another. - -#### Reserve Vault - -The [Yellow Reserve Vault](../finance/yellow-reserve-vault.md) is our treasury entity and is tasked with two main responsibilities: - -1. To provide stability for the [$YELLOW](glossary.md#usdyellow) token -2. To build a diversified currency reserve to resolve settlement disputes between brokers. - -#### Retail Brokers - -A small exchange located in a specific country or region that complies with local regulations. In our network, we define brokers as non-custodial businesses. - -## S - -#### Settlement - -Yellow Network initiates a daily automatic settlement at 0:00 UTC. The settlement process can also be triggered by a broker at any time (ad-hoc); for example, if the broker requires liquidity to honor a withdrawal request from an end-user. - -If a broker's position has insufficient collateral he will be prevented from further B2B trades. Frequent broker-initiated settlements can prevent that situation. - -#### State Channel - -[State channels](https://ethereum.org/en/developers/docs/scaling/state-channels/) refer to the process in which users transact with one another directly outside of the blockchain, or "off-chain," and greatly minimizes their use of "on-chain" operations. - -## T - -#### Tokenomics - -Tokenomics is a term that captures a token's economics. It describes the factors that impact a token's use and value, including but not limited to the token's creation and distribution, supply and demand, incentive mechanisms, and token burn schedules. You can find the Yellow Network Tokenomics [here](../resources/tokenomics.md). - -#### Tiers - -Tiers are used to define the number of [trading channels](glossary.md#trading-channel) a participant can use. Tiers are based on the number of [$YELLOW](glossary.md#usdyellow) the participant locks with the [Yellow Network](glossary.md#yellow-network). Tiers are also used to determine the applicable [fee layer](glossary.md#fees) of a participant. - -#### Trading Channel - -Participating brokers and liquidity providers can open trading channels to use and share liquidity with others. Opening trading channels requires [$YELLOW](glossary.md#usdyellow) tokens and the use of channels is subject to a [clearing fee](glossary.md#fees). - -## U - -## V - -## W - -#### Whitepaper - -A whitepaper is an informational document issued by a company or [not-for-profit](https://www.investopedia.com/terms/n/not-for-profit.asp)organization to promote or highlight the features of a solution, product, or service that it offers or plans to offer. Our Whitepaper can be found [here](../../docs-hub/whitepaper.md). - -## X - -## Y - -#### $YELLOW - -[$YELLOW](../resources/tokenomics.md) is our ERC-20 token. The use of Yellow Network requires participants to hold $YELLOW. - -## Z diff --git a/docs/legacy/about/market-analysis.md b/docs/legacy/about/market-analysis.md deleted file mode 100644 index 18f178d..0000000 --- a/docs/legacy/about/market-analysis.md +++ /dev/null @@ -1,175 +0,0 @@ ---- -sidebar_position: 5 -description: The status-quo in global crypto markets. ---- - -# 📊 Market Analysis - -:::info -Updated: September 7, 2022 - -_All information in this section is sourced from publicly available data and represents a snapshot at the time of writing unless otherwise stated._ -::: - -This section aims to establish a general understanding of the current status quo in crypto markets and crypto trading as they are crucial factors for Yellow Network. - -Our market analysis will focus on three major topics: - -1. The Current State of Crypto Markets. -2. Trends and Expectations. -3. Problems and Roadblocks. - -## Key Takeaways - -* Blockchain has made its transition from a niche market to a multi-billion dollar industry. -* After a stellar 2021, the crypto industry is facing increased external and internal challenges. -* Solid regulatory frameworks will be critical to future mass adoption. -* Solving the blockchain trilemma remains the focal point of industry development. -* The industry is heading away from the "one-chain" approach, helped by Layer-2 and Layer-3 solutions. - -## Current State of Crypto - -### From a Stellar 2021 - -#### User Adoption - -In our view, the year 2021 saw a pivotal change in the mainstream acceptance of crypto assets and blockchain technology, especially in the DeFi and NFT space. - -Web3 technology is particularly prone to the network effect, which suggests that platform value increases at a faster rate than the increase in new users. As a result, the valuations of many projects skyrocketed over the past two years. - -Major players such as Visa, Paypal, Walmart, Microsoft, and other players from various industries branched into the Web3 space, and El Salvador became the first country to make Bitcoin legal tender. - -Stablecoins have found broader institutional acceptance, crossing $5tn volume in 2021, a 370% year-on-year growth. - -Venture capital allocated to crypto projects surpassed $14bn spread over roughly 1,700 deals. - -#### The Gas Issue - -The increase in crypto adoption has led to harsh spikes in transaction prices on certain blockchains, most notably ETH and BTC. This has started pushing many smaller players to the side. Gas prices significantly impact trading profitability, leading to failed trade executions and skewed pricing. - -*[Image placeholder: Daily transaction fees chart]* - -Source: The Block, [https://www.theblock.co/data/on-chain-metrics/comparison-bitcoin-ethereum/transaction-fees-daily](https://www.theblock.co/data/on-chain-metrics/comparison-bitcoin-ethereum/transaction-fees-daily) - -#### Growth of Layer-1 and Layer-2 Platforms - -The emergence of DeFi drove large quantities of new users to L1 platforms. This caused congestion and gas fee spikes, especially on the ETH blockchain. This, in turn, gave rise to non-ETH solutions and other workarounds, most notably Layer-2 and Layer-3 projects. - -Many of these solutions aim to provide additional scalability and eradicate some shortcomings of existing blockchain solutions. - -For example, the use of cross-chain bridging surged from $670M to $32B throughout 2021. However, this massive surge in volume increasingly attracts exploits and hacks, as shown in the graph below. - -*[Image placeholder: Funds stolen by DeFi attackers chart]* - -Source: The Block, [https://www.theblock.co/data/decentralized-finance/exploits/funds-stolen-by-defi-attackers](https://www.theblock.co/data/decentralized-finance/exploits/funds-stolen-by-defi-attackers) - -### To a Crypto Winter in 2022 - -#### Falling Prices and Volumes - -Following a strong year in 2021 for most crypto assets and the Web3 space in general, worsening global economic factors started spilling over into crypto markets. Most (crypto) assets have since seen a steep decline in exchange trading volumes, shrinking the total crypto market capitalization to about $1T, down from almost $3T at its peak in November 2021. - -*[Image placeholder: Crypto total market cap chart]* - -Source: The Block, [https://www.theblock.co/data/crypto-markets/prices/crypto-total-marketcap](https://www.theblock.co/data/crypto-markets/prices/crypto-total-marketcap) - -#### Failing Asset Managers and Protocols - -Price declines in assets led to short liquidations and ultimately the collapse of several asset managers and entire blockchain protocols. 3 Arrow Capital (3AC) and Terra Protocol are the most prominent examples. Accelerating short liquidation leads to additional price pressure, ultimately causing and reinforcing a bear market. - -*[Image placeholder: Short liquidations chart]* - -Source: The Block, [https://www.theblock.co/data/crypto-markets/futures/short-liquidations](https://www.theblock.co/data/crypto-markets/futures/short-liquidations) - -#### Impact on Exchanges - -Exchanges have seen a steep decline in activity and are confronted with [volumes down 50% from their highs in late 2021.](https://www.theblock.co/data/crypto-markets/spot/cryptocurrency-exchange-volume-monthly) Recent data suggests a bottoming out of falling exchange volumes. On the other hand, fiat-to-crypto exchange volumes continue to decline, resulting in reduced buying pressure and price support for most cryptocurrencies. - -While in the past two years decentralized exchanges (DEXs) have continuously gained market share over Centralized Exchanges this trend has started to reverse in the early months of 2022. - -*[Image placeholder: DEX to CEX spot trade volume chart]* - -Source: The Block, [https://www.theblock.co/data/decentralized-finance/dex-non-custodial/dex-to-cex-spot-trade-volume](https://www.theblock.co/data/decentralized-finance/dex-non-custodial/dex-to-cex-spot-trade-volume) - -*[Image placeholder: DEX monthly volume chart]* - -Source: The Block, [https://www.theblock.co/data/decentralized-finance/dex-non-custodial/dex-volume-monthly](https://www.theblock.co/data/decentralized-finance/dex-non-custodial/dex-volume-monthly) - -#### Scaling Solutions on the Rise - -Contrary to trading volumes and asset prices, value locked in scaling solutions has shown (some) resilience in 2022. State channel solutions still represent a relatively small market share when compared to Rollups, but have maintained an overall market share. - -*[Image placeholder: Value locked in Ethereum scaling solutions chart]* - -Source: The Block, [https://www.theblockcrypto.com/data/scaling-solutions/scaling-overview/value-locked-of-ethereum-scaling-solutions](https://www.theblockcrypto.com/data/scaling-solutions/scaling-overview/value-locked-of-ethereum-scaling-solutions) - -#### Bitcoin Loses Market Share - -One of the most notable changes in the 2022 crypto landscape is Bitcoin losing overall market share to other coins, most notably Ethereum. While ETH has profited from increased interest ahead of the [Merge](https://ethereum.org/en/upgrades/merge/), i.e., the change from PoW to PoS, Bitcoin seems to have somewhat lost its place as the leading role in the recent cryptocurrency narrative. - -The recent price declines have cast also doubt on Bitcoins' ability to act as an inflation hedge. At the same time the oldest, and still largest, cryptocurrency shows increased correlation with traditional asset benchmarks such as the S\&P500 and in particular the NASDAQ. - -#### The Rise of Regulations - -Regulators and other governing bodies show increasing attention to both the Web3 space, and in particular to cryptocurrencies. While being a multi-trillion dollar industry, the Web3 landscape today remains fairly unregulated. Increasing reports of exploits, hacks, and project failures pose considerable risks to an ever-growing number of investors, stakeholders, and participants in the space. - -A lack of sufficient regulation makes it difficult to recover stolen funds. As a result, smaller players trying to enter the market suffer, due to low consumer confidence.\ - - -## Trends and Expectations - -#### New Policies and Regulations - -A recent article by [The Block](https://www.theblock.co/post/167451/the-worlds-securities-law-watchdog-is-scrambling-to-create-common-standards-for-crypto) indicates that the world's securities watchdog is scrambling to create common standards for crypto in an attempt to bring more clarity to the legal aspect of the industry. - -The European Parliament is expected to follow up on its [attempt to regulate cryptocurrencies](https://www.europarl.europa.eu/news/en/headlines/economy/20220324STO26154/cryptocurrency-dangers-and-the-benefits-of-eu-legislation) across Europe. - -We expect most regulators to follow a path of gradual acceptance toward Web3 solutions in a shift from skepticism to pragmatism. In our eyes, this will benefit the industry at large and, after some initial adjustment, spark a new bull run in crypto markets. - -In their 2022 Outlook, [Sygnum](https://www.sygnum.com/digital-asset-outlook-report-download), a Swiss Digital Asset Bank, defines the following regulatory key areas: - -* Clarification on the definition of Virtual Assets and Virtual Asset Service Providers. -* Clarity on issues around the use of Stablecoins. -* Guidance on risks and the tools available to countries to address the risks related to P2P transactions. -* Additional guidance on the Travel Rule, i.e., the transfer of identification for payments on the blockchain. -* Principles and guidelines on information sharing and cooperation amongst authorities competent to supervise Virtual Assets. - -#### Empowering Real-World use cases - -The Web3 space will continue to mature and pivot towards more real-world applications. DeFi was the first field to reach critical mass in 2021 and we expect other sectors such as gaming and metaverse-related applications to gain momentum going forward. - -Existing and established use cases, like crypto trading, will continue to grow and so will enabling technologies, such as scalability and security solutions. - -[According to the UN](https://unctad.org/news/global-trade-hits-record-high-285-trillion-2021-likely-be-subdued-2022), global trade volumes in 2021 reached an estimated $28.5trn in goods and services. Given regulatory hurdles can be cleared, smart contracts are likely to see increased adoption in global trade, freeing up capital, reducing cost, and providing transparency and efficiency. - -#### Growth of Scalability Solutions to Continue - -We expect the need and demand for scalability solutions to continue to grow exponentially over the coming years. Safety and security, rather than pure speed, will determine the success of these solutions. - -According to a report by [Sygnum](https://www.sygnum.com/digital-asset-outlook-report-download), scalability solutions could help solve the dilemma of a single dominant blockchain. Receding Bitcoin dominance and the rise of Layer-2 solutions throughout 2021 and 2022 seem to confirm this thesis. - -## Roadblocks and Risks - -Several roadblocks are likely to persist in the near future and will take time to overcome: - -* Inconsistent regulatory approaches taken by different countries that enable regulatory arbitrage between jurisdictions. -* The dynamic pace of technological evolvement will continue to pose difficulties for regulators to adapt. -* The decentralized nature of blockchain makes it near impossible to regulate under existing law structures. -* As Web3 develops and finds more widespread adoption it will continue to show increased correlation with other, more traditional, markets and thus partially losing its diversification effect. -* An impending economic downturn caused by inflation and supply chain shortages could reduce venture capital flows and lead investors to reduce risk, thus leading to capital shortages and further price decline of digital assets. - -## Conclusion - -After a strong performance in 2021, the crypto industry has now reached full public attention and is unlikely to disappear despite facing increasing challenges in 2022. - -We predict that some headwinds such as high inflation, supply chain shortages, and regulatory uncertainty, are temporary and likely to subdue over the next 12-24 months. - -Industry internal issues, such as the question of security and scalability, have been acknowledged and we see an increasing amount of solutions being developed to confront these issues. - -In our view, challenging market environments tend to have a cleansing effect in rapidly growing industries. Similar to the Dot-Com bubble in 2001, trying times reduce the number of bad actors and "hype" projects with no utility. Capital will flow towards ideas and companies that focus on advancing the technology and its use cases, ultimately improving the environment for all stakeholders. - -While there is a risk of consolidation and concentration by prominent players, the underlying decentralized nature of blockchain should, at least partially, prevent what happened to the internet over the past two decades, where a few large corporations control the market. - -Regulatory frameworks will have to be rewritten to accommodate the complex nature of decentralization in order to build trust and foster security. - -As a result, the collaboration between all stakeholders remains critical for widespread adoption. diff --git a/docs/legacy/about/offering.md b/docs/legacy/about/offering.md deleted file mode 100644 index b80f4c7..0000000 --- a/docs/legacy/about/offering.md +++ /dev/null @@ -1,74 +0,0 @@ ---- -sidebar_position: 4 -description: >- - True P2P liquidity; Yellow Network will enable brokers to link to other - connected brokers and exchanges, merge order books, and use liquidity to - support their brokerage activities ---- - -# 🆕 Offering - -:::info -Yellow Network is a project in development. Not all solutions presented in the following (sub)sections are implemented at this stage. The current, and all subsequent sub-pages, are subject to change. - -For more information, visit the [Roadmap](roadmap.md). -::: - -## Key Benefits - -* Works worldwide all-in-one toolset NeoDAX SDK -* Easy to deploy for any stakeholder -* A Web3 solution ready for mature retail finance -* Real-time inter-broker exchange -* Near-instant off-chain transactions -* Efficient on-chain transactions - -## A Solution for Everyone - -Cutting-edge state channel technology enables fast trading and reaching assets locked on isolated networks without directly bridging them. - -### **For Broker Startups** - -* 1-click installation and easy maintenance -* Connect to other brokers to enhance your liquidity and offer token pairings -* Easy licensing and regulation - -### **For Retail Investors and Traders** - -* Access to audited, licensed, and trusted brokers -* Access to multiple assets from various chains -* User-friendly UI with familiar features to centralized exchanges -* Funds are protected by professional third-party custodians and smart contracts - -### **For Market Makers** - -* Shared liquidity -* Ultra high-speed settlement -* No hidden network fees -* Define your own market making fee - -### For Exchanges - -* Offer your clients access to additional token pairings -* Deepen the liquidity of existing tokens -* Additional revenue stream for market making -* Link between CEX and DEX -* Access to new markets - -## Security - -Security is ensured by dividing responsibilities between custodians, brokers, and exchanges. - -Our solution is hardware and software wallet-based and non-custodial. Unlike most CEXs, this resolves users' safety concerns and significantly decreases the possibility of attacks on Yellow Network. Phasing out controllable hot wallets is a big step towards transparency for the end-user. - -Yellow Network also ensures the security of the users' funds by requiring each broker to deposit collateral in the form of $YELLOW tokens to operate on the network. Any fraud or malicious activity that may affect users is detected on the broker's side; the dispute system will immediately return the user's assets, thus preventing fraudulent transactions. - -### **For Brokers** - -Today, we see hacks occurring everywhere and witness how various bottlenecks and flaws lead to huge token steals. State channel technology proves effective in fighting this dangerous trend. The funds belong to either a state channel or the user's wallet. On both sides, it is impossible to break into the wallet without the secure private key or avoid two-sided confirmation for the final status update on the state channel. - -### For End-Users - -Yellow Network is non-custodial. End-users deposit funds to the smart contract through their personal hard/software wallet. This resolves major end-user concerns about the improper storage of funds and the safety of their assets. - -The security of the end-users' funds is also ensured by the amount of collateral that brokers have to deposit before opening a trading channel. As soon as any fraud or malicious activity is detected on the state channel, the dispute system will ensure the return of assets to their rightful owners. diff --git a/docs/legacy/about/partners-and-advisors.md b/docs/legacy/about/partners-and-advisors.md deleted file mode 100644 index 024e856..0000000 --- a/docs/legacy/about/partners-and-advisors.md +++ /dev/null @@ -1,208 +0,0 @@ ---- -sidebar_position: 9 -description: Meet some of our trusted partners and advisors ---- - -# 👥 Partners & Advisors - -:::info -Yellow Network is a project in development. Not all solutions presented in the following (sub)sections are implemented at this stage. The current, and all subsequent sub-pages, are subject to change. - -For more information, visit the [Roadmap](roadmap.md) -::: - -We are proud to have a strong and ever-expanding network of Advisors, Backers, and Partners from different fields and industries. These partnerships allow us to achieve far-reaching impact and scale. - -If you are interested in partnering with Yellow Network, reach out to us via our [social media](#). - -## **Advisors** - -Learn more about our trusted advisors who help to promote Yellow Network and provide us with decades of expertise: - -**Chris Larsen -** [Co-founder and Chairman, Ripple](https://ripple.com/company/leadership/) - -**Robert Drost** - [Head of R\&D, Consensys](https://www.linkedin.com/in/rjdrost/) - -**Juan Otero** - [Founder & CEO, Travala.com](https://www.linkedin.com/in/joterovila/?originalSubdomain=au) - -## Backers - -Learn more about our cornerstone backers: - -
- -GSR - -Founded in 2013, GSR is a crypto market maker with 300 employees across the globe. GSR specializes in providing liquidity, risk management strategies, and structured products to sophisticated global investors in the digital assets industry. A leadership team of veteran finance and technology executives from Goldman Sachs, Citadel, J.P. Morgan, and Two Sigma, among others, has created one of the world’s fastest and most robust digital asset trading systems. - -GSR is deeply embedded in every major sector of the cryptocurrency ecosystem. GRS works with leading cryptocurrency projects, exchanges, funds, and miners as well as financial institutions taking their first steps into the world of digital assets. - -
- -
- -Gate.io - -Founded in 2013, Gate.io has strived to provide its users with the best trading experience in the last 8 years. In terms of trading volume, Gate.io is one of the top 10 crypto exchanges in the world listing crypto assets that are great in quality and have a high rate of return. - -
- -
- -LD Capital - -LD Capital is a leading crypto fund in investment and trading in primary and secondary markets, whose sub-funds include Beco Fund, FoF, hedge fund, Meta Fund, etc. Since its establishment in 2016, LD Capital has successively invested in more than 300 enterprises. With a highly professional global team and unique industrial resource advantages, LD Capital has laid its emphasis on offering superb services after investments, aiming to support the project in enhancing its long-term value and ecological investment throughout the life cycle. - -More on [https://medium.com/yellow-blog/ld-capital-establishes-strategic-partnership-with-web3-disruptor-yellow-c0ccd59b7ebf](https://medium.com/yellow-blog/ld-capital-establishes-strategic-partnership-with-web3-disruptor-yellow-c0ccd59b7ebf) - -
- -
- -MRC - -A Blockchain Advisory and Investment Firm, incubating and accelerating early-stage startups since 2019. - -More on [https://medium.com/yellow-blog/moonrock-capital-enter-a-strategic-partnership-with-yellow-7574a3aa2fce](https://medium.com/yellow-blog/moonrock-capital-enter-a-strategic-partnership-with-yellow-7574a3aa2fce) - -
- -
- -Bitmart - -A fifth-generation blockchain that aims to bring a paradigm shift from a for-profit to a for-benefit economy. - -5ire intends to be the leading blockchain ecosystem to solve sustainability issues with its proprietary nPoS-based algorithm. 5ireChain’s network acts as a governance structure that democratically empowers and incentivizes DAOs and Working Groups that accelerate the implementation of the UN 2030 Agenda. 5ire technology stack offers protocol-level SDG oracles, cross-chain interoperability, Metaverses, WebAssembly and EVM smart contracts, Real-time economy data collection and telemetry with IoT, AR/VR, smart sensors, and incentivized AI SDG analysis. - -More on [https://medium.com/yellow-blog/5ire-joins-yellow-to-facilitate-adoption-of-the-web3-broker-clearing-network-b8c3fbe3faa0](https://medium.com/yellow-blog/5ire-joins-yellow-to-facilitate-adoption-of-the-web3-broker-clearing-network-b8c3fbe3faa0) - -
- -
- -MEXC - -Founded in 2018, MEXC Global is known as the exchange of high-performance and mega transaction matching technology. The team at MEXC Global is some of the first movers and pioneers of financial and blockchain technology. Currently, MEXC Global caters to 10 M+ users in more than 170 countries around the world and we have just started. This magnificent achievement is a significant milestone, and MEXC Global aims to become the go-to platform for new traders and experienced investors as they move forward in their financial journey. - -MEXC has a presence over and across major continents and jurisdictions around the globe and is regulated, either directly or through affiliates, by some of the world's most renowned jurisdictions. MEXC Global also offers localized language support for investors from different countries, making it easier for them to trade. The exchange at MEXC Global is a high-performance trading engine that has been developed by experts from the banking industry and is capable of completing 1.4 million transactions per second, which results in groundbreaking efficiency and enhanced performance. User security is of top priority at MEXC Global because of which our servers are hosted independently across multiple countries ensuring optimal data integrity and security. - -
- - - -****+more than 25**** other crypto companies and investment funds - -## Tech Partners - -Learn more about some of our key tech partners: - -
- -ByBit - -Qredo is rearchitecting digital asset ownership and blockchain connectivity. A radical new approach to bring liquidity and capital efficiency to the blockchain economy, Qredo has pioneered the first decentralized trustless multi-party computation (MPC) custodial network. This advancement enables Qredo to offer decentralized custody, native cross-chain swaps, and cross-platform liquidity access. - -Qredo works at the cutting-edge of cybersecurity and blockchain. By utilizing the latest innovations in cryptography and distributed ledger technology, Qredo delivers a powerful global network for securing and trading digital assets. - -[https://www.qredo.com/](https://www.qredo.com/) - -
- -
- -Cobo - -Cobo is Asia-Pacific’s largest crypto custodian. Trusted by over 300 institutions and HNWIs to grow and protect their crypto assets, the company focuses on building scalable infrastructure and powering the Web 3.0 revolution around the world. Its proprietary DeFi asset management services crossed the 1.5B AuM mark and achieved a unique risk to reward profile that rivals top hedge funds - without over-exposure to headwinds. As a strong blockchain and DeFi infrastructure builder, Cobo provides Software-as-a-Service products WaaS (wallet), Daas (DeFi), MaaS (NFT Minting) and StaaS (Staking). Amongst other projects, Cobo’s incubator arm also enriches the DeFi ecosystem through its investments in early stage innovative and promising DeFi projects. Its respected security team also features regularly in crypto communities for its contribution towards protecting the crypto ecosystem and patching the vulnerabilities in protocols. - -[https://www.cobo.com/](https://www.cobo.com/) - -
- -
- -Polygon - -Polygon believes in Web3 for all. Polygon is a decentralized Ethereum scaling platform that enables developers to build scalable user-friendly dApps with low transaction fees without ever sacrificing on security. - -[https://polygon.technology/](https://polygon.technology/) - -
- -
- -ConsenSys - -ConsenSys is the leading Ethereum software company. We enable developers, enterprises, and people worldwide to build next-generation applications, launch modern financial infrastructure, and access the decentralized web. Our product suite, composed of [Infura](https://infura.io/), [Quorum](https://consensys.net/quorum), [Truffle](http://trufflesuite.com/), [Codefi](https://codefi.consensys.net/), [MetaMask](https://metamask.io/), and [Diligence](https://consensys.net/diligence), serves millions of users, supports billions of blockchain-based queries for our clients, and has handled billions of dollars in digital assets. Ethereum is the largest programmable blockchain in the world, leading in business adoption, developer community, and DeFi activity. On this trusted, open source foundation, we are building the digital economy of tomorrow. - -[https://consensys.net/](https://consensys.net/) - -
- -
- -Mesh - -ConsenSys Mesh (a.k.a. MESH) is an accelerator, incubator, investor and enabler of blockchain technology solutions. Founded in 2015 by Ethereum co-founder Joseph Lubin, MESH is a network of loosely coupled, tightly aligned teams, products and investments with a single mission to champion global adoption and awareness of groundbreaking technologies in Web3. - -[https://www.mesh.xyz/](https://www.mesh.xyz/) - -
- -
- -Zokyo - -Zokyo is run by the engineers that built, ran or secured some of the largest cryptocurrency companies to date.\ -\ -Our team consists of crypto industry pioneers, veteran ethical hackers that have earned bounties from several Fortune 200 companies including (Uber, Paypal, Facebook, LinkedIn, etc), designers, engineers, tokenomic experts, advanced crypto traders, and experienced investors. - -Our founder, Hartej Sawhney, co-founded Hosho, ranked #1 Smart Contract Auditor in 2019 by Forbes. - -As industry pioneers, our team has played a key role in elevating standards in the digital asset ecosystem and introducing products and services that have set the industry benchmark for security, transparency, and compliance. Zokyo's efforts have been recognized as paving the way for the ongoing institutionalization of the industry. - -[https://www.zokyo.io/](https://www.zokyo.io/) - -
- -
- -Fireblocks - -For institutions that need to store and move digital assets without the operational or security headache. - -Fireblocks streamlines operations by bringing all your exchanges, OTCs, counterparties, hot wallets, and custodians into one platform. Wallets, deposit addresses, and API credentials are secured using patent-pending chip isolation technology and the newest breakthrough in cryptography (MPC). Institutions are using Fireblocks to move funds securely in seconds – instead of hours. - -[https://www.fireblocks.com/](https://www.fireblocks.com/) - -
- -
- -Assetum - -[https://www.assetum.io/](https://www.assetum.io/) - -
- -
- -HackenAI - -Web3 Cybersecurity Auditor - -[https://hacken.io/](https://hacken.io/) - -
- -
- -Magmo - -Web3 scalability solutions - -[https://magmo.com/](https://magmo.com/) - -
- -****+10**** other industry leaders diff --git a/docs/legacy/about/related-work/README.md b/docs/legacy/about/related-work/README.md deleted file mode 100644 index 3f98c3d..0000000 --- a/docs/legacy/about/related-work/README.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -description: Learn about projects that laid the groundwork for Yellow Network ---- - -# 🗺️ Related Work - -Yellow Network stands at the crossroads between traditional financial markets and Web3. - -While the underlying technology and the focus of Yellow Network are deeply embedded in the world of blockchain and Web 3, we seek to resolve a matter that has its root in traditional finance and trade. - -Yellow Network aims to bring the concept of a traditional clearing house into the Web 3 space. To understand our approach and the challenges we face, it is essential to be familiar with related work done in both areas, Web3, and traditional finance. - -Learn more about [related work in Web3.](web-3.md) - -Learn more about the function of [a clearing house in traditional finance.](traditional-finance.md) diff --git a/docs/legacy/about/related-work/traditional-finance.md b/docs/legacy/about/related-work/traditional-finance.md deleted file mode 100644 index 8a7329f..0000000 --- a/docs/legacy/about/related-work/traditional-finance.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -description: The definition, function, and purpose of a traditional clearing house ---- - -# 💶 Traditional Finance - -In traditional finance terms, a clearinghouse is an independent institution formed to facilitate the exchange of securities, commodities, or derivatives. The clearinghouse stands between two broker firms, taking the opposite side of each party and thus reducing the risk of either party honoring its trade settlement obligations. - -The clearinghouse enters the picture after a buyer, and a seller executes a trade. Its role is to accomplish the steps that finalize and validate the transaction. In acting as a middleman, the clearinghouse provides the security and efficiency integral to stability in a financial market. - -*[Image placeholder: Role of a Clearing House diagram]* - -A traditional clearinghouse is tasked with five crucial roles that add stability, safety, and transparency to markets: - -#### 1) Clearing and Finalizing Trades - -This is the principal role of the clearinghouse. It means that all trades that the exchange reports are up to the required market standards and that each participating party can fulfill their commitment. Once a trade is “cleared” it means the trade is completed, i.e., the buyer has paid for the goods and the seller has delivered the asset. - -#### 2) Settling Trades and Netting Margin Accounts - -Besides its function as an overseeing body, the clearinghouse also drastically reduces the number of payments between parties through a "Netting" process. Brokers usually carry out thousands of transactions a day. Settling each transaction would be a logistical nightmare. Netting allows brokers only to pay for the actual outstanding balance of their trading account. - -#### **3) Margin Accounts & Payments** - -Margin accounts are accounts the brokers hold with the clearinghouse. The amount required to be held on these accounts is often defined by mathematical formulas that consider the risk of the broker's open positions. The margin amount is the collateral a broker must maintain at all times to ensure his open positions. - -If the broker can’t meet the margin obligation, the clearinghouse has a procedure to either reduce or liquidate the position. This is called partial or full close-out. - -#### **4) Asset Delivery** - -At the agreed time of exchange, the clearinghouse ensures that the seller delivers the money and the buyer transfers the asset in question. - -If the required margin amount exceeds the balance, the clearinghouse will issue a margin call, i.e., a request to top up the account. - -#### **5) Reporting** - -The clearinghouse is tasked with reporting all activity to regulators and governing bodies. This facilitates oversight since controlling entities don’t have to work out each broker's activity but can view the market as a whole. - -It further allows for analytical data such as market depth, flows, trends, and other important statistical measures for all market participants. diff --git a/docs/legacy/about/related-work/web-3.md b/docs/legacy/about/related-work/web-3.md deleted file mode 100644 index f601892..0000000 --- a/docs/legacy/about/related-work/web-3.md +++ /dev/null @@ -1,88 +0,0 @@ ---- -description: Summary of Web3 projects with related work to Yellow Network ---- - -# 🌕 Web 3 - -:::info -Related Work refers to aspects of existing concepts that lay the groundwork for a new project. -::: - -Since the launch of Bitcoin, cryptocurrency trading has witnessed massive user adoption on a global scale and many alternative projects have been developed in the space. Users now have a broad choice of different blockchains, tokens, and decentralized applications. New projects are launched daily, many of which aim to simplify the users' journey in this wild Web3.0. - -Solutions such as bridges are great examples of an effort to interconnect blockchains, but they suffer from a lack of decentralization and pose a security risk. To avoid bridges and still trade effectively, users often require significant liquidity of the same token across different chains to trade efficiently. - -## Scope & Key Takeaways - -* Identify projects that classify as related work to Yellow Network Smart Clearing Protocol; -* Focus on best-in-class decentralized exchange services, liquidity aggregators, and layer-3 protocols; -* Clarify that there is currently no related project with the same scope; -* State of the market overview. - -## Decentralized Applications (dApps) - -### Uniswap—A DEX Case Study - -#### **Short history** - -Uniswap is a decentralized exchange application launched in 2018. It is the first DEX to gain significant traction on the [Ethereum Mainnet](https://ethereum.org/en/) in 2020. Since then, many clones and other decentralized applications have been launched across various blockchains and are used by millions of users to swap tokens, lend or borrow cryptocurrency assets, bridge funds, etc. - -In short, Uniswap paved the way for DeFi (Decentralized Finance). - -#### **Security, and Auditability** - -Uniswap, and other DEXs brought many advantages compared to centralized exchanges. The exchange software is fully implemented in smart contracts deployed on the blockchain. Its open-source nature means anyone can read how it works and potentially build a clone. As the DEX has no custody over user assets, there are fewer risks of wallet hacks. Since there is no expensive underlying business operation, transaction costs tend to be lower. But despite independent audits, self-custody, and other security mechanisms, many DeFi applications are still victims of breaches and exploits. - -#### **Automatic Market Making (AMM)** - -Anyone can provide liquidity to Uniswap markets, called pools, and receive a revenue share from fees collected from trading (swapping). Moreover, the price of assets is managed automatically; every trade impacts the price up or down depending on whether it is placed as an ask or a bid order. Since its v1, the protocol evolved to be more resilient and secure with v2 and introduced more effective liquidity use with v3. - -The Uniswap protocol provides an elegant solution to the problem of market making and access to liquidity. - -#### **Performances** - -The success of decentralized applications is increasingly leading to network congestion. A prime example was the spike in gas fees on Ethereum in 2021. But the Ethereum chain was not alone, and the cost of transactions on many other chains increased drastically, sometimes to a point where it was reaching such unsustainable levels that users stopped interacting with the chain as it became simply too expensive. In addition, many DEXes and other DeFi applications face throughput limitations caused by the low hash rates of certain blockchains. Today many new projects claim to tackle the blockchain scalability problem, and some, like Polygon and Solana, indeed drastically improved the throughput of transactions. - -### Lightning Network - -The Lightning Network is a Layer-2 solution for the Bitcoin network. It was proposed as a solution to the scalability problem of the Bitcoin network and leverages state channel technology to be used as a payment channel to perform any number of off-chain transactions. An on-chain funding transaction initiates a payment channel. Then, it is followed by any number of off-chain transactions. Finally, to commit balances, a settlement transaction is performed on-chain. At the same time, the Lightning Network introduces real-time fund transfers in the blockchain. Yellow Network protocol leverages the same technology for high-frequency trading. - -### DyDx - -DyDx is a trading platform for crypto derivatives. It combines the speed of a centralized order book and the transparency of decentralized applications. The result is a more secure and faster software architecture. The downside is that it is limited to Ethereum users. - -### Qredo - -Qredo focuses on securing digital assets using MPC, eliminating the sensitive private key from the signature computation. It also allows settlements by updating an internal ledger entry without costly transactions on the blockchain. While Qredo brings state-of-the-art security for digital assets, it doesn't facilitate high-frequency trading. - -### LayerZero - -LayerZero provides an SDK that enables cross-chain transactions, but it requires modifying existing smart contracts and does not solve performance issues. It increases the number of transactions on already congested chains. - -### Woo network - -Wootrade is a dark pool trading platform that offers significantly above-average liquidity, tighter spreads than the major exchanges, and zero (or even negative!) fees. Wootrade trying to solve the liquidity, cost, and adverse selection issues of cryptocurrency trading for exchanges, institutions, and (eventually), retail traders, through the use of redesigned incentive mechanics. - -### 1Inch - -An entry point to the 1inch Network's tech. The 1inch dApp is a 1 DeFi aggregator, offering access to the liquidity and token swap rates on various DEXes, with features, including partial fill and the ability to find the best swap paths across multiple liquidity sources. Users can optimize trades of DEXs on multiple networks and also with the 1inch DeFi Wallet users can buy crypto with their bank card using our partner fiat gateway providers. - -### HyperLiquid - -HyperLiquid is a high-performance decentralized exchange focused on perpetual contracts and derivatives trading. While it offers high-speed trading capabilities, it operates as a single trading venue. Yellow Network, in contrast, does not aim to launch a single trading venue but rather provides the infrastructure to build DEXs like HyperLiquid rapidly with lower CAPEX and OPEX through its layer-3 virtual ledger. - -### AsterDEX - -AsterDEX is another example of a decentralized exchange platform in the Web3 space. Similar to HyperLiquid, Yellow Network's approach differs by providing foundational infrastructure that enables projects like AsterDEX to be built more efficiently. The Yellow Clearnet layer-3 allows builders to create such platforms with reduced capital expenditure and operational costs. - -## State of the Market (Q4, 2023—Q1, 2024) - -The macroeconomic climate has been defined by inflation and the extension of geopolitical crises. These headwinds have been strongly reflected in the crypto markets. We have also seen the effects of Terra, Celsius, and 3AC’s capitulations impact the market and encourage mass de-risking across all crypto assets. - -2022 has seen the Total Crypto Market Cap fall from over $2.2 Trillion down to below $1 Trillion, further demonstrating the fear in the markets and low-risk sentiment. The move into digital assets and out of fiat currencies due to diminished confidence in monetary bodies is a dynamic that may continue to foster if current economic conditions persist. - -After we saw the collapse of Terra in Q2, the total value locked (TVL) across the major chains fell sharply. We peaked this year with over $196 Billion in TVL which sold off to current levels at below $64 Billion. - -TVL’s behavior during Q3 was similar to the consolidation we saw in digital asset prices, during the same period. As the value of the underlying assets varied in value off the back of macroeconomic risk, TVL adjusted accordingly. QoQ TVL increased by 1.99%. - -**Since the huge capitulation, markets have seen very little recovery. This is relevant as the competitive market analysis is looking at a crippled market, which should be noted.** diff --git a/docs/legacy/about/roadmap.md b/docs/legacy/about/roadmap.md deleted file mode 100644 index 5f34885..0000000 --- a/docs/legacy/about/roadmap.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -sidebar_position: 7 -description: Explore what Yellow Network has in store for the future. ---- - -# 🗺️ Roadmap - -:::info -This Product Roadmap is a general description of the product direction set up for Yellow Network and related products. Work is still ongoing, so this section is subject to change. -::: - -### Product Roadmap - -| Period | Milestones | -|--------|------------| -| **Q1 2024** | - Launch of Yellow Smart Account | -| **Q2 2024** | - Rollout of Yellow Terminal
- Linea Mainnet Integration
- Canary trading test environment
- Onboarding of Initial Builders | -| **Q3 2024** | - Product launch of Yellow Network Telegram app
- Product launch of Yellow Vault
- Start of Yellow Locking Campaign Season 1
- Start of liquidity building through the locking | -| **Q4 2024** | - Distribution of season 1 rewards
- Start of Yellow Locking Campaign Season 2
- Adding support of 6 EVM chains
- Expansion of Builder Program
- Organization of Yellow Network Hackathons
- Instant cross-chain trading feature | -| **2025** | - Launch of Yellow Clearnet virtual ledger layer-3
- SDK released to builders
- State-channels smart-contract nitrolite deployed
- Clearnode golang microservice for off-chain state-channel operations
- Used in multiple Hackathons
- NeoDAX SPOT release (built on Clearnet layer) - expected before end of 2025 | -| **Q1 2026** | - NeoDAX SPOT trading between brokers
- Expansion of Brokerage Ecosystem
- Enhancement of Multi-chain abstraction | -| **Q2 2026** | - NeoDAX support for Perpetual contract trading
- Advanced orders
- Risk Neutral Broker Dealer market making
- Further Expansion of Brokerage Ecosystem | - diff --git a/docs/legacy/about/summary.md b/docs/legacy/about/summary.md deleted file mode 100644 index addd099..0000000 --- a/docs/legacy/about/summary.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -sidebar_position: 1 -description: Yellow Network seeks to revolutionize broker-to-broker trading for crypto assets through its virtual ledger layer-3 infrastructure. ---- - -# 📌 Summary - -As blockchain technology evolves, so does the complexity and the variety of solutions. - -At Yellow Network we are committed to making cryptocurrency trading lean, efficient, and secure. - -A large amount of blockchains, tokens, and platforms has led to a silo approach that confronts users with inefficiencies and security issues, hindering scalability and mass adoption. - -Yellow Network aims to address this issue by providing **Yellow Clearnet**, a virtual ledger layer-3 infrastructure that uses state channels to connect brokers across blockchains, allowing it to reach tokens locked in isolated networks without cross-chain bridging. The layer-3 is built using state-channel smart contracts (nitrolite - a simplified take on nitro) and clearnode, a golang microservice that acts as the off-chain service for state-channel ledger operations. - -The matching throughput of our network averages billions of messages daily, far quicker than any Layer-1 or Layer-2 solution currently available. Our solution is an automated smart clearing protocol, comparable to the function of a clearing house in traditional finance. Yellow Network acts as a mediator between brokers, exchanges, and market makers through its chain-agnostic layer-3 infrastructure. - -**NeoDAX**, built on top of the Yellow Clearnet layer, is the prominent application providing broker-to-broker trading venues. The layer-3 virtual ledger allows rapid development of DEX platforms like NeoDAX with lower CAPEX and OPEX, enabling builders to create fast DeFi applications with the SDK made available through multiple Hackathons. - -By decoupling trading and settlement through the layer-3 virtual ledger, the Yellow Network protocol enables true decentralization of high-frequency trading and widens access to digital and traditional assets. diff --git a/docs/legacy/about/the-problem.md b/docs/legacy/about/the-problem.md deleted file mode 100644 index f0f11c9..0000000 --- a/docs/legacy/about/the-problem.md +++ /dev/null @@ -1,68 +0,0 @@ ---- -sidebar_position: 2 -description: The market challenges Yellow Network seeks to address ---- - -# 🚧 The Problem - -Today, the world of cryptocurrency trading shows significant inefficiencies partially due to its decentralized nature. Here at Yellow Network, we are dedicated to tackling some of the deficiencies of the Web3 space. - -## The Blockchain Trilemma - -*[Blockchain Trilemma Diagram - Source: Yellow.org & Ledger Academy]* - -> "The three pillars of blockchain scalability, decentralization and security co-exist but struggle to exist in harmony." - Vitalik Buterin - -The so-called blockchain trilemma describes the problem that any project can only prioritize two out of three aspects at any given time. - -Based on this theory, the Yellow Network team has identified critical key deficiencies in cross-broker and cross-chain cryptocurrency trading. - -### Scalability - -Traditional finance approaches this problem by having multiple layers of specialized actors. - -On the other hand, crypto markets primarily operate in silos and independent blockchains, leading to a highly fragmented ecosystem. - -Since we started this project, many more Layer-1 and Layer-2 blockchains have appeared, and we are now dealing with hundreds of blockchains. The fragmentation is now acute. There are over 200 notable exchanges and over 6000 cryptocurrencies. Around 100 use their own proprietary blockchain, making it hard to achieve secure interoperability. - -Despite the critical nature of blockchain interoperability, cross-chain systems still face several hurdles when transacting assets or data between chains. These difficulties include transaction rate bottlenecks and disparities in trust. - -Many projects attempting to solve cross-chain issues have relied on interblockchain communications, copying state from one chain to another. This approach is very problematic as it generates waste on-chain, increases the usage of transactions per chain, is very slow since it requires blockchain confirmation on both ends, and is fairly complex to scale as a generic solution for every blockchain. Different chains may have different security requirements to confirm a state is valid and won't be reverted. - -The layer-3 virtual ledger approach remedies these issues by using state-channel smart contracts deployed on every chain and synchronizing the data off-chain using traditional high-speed databases such as Postgres, SQLite, and DHT networks like Kademlia. - -These silos and sub-ecosystems hinder scalability, efficiency, and mass adoption. - -*[Image placeholder: Traditional finance vs. Crypto finance comparison diagram]* - -### Security - -Certain scalability projects such as [bridges](https://www.coindesk.com/learn/are-blockchain-bridges-safe-why-bridges-are-targets-of-hacks/) increasingly suffer from fraudulent attacks and exploits. This impacts trust, acts as a major roadblock for many traders, and traps them within chain ecosystems, further hindering scalability. - -Market places like [centralized exchanges](the-problem.md#centralized-exchanges-cex) that offer custody provide ease of access, but their custody solutions can put user funds at risk if hacked. - -Decentralized exchanges eliminate the custody risk but introduce a subset of [other threats](the-problem.md#decentralized-exchanges-dex). - -### Decentralization - -As the current situation reveals, even though decentralization is considered the driving force within the crypto space, it is far from being a reality. What is referred to as "[decentralization theater](https://www.imf.org/en/Publications/fandd/issues/2022/09/Defi-promise-and-pitfalls-Fabian-Schar)" creates a risk of deception as, in many cases, DeFi protocols remain heavily centralized. - -As a matter of fact, even with most DEXs, there is no real decentralized trading. For example, some DEXs may still rely on a central entity to control the flow of buy and sell orders, which allows them to prevent users from placing orders. Others continue to use third-party accounts as a way to route transactions, making them not really non-custodial in nature. When it comes to their underlying technology blockchain, computing is not fully decentralized, as all machines re-compute the same code in order to reach consensus. Additionally, liquidity remains concentrated on a single chain. As such, trading on decentralized exchanges stands in contrast to something like the shipping industry, which exhibits true decentralization. A vast network of companies works together to ensure global shipping functions effectively. - -## Market and liquidity fragmentation - -Due to the proliferation of blockchains, there has been a fragmentation of assets and liquidity across different layer-1 protocols and increasingly [layer-2 chains](https://l2beat.com/scaling/tvl/). Their interoperability is limited, having hitherto been dependent on centralized cross-chain bridges that have emerged as a [top security risk](https://blog.chainalysis.com/reports/cross-chain-bridge-hacks-2022/) due to the many substantial hacks that have [occurred](https://twitter.com/tokenterminal/status/1582376876143968256/photo/1) since September 2020. - -To counteract market fragmentation, centralized crypto exchanges (CEXs) have rushed onto the scene. Over the last few years, [more than 200](https://coinmarketcap.com/rankings/exchanges/) CEXs have emerged worldwide. While many of them allow for the trading of digital assets across various blockchains, these CEXs remain isolated silos that trap liquidity. They all have their list of markets, which, unlike in traditional finance, are neither global nor aggregated. Some exchanges even choose a set of blockchains they more closely work with, amplifying the overall market's fragmentation. - -The dominance of CEXs in crypto trading has been hailed as one of the [big ironies](https://www.coindesk.com/markets/2019/03/30/the-ultimate-irony-of-crypto-trading/) of a world that wants to achieve decentralization. Thus, decentralized crypto exchanges (DEXs) have gained in popularity and volume, at one point in time even [driving on-chain transaction volumes past](https://blog.chainalysis.com/reports/defi-dexs-web3/) that of centralized platforms. - -Although DEXs may provide a number of benefits over CEXs in terms of censorship resistance or accessibility, they are not yet of [sufficient quality to compete](https://www.snb.ch/n/mmr/reference/sem_2022_06_03_barbon/source/sem_2022_06_03_barbon.n.pdf)\[^12] with the largest CEXs. One of their main problems is the fact that a DEX's blockchain-enabled transparency lends itself to [front-running](https://link.springer.com/chapter/10.1007/978-3-030-43725-1_13). Also, they lack speed and have a hard time competing regarding transaction costs and price efficiency. - -Due to their on-chain architecture, DEXs remain unsuitable for high-frequency trading. Furthermore, when compared to centralized exchanges, there is a general lack of market depth. Market making is limited because, in the context of DEXs, liquidity providers factor in the volatility and security issues of decentralized exchange protocols and therefore deploy limited capital in accordance with their risk profiles. More generally, because the competition among DEXs is currently high, individual platforms struggle to retain liquidity as most liquidity providers only deploy [mercenary capital](https://www.mechanism.capital/native-token-liquidity/) that will instantly withdraw funds if competitors bait them with higher short-term returns. - -A recent analysis purports to [show](https://blog.bitfinex.com/media-releases/hodlers-put-faith-in-centralised-exchanges-as-platforms-flex-high-tech-security/) that crypto traders are more comfortable trading on CEXs given the growing threat of hacks that have materialized in the decentralized finance (DeFi) space over the course of this year. In the aftermath of the [FTX collapse](https://www.investopedia.com/what-went-wrong-with-ftx-6828447), this could be changing, as the inherent count party risk coming with CEXs could increasingly be seen as a major disadvantage. While CEXs are striving to provide transparency by incorporating [proof of reserves](https://niccarter.info/proof-of-reserves/), in which a custodian transparently attests to the existence of on-chain reserve assets (but not liabilities), DEXs are working towards solving their [blockchain-based scalability issues](https://www.researchgate.net/publication/342639281_Scaling_Blockchains_A_Comprehensive_Survey). - -## Lack of regulatory frameworks - -Undeniably, DEXs with centralized components must be subject to the regulatory standards that CEXs must follow. However, this is not the case as specific regulation pertaining to the crypto industry is still missing. Consequently, this lack of regulatory frameworks leads to the fact that there is no separation of responsibilities -- mostly among CEXs. In fact, they are doing a bit of everything: Managing their security in-house, doing their own custody, issuing their own stablecoin, launching investment products, or acting as a launchpad. This not only creates a conflict of interest since CEXs act as marketplaces, market makers, liquidity providers, and custodians, but with this concentration in services, a lot of trust ends up being placed in CEXs - the opposite of what the blockchain space is about. diff --git a/docs/legacy/about/the-solution.md b/docs/legacy/about/the-solution.md deleted file mode 100644 index 7126fb7..0000000 --- a/docs/legacy/about/the-solution.md +++ /dev/null @@ -1,60 +0,0 @@ ---- -sidebar_position: 3 -description: >- - Yellow Network decentralizes the trading for real by allowing participants to - trade using their nearest node. ---- - -# 🚀 The Solution - -[Yellow Network](https://www.yellow.org/) has been specifically designed to address the challenges faced by the current financial ecosystem. It aims to create a decentralized clearing and settlement framework where businesses can collaborate and leverage a robust liquidity infrastructure, similar to how internet service providers and network firms interconnect and operate under regulatory frameworks in various countries. - -By seamlessly connecting brokers and exchanges, Yellow Network serves as a clearing and settlement network of interconnected nodes operating across different blockchains. This blockchain-agnostic approach enables the aggregation of liquidity from various chains, resulting in improved efficiency, reduced slippage, and enhanced execution of trades. With Yellow Network, participants can access the best possible trading opportunities. - -To facilitate high-speed trading, Yellow Network implements **Yellow Clearnet**, a virtual ledger layer-3 infrastructure. This layer-3 is composed of state-channel smart contracts (using nitrolite, a simplified take on nitro) and clearnode, a golang microservice that acts as the off-chain service for state-channel ledger operations. This infrastructure allows for secure and decentralized communication and trading between brokers and exchanges. By leveraging this technology, Yellow Network ensures that transactions can be executed swiftly and efficiently while maintaining the integrity and security of the network. - -The layer-3 virtual ledger enables the development of chain-agnostic applications. **NeoDAX**, built on top of the Yellow Clearnet layer, is the prominent application providing broker-to-broker trading venues. The layer-3 infrastructure allows rapid development of DEX platforms like NeoDAX with lower CAPEX and OPEX. - -The heart of Yellow Network lies in its state channel smart clearing protocol called ClearSync, which operates in a fully decentralized manner. This protocol ensures that the collateral locked within a state channel is governed by a smart contract controlled by the parties involved in the channel. As a result, Yellow Network does not have control over any funds, establishing a non-custodial system for its participants. - -In summary, Yellow Network's decentralized architecture, blockchain-agnostic approach, and layer-3 state channel infrastructure work together to revolutionize the financial ecosystem providing participants with enhanced liquidity, faster trading capabilities, and improved secure trading experience. - -Yellow Network distinguishes itself from other platforms by operating on a network of intermediate nodes rather than relying on a singular blockchain. By adopting this decentralized approach, Yellow Network enables participants to engage in high-frequency trading directly with each other on a broker-to-broker basis. - -Yellow Network serves as a clearing and settlement system that facilitates the communication of trading liabilities, updates to states within state channels, and the resolution of state channel challenges. This unique combination of features draws parallels to the SWIFT messaging protocol and ECN direct order matching protocol. While SWIFT and ECN enable brokers to access global financial markets in traditional finance, Yellow Network performs a similar role for digital assets. This clear-cut setup allows Yellow Network to contribute to the separation of powers, duties, and responsibilities by emulating an essential element of the traditional finance stack - the clearing house. - -By adopting a decentralized approach and incorporating a smart clearing protocol, Yellow Network revolutionizes the way digital assets are traded and settled. It provides participants with increased autonomy, transparency, and efficiency, aligning with the evolving needs and expectations of the financial ecosystem. - -## Scalability - -The use of state channels in Yellow Network is a game-changer for scalability. It connects brokers and exchanges, enabling swift, efficient off-chain trading and clearing. This facilitates high-frequency trading without overburdening the blockchain, making it highly scalable for complex trading activities. - -Moreover, the network amplifies the capabilities of smaller, specialized participants, allowing them to offer more competitive pricing and handle larger trade volumes. This benefit stems from the network's extensive reach and capabilities. Another key feature is the implementation of margin accounts within the clearing network. Participants can utilize margin netting, significantly optimizing capital utilization and allowing for more strategic capital management. This aspect is particularly advantageous in managing multiple transactions, enhancing overall trading efficiency. - -Furthermore, Yellow Network simplifies the settlement process by consolidating numerous trades into a single blockchain transaction, thus streamlining millions of trades into one settlement transaction, which reduces transaction fees and processing time. - -Yellow Network participants hold trading accounts that they use [margin netting](../architecture/smart-clearing-protocol.md), allowing for more efficient use of their capital. - -## Liquidity - -On the liquidity front, Yellow Network effectively breaks down the traditional silos, enabling seamless liquidity exchange across platforms and chains. This directly addresses market fragmentation, increasing market depth, and ensuring stable trading conditions. The increased depth is essential for a healthy market, offering better price discovery for assets. The network's ability to unify disparate liquidity sources is pivotal in reducing conflicts arising from fragmented markets. - -Traders gain access to a cohesive and comprehensive liquidity pool, leading to a more efficient trading experience. In essence, Yellow Network's unification of liquidity is instrumental in creating an integrated market where assets are traded more fluidly, and prices reflect a broader market sentiment. - -## Decentralization - -Yellow Network embraces decentralization through its implementation of a fully decentralized Layer-3 state channel solution. This innovative approach empowers participants to have complete control over their assets by self-custodying them in their personal and smart wallets. Transactions between participants occur peer-to-peer, eliminating the need for reliance on a centralized marketplace. This decentralized nature of Yellow Network ensures increased security, privacy, and autonomy for all users involved in the network. - -## Counterparty Risks - -Yellow Network minimizes counterparty risks by allowing trades to be settled across different brokers and exchanges without the need to transfer assets to other chains or platforms. This automated netting process significantly lowers the risk of being excessively exposed to any specific party. - -Additionally, Yellow Network operates collateral and safety deposits to efficiently address and settle any settlement disputes that may arise among participants. This ensures a secure and reliable settlement process for all involved parties. - -## Capital Efficiency - -Trading firms can enhance their capital efficiency by consolidating trades and enabling lower margin requirements. This approach enables firms to allocate their available funds effectively and potentially reduce the collateral required for their trading activities. By netting trades, firms can offset positions and reduce their overall exposure, which can help optimize their capital usage and potentially increase profitability. Additionally, lower margin requirements can free up more capital for other investments or trading opportunities, further enhancing the firm's overall financial efficiency. - -## Regulations - -Yellow Network aims to simplify the role of brokers by implementing a broker-dealer model. This model enables brokers to distribute their responsibilities, eliminating the need for them to serve as a sole point of contact for various functions such as exchange, custodian, and clearing house. By adopting this approach, Yellow Network aligns with regulatory preferences, making it easier for brokers to obtain licenses and foster positive relationships with regulators. Ultimately, this model streamlines the operations of brokers, enhancing their efficiency and effectiveness in the industry. diff --git a/docs/legacy/architecture/README.md b/docs/legacy/architecture/README.md deleted file mode 100644 index 0150c2f..0000000 --- a/docs/legacy/architecture/README.md +++ /dev/null @@ -1,28 +0,0 @@ -# 📐 Architecture & Design - -:::info -Yellow Network is a project in development. Not all solutions presented in the following (sub)sections are implemented at this stage. The current, and all subsequent sub-pages, are subject to change. - -For more information, visit the [Roadmap](../about/roadmap.md) -::: - -Yellow Network is using a mesh (peer-to-peer) network, using state channels to unify blockchains and reach tokens locked on isolated networks, without the need of bridging them. Our technology is not a new blockchain. It is an independent network using the same principle as the Bitcoin lightning network to reach high performance and secure consensus. - -The matching throughput of Yellow Network allows for billions of messages per day, faster than any Layer-1 or Layer-2 solution available today. - -Yellow Network is essentially an automated smart clearing house. Similar to the clearing houses found in traditional finance, it allows brokers to settle through a trusted intermediary, eliminating counterparty risk. - -Brokers running on Yellow Network are non-custodial participants. This approach makes the business much more resilient to hacks, lowers maintenance costs, and simplifies the launching process. - -All order book transactions are open for audit and review, instead of being stored inside a single server of a centralized exchange platform without any accountability or transparency. - -When a broker opens a trading channel, he agrees on the state of the order book and broadcasts updates to it. When the channel is closed, positions are settled and written on the chain. - -Through our state channel approach, we combine multiple different blockchains without bridging them. The absence of bridging improves architectural security, minimizing asset movement and the risk of human errors and losses. - -#### How P2P trading works - -1. Two brokers choose a Layer-1 EVM compatible blockchain to work on (e.g., Ethereum or Polygon) and lock collateral by deploying an [adjudicator smart contract](smart-clearing-protocol.md#adjudicator-smart-contract). They make a smart contract call to ensure that the [state channel](smart-clearing-protocol.md#state-channel-protocol) is open and funded by both parties. -2. A persistent connection between the two brokers is opened, enabling high-speed communication off-chain and allowing them to open thousands of positions in order to buy and sell any digital assets available in their custody. All those trade liabilities accumulate in the state channel without depending on the underlying blockchain. -3. When the amount of liabilities becomes significant relative to the collateral, any broker can trigger an ad-hoc settlement of open positions. Alternatively, Yellow Network automatically settles all open positions at 0:00 am UTC. -4. On-chain/off-chain settlement is executed simultaneously across all relevant blockchains [atomically using hash time lock](smart-clearing-protocol.md#hash-time-lock-htl). diff --git a/docs/legacy/architecture/custodial-layer.md b/docs/legacy/architecture/custodial-layer.md deleted file mode 100644 index 31ba906..0000000 --- a/docs/legacy/architecture/custodial-layer.md +++ /dev/null @@ -1,51 +0,0 @@ -# Custodial Layer - -:::info -At this stage, Yellow Network does not provide any in-house custodial solution, neither centralized nor decentralized. This means that participating brokers are responsible to provide their own custody solutions. - -However, we are aware of the need for decentralized custodial solutions and plan to address this issue in the near future. -::: - -## Broker Identity and Security - -Brokers are identified by an ECDSA key-pair. They are recommended to use an MPC TSS (Multi-Party Computation Threshold Signature Scheme) custody solution such as the FROST protocol for example. - -**A key security principle depends on the diversity of custody solutions and providers used by the brokers to ensure there is no central vulnerability to the network.** This distributed approach to custody enhances the overall security and resilience of the Yellow Network. - -## Collateral Types - -The Yellow Network Smart Clearing Protocol does not custody assets of participating brokers except for: - -1. **Access collateral** - For accessing the layer-3 ledger layer. Participants lock $YELLOW tokens to gain access to the state channel infrastructure. -2. **Trading collateral** - Typically a stablecoin amount locked for a NeoDAX session, either from retail-to-broker or broker-to-broker trading. - -All participants should have registered their public key and locked $YELLOW tokens. Yellow Network will have access to the collateral for risk management purposes in the case of a dispute between brokers. - -### Flexible Architecture - -The custodian solution used by a broker is independent of Yellow Network. It comes with only a few mandatory requirements to integrate a new custody provider. - -At this stage we plan to integrate the following third-party custody solutions: - -* [Qredo](https://www.qredo.com/) -* [Gnosis safe](https://gnosis-safe.io/) -* [Cobo](https://cobo.com/) -* [Fireblocks](https://www.fireblocks.com/) - -Technically, any custodial solution can be supported by Yellow Network, and we plan to expand our offer continuously. [Contact](#) our sales and development team for specific requests. - -### Multi-Chain - -Most custody solutions support a growing list of blockchains; we plan to leverage third-party custodial solutions to continuously grow the number of supported blockchains in Yellow Network. However, support of a native wallet solution is still possible, meaning that communication with the blockchain happens directly through the blockchain node, rather than a third-party service. This is achieved through a smart contract that secures withdrawals through a multi-signature process. - -### Multi-Signature Withdrawals - -To withdraw funds, the custodian requires a signature from the user, the broker, and a third party. - -A third-party service is used to verify several factors before processing a user withdrawal. This party is independent of the user and the broker. It prevents users from malicious brokers withdrawing funds on their behalf. - -We allow users to configure a combination of third-party verification methods to allow a withdrawal: - -* 2FA (SMS, [Google Authenticator](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2\&hl=en\&gl=US), [YubiKey](https://www.yubico.com/products/yubikey-5-overview/)) -* Email verification - diff --git a/docs/legacy/architecture/risk-management.md b/docs/legacy/architecture/risk-management.md deleted file mode 100644 index 8f7e6f7..0000000 --- a/docs/legacy/architecture/risk-management.md +++ /dev/null @@ -1,117 +0,0 @@ ---- -description: Enhancing trust and providing security ---- - -# Risk Management - -Applying a simple yet effective risk management system is key to maintaining stability, transparency, and trust. - -Yellow Network manages risks by requiring participating brokers to deposit collateral, providing an automated dispute resolution via smart contract, and with the ability to request manual intervention in the case of error detection. - -## Collateral - -Broker-to-broker trading is secured through collateral deposited by brokers. There are two types of collateral that have to be provided: - -* **Access collateral** - For accessing the layer-3 ledger layer. Required to become an accredited Yellow Network participant. All participants should have registered their public key and locked $YELLOW tokens. -* **Trading collateral** - Typically a stablecoin amount locked for a NeoDAX session, either from retail-to-broker or broker-to-broker trading. Agreed upon when a state channel is opened. Secures day-to-day trading activities and prevents overexposure. - -### Network Access Collateral - -The Network Access Collateral is the gateway to becoming an accredited participant of Yellow Network and requires $YELLOW tokens. - -To join Yellow Network, brokers must lock a minimum amount of 250,000 $YELLOW tokens. This allows them to create peer-to-peer trading channels and access the liquidity pool of those peers. - -The more $YELLOW a participant locks in, the more state channels can be opened. - -Sample below: - -
$YELLOW StackedOpened state channels
250.0004
500.0008
1.000.00016
2.000.00032
4.000.00064
- -To unstack funds, a broker needs to close open trading channels and request a withdrawal. There is a 30-day lockup period for funds post the withdrawal request in order to account for any post-transaction claims. - -In case of disputes, the [adjudicator](smart-clearing-protocol.md#adjudicator-smart-contract) can access the network access collateral. - -### Trading Collateral - -When opening a trading channel with another broker, both parties agree on a collateral amount to deposit on the channel. Those funds are used to reduce the risks of the trades between the two brokers, and prevent overexposure. Trading collateral also acts as first line of defense in case of dispute. - -#### Example - -The state of the trading channel contains the liabilities that one broker owes to the other. - -Considering the following trades: - -* Broker A buys 1 BTC for 50,000$ from Broker B -* Broker B buys 10 ETH for 30,000$ from Broker A - -These trades lead to the following liabilities between the two brokers: - -| Currency | Broker A | Broker B | -| ---------------------- | -------------- | -------------- | -| ETH | 10 ETH (@ $3k) | | -| BTC | | 1 BTC (@ $50k) | -| USD | $20,000 | | -| Total Liability in USD | $50,000 | $50,000 | - -Now let's consider BTC price raises by 5% to $52,500 and ETH raises by 10% to $3,300. The estimated liabilities value in USD would become: - -| Currency | Broker A | Broker B | -| -------- | ---------------- | ---------------- | -| ETH | 10 ETH (@ $3.3k) | | -| BTC | | 1 BTC (@ $52.5k) | -| USDC | $20,000 | | -| Total | $53,000 | $52,500 | - -In this situation liabilities are unbalanced; Broker A owes 500$ more in assets to Broker B. As long as the collateral locked by both brokers is higher than this amount, Broker B's position is not at any risk. - -In the last example, we can see that a small amount of collateral can be used to cover a relatively large number of trades even in the case of a significant market movement. - -#### Collateral thresholds - -Brokers are responsible for monitoring the balance of liabilities and ensuring the difference doesn't exceed the collateral of the other broker. - -Actions can be configured at the following thresholds: - -| Threshold | Action | -| --------------------------------- | --------------------------------------------------------------------------- | -| Higher than 80% of the collateral | Trigger a settlement of the liabilities | -| Higher than 95% of the collateral | Disconnect the order books streaming to ensure no more trades are performed | - -## Disputes - -Disputes occur when participating brokers fail to meet their liabilities within Yellow Network. We divide disputes into two categories: State Channel Disputes and Settlement Disputes. - -In the case of a dispute, trading activity on the channel in question is halted until the dispute is resolved. - -### Settlement Disputes - -A settlement dispute occurs when a broker cannot fulfill his obligation at the [time of settlement](smart-clearing-protocol.md#settlement-trigger). In this case, the smart clearing contract will access the deposited collateral to satisfy the settlement process. - -After a settlement dispute is resolved, the broker has to ensure that he has sufficient fresh [collateral](risk-management.md#collateral) before the state channel is reopened for activity. - -### State Channel Disputes - -A State Channel Dispute is triggered manually by a broker and signals an issue between the broker and the protocol. For example, when a broker discovers a bug in the smart clearing protocol. - -While state channels have an automated way to challenge a state for unlocking escrowed funds, this does not cover all possible malicious behavior happening off-chain. - -State Channel Disputes trigger a halt of the trading channel and a manual intervention from the Yellow Network support team. If the dispute can be resolved the state channel is reopened for trading. If no solution is found, the channel is closed and all open positions are reverted, using brokers' collateral if necessary. - -## Online Dispute Resolution Center (ODRC) - -The **Yellow Online Dispute Resolution Center (ODRC)** can handle all manual disputes through auditing logs and quorum vote of appointed anonymous auditors. - -### Participant Registry - -The registry is a reputation database for participants, recording key information such as: -- Trading volume -- Disputes lost -- Amount of capital locked -- Public key registration -- Reputation scores - -Any participant can file a dispute against another participant for a filing fee. An independent arbitration board consults the audit trails available and enforces the outcome of the dispute, which may result in: -- A reputation fault -- A token slash (participant collateral can be slashed in case of dispute loss) - -**Reputation and disputes are recorded on-chain in the participant registry**, ensuring transparency and accountability across the network. diff --git a/docs/legacy/architecture/smart-clearing-protocol.md b/docs/legacy/architecture/smart-clearing-protocol.md deleted file mode 100644 index 410820b..0000000 --- a/docs/legacy/architecture/smart-clearing-protocol.md +++ /dev/null @@ -1,142 +0,0 @@ ---- -description: How Yellow Network operates ---- - -# Smart Clearing Protocol - -Despite the stakeholders in crypto being slightly different from a [clearing house in traditional finance](../about/related-work/traditional-finance.md), the introduction of an independent Layer-3 smart clearing protocol helps to mitigate the problems of: - -Market fragmentation by connecting smaller brokers, market makers, and exchanges; cross-chain and cross-network. - -Market depth & liquidity by aggregating liquidity and order flow between all participants. - -Conflict of interest whereby many traditional crypto exchanges not only act as a marketplace but at the same time act as market makers, liquidity providers, and custodians. - -Introducing a dedicated smart clearing protocol will de-risk the existing landscape and open the market for new participants while simultaneously comforting regulators. - -Liquidity aggregation helps smaller, specialized exchanges and brokers to offer better pricing and handle larger trade volumes. - -Clients from large exchanges can trade additional token pairings for which they otherwise would have to move custodied assets. - -By holding margin accounts with the clearing house, brokers and exchanges can use margin netting to allow for more efficient use of capital. - -This greatly reduces the risk of overexposure and helps to streamline liquidity management and capital efficiency. - -The Clearing Protocol can accurately report order flow data to regulators. This lowers the reporting burden for traders and brokers while simultaneously increasing the marketplace's safety and transparency, and helping to identify and exclude bad actors. - -![The Yellow Network brings these functionalities using cutting-edge state channel technology and settlement via smart contracts.](/img/placeholder.png) - -## Protocol Overview - -The Yellow Network smart clearing protocol is a set of automated smart contracts and services allowing brokers to exchange assets by storing off-chain liabilities and periodically settling those liabilities on-chain. - -Liabilities are secured by [state channel technology](smart-clearing-protocol.md#state-channel-protocol) and backed by [collateral](risk-management.md#collateral), acting as an insurance fund for each broker. - -This allows brokers to perform high-frequency trading of on-chain assets by removing the need to move those assets at every transaction. - -The Yellow Network smart clearing protocol takes care of brokers' collateralization levels and liability risk management in real time. If anything goes wrong during an exchange, the state channel [adjudicator](smart-clearing-protocol.md#adjudicator-smart-contract) will allow the quick and easy resolution of the issue. - -A [settlement](smart-clearing-protocol.md#settlement) mechanism is used to clear/reduce the liabilities of a broker by moving funds between custodians. - -![General overview of Yellow Network Clearing Protocol](/img/placeholder.png) - -## State Channels - -#### Logic - -State channels allow for fast, direct communication between two participants with trustless off-chain state manipulation. All participants sign each state change (transition) in the channel. - -A state transition consists of updates of a participant's liabilities; i.e., when one participant exchanges an asset, liabilities on both sides are created, representing this exchange. - -Here is an example of how the state channel captures a trade between two brokers: - -* Broker A buys `1 BTC` for `30,000 USDC` from Broker B\ - Two liabilities will be added to the channel state - * Liability 1: Broker A liability to Broker B: `30,000 USDC`\ - It means that Broker A will have to give `30,000 USDC` to Broker B at settlement time - * Liability 2: Broker B liability to Broker A: `1 BTC`\ - It means that Broker B will have to give `1 BTC` to Broker A at settlement time - -#### State Definition - -A state channel's definition, as seen in the [overview,](smart-clearing-protocol.md#protocol-overview) contains liabilities held between two participants. - -This means that, at any point in time, each participant knows what liabilities they have, in which asset, and with whom these liabilities have to be [settled](smart-clearing-protocol.md#settlement). - -#### Adjudicator Smart Contract - -The state channel smart contract is called the adjudicator. Its role is to hold the [collateral](risk-management.md#collateral) of each participant while the channel is open. - -If any transaction leads to an invalid state, the smart contract resolves the issue (dispute) and uses the locked collateral as insurance. - -In case of a [settlement ](smart-clearing-protocol.md#settlement)issue, the adjudicator is also able to manage collateral to overcome the dispute. - -#### Channel Creation - -A channel creation consists of two phases: - -* **Pre-funding stage**\ - Each participant agrees on how much collateral he will lock in the channel.\ - When both participants agree on the collateral amount, they lock the collateral in the [adjudicator](smart-clearing-protocol.md#adjudicator-smart-contract) smart contract. -* **Post-funding stage**\ - After the collateral of both participants is locked on-chain, the channel is considered open and ready to receive state updates by either participant. - -#### Channel Closing - -Closing a state channel is done by producing a final state transition. This will cause an automatic [settlement](smart-clearing-protocol.md#settlement) of all open positions, clear liabilities, and allow each participant to see their [collateral](risk-management.md#collateral) being unlocked (if no dispute is in progress). - - - -## Settlement - -Settlement is the act of clearing each state channel participant's liabilities. - -Clearing or reducing the liabilities of participants is achieved by moving funds between each participant's [custodian](custodial-layer.md). - -The settlement is an atomic, multi-chain, and multi-asset transfer process which is written on the respective blockchains. - -#### Settlement trigger - -A settlement may be triggered manually (allowing a broker to reduce his collateral usage) or automatically at 0.00 am UTC. - -Situations that trigger a settlement: - -* [Closing a state channel](smart-clearing-protocol.md#close-a-channel). -* Automated daily settlement at 0.00 am UTC. -* The risk exposure of open trades is considered too high by a participant node, i.e. the open net liabilities exceed the [collateral thresholds](risk-management.md#collateral-thresholds). -* An end-user requests a withdrawal of an asset that is not in the broker's custody but still in a trading channel's liabilities. - -#### Settlement Methods - -Settlements are often performed through withdrawal of funds from Layer-3 to any target blockchain, with the clearnode responsible for settlement. - -The escrow infrastructure depends on each chain's capacity. They are often simplified state-channels for lightweight ledger operations. In some cases, the escrow mechanism used will be a Hash Timelocked Contract (HTLC). - -##### Hash Timelocked Contracts (HTLC) - -A hash timelocked contract (HTLC) is a smart contract used to ensure that a transfer between two parties, performed before an expiration time, allows a rollback and payer to be refunded. It allows two parties to perform an atomic swap without a third party. - -Using an HTLC for the settlement process can move funds from one broker's custody to another on an atomic level and on multiple blockchains. - -This technology was introduced first in Bitcoin and is compatible with all blockchains. - -See also: [https://en.bitcoin.it/wiki/Hash\_Time\_Locked\_Contracts](https://en.bitcoin.it/wiki/Hash_Time_Locked_Contracts) - -## Disputes - -Disputes occur when participating brokers fail to meet their liabilities within Yellow Network. We divide disputes into two categories: State Channel Disputes and Settlement Disputes. - -In the case of a dispute, trading activity on the channel in question is halted until the dispute is resolved. - -### Settlement Disputes - -A settlement dispute occurs when a broker cannot fulfill his obligation at the [time of settlement](smart-clearing-protocol.md#settlement-trigger). In this case, the smart clearing contract will access the deposited collateral to satisfy the settlement process. - -After a settlement dispute is resolved, the broker has to ensure that he has sufficient fresh collateral before the state channel is reopened for activity. - -### State Channel Disputes - -A state channel dispute is triggered manually by a broker and signals an issue between the broker and the protocol; for example, when a broker discovers a bug in the smart clearing protocol. - -State channel disputes trigger a halt of the trading channel and a manual intervention from the Yellow Network support team. If the dispute can be resolved the state channel is reopened for trading. If no solution is found the channel is closed and all open positions are reverted, using brokers' collateral if necessary. - diff --git a/docs/legacy/architecture/supported-technologies.md b/docs/legacy/architecture/supported-technologies.md deleted file mode 100644 index d224005..0000000 --- a/docs/legacy/architecture/supported-technologies.md +++ /dev/null @@ -1,68 +0,0 @@ ---- -description: >- - Overview of technologies we currently support or plan to support in future - releases ---- - -# Supported Technologies - -## NeoDAX Web SDK - -* npm: [https://www.npmjs.com/package/@openware/neodax-web-sdk](https://www.npmjs.com/package/@openware/neodax-web-sdk) -* docs: [https://storybook-neodax-master.v4.uat.opendax.app/?path=/story/getting-started--pag](https://storybook-neodax-master.v4.uat.opendax.app/?path=/story/getting-started--page) - -## Pluggable Custody Solutions - -* [Qredo](https://www.qredo.com/)\* -* [Gnosis safe](https://gnosis-safe.io/)\* -* [Cobo](https://cobo.com/)\* -* [Fireblocks](https://www.fireblocks.com/)\* - -_\*planned, release date tba_ - - - -## **KYC (Know Your Customer)** - -End-user identity verification is the responsibility of each participating broker. - -Yellow Network allows brokers to integrate their own third-party KYC provider.\*\ -Examples: \ -\- [Synaps](https://synaps.io/)\ -\- [Kycaid](https://kycaid.com/) - -_\*planned, release date tba_ - -## **Blockchains**[**​**](https://www.yellow.org/docs/litepaper/product#blockchains) - -List of supported blockchain networks: - -* [Ethereum](https://ethereum.org/en/) -* [Polygon](https://polygon.technology/) -* [Binance Smart Chain](https://www.bnbchain.org/en) - -#### List of networks to be supported in future rollouts: - -* [Bitcoin](https://bitcoin.org/en/) -* [Solana](https://solana.com/) -* [Polkadot](https://polkadot.network/) - -We aim to continuously add new networks and blockchains into the future. If you have a specific request, please reach out to us via our [Discord](https://discord.gg/YA2xKdJj). - -## **Currencies and Markets** - -* The number of supported currencies depends on each broker. Brokers have the ability to add currencies and appropriate markets at their own discretion from the admin panel. -* **Broker-to-Broker Trading is available to brokers only for approved markets and currencies with assets matching from both sides.** - -_**Note: A list of supported currencies and trading pairs will be made available shortly**_ - -## **Support** - -#### **For End-Users**[**​**](https://www.yellow.org/docs/litepaper/product#decentralized-support) - -* Connected brokers are responsible to provide customer service for their end-users; e.g., Zendesk-like systems for operating activities ([ZenDesk](https://www.zendesk.com/), [FreshDesk](https://freshdesk.com/), ...) - -#### For Accredited Brokers and Participants - -* Contact us via [Discord](https://discord.gg/YA2xKdJj) - diff --git a/docs/legacy/architecture/system-overview.md b/docs/legacy/architecture/system-overview.md deleted file mode 100644 index f488bd2..0000000 --- a/docs/legacy/architecture/system-overview.md +++ /dev/null @@ -1,94 +0,0 @@ ---- -description: Technologies used and created by the Yellow Network team ---- - -# System Overview - -![Technologies Used and Created by Yellow](/img/placeholder.png) - -**Yellow Network** is mainly composed of two layers: - -1. **The virtual ledger layer (Layer-3)** - Yellow Clearnet - formed by a network of nodes called "clearnode" - - Clearnodes are gateways from blockchain to layer-3 - - Main duties: account record keeping, blockchain deposit and withdrawal using state-channels - - Built with state-channel smart contracts (nitrolite) and clearnode golang microservices - -2. **Applications built on layer-3** including: - - **NeoDAX**: The prominent application for broker-to-broker trading - - **Watchdogs**: Replicate states for participants and call challenges in case of disaster - - **Oracles**: Off-chain price feeds and data providers using $YELLOW token subscription model - - Other high-speed DeFi applications utilizing the virtual ledger - -**Yellow Nodes:** [Jamstack](https://jamstack.org/), [Golang](https://go.dev/), [Next.js](https://nextjs.org/), [gRPC](https://grpc.io/) - -## **The Broker Node** - -The broker node is built with [NeoDAX™ WEB SDK](https://web-sdk.openware.com/?path=/story/getting-started--page), which offers reusable UI components for common exchange platform interfaces, including widgets. - -All components come with a simple, modern design, and are customizable. - -The library leverages React state management tools such as providers, hooks, and utils to connect to the [NeoDAX™ WEB SDK](https://web-sdk.openware.com/?path=/story/getting-started--page) for JavaScript and pass data to the UI layer, simplifying state synchronization. - -Demo Version - [alpha.yellow.org](http://alpha.yellow.org/) - -**Functionality** - -1. MetaMask Sign In. -2. Deposit /Withdraw (custody contract). -3. Spot Trading (local node, network trading in progress). -4. Broker Admin Panel (Supabase Studio). - -#### Modular Architecture - -A great fit for exchange businesses allows deep customization. - -* Worldwide accessible assets of any type. -* Secure, customizable, and easily localized. -* Ultra-high-speed performance. - -## **Matching Engine**[**​**](https://www.yellow.org/docs/litepaper/product#matching-engine) - -Each broker has its own matching engine, called _Finex,_ a high-performance trading engine of the [NeoDAX™ crypto exchange software stack](https://www.openware.com/product/neodax). It is written in GO language for high throughput of orders and trades. The _Finex_ engine is the core component of the trading platform. It accepts or rejects orders, adds them to the order book, processes trades when orders match, and keeps a persistent state in the database. It prevents users from spending more funds than are available on their balance. - -Features supported in _Finex_ spot matching engine: - -* **Bulk orders** to post or cancel many orders in a single request -* **Post-only order:** advanced limit order which will not match immediately; it guarantees that it will be filled or canceled -* **Fill or kill order:** an advanced limit order which must be fully filled or gets automatically canceled -* **Stop-loss:** advanced market order used to buy or sell a specific asset once the market reaches the limit price. Once the predefined limit price is achieved, the system creates a spot market order. -* **Stop-limit:** advanced limit order used to buy or sell a specific asset at a predefined limit. Contrary to the stop-loss order, a stop-limit order creates a limit order instead of buying the asset outright once the limit price is achieved. -* **API Rate limit**: a rate limiter configurable depending on user roles; it can be configured at the API server level and the trading engine level -* **Bi-directional WebSocket API**: allows end-users and brokers' bots to create and cancel orders and be notified about trades in real-time -* [**gRPC API** with JS and go libraries to speed up the development of bots](https://docs.openware.com/neodax/developers-guides/api-documentation/grpc-protocol) - -## State Channel Technology - -The state channel protocol keeps track of assets owned by brokers, without involving blockchains in trade operations, in an ultra-fast and secure manner. - -The state channel technology creates a metadata index over the liquidity and digital assets on any blockchain, and can add liabilities to it. - -Two brokers open a trading channel using state channel technology, to share liquidity and order books. - -They deposit collateral in a smart contract called the adjudicator, which serves as an independent, neutral clearing house or intermediary; it also safeguards the collateral to ensure a fair outcome. - -Brokers can close the trading channel or trigger a settlement process at any time to honor a withdrawal request by the end-user, or if the value of the underlying assets becomes unbalanced. - -Brokers are required to lock $YELLOW tokens to open channels with other participants. Once a channel is closed any $YELLOW tokens can be unlocked 30 days after the last trade conducted on the trading channel. - -[Read more about how we use state channel technology for our smart clearing protocol.](smart-clearing-protocol.md) - -## Electronic Communication Network (ECN) - -Yellow Network implements a mesh and decentralized ECN through its layer-3 virtual ledger infrastructure. - -An electronic communication network (ECN) is a computerized system that automatically matches buy and sell orders for securities in the market. ECN trading is especially helpful when participants in different geographical areas wish to complete a secure transaction without the use of a third party. - -The ECN aggregates the books of brokers and market makers in different locations through broker-to-broker connections. This leads to deeper liquidity and larger order books and thus a tighter bid-ask spread and faster order execution. Traders can get more attractive spreads and better order flow. - -An additional benefit of the ECN's order aggregation is better price transparency for all participating brokers and market makers. - -Using an ECN counters market fragmentation issues, while maintaining the decentralization aspect of the crypto trading market. The most advanced state-channel protocols are used between NeoDAX nodes and other backend servers, allowing instant, real-time PNL margin confirmation, which provides access to on-chain margin collateral at any given disaster event. - -_\[INSERT: ECN Deal Flow Graphic (in preparation)]_ - -ECN provides brokers access to global financial markets; the Yellow Network protocol forms a decentralized ECN for digital assets through its layer-3 infrastructure and NeoDAX applications. diff --git a/docs/legacy/business/README.md b/docs/legacy/business/README.md deleted file mode 100644 index 882cc65..0000000 --- a/docs/legacy/business/README.md +++ /dev/null @@ -1,45 +0,0 @@ -# Business model - -> "_Trading and speculation are the #1 use case for cryptocurrency but most trading does not use any benefits of the blockchain. This is about to change."_ -> -> **– Louis Bellet, CEO of Yellow** - -With Yellow Network, you unlock the most cost-efficient and legal-friendly framework to run any exchange business. - -|

BECOME A BROKER

For fintech & crypto startups

|

ADD ASSETS TO PORTFOLIO

For traditional finance Industry

|

SAVE ON FEES WITH $YELLOW TOKENS

For profit-oriented traders

| -| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | -| Kickstart your local/worldwide brokerage business OR build a broker to buy/trade unique assets with features and performance of centralized exchanges, while funds are protected with smart-contract custody. | Enrich the number of supported assets and increase revenue streams with a low-friction legal framework. Wrapped tokens managed using state channel smart contracts provide access to diverse assets and unique markets. | Reduce the trade fees charged by the platform while holding $YELLOW tokens on your balance on Yellow-supported platforms. | -| | | | - -_**The global strategy is to have 1,000 nodes operating globally on the network by 2028.**_ - -#### Key stakeholders are: - -* **Existing Customers** - -Over 50 exchanges are ready to engage with the beta launch of NeoDAX™ v4 with the native Yellow Network integration immediately. - -* **FinTech Entrepreneurs** - -Those interested in opening an exchange. Our new solution fits every budget and is radically more simple than a standard centralized exchange. - -* **Financial Institutions** - -Co-invest with us and show interest in selling their services through Yellow Network; they bring a deal flow of their incubates. - -* **Crypto-Enthusiasts, Miners & Traders** - -Can quickly deploy our node software on any cloud and start liquidity-mining with their exchange account. - -#### Token Usage[​](https://www.yellow.org/docs/litepaper/yellow-token#token-usage) - -$YELLOW tokens are locked to be able to open trading channels with other brokers. - -The node software is open-source; however, you need to lock $YELLOW tokens to become an exchange broker in Yellow Network. - -**Access shared liquidity** - -* Launch an application on supported hardware and give it a name. -* Lock 250,000 YELLOW tokens to activate 4 peer-to-peer trading channels. -* Stake collateral to be able to exchange between brokers. -* Access shared order book liquidity of connected peers. diff --git a/docs/legacy/business/background.md b/docs/legacy/business/background.md deleted file mode 100644 index da63276..0000000 --- a/docs/legacy/business/background.md +++ /dev/null @@ -1,75 +0,0 @@ -# Background - -Cryptocurrency trading is now a reality witnessing a massive user adoption rate worldwide. Since Bitcoin, many alternative projects have been developed in the space. Users now have a broad choice of different blockchains and many decentralized applications. New challenges appear to simplify the users' journey in this wild wide web 3.0. Bridges are an example of technologies brought to interconnect blockchains but suffer from a lack of decentralization, an ERC20 native connection from one to another chain, and a need for significant liquidity for many tokens on every chain to satisfy the users' demand. - -### Related Work - -#### Centralized Exchange - -**Security concerns** - -Centralized exchanges are entirely in charge of the assets deposited by users, meaning users have to trust them to secure platform wallets correctly and process trades fairly. Big exchanges take security seriously and make significant investments to do so. However, we can still read news of hacked cryptocurrency exchanges and users' funds drained by attackers. Nevertheless, often smaller exchanges can not afford the cost of securing users' funds effectively. - -**Support of blockchains** - -For a centralized exchange to continue running, many operations are needed. We just mentioned the security aspect, which requires a dedicated team's full-time attention. The support of many blockchains is also complex and leads to high costs. Each of them needs to be explicitly monitored to ensure nodes and platform applications stay synchronized and process blocks in real-time. The load of some chains sometimes escalates quickly with the cost of transactions, leading to withdrawals not proceeding or doing so very slowly. Overall the gas price for withdrawal transactions and deposit processing might need adjusting frequently. - -**Compliance** - -Complying with local regulations can be challenging for exchanges. Small exchanges will probably prefer to target a single market and abide by a single regulator. Another common approach is registering the company in a country where it can operate without regulations. This solution exposes users to the platform operator's goodwill, regulation rules usually being made to protect customers. - -**Market making & Access to liquidity** - -Running an exchange with many markets imposes maintaining order books with tight spreads to provide the best offers possible to users. It also requires deep liquidity in the order book to avoid significant price moves in case of sporadic big demand in a market. Centralized exchanges usually delegate this duty to "market makers." This service can be costly, and the exchange might still have to provide a big part of the liquidity injected into the order book. - -#### Uniswap - -**Short history** - -Uniswap is a decentralized exchange application launched in 2018 \[@uniswap-history]. It is the first DEX to gain significant traction on the Ethereum Mainnet by August 2020. Since then, many clones and other decentralized applications have been launched on many blockchains and used by millions of users to swap tokens, lend or borrow cryptocurrencies assets, bridge funds between blockchains, and many more use cases. - -Uniswap paved the way for DeFi (Decentralized Finance). - -**Security, Auditability** - -It brought many advantages compared to centralized exchanges. The exchange software is fully implemented in smart contracts deployed on the blockchain. Thus anyone can read how it works. Independent parties perform many audits, and many DeFi applications are left with breaches, with funds exploited. However, over time the security of those applications tends to be proven. - -**Automatic market making** - -Anyone can provide liquidity to Uniswap markets (AKA pools) and receive a revenue share from fees collected during trading (AKA swaps). Moreover, the price of assets is managed automatically; every trade impacts the price up or down depending if it is an ask or a bid. Since version one, the protocol evolved to be more resilient in v2 and to use more effectively the liquidity in v3 \[@angeris2020improved]. - -Uniswap protocol provided an elegant solution to the problem of market making and access to liquidity. - -**Performances** - -The success of those applications has led to congestion in the Ethereum network, cost of transactions has been increasing, reaching unsustainable levels. DEXes and other DeFi applications are facing the limitation of blockchains throughput. Many projects claim to solve the problem of blockchain scalability, and some drastically improve the throughput of transactions like Polygon or Solana. - -**Front running bots** - -Transparency of blockchain transactions and the fact that Ethereum orders transactions by gas price expose users of DEXes to front-run bots. \[@daian2019flash]. - -Such bots are monitoring the blockchain and the in-memory transactions pool (containing transactions not yet mined in a block) for incoming swap transactions. They check the slippage tolerance allowed by the user and calculate the cost of front-running transactions. When profitable, they execute a transaction just before the user by setting a higher gas price, and finalize this transaction just after the user takes the profit. - -**Comply with local regulations** - -Decentralized applications are accessible by everyone on the planet in the same way, without any difference between users. This feature allows anyone to access cryptocurrency wallets and use those solutions; this is a powerful feature that gives access to people who can not open a bank account to cryptocurrencies and decentralized finance products. - -Nevertheless, each country has specific regulations applied to financial products; thus, those fully open and restrictionless solutions often violate those rules. - -#### Lightning Network \[@poon2016bitcoin] - -The Lightning Network is a Layer-2 solution for the Bitcoin network. It was proposed as a solution to the scalability problem of the Bitcoin network. It leverages state channel technology to be used as a payment channel to perform any number of off-chain transactions. A payment channel is initiated by an on-chain funding transaction. Then it is followed by any number of off-chain transactions. Finally, to commit balances, a settlement transaction is performed on-chain. At the same time, the lightning network introduces real-time fund transfer in the blockchain. Yellow Network protocol leverages the same technology for high-frequency trading. - -#### DyDx \[@juliano2017dydx] - -[DyDx](https://whitepaper.dydx.exchange/) is a trading platform of derivatives markets. It combines the speed of a centralized order book and the transparency of decentralized applications. The result is a more secure and faster software architecture. The downside is that it is limited to Ethereum's users. - -#### Qredo \[@mccuskerqredo] - -[Qredo](https://www.qredo.com/qredo-white-paper.pdf) focuses on securing digital assets using MPC \[REFERENCE NEEDED], eliminating the sensitive private key from the signature computation. It also allows settlements by updating an internal ledger entry without costly transactions on the blockchain \[TO BE CONFIRMED]. While Qredo brings state-of-the-art security for digital assets, it doesn't facilitate high-frequency trading. - -#### LayerZero - -LayerZero provides an SDK that enables cross-chain transactions, but it requires modifying existing smart contracts and does not solve performance issues. It actually increases the number of transactions on already congested chains. - -### diff --git a/docs/legacy/business/conclusions.md b/docs/legacy/business/conclusions.md deleted file mode 100644 index 732ad5b..0000000 --- a/docs/legacy/business/conclusions.md +++ /dev/null @@ -1,3 +0,0 @@ -# Conclusions - -By decoupling trading and settlement Yellow Network's protocol makes possible decentralization of high frequency trading and widen the access of a great variety of assets, including digital and traditional assets. diff --git a/docs/legacy/business/market-evaluation.md b/docs/legacy/business/market-evaluation.md deleted file mode 100644 index fb699fb..0000000 --- a/docs/legacy/business/market-evaluation.md +++ /dev/null @@ -1,84 +0,0 @@ -# Market Evaluation - -### Market Evaluation & Challenges - -#### Lessons from Traditional Finance - -We’ve been powering 150+ fintech businesses and expect blockchain-powered finance to grow exponentially. Crypto-trading is disruptive but how does it stand against traditional finance? - -*[Traditional Finance vs Crypto Finance Comparison Chart]* - -To overgrow The Wall Street, crypto should use and reimagine the competitor’s strengths. - -### Industry Participants and Regulations - -We are convinced that Crypto Finance should learn and leverage from the legacy of Traditional Finance when it comes to responsibilities and users' protection. It will finally bring blockchain and Web3 finance to the new level of mass-scale. - -#### Financial Forecast & Target MarketCap - -Crypto Trading Volume (datasource: coinmarketcap). - -| **Year** | **Volume** | **YoY** | -| -------- | -------------------- | --------------- | -| 2014 | $13,504,129,508 | | -| 2015 | $14,758,148,680 | 9.29% | -| 2016 | $44,388,474,008 | 200.77% | -| 2017 | $2,065,254,720,344 | 4552.68% | -| 2018 | $6,630,504,556,251 | 221.05% | -| 2019 | $20,139,767,025,388 | 203.74% | -| 2020 | $44,487,027,596,607 | 120.89% | -| 2021 | $58,262,543,013,758 | 30.97% | -| 2022 | $69,915,051,616,510 | 20% (estimated) | -| 2023 | $83,898,061,939,812 | 20% (estimated) | -| 2024 | $100,677,674,327,774 | 20% (estimated) | - -Our projection of the expected gross revenue ratio from HFT trading activities vs. retail trading. - -| **Year** | **2022** | **2023** | **2024** | **2025** | -| ------------------------ | -------- | -------- | -------- | -------- | -| Active nodes | 185 | 385 | 585 | 845 | -| Number of active brokers | 37 | 77 | 117 | 164 | -| Est. HFT Gross revenue | $51M | $230M | $552M | $1,064M | -| Est. Total Gross revenue | $63M | $254M | $600M | $1,157M | - -Crypto trading market is already large, reaching $60T volume in 2021 (with 30% YoY growth). Conquering half of a percent share in crypto trading, Yellow Network becomes a hectocorn, executing up to $600B yearly and connecting hundreds of brokers. - -| | **2022** | **2023** | **2024** | -| --------------------------------------- | ------------ | ------------ | ------------- | -| Crypto Trading Volume | $70 trillion | $84 trillion | $100 trillion | -| Yellow Network Volume Share | 0.08% | 0.30% | 0.60% | -| Number of brokers | 50 | 120 | 250 | -| Network gross revenue | $56M | $250M | $600M | -| Projected Market Cap (20x Gross Profit) | $1.1B | $5B | $12B | -| CMC Rank | Top-100 | Top-40 | Top-20 | - -#### Market Positioning: Comparable Projects FDV - -The Yellow Network provides foundational infrastructure for decentralized finance, positioning us alongside major industry players. Based on the Fully Diluted Valuations (FDV) of comparable projects as of October 3, 2025, the market opportunity is substantial: - -| Project | FDV (Fully Diluted Valuation) | -| ----------- | ----------------------------- | -| HyperLiquid | $50B | -| Aster | $14B | -| Uniswap | $8B | -| Jupiter | $3B | -| Raydium | $1.6B | - -These valuations demonstrate the significant market opportunity for infrastructure providers in the DeFi space. Yellow Network's unique approach of providing the underlying layer-3 infrastructure rather than operating as a single trading venue positions us to capture value across multiple use cases and applications. - -#### Our Partners - -*[Image placeholder: Partners logos diagram]* - -We are currently receiving more than 50 leads/applications per week with an average budget of \~$250K. - -#### Cost-Revenue Structure for Brokers - -Our solution suggests significant cost reduction of R\&D as well as Infrastructure maintenance costs, allowing businesses inside Yellow Network to focus on marketing and growth. It is also enabling new revenue streams. - -| **Costs** | **Revenue Streams** | -| -------------------------------- | ------------------------------- | -| Marketing & Customer Acquisition | Trading Fees | -| Product development | Network Liquidity share profits | -| Operations, Customer support | Asset listings and Launchpad | -| Infrastructure | Dedicated WASM trading bots | diff --git a/docs/legacy/business/token-utility.md b/docs/legacy/business/token-utility.md deleted file mode 100644 index fb00b81..0000000 --- a/docs/legacy/business/token-utility.md +++ /dev/null @@ -1,55 +0,0 @@ -# Token Utility - -* **Token Name:** YELLOW -* **Token Ticker:** $YELLOW - -### **Token Usage**[**​**](https://www.yellow.org/docs/litepaper/yellow-token#token-usage) - -$YELLOW tokens must be locked to access the state-channel infrastructure and become a participant in the Yellow Network. - -The node software is open-source; however, you need to lock $YELLOW tokens to become an exchange broker or application in Yellow Network. - -## Participant Registry and Collateral - -A **central registry and vault contract** is used for participants to register and lock $YELLOW tokens. - -### Minimum Requirements -- There is a **minimum amount** required to become a visible licensed broker or application on the network, but there is **no maximum**. -- The amount applications are ready to put at stake should increase trust in their correct behavior. -- Lock 250,000 $YELLOW tokens to activate 4 broker-to-broker trading channels -- Stake collateral to be able to exchange between brokers -- Access shared order book liquidity of connected peers - -### Registry Information - -The registry serves as a **reputation database** for participants, recording key information such as: -- Trading volume -- Disputes lost (recorded on-chain) -- Amount of capital locked -- Public key registration -- Reputation scores - -All participants should have registered their public key and locked $YELLOW tokens before accessing the layer-3 infrastructure. - -### Yellow Token Characteristics - -**Token Type:** ERC-20 - -**Blockchain Network:** ETH - -**Max Supply:** 10,000,000,000 - -### **Token Distribution** - -*[Token Distribution Chart]* - -* 30% will be dedicated to ecosystem projects development (Community Fund)**;** -* Funds from that pool will be allocated based on community proposals 15% will be allocated for growth-hacking rewards; -* 10% will be allocated for trading mining rewards; -* 20% will be proportionally vested to the investors during 3 years period; -* 10% will be proportionally vested to the founders and team during 5 years period; -* 12.5% will be allocated for Yellow Treasury and for future growth; -* 2.5% will be allocated for liquidity provision. - - - diff --git a/docs/legacy/faq.md b/docs/legacy/faq.md deleted file mode 100644 index f1f760f..0000000 --- a/docs/legacy/faq.md +++ /dev/null @@ -1,273 +0,0 @@ -# FAQ - -### Company - -#### About Yellow Companies Group - -Yellow is an umbrella brand, representing a conglomerate of fintech and blockchain product companies. - -Contributors to this project within the Yellow ecosystem are Openware (technology—NeoDAX™), Assetum (market-making), Yellow Capital (incubates and leads), Attirer (crypto marketing services). - -We merge the multi-year crypto software development experience of Openware and Yellow’s success running a crypto exchange. This multi-structural practice allowed us to inspect numerous potential bottlenecks on both sides. - -Yellow Network is powered by Openware’s software; NeoDAX™. While NeoDAX™ brokerage software is free, connecting the node to liquidity streams (channels) requires staking the $YELLOW token—starting from 250,000 for 4 channels. - -We offer optional enterprise-grade support for node runners which is $240,000 per year. - -Moreover, the Openware partner network will ensure the adoption and integration of new and operating CEXs and DEXs to the Yellow Network. - -Assetum is a market-making company that would contribute to the project’s liquidity via the widespread network of partnerships. Yellow Connect brings new exciting Blockchain solutions and crypto projects through the Yellow Incubator to ensure their native integration into the ecosystem. - -#### **About Openware, Inc.** - -Cloud Software Engineering company with experience of over ten years of servicing European retail banks, shifting their focus entirely to the blockchain industry with the release of open-source modular platform [NeoDAX™](https://github.com/openware/neodax) for building digital asset trading systems. Over the past years, Openware has shipped over 150 trading platforms to their clients. - -#### About Yellow.com, Inc. - -Crypto Market Maker that provides startup seed funding, mentorship, advisory, data analytics, and fintech software solutions. Yellow is also a lifestyle with a vibrant blockchain community through its co-working hub in Chiang Mai (Thailand), conferences, meet-ups, and entertainment for digital nomads. - -**❓ How many people are 100% dedicated to working on Yellow Network?** - -All of the team members are dedicated to the Yellow Network. We have been running a 12-week [Blockchain Hackademy](https://www.youtube.com/watch?v=TWv\_tgOpTik) for four years where students master their knowledge and specialize in blockchain & software development. Today we can grow at a pace of 5 dev/month. - -**❓ Could you tell us about Yellow Incubator, what do they mainly work on?** - -Yellow Incubator is a vastly experienced team that advises, develops, and funds blockchain, crypto, DeFi, and NFT projects, providing seed investment, VC, and market making solutions. We finance solid projects that use NeoDAX™, reducing license costs for startups and getting equity. The company also counts Legal and Marketing teams. And we are always busy at our [blockchain incubator premises](https://www.youtube.com/watch?v=VoZLpTlSzds) in Chiang Mai, Thailand, known for its welcoming network of blockchain experts, entrepreneurs, and enthusiasts. - -### Business Model - -❓ What is the expected gross revenue ratio from HFT trading activities vs. retail trading? - - - -| **Year** | **2022** | **2023** | **2024** | **2025** | -| ------------------------ | -------- | -------- | -------- | -------- | -| Active nodes | 185 | 385 | 585 | 845 | -| Number of active brokers | 37 | 77 | 117 | 164 | -| Est. HFT Gross revenue | $51M | $230M | $552M | $1,064M | -| Est. Total Gross revenue | $63M | $254M | $600M | $1,157M | - -**❓ How do you plan to increase the number of brokers during the following years?** - -We currently have a number of brokers in the alpha testing of the network. - -Every month, we receive 160 new customer inquiries for creating their brokerage. - -Also, we have about 20 partner distributors who have their stream of customers. They can install the appliance that is activated when they stake enough $YELLOW tokens. - -**❓ How do you plan to share revenues with Yellow network users? Where do the fees go?** - -To collect fees, you must run a Yellow node and mine trades. You can create liquidity channels and charge for the usage (traffic using it). Your collateral on this state channel is used to connect the network to reach more liquidity, thus, collecting a fee from a volume in it. - -Transaction fees are collected from clearing and trading fees and deposited into the **Yellow Treasury Vault**. The vault implements a buy-back mechanism of the $YELLOW token to stabilize its value through liquidity provision. - -**❓ What is the Yellow Treasury Vault?** - -The Yellow Treasury Vault (formerly Yellow Reserve Vault) is our treasury entity with the following main responsibilities: -1. To provide stability for the $YELLOW token through a buy-back mechanism -2. Building a diversified currency reserve to resolve disputes between brokers -3. Collecting transaction fees from clearing and trading fees - -The Treasury Vault can decide to burn $YELLOW under certain conditions to support the valuation of the native Yellow Network token. - -**❓ What is your way of calculating the Projected Market Cap?** - -Using the NASDAQ algorithm, we calculated it at 20x annual revenues of all connected brokers, it is usual for crypto startups to reach 100x annual revenues. - -**❓ How does Yellow Network compare to other DeFi projects in terms of market valuation?** - -Yellow Network provides foundational infrastructure for decentralized finance, positioning us alongside major industry players. Based on the Fully Diluted Valuations (FDV) of comparable projects as of October 3, 2025: - -| Project | FDV (Fully Diluted Valuation) | -| ----------- | ----------------------------- | -| HyperLiquid | $50B | -| Aster | $14B | -| Uniswap | $8B | -| Jupiter | $3B | -| Raydium | $1.6B | - -Yellow Network's unique approach of providing the underlying layer-3 infrastructure rather than operating as a single trading venue positions us to capture value across multiple use cases and applications. Unlike HyperLiquid or AsterDEX which operate as single trading venues, Yellow Network enables rapid development of DEX platforms with lower CAPEX and OPEX. - -**❓ How is the network Combined Revenue calculated? What are the hypothetical values for trading fees?** - -The Network Combined Revenue is calculated based on the revenue of all brokers of the network. The trading fees will range from 0.1 to 0.15%. - -### Tokenomics/Finance - -**❓ Have you worked with any Tokenomics advisor? If yes, which one?** - -Besides our in-house experts, we are delighted to have various reputable Tokenomics Advisors such as [**Juergen Hoebarth**](https://www.linkedin.com/in/juergenhoebarth/) or [**Juan Otero**](https://www.linkedin.com/in/joterovila/) supporting our project. - -**❓ Total supply of 10 Billion tokens = hard cap, correct?** - -Yes, correct. - -**❓ What benefits do YELLOW token holders get?** - -* Ability to stake $YELLOW token to run a node; -* Ability to stake token for liquidity mining (collecting fees going through the channel); -* DAO is possible depending on US regulations (DAO risks qualifying the token to security, which we don’t mind, but security token can’t be listed on most CEX, so it's really a gray area these days); -* Social activity such as influencing articles and projects on [yellow.com](http://yellow.com) launchpad; -* Paying fees for liquidity, and reducing these fees by the number of $YELLOW tokens in the hold. - -**❓ Do you have plans to move to the DAO model (as a community-driven model)?** - -Yes. Community funds and 55% of the tokens are DAO-driven. - -**❓ How does your company treasury work?** - -The company treasury is created to expand any group-related company, but it will most likely be inter-company loans, as those tokens are on the Seychelles balance sheet. - -**❓ Trade mining rewards: what happens when the 10% have been distributed? Is it just to boost acquisition and liquidity at the beginning?** - -Similar to bitcoin rewards, trading mining only brings the fees, but no additional rewards. - -**❓ What entity will sell the tokens?** - -[Layer-3 Foundation](https://www.layer3.foundation/). - -### Product / Architecture - -**❓ What is Yellow Clearnet?** - -Yellow Clearnet is our virtual ledger layer-3 infrastructure that forms the foundation of the Yellow Network. It is composed of: -- State-channel smart contracts using **nitrolite** (a simplified take on the Nitro protocol) -- **Clearnode** - a golang microservice that acts as the off-chain service for state-channel ledger operations -- Clearnodes serve as gateways from blockchain to layer-3, handling account record keeping and blockchain deposits/withdrawals - -The layer-3 was launched in 2025 with SDK released to builders and has been used in multiple Hackathons. - -**❓ What is NeoDAX and how does it relate to Yellow Network?** - -NeoDAX is the prominent application built on top of the Yellow Clearnet layer-3 infrastructure. It provides broker-to-broker trading venues. The layer-3 virtual ledger allows rapid development of DEX platforms like NeoDAX with lower CAPEX and OPEX, enabling builders to create fast DeFi applications. - -- NeoDAX SPOT release is expected before the end of 2025 -- Q1 2026: NeoDAX will support SPOT trading between brokers -- Q2 2026: NeoDAX plans to add support for Perpetual contract trading - -**❓ What other applications are built on Yellow Network's layer-3?** - -Besides NeoDAX, the Yellow Network ecosystem includes: -- **Watchdogs**: Replicate states for participants and call challenges in case of disaster -- **Oracles**: Off-chain price feeds and data providers using $YELLOW token subscription model -- Other high-speed DeFi applications utilizing the virtual ledger - -**❓ Why did you choose a state channel technology among other scaling solutions? Why not side-chains or rollups?** - -State channels are faster, not limited to single side-chains; they also enable cross-chain trading. The layer-3 virtual ledger approach remedies issues with interblockchain communications by using state-channel smart contracts deployed on every chain and synchronizing data off-chain using traditional high-speed databases such as Postgres, SQLite, and DHT networks like Kademlia. - -This approach avoids the problems of copying state from one chain to another, which generates waste on-chain, increases transaction usage per chain, is very slow (requires blockchain confirmation on both ends), and is complex to scale as a generic solution. - -**❓ "Liquidity providers take a share of profits from trading fees."—Is everything happening on-chain? How do you manage that with state channels?** - -Funding, opening state channels is on-chain. Trading is performed off-chain (both local trades on Broker's node and broker-to-broker trades). Brokers deposit collateral and $YELLOW tokens, so they can exchange the liquidity then, and the provider collects the fees. - -**❓ What types of collateral are required in Yellow Network?** - -There are two types of collateral: -1. **Access collateral** - For accessing the layer-3 ledger layer. Participants lock $YELLOW tokens to gain access to the state channel infrastructure. -2. **Trading collateral** - Typically a stablecoin amount locked for a NeoDAX session, either from retail-to-broker or broker-to-broker trading. - -All participants must register their public key and lock $YELLOW tokens in the central registry and vault contract. - -**❓ What is the Participant Registry?** - -The registry is a reputation database for participants, recording key information such as: -- Trading volume -- Disputes lost (recorded on-chain) -- Amount of capital locked -- Public key registration -- Reputation scores - -There is a minimum amount required to become a visible licensed broker or application on the network, but no maximum. The more applications are willing to stake, the more it increases trust in their correct behavior. - -**❓ What Layer-1s are you connected to and planning to connect to?** - -We plan to connect to every Layer-1,2 bridges, wallets, bank, exchange. Partners are in queue for the software development where our engineer builds the connectors, then we make a joint press release. - -**❓ How do Finex nodes sync prices? Will there be a price difference between nodes? Do all Finex nodes share the same liquidity depth? Can the Finex node run as a standalone mode?** - -Broker-to-broker broadcast using a PubSub; a market is a Topic. There can be price differences between nodes. Depending on how many peers this node has, it has a more or less complete Orderbook. (Think torrent discovery of node). - -All Finex nodes can show the same depth; how deep they go depends on their state channel collateral. The most advanced state-channel protocols are between NeoDAX nodes and other backend servers, allowing instant, real-time PNL margin confirmation, which provides access to on-chain margin collateral at any given disaster event. - -Finex nodes can run stand-alone with non-network orderbooks. - -**❓ Is the Finex network based on blockchain architecture or other distributed architecture?** - -Using LibP2P (think ipfs) it is a new network with gateways being state channels Smart-Contracts on each Layer-1,2 - -**❓ If the Finex network crashes, how to ensure the security of users’ assets based on this architecture?** - -Users’ assets are in the smart contract custody, a crash would not affect them, they could withdraw their funds even if the broker never comes back. - -**❓ OpenFinance uses Custody to host user assets. If users deposit assets into this contract if the L3 state channel crashes, how can users withdraw their assets?** - -They can withdraw by calling the method from MetaMask. - -**❓ Can you elaborate on cross-chain settlements?** - -Settlements are often performed through withdrawal of funds from Layer-3 to any target blockchain, with the clearnode responsible for settlement. The escrow infrastructure depends on each chain's capacity - they are often simplified state-channels for lightweight ledger operations. In some cases, the escrow mechanism used will be a Hash Timelocked Contract (HTLC). - -An "Adjudicator" is a smart contract that collects and releases funds for a state channel; it is possible to design Adjudicators with two or more smart contracts for custody, which means it can open a channel between brokers from different networks. - -**❓ What custody solutions does Yellow Network recommend?** - -Brokers are identified by an ECDSA key-pair. They are recommended to use an MPC TSS (Multi-Party Computation Threshold Signature Scheme) custody solution such as the FROST protocol. - -A key security principle depends on the diversity of custody solutions and providers used by the brokers to ensure there is no central vulnerability to the network. This distributed approach to custody enhances the overall security and resilience of the Yellow Network. - -**❓ Can you elaborate on Dispute Resolution?** - -A dispute occurs when brokers do not agree on the final balance, this is most often due to network issues or malicious broker cases. Yellow Network has implemented a comprehensive dispute resolution system: - -**Automated State Channel Disputes:** -- State channels have an automated way to challenge a state for unlocking escrowed funds -- However, this does not cover all possible malicious behavior happening off-chain - -**Yellow Online Dispute Resolution Center (ODRC):** -The ODRC handles all manual disputes through auditing logs and quorum vote of appointed anonymous auditors. Any participant can file a dispute against another participant for a filing fee. - -An independent arbitration board consults the audit trails available and enforces the outcome of the dispute, which may result in: -- A reputation fault -- A token slash (participant collateral can be slashed in case of dispute loss) - -Reputation and disputes are recorded on-chain in the participant registry, ensuring transparency and accountability. - -**❓ How is the challenge/judge mechanism of Yellow Network's state channel designed?** - -The system includes multiple layers: -1. **Watchdogs**: Auditing entities that replicate state from channels using DHT or other fail-over mechanisms, share audit logs, and can call challenges to unlock escrowed funds in the event of a disaster (e.g., a NeoDAX crash/bankruptcy) -2. **Automated challenges**: For state channel disputes related to unlocking escrowed funds -3. **ODRC**: For manual dispute resolution through arbitration and quorum voting - -### Traction / Development Stage - -**❓ What is the current status of Yellow Network development?** - -In 2025, we created the virtual ledger layer-3 "Yellow Clearnet": -- The SDK is available to builders and has been used in multiple Hackathons -- The layer is composed of state-channels smart-contract nitrolite (a simplified take on nitro) and clearnode, a golang microservice to act as the off-chain service for state-channel ledger operations -- NeoDAX SPOT release is expected before end of 2025, now built on top of clearnet layer -- In Q1 2026, NeoDAX is expected to support SPOT trading between brokers -- In Q2 2026, NeoDAX plans to add support for Perpetual contract trading - -**❓ How has the blockchain fragmentation issue evolved since the project started?** - -Since we started this project, many more Layer-1 and Layer-2 blockchains have appeared, and we are now dealing with hundreds of blockchains. The fragmentation is now acute, making our layer-3 virtual ledger solution even more critical for unifying cross-chain liquidity. - -**❓ Is** [**Yellow.com**](http://yellow.com) **currently running as a CEX, or has L3(Yellow Network) been implemented?** - -[Yellow.com](http://yellow.com) is running NeoDAX™ V3; it uses our liquidity network v1 called XLN. The V4 update is expected in June-July of 2022. - -**❓ When I use** [**Yellow.com**](http://yellow.com) **to deposit ETH, an ETH address is generated on the deposit page. If I deposit ETH to this address, what will happen later? When will the deposit amount appear on the assets page?** - -We advise you to test it yourself at [alpha.yellow.org](https://alpha.yellow.org/). - -**❓ Peatio is a previous generation of CEX software that has not been maintained for 6 years. During your developing process, which features did you keep, which were removed, which were added?** - -We are the core maintainers of Peatio, which we have updated for the last 4 years (v1,2,3.) Currently, we still maintain v3.1—the architecture has completely changed since the old Peatio from 2015. - -### References - -\[1] T. Close, "Nitro Protocol" https://eprint.iacr.org/2019/219.pdf, 2019. \ No newline at end of file diff --git a/docs/legacy/finance/README.md b/docs/legacy/finance/README.md deleted file mode 100644 index 4585987..0000000 --- a/docs/legacy/finance/README.md +++ /dev/null @@ -1,19 +0,0 @@ -# Finance - -Yellow is a mesh network that uses state channels to unify all of the blockchains. This is not a new blockchain. - -It is a financial transaction processing framework built on top of existing blockchains through a Layer-3 concept. - -We use state channel technology to build a metadata index over the liquidity and digital assets over any blockchain, making trading easier. - -The benefit of this approach is a global, localized, and ultra-high-speed consolidation and aggregation of liquidity, smooth order flow and because there is no blockchain there is no typical performance bottleneck. - -The overlay envisions a three fold approach, commonly used in traditional financial markets; - -1\) A _Smart Clearing House_ to independently clear and validate transactions - -2\) Offering _Cross Currency Swaps_ to facilitate liquidity management between brokers - -3\) An _Electronic Communication Network_ for automated order matching on a best effort basis - -The mesh network also supports further decentralization of the crypto asset space, as it will allow small brokers and market makers to operate more efficiently without the use of large centralized exchanges, which often require the custody of assets on their proprietary platform. diff --git a/docs/legacy/finance/fee-calculation-example.md b/docs/legacy/finance/fee-calculation-example.md deleted file mode 100644 index 659736a..0000000 --- a/docs/legacy/finance/fee-calculation-example.md +++ /dev/null @@ -1,48 +0,0 @@ -# Fee Calculation Example - -#### Pre-Defined parameters (Assumptions) - -* Liquidity Fee is charged at the end of each clearing cycle -* Clearing Fee is charged at the end of each clearing cycle -* Liquidity Fee as agreed between Brokers is 0.01% -* Price BTC/USDT = 20,000 -* Price $YELLOW/USDT = 10 -* Transaction; Broker A buys 20 BTC vs. USDT from Broker B -* Agreed Liquidity Fee between Brokers = 0.05% - -**Broker A** - -* Acts as Market Taker and is thus subject to **pay** the Liquidity Fee -* 4 open State Channels = 100 bps Clearing Fee -* Liability Broker A; USDT 200,000 USDT (will have to settle/send USDT to Broker B) - -#### Broker B - -* Acts as Market Taker and is thus entitled to **receive** the Liquidity Fee -* 8 open State Channels = 80bps Clearing Fee -* Liability Broker B; 10 BTC (will have to settle/send BTC to Broker A) - -**Fee Calculation** - -* Liquidity Fee Broker A = 200,000 x 0.05% = 100 USDT -* Clearing Fee Broker A = 200,000 / 10 x 1% = 200 YELLOW -* Clearing Fee Broker B = 10 x 20,000 / 10 x 0.8% = 160 YELLOW - -#### Settlement Amounts - -| Currency | Broker A | Broker B | -| -------- | -------- | -------- | -| BTC | +10 | -10 | -| USDT | -200,100 | +200,100 | - -#### Fee Payment Cash Flow - -| Type | Broker A | Broker B | Period | -| ------------------ | ------------ | ------------ | ------------- | -| Liquidity Fee (L1) | -100 USDT | n/a | On Settlement | -| Clearing Fee (L2) | -200 $YELLOW | -160 $YELLOW | On Settlement | - -Broker A will receive a total of 10 BTC on settlement and paying a total of USDT 200,100. The Yellow Network will receive a total of 360 $YELLOW for the Reserve Vault. - -* The Liquidity Fee is charged automatically to the wallet of Market Taker at clearing. -* the Clearing Fee is automatically charged to the $YELLOW wallet of both Brokers at clearing. diff --git a/docs/legacy/finance/fee-structure/README.md b/docs/legacy/finance/fee-structure/README.md deleted file mode 100644 index 20db345..0000000 --- a/docs/legacy/finance/fee-structure/README.md +++ /dev/null @@ -1,11 +0,0 @@ -# Fee Structure - -The Yellow Clearing House will charge fees and reward participants based on their activity within the Yellow Network. The Yellow Network will not charge fees for profit; all collected fees are either redistributed or used for token liquidity management. - -![YN Fee Distribution](/img/placeholder.png) - -Brokers using the Yellow Network will encounter two fee layers. - -The first layer is a **Liquidity Fee** directly negotiated between the brokers to incentivize market-making and liquidity provisioning within the Yellow Network. - -The second layer is a **Clearing Fee** for both sides of a trade. The clearing fee is sent to the Yellow Reserve Vault that provides treasury and burning functions, supporting the $YELLOW token price and providing our native token a simple yet effective use case. diff --git a/docs/legacy/finance/fee-structure/layer-1-liquidity-fee.md b/docs/legacy/finance/fee-structure/layer-1-liquidity-fee.md deleted file mode 100644 index 305abac..0000000 --- a/docs/legacy/finance/fee-structure/layer-1-liquidity-fee.md +++ /dev/null @@ -1,14 +0,0 @@ -# Layer 1 - Liquidity Fee - -The Liquidity Fee is agreed upon between the brokers when opening a channel. The broker acting as a market maker will set receive the entirety (100%) of the fees paid by the broker acting as a market taker. - -The Liquidity Fee is volume-based, calculated at position opening in % of the base currency of the market taker and added to, or subtracted from, the market taker's liability. - -**Liquidity Fee=Trade Nominal in Liability Ccy x Market Taker Fee (%)** - -Broker Fees are due on settlement, directly charged to the market takers stablecoin wallet and transferred to the market maker. - -**Defined by:** Brokers when they establish a trading channel\ -**Beneficiary:** Market Making Broker\ -**Payment Ccy:** Liability Currency of Trade\ -**Periodicity:** Calculated on every trade and charged on the settlement at 0.00 am UTC diff --git a/docs/legacy/finance/fee-structure/layer-2-clearing-fee.md b/docs/legacy/finance/fee-structure/layer-2-clearing-fee.md deleted file mode 100644 index 55a8dd1..0000000 --- a/docs/legacy/finance/fee-structure/layer-2-clearing-fee.md +++ /dev/null @@ -1,32 +0,0 @@ -# Layer 2 - Clearing Fee - -Fees that are paid from the broker to the Yellow Clearing House. - -A Clearing Fee is due whenever Broker positions are cleared/settled on the Yellow Network. The fee is calculated as % of the settlement liability, converted into $YELLOW, and invoiced to each broker's dedicated $YELLOW spending wallet on settlement. - -* The Clearing Fee is due whenever Broker positions are cleared/settled on the Yellow Network. -* The Clearing Fee is calculated as % of the settlement liability, converted into $YELLOW, and invoiced monthly to each broker's dedicated $YELLOW spending wallet. -* The Clearing Fee Fee is only applied to net cross-broker exchanged volume. -* The Clearing fees are defined by Yellow Clearing House, and 100% of it goes to the Clearing House. -* There are dynamic fee levels with a floor fee that depends on the number of $YELLOW tokens stacked. -* The Clearing Fee is not for profit and funds the Yellow Reserve Vault. - -**Clearing Fee=Net Settlement Liability calculated in $YELLOW x Clearing Fee (%)** - -**Defined by:** Yellow Clearing House\ -**Beneficiary:** Yellow Clearing House\ -**Payment Ccy:** $YELLOW\ -**Periodicity:** Periodicity: Calculated and paid on settlement \ - (min. every 24h, or on a specific settlement request by the Broker) - -| Broker Tier\* | $YELLOW Stacked | Clearing Fee | -| ------------- | --------------- | ------------ | -| 4 channels | 250.000 | 100 bps | -| 8 channels | 500.000 | 80 bps | -| 16 channels | 1.000.000 | 40 bps | -| 32 channels | 2.000.000 | 20 bps | -| 64 channels | 4.000.000 | 10 bps | - -_\*The applicable Broker Tier is defined at the beginning of each clearing cycle. Brokers can not move tiers during a clearing cycle._ - -_Note: All positions are subject to a daily clearing at 0.00 am UCT. Brokers must ensure a sufficient $YELLOW token balance (as outlined in the Risk Management Section) to cover any outstanding Clearing Fees. Failure to meet the clearing fee payment will prevent the Broker from engaging in new positions until the payment for the previous cycle is satisfied._ diff --git a/docs/legacy/finance/smart-clearing-house.md b/docs/legacy/finance/smart-clearing-house.md deleted file mode 100644 index 8c557f5..0000000 --- a/docs/legacy/finance/smart-clearing-house.md +++ /dev/null @@ -1,63 +0,0 @@ -# Smart Clearing House - -### Traditional Clearing House Definition - -A clearing house, in traditional finance terms, is an independent institution formed to facilitate the exchange of securities, commodities, or derivatives. The clearing house stands between two broker firms by taking the opposite side of each party and thus reduces the risk of either party honoring its trade settlement obligations. - -Yellow leverages Layer-2 chains for a clearing house implementation on-chain. - -The clearing house enters the picture after a buyer and a seller execute a trade. Its role is to accomplish the steps that finalize, and therefore validate, the transaction. In acting as a middleman, the clearinghouse provides the security and efficiency that is integral to stability in a financial market. - -A traditional Clearing House is tasked with five crucial roles that add stability, security and transparency to markets; - -#### 1) Clearing & Finalizing Trades - -This is the principal role of the clearinghouse. It means that all trades that the exchange reports are up to the required market standards and that each participating party is able to fulfill their commitment. Once a trade is “cleared” it means the trade is completed. i.e. the buyer has paid for the goods and the seller has delivered the asset. - -#### 2) Settling Trades and Netting Margin Accounts - -Besides its function as an overseeing body the clearinghouse also drastically reduces the number of payments between parties through a process called Netting. Brokers usually commit thousands of transactions a day. Settling each transaction would be a logistical nightmare. Netting allows brokers only to pay for the actual outstanding balance of their trading account. - -#### **3) Margin Accounts & Payments** - -Margin accounts are accounts that the brokers hold with the clearinghouse. The amount required to be held on these accounts is often defined by mathematical formulas that take into consideration the risk of the broker's open positions. The margin amount is the collateral that a broker needs to maintain at all times to ensure his open positions. - -If the broker can’t meet the margin obligation the clearinghouse has a set procedure to either reduce or liquidate the position, called partial or full close-out. - -#### **4) Asset Delivery** - -At the agreed time of exchange, the clearinghouse ensures that the seller delivers the money and the buyer transfers the asset in question. - -If the required margin amount exceeds the balance the clearinghouse will issue a margin call, i.e. a request to top up the account. - -#### **5) Reporting** - -The clearinghouse is also tasked to report all activity to oversee regulators and governing bodies. This facilitates the oversight since controlling entities don’t have to work out the activity of each broker but instead can view the market as a whole. - -It further allows for analytical data such as market depth, flows, trends, and other statistical measures that are important for all market participants. - -### Benefits of a Crypto Clearing House - -Despite the stakeholders in Crypto being slightly different from traditional finance, the introduction of an independent Layer-3 clearinghouse helps to mitigate the problems of; - -_**Market Fragmentation**_ by connecting smaller brokers, market makers, and exchanges cross-chain and cross-network - -_**Market Depth & Liquidity** _ by aggregating liquidity and order flow between all participants - -_**Conflict of Interest**_ whereby many traditional crypto exchanges not only act as a marketplace but at the same time act as market makers, liquidity providers, and custodians. - -Overall the introduction of a dedicated Crypto Clearinghouse will de-risk the existing landscape and open the market for new participants while at the same time comforting regulators. - -**Liquidity aggregation** helps smaller, specialized exchanges and brokers to offer **better pricing** and handle **larger trade volumes**. - -Clients from large exchanges will be able to trade **additional token pairings** for which they otherwise would have to move custodied assets. - -By holding **margin accounts** with the clearinghouse, brokers and exchanges can use **margin netting** to allow for a more **efficient use of capital**. - -This greatly **reduces the risk of overexposure** and helps to **streamline liquidity management** **and capital efficiency**. - -The Clearing House can **accurately report order flow data to regulators** and thus **lower the reporting burden for traders and brokers** while at the same time **increasing the safety and transparency** of the marketplace, as well as helping to **identify and exclude bad actors**. - -![Role of a Clearinghouse in Crypto](/img/placeholder.jpg) - -**Yellow Network brings these functionalities by using cutting-edge state channel technology and settlement via smart contracts.** diff --git a/docs/legacy/finance/yellow-reserve-vault.md b/docs/legacy/finance/yellow-reserve-vault.md deleted file mode 100644 index 17b1966..0000000 --- a/docs/legacy/finance/yellow-reserve-vault.md +++ /dev/null @@ -1,22 +0,0 @@ -# Yellow Treasury Vault - -The **Yellow Treasury Vault** is our treasury entity and is tasked with the following main responsibilities: - -1. **To provide stability for the $YELLOW token** through a buy-back mechanism -2. **Building a diversified currency reserve** to resolve disputes between brokers -3. **Collecting transaction fees** from clearing and trading fees - -## Fee Collection and Buy-Back Mechanism - -Transaction fees are collected from clearing and trading fees and deposited into the Yellow Treasury Vault. The vault implements a **buy-back mechanism of the $YELLOW token to stabilize its value through liquidity provision**. - -$YELLOW Tokens sent to the Treasury Vault will be used to build a diversified portfolio of tokens and coins. Holding a diversified portfolio reduces market risk while at the same time enabling the vault to have a variety of currencies to settle disputes. - -The Treasury Vault can decide to burn $YELLOW under certain conditions to support the valuation of the native Yellow Network token. - -**\*A detailed definition of Yellow Reserve Vault is currently in progress**\* - - - - - diff --git a/docs/legacy/index.md b/docs/legacy/index.md deleted file mode 100644 index 4946df7..0000000 --- a/docs/legacy/index.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Legacy Documentation -description: Legacy Yellow Network documentation and resources -displayed_sidebar: legacySidebar -sidebar_position: 1 ---- - -# Legacy Documentation - -This section contains legacy Yellow Network documentation that is no longer actively maintained but preserved for reference. - -Welcome to the legacy documentation for Yellow Network. This section contains information about previous versions, architecture, and concepts related to the project. - -Please note that some of this information may be outdated. For the most current documentation, please refer to the main sections of this site. - -## Key Sections - -- **[About](./about/summary.md):** Get a summary of what Yellow Network aimed to solve. -- **[Architecture](./architecture/README.md):** Dive into the technical design and components of the legacy system. -- **[Business](./business/README.md):** Understand the business model and market evaluation from the past. -- **[Finance](./finance/README.md):** Learn about the financial concepts, including the fee structure and clearing house model. diff --git a/docs/legacy/resources/communications-and-marketing.md b/docs/legacy/resources/communications-and-marketing.md deleted file mode 100644 index daa40ac..0000000 --- a/docs/legacy/resources/communications-and-marketing.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -description: Learn more about Yellow Network and Yellow ecosystem ---- - -# 🗣️ Communications & Marketing - -:::info -Yellow Network is a project in development. The data presented in the following (sub)sections might not be up to date. The current, and all subsequent sub-pages, are subject to change. -::: - -## The Yellow Network Blog - -Keep up to date with the latest developments of Yellow Network, educational content, news breakdowns, industry research, and other blockchain-related readings via our official [Medium.com](https://medium.com/yellow-blog) publications page. - -Read our Blogposts on [Medium.com](https://medium.com/yellow-blog) - -### Yellow Network Media Kit - -[Yellow Network Media Kit](https://drive.google.com/file/d/1o9RxdTMbeiJhIhsrpa7CzTg4MrmXpD0g/view?usp=share_link) - -**Logo files, project description, photos:** [https://drive.google.com/drive/folders/1U1revrTuIX4dmTRl4uvwU1uluFKzRvPV?usp=share\_link](https://drive.google.com/drive/folders/1U1revrTuIX4dmTRl4uvwU1uluFKzRvPV?usp=share_link) - -### Live Twitter Feed :red\_circle: - -Follow us on [Twitter](https://twitter.com/Yellow) - -## Contact Us - -For any questions and community-related inquiries, please reach out to us via our [Social Media.](#) diff --git a/docs/legacy/resources/duckies/duckies-one-pager.md b/docs/legacy/resources/duckies/duckies-one-pager.md deleted file mode 100644 index 0c03cbc..0000000 --- a/docs/legacy/resources/duckies/duckies-one-pager.md +++ /dev/null @@ -1,3 +0,0 @@ -# 📃 Duckies One-Pager - -[Download Duckies Whitepaper English.pdf](/assets/Duckies%20Whitepaper%20English.pdf) diff --git a/docs/legacy/resources/duckies/ducklings-game.md b/docs/legacy/resources/duckies/ducklings-game.md deleted file mode 100644 index 5f0e584..0000000 --- a/docs/legacy/resources/duckies/ducklings-game.md +++ /dev/null @@ -1,84 +0,0 @@ ---- -description: An NFT-based Card Trading Game ---- - -# 🦆 Ducklings Game - -*[Image placeholder: Ducklings Game header image]* - -Welcome to the wacky world of Ducklings Trading Card Game, a blockchain-based NFT collectible game! You'll embark on a journey as a duckling breeder to collect and meld Ducklings NFT cards. You'll encounter the eccentric and mad scientist, Dr. Quackers, who has taken over the game with his expertise in genetic engineering. - -Dr. Quackers has created a laboratory and is mixing (melding) Ducklings left and right to get as many Mythic breeds so he can dominate the duckies’ world! Outsmart Dr. Quakers with your own Ducklings collection to not let him win! But be careful when melding, as it can go wrong and the duck will become Zombeak, a duckie-mutant! - -*[Image placeholder: Dr. Quackers laboratory diagram]* - -## Types and Rarities of Dr. Quacker’s Creations - -Your objective is to get ahead of Dr. Quackers and create the ultimate Mythic Duckling species before he can. To do so, you must collect as many Legendary Ducklings as possible and meld them to create new and powerful Mythics. Melding cards requires careful planning, as the input cards are destroyed and a new card is created. - -Be wary of failed melding attempts, as they'll result in the creation of special cards called Zombeaks that form their own collection. - -To start your duckling breeding journey, you can get **Ducklings Booster Packs** containing 1, 5, 10, 25, or 50 cards. - -## **Ducklings Booster Pack** - -****Rarity probability distribution per booster pack: 85% common, 12% rare, 2.5% epic, and 0.5% legendary.**** - -## Melding Ducklings - -Each Duckling card belongs to a family and a color; and there are 5 different families (Flockers, Feathers, Waddlers, Mallards, and Fluffers) and 4 different colors (Red, Blue, Green, and Purple) in total, each with an even distribution. - -*[Image placeholder: Duckling families and colors diagram]* - -But don't worry if you can't find the Duckling you're looking for, you can earn $DUCKIES tokens by completing community quests and using them to purchase more cards. - -1. In order to meld common Ducklings, you'll need to meld five cards of the same rarity level, color, or family to create a superior card of the next rarity level. Melding costs vary depending on the rarity level, ranging from 100 $DUCKIES for common cards to 1000 $DUCKIES for legendary cards. -2. The melding function allows the player to place 5 cards of the same rarity level and meld them into one card of superior rarity. You can meld Common cards into Rare, Rare cards into Epic, Epic cards into Legendary, and Legendary into Mythic. - -_Melding requirements differ based on the Ducklings’ rarity level:_ - -****Melding Common Ducklings:**** Same color ****OR**** same family;\ -****Melding Rare or Epic Ducklings:**** Same color ****AND**** same family;\ -****Melding Legendary Ducklings:**** Same color ****AND**** each family. - -_**During the melding, the input cards are destroyed, and a new card is created.**_ You can meld the resulting cards further to get a higher rarity. - -## MYTHIC: Dr. Quaker's Masterpiece - -You had 5 legendaries, all with the same color and different families? It is now time to meld them, and the laboratory will bore the ultimate masterpiece, the **MYTHIC**!! - -As a Mythic NFT holder, you'll be ranked based on the rarity of your Mythic NFT (1-60), with higher ranks giving you access to exclusive benefits such as yields of our native token, $DUCKIES, as well as $YELLOW, and other partner tokens. But it's not just about the rewards—owning a Mythic NFT is a mark of distinction and status within our community. - -Mythic NFTs also have a place in our official Ambassador Program. You'll gain even more perks, including early access to new features and products, the chance to participate in our expansion strategies, and access to private sales that are not available to everyone. - -1. Access to expansion strategies; -2. Benefits in $YELLOW and $DUCKIES & partner tokens; -3. Exclusive early access rights; -4. Access to our private sales; -5. Higher place in the Ambassador program, higher additional rewards. - -Now is the time to mint and meld Ducklings, bring the ultimate reward ‘’Mythics’’ to space, and earn the benefits of them as a unique Mythic holder!\ - - -## ![](https://lh5.googleusercontent.com/E2qIXyJ4gQ6eFESy3jcfZ-0lz6qGBRIAFLfCTEA2zDgXlR2R9cCDiKvkDyBhY3SDSH1Ln7DQuKeOMcTyE3YN8D5fVtC-mo134nR_i-qi5sEo3JE-hx1SzK5yp1CjSxbNHX6exjTY9bqKkwqvb9DVuLc)Zombeaks: Duckie-Mutants - -If a melding attempt fails, the player receives a neutral card called a Zombeak. - -Zombeaks cannot be used for further melding with other cards; however, they form a unique collection and can be melded between each other to create a rarer Zombeak! - -* When melding Common cards, there is a 15% probability of getting a Zombeak. -* When melding Rare cards, there is a 10% probability of getting a Zombeak. -* When melding Epic cards, there is a 5% probability of getting a Zombeak. -* When melding Legendary cards, there is a 1% probability of getting a Zombeak. - -Just as nature fails sometimes, your meld can fail as well as there is nothing you can do apart from accepting this fact and melding mutants between each other to create an even rarer breed of them 🙂 - -Are you ready to dive into this WACKY world of duck breeding and create new and exciting breeds of Ducklings? Start today and see what kind of amazing creations you can come up with. Get ready to dive in and see what kind of creations you can come up with! - -### Download the rules guide: - -[Download Official Duckies NFT Game Rules.pdf](/assets/Official%20Duckies%20NFT%20Game%20Rules.pdf) - -## Duckies Media Kit - -**Logos, images, project details:** [https://drive.google.com/drive/u/0/folders/1xXloVv8L\_JtOyYsiGkaPIBkdAnbwSJlx](https://drive.google.com/drive/u/0/folders/1xXloVv8L_JtOyYsiGkaPIBkdAnbwSJlx) diff --git a/docs/legacy/resources/legal/audit-and-kyc.md b/docs/legacy/resources/legal/audit-and-kyc.md deleted file mode 100644 index c5c4fa3..0000000 --- a/docs/legacy/resources/legal/audit-and-kyc.md +++ /dev/null @@ -1,20 +0,0 @@ -# 🔐 Audit & KYC - -:::info -Yellow Network is a project in development. Not all solutions presented in the following (sub)sections are implemented at this stage. The current, and all subsequent sub-pages, are subject to change. - -For more information, visit the [Roadmap.](../../about/roadmap.md) -Audit & KYC is currently in progress and the results will be published soon. -::: - -### [Hacken Security Audit \[March 2, 2023\]](https://hacken.io/audits/yellownetwork/) - -**Score:** 10/10 - -**Languages:** Solidity - -#### Report: - -[Download Yellow Network Audit 2323.pdf](/assets/Yellow%20Network%20Audit%202323.pdf) - -_**More audits will be published closer to TGE.**_ diff --git a/docs/legacy/resources/legal/general-t-and-c.md b/docs/legacy/resources/legal/general-t-and-c.md deleted file mode 100644 index ff57059..0000000 --- a/docs/legacy/resources/legal/general-t-and-c.md +++ /dev/null @@ -1,283 +0,0 @@ ---- -description: 'General Terms & Conditions of Yellow Network. Last revised: Nov 18, 2022' ---- - -# 📝 General T&C - -:::info -Yellow Network is a project in development. Not all solutions presented in the following (sub)sections are implemented at this stage. The current, and all subsequent sub-pages, are subject to change. - -For more information, visit the [Roadmap](../../about/roadmap.md) - -For Terms and Conditions specific to $YELLOW tokens, please refer to the dedicated section - [$YELLOW T\&C](usdyellow-t-and-c.md) -::: - -These Terms of Service are entered into between you (hereinafter referred to as “**you**” or “**your**”) and Layer3 Fintech Ltd. (as defined below). - -By accessing, downloading, using or clicking on “I agree” to accept any Layer3 Fintech Ltd. Services (as defined below) provided by Layer3 Fintech Ltd. (as defined below), you agree that you have read, understood and accepted all of the terms and conditions stipulated in these Terms of Service (hereinafter referred to as “**these Terms**” or “**Terms**”) as well as our [Privacy Policy](privacy-policy.md). In addition, when using some features of the Layer3 Fintech Ltd. Services, you may be subject to specific additional terms and conditions applicable to those features. - -**IF YOU DO NOT AGREE WITH THESE TERMS OF SERVICE, DO NOT ACCESS LAYER3 FINTECH LTD.'s ASSOCIATED WEBSITES OR USE LAYER3 FINTECH LTD. SERVICES.** - -In the event of any inconsistency between these Terms and any other pages, policies, terms, conditions, licenses, limitations, or obligations contained within or on the Website, these Terms shall prevail. - -The Layer3 Fintech Ltd. Services are complex and carry a high level of risk and are not appropriate for users who do not possess the appropriate level of knowledge and experience to deal with them. Layer3 Fintech Ltd. is under no obligation to assess the suitability of the Services for users and any comment or statement which may be made by Layer3 Fintech Ltd. or any of its Associates as to the suitability of the Services to you should under no circumstances be considered as investment or legal advice and should not be received or relied upon as such. - -**BY MAKING USE OF LAYER3 FINTECH LTD. SERVICES, YOU ACKNOWLEDGE AND AGREE THAT (I) YOU ARE AWARE OF THE RISKS ASSOCIATED WITH TRANSACTIONS OF DIGITAL ASSETS; (II) YOU SHALL ASSUME ALL RISKS RELATED TO THE USE OF LAYER3 FINTECH LTD. SERVICES AND TRANSACTIONS OF DIGITAL ASSETS; AND (III) LAYER3 FINTECH LTD. SHALL NOT BE LIABLE FOR ANY SUCH RISKS OR ADVERSE OUTCOMES.** - -These Terms may be amended, changed, modified or updated by Layer3 Fintech Ltd. at any time and without prior notice to you. You should check back as often as possible ON THIS PAGE to confirm that your copy and understanding of these Terms are current and correct. Your non-termination or continued access to the Website and/or use of any Services after the effective date of any amendments, changes, or updates constitutes your acceptance of these Terms, as modified by such amendments, changes, or updates. - -**1. Definitions** \ -In these Terms and all documents incorporated herein by reference, the following words have the following meanings unless otherwise indicated: - -1.1 “**Affiliates**” means any Person that, directly or indirectly, through one or more intermediaries, controls, is controlled by, or is under common control with, you or Layer3 Fintech Ltd., and for purposes of this definition “control” (including, with correlative meanings, the terms, “controlled by” and “under common control with”), as used with respect to you or Layer3 Fintech Ltd., means the possession, directly or indirectly, of the power to direct or cause the direction of this management or policies of you or Layer3 Fintech Ltd., whether through the ownership of voting securities, by contract or otherwise; - -1.2 “**AML**” means anti-money laundering, including, but not limited to, all Laws applicable to the Parties prohibiting money laundering or any acts or attempted acts to conceal or disguise the identity or origin of; change the form of; or move, transfer, or transport, illicit proceeds, property, funds, Fiat Currencies, or Digital Assets; - -1.3 “**Anti-Corruption**” means all Laws applicable to each Party prohibiting corruption or bribery, kickbacks, inducements, and other related forms of commercial corruption or bribery; - -1.4 “**Associates**” means Layer3 Fintech Ltd. and each and every one of its shareholders, directors, officers, affiliates, employees, contractors, agents, partners, insurers, and attorneys who are acting or performing or have acted or performed services for the benefit of or on behalf of the Website; - -1.5 “**Copyrights**” means all materials are used by Layer3 Fintech Ltd. under license. These materials include, but are not limited to, all the text, graphics, user interfaces, visual interfaces, photos, sounds, process flow diagrams, computer code (including HTML code), programs, software, products, information and documents, as well as the design, structure, selection, coordination, expression, look and feel, and layout of any content included in the services or provided through Layer3 Fintech Ltd. Services, are exclusively owned, controlled and/or licensed by Layer3 Fintech Ltd. or its members, parent companies, licensors or affiliates; - -1.6 “**CTF**” means counter-terrorist financing; - -1.7 “**Digital Assets**” means a digital representation of value that functions as (i) a medium of exchange; (ii) a unit of account; (iii) a store of value; (iv) other similar digital representations of rights or assets, typically including blockchain-based assets or rights including tokens, sovereign cryptocurrency or virtual currency such as Bitcoin, Ether or Litecoin, and/or (v) their derivatives or other types of digitalized assets with a certain value; - -1.8 “**Digital Assets Address**” means an alphanumeric identifier that represents a potential destination for a Digital Assets transfer, which typically is associated with a user’s Digital Assets Wallet; - -1.9 “**Digital Assets Wallet**” means a software application, or other mechanisms, that provide a means for holding, storing, and transferring Digital Assets, including a user’s Digital Assets Address, Digital Assets balance, and cryptographic keys; - -1.10 “**Economic Sanctions**” means financial sanctions, trade embargoes, export or import controls, anti-boycott, and restrictive trade measures enacted, administered, enforced, or penalized by any Laws applicable to you or the Website; - -1.11 “**Fiat Currencies**” means the money or currency of any country or jurisdiction that is (i) designated as legal tender; and, (ii) circulated, customarily used, and accepted as a medium of exchange in the country or jurisdiction of issuance; - -1.12 “**Government**” means any national, federal, state, municipal, local, or foreign branch of government, including, but not limited to, any department, agency, subdivision, bureau, commission, court, tribunal, arbitral body, or other governmental, government-appointed, or quasi-governmental authority or component exercising executive, legislative, juridical, regulatory, or administrative powers, authority, or functions of or pertaining to a government instrumentality; - -1.13 “**Government Approval**” means any authorization, license, permit, consent, approval, franchise, concession, lease, ruling, certification, exemption, exception, or waiver by or with any Government necessary to conduct the business of either Party or the execution, delivery and performance of the Services or any transaction entered into under these Terms; - -1.14 “**Government Official**” means an officer or employee of any Government, a director, officer, or employee of any instrumentality of any Government, a candidate for public office, a political party or political party official, an officer or employee of a public international organization, and any person who is acting in an official capacity for any of the foregoing, even if such Person is acting in that capacity temporarily and without compensation; - -1.15 “**KYC**” means the “know-your-customer” process that Layer3 Fintech Ltd. has put in place before entering into a business relationship or conducting transactions with you. As part of this process, Layer3 Fintech Ltd. may do anything that it deems necessary in order to identify you, verify your identity, scrutinize and investigate your transactions, or comply with any applicable law or regulation. - -1.16 “**Laws**” means all laws, statutes, orders, regulations, rules, treaties, and/or official obligations or requirements enacted, promulgated, issued, ratified, enforced, or administered by any Government that apply to you or the Website; - -1.17 “**Losses**” means, collectively, any claim, application, loss, injury, delay, accident, cost, business interruption costs, or any other expenses, including, but not limited to, any incidental, direct, indirect, general, special, punitive, exemplary, or consequential damages, loss of goodwill or business profits, work stoppage, data loss, computer failure or malfunction, or any and all other commercial losses; - -1.18 “**Marks**” means the trademarks, service marks, and trade names, including, but not limited to, both word marks and design marks of Layer3 Fintech Ltd. and/or Layer3 Fintech Ltd. Services; - -1.19 “**Person**” includes an individual, association, partnership, corporation, company, other body corporate, trust, estate, and any form of organization, group, or entity; - -1.20 “**Personal Data**” has the meaning set out in the [Privacy Policy;](privacy-policy.md) - -1.21 “**Prohibited Jurisdiction**” means (i) any jurisdiction in which the entry into this Term of Services and/or the usage of the Services are prohibited by applicable Law; (ii) any jurisdiction which is subject to United States, United Nations or other applicable Economic Sanctions or embargoes; - -1.22 “**Prohibited Person**” means any citizen or resident of, Government or Government Official of, or Person in or subject to the jurisdiction of, any Prohibited Jurisdiction; and any Sanctioned Person; - -1.23 “**Sanctions List**” means the “[Specially Designated Nationals and Blocked Persons](https://home.treasury.gov/policy-issues/financial-sanctions/specially-designated-nationals-and-blocked-persons-list-sdn-human-readable-lists)” List and the other lists, including, but not limited to, the “[Sectoral Sanctions Identifications List](https://home.treasury.gov/policy-issues/financial-sanctions/consolidated-sanctions-list-non-sdn-lists/sectoral-sanctions-identifications-ssi-list)”, published by the Office of Foreign Assets Control of the U.S. Department of the Treasury; the [Section 311 Special Measures for Jurisdictions, Financial Institutions, or International Transactions of Primary Money Laundering Concern](https://www.fincen.gov/resources/statutes-and-regulations/311-special-measures) published by Financial Crimes Enforcement Network of the U.S. Department of the Treasury; any other foreign terrorist organization or other sanctioned, restricted, or debarred party list published under Economic Sanctions, AML, or CTF Laws of or by Governments of the United States, the United Kingdom, or the United Nations; - -1.24 “**Sanctioned Person**” means any Person or Digital Assets Address that is: (i) specifically listed in any Sanctions List; (ii) directly or indirectly owned 50 percent or more by any Person or group of Persons in the aggregate, or a Digital Assets Wallet associated with such Person or Persons, referred to in any Sanctions List, or Government or Government Official of any Prohibited Jurisdiction; or (iii) that is subject to any Government Approval or otherwise sanctioned, restricted, or penalized under applicable Laws; - -1.25 “**User Submissions**” means any member profile pages, forums, groups, and other interactive features that allow users to post, submit, publish, display, or transmit to other users’ content or materials. - -1.26 “**Website**” means Layer3 Fintech Ltd.'s associated websites (whose domain names include but are not limited to [https://yellow.org](https://yellow.org)) - -1.27 “**Layer3 Fintech Ltd.**” or “**Operator**” means any Person that runs Layer3 Fintech Ltd. Services, including but not limited to legal persons, unincorporated organizations and teams that provide Layer3 Fintech Ltd. Services and are responsible for such services. For convenience, unless otherwise stated, references to " Layer3 Fintech Ltd.", "Operator" and “we” in these Terms specifically mean Layer3 Fintech Ltd. UNDER THESE TERMS, LAYER3 FINTECH LTD. OPERATORS MAY CHANGE AS LAYER3 FINTECH LTD.’S BUSINESS ADJUSTS, IN WHICH CASE, THE CHANGED OPERATORS SHALL PERFORM THEIR OBLIGATIONS UNDER THESE TERMS WITH YOU AND PROVIDE SERVICES TO YOU, AND SUCH CHANGE DOES NOT AFFECT YOUR RIGHTS AND INTERESTS UNDER THESE TERMS. ADDITIONALLY, THE SCOPE OF LAYER3 FINTECH LTD. OPERATORS MAY BE EXPANDED DUE TO THE PROVISION OF NEW LAYER3 FINTECH LTD. SERVICES, IN WHICH CASE, IF YOU CONTINUE TO USE LAYER3 FINTECH LTD. SERVICES, IT IS DEEMED THAT YOU HAVE AGREED TO JOINTLY EXECUTE THESE TERMS WITH THE NEWLY ADDED LAYER3 FINTECH LTD. OPERATORS. IN CASE OF A DISPUTE, YOU SHALL DETERMINE THE ENTITIES BY WHICH THESE TERMS ARE PERFORMED WITH YOU AND THE COUNTERPARTIES OF THE DISPUTE, DEPENDING ON THE SPECIFIC SERVICES YOU USE AND THE PARTICULAR ACTIONS THAT AFFECT YOUR RIGHTS OR INTERESTS. - -1.28 “**Layer3 Fintech Ltd. Services**” means various services provided to you by Layer3 Fintech Ltd. that are based on Internet and/or blockchain technologies and offered via Website, mobile applications, desktop clients and other forms (including new ones enabled by future technological development). Layer3 Fintech Ltd. Services include but are not limited to such Yellow ecosystem components as the Yellow Network, the Global Exchange Platform and novel services to be provided by Layer3 Fintech Ltd. and/or Yellow. - -**2. General Provisions** - -2.1 **Legal Agreement**. These Terms constitute a legal agreement and create a binding contract between you and Layer3 Fintech Ltd. - -2.2 **Additional Terms**. Due to the rapid development of Digital Assets and Layer3 Fintech Ltd., these Terms between you and Layer3 Fintech Ltd. do not enumerate or cover all rights and obligations of each party and do not guarantee full alignment with needs arising from future development. Therefore, THE PRIVACY POLICY AND ALL OTHER AGREEMENTS ENTERED INTO SEPARATELY BETWEEN YOU AND LAYER3 FINTECH LTD. ARE DEEMED ADDITIONAL TERMS THAT ARE AN INTEGRAL PART OF THESE TERMS AND SHALL HAVE THE SAME LEGAL EFFECT. YOUR USE OF LAYER3 FINTECH LTD. SERVICES IS DEEMED YOUR ACCEPTANCE OF THE ABOVE ADDITIONAL TERMS. - -2.3 **Right to Amend, Change, Modify or Update these Terms**. Layer3 Fintech Ltd. reserves the right to amend, change, modify or update these Terms at our sole discretion at any time. You may be notified of such changes on the Website or via email, but you shall check the date displayed on the \[Last revised] date on the title of these Terms. ANY AND ALL AMENDMENTS, CHANGES, MODIFICATIONS OR UPDATES TO THESE TERMS WILL BECOME EFFECTIVE UPON PUBLICATION ON THE WEBSITE OR RELEASE TO USERS. THEREFORE, YOUR CONTINUED USE OF LAYER3 FINTECH LTD. SERVICES IS DEEMED YOUR ACCEPTANCE OF THE MODIFIED AGREEMENT AND RULES. IF YOU DO NOT AGREE TO ANY AMENDMENTS, CHANGES, MODIFICATIONS OR UPDATES TO THESE TERMS, YOU MUST STOP USING LAYER3 FINTECH LTD. SERVICES IMMEDIATELY. YOU ARE RECOMMENDED TO REVIEW THESE TERMS AS OFTEN AS POSSIBLE TO ENSURE YOUR UNDERSTANDING OF THE TERMS AND CONDITIONS THAT APPLY TO YOUR ACCESS TO AND USE OF LAYER3 FINTECH LTD. SERVICES. - -**3. Use of the Website and the Services.** - -3.1 **Right to Use the Website and the Services**. If you (a) have a Digital Assets Wallet, (b) are not a Prohibited Person, (c) do not operate your Digital Assets Wallet for the benefit of a Prohibited Person and (d) comply with these Terms, Layer3 Fintech Ltd. grants you the limited right to use the Services. The right to use the Services is a personal, restricted, non-exclusive, non-transferable, non-sublicensable, revocable, limited license, and it is subject to the limitations and obligations in these Terms of Service. Nothing in these Terms of Service gives you any license (other than as set out in this paragraph), right, title, or ownership of, in, or to the Website, any of the Services, the Copyrights or the Marks. Layer3 Fintech Ltd. may suspend or terminate the provision of Services to you, your Digital Assets, Digital Assets Wallet, or to any of your Digital Assets Address, or to freeze or terminate your Digital Assets Wallet, at its sole discretion, as required by applicable Laws or where Layer3 Fintech Ltd. determines that you have violated, breached, or acted inconsistently with any of these Terms of Service. - -3.2 **Prohibited Use of the Website and the Services**. You are strictly prohibited to - -a) use the Website or any of the Services if you are a Prohibited Person. - -b) operate Digital Assets Wallet for and make orders or transactions in a Digital Assets Wallet for the financial or other benefits of a Prohibited Person. - -c) use the Website or any of the Services in order to disguise the origin or nature of illicit proceeds of, or to further, any breach of applicable Laws, or to transact or deal in, any contraband Digital Assets, Fiat Currencies, funds, property, or proceeds. - -d) use the Website or any of the Services if any applicable Laws, including, but not limited to, AML Laws, CTF Laws, Anti-Corruption Laws and Economic Sanctions Laws, prohibit, penalize, sanction, or expose the Operator to liability for any Services furnished or offered to you or your Digital Assets Wallet(s) or Digital Assets Address(es) under these Terms of Service. - -e) use the Website or any of the Services, or any financial services of a U.S. Financial Institution, whether or not an Associate of the Operator, to facilitate, approve, evade, avoid, or circumvent any applicable Laws, including, but not limited to, AML Laws, CTF Laws, Anti-Corruption Laws, and Economic Sanctions Laws. - -f) use the Website or any of the Services to evade taxes under the Laws of the British Virgin Islands or any other jurisdiction(s) applicable to you or the Website. - -g) trade on the Website or use any Services, with anything other than Fiat Currencies, keys, property, or Digital Assets that have been legally obtained by you and that belong to you. - -h) use the Website or any Services to interfere with or subvert the rights or obligations of the Operator or the rights or obligations of any other Website user or any other Person. - -i) post, submit, publish, display, or transmit any User Submission that violates the Terms of Service or the rights of any Person, including, but not limited to, the intellectual property rights of any Person. - -j) trade using misleading or inaccurate information presented to the Website or to the Operator or take advantage of any technical glitch, malfunction, failure, delay, default, or security breach. - -k) use the Website or any Services to engage in conduct that is detrimental to the Operator or to any other Website user or any other Person. - -l) use the Website or any Services to: (i) engage or attempt to engage in wash trading, spoofing, fictitious trading or price manipulation; (ii) enter orders or quotes with the intent to disrupt, or with reckless disregard for the adverse impact on, the orderly conduct of trading or the fair execution of transactions; or (iii) enter orders or quotes in the Website or any Digital Token market with the intent of creating the false impression of market depth or market interest. - -m) falsify any Digital Assets Wallet, Digital Assets Address, Website registration, exchange, or administration details provided to the Operator or any of its Associates, impersonate another person or misrepresent your affiliation with a person. - -n) post, submit, publish, display, or transmit any User Submission that is likely to deceive any Person. - -o) falsify or materially omit any information or provide misleading or inaccurate information requested by the Operator or any of its Associates, including, but not limited to, at Website registration or during the course of administering any Services to you. - -p) cause injury to, or attempt to harm, the Operator, any of its Associates or any person through your access to the Website or any Services, including, but not limited to, posting, submitting, publishing, displaying, or transmitting any User Submission that is defamatory, obscene, indecent, abusive, offensive, harassing, violent, hateful, inflammatory, or otherwise objectionable. - -q) promote discrimination based on race, religion, nationality, disability, sexual orientation, gender or gender identity, or age. - -r) give the impression that a User Submission emanates from or is endorsed by the Operator or its Associates or any other Person if that is not the case. - -s) have more than one registered identity on the Website, or use any Digital Assets Wallet on a one-time, "throwaway" basis; any such additional Digital Assets Wallets or one-time "throwaway" Digital Assets Wallet may be frozen, terminated or suspended at the absolute discretion of the Operator. - -t) where you are subject to prohibitions or restrictions as set forth in these Terms, access the Website or use any Services utilizing any virtual private network, proxy service, or any other third-party service, network, or product with the effect of disguising your IP address or location, or access the Website or use any Services using a Digital Assets Address in or subject to the jurisdiction of any Prohibited Jurisdiction or Government or Government Official thereof. - -u) post, submit, publish, display, or transmit any advertising or promotional material without the prior written consent of the Operator or its Affiliate. - -v) utilize a Digital Assets Wallet, any Services or the Website for the financial or other benefits of a Prohibited Person; or - -w) violate, promote, cause a violation of, or conspire or attempt to violate these Terms of Service or applicable Laws. - -Any use as described in this paragraph shall constitute a “**Prohibited Use**”. If Layer3 Fintech Ltd. determines or suspects that you have engaged in any Prohibited Use, Layer3 Fintech Ltd. may address such Prohibited Use through an appropriate sanction, in its sole and absolute discretion. Such sanction may include, but is not limited to, removing or declining to post any User Submissions you provide, making a report to any Government, law enforcement, or other authorities, without providing any notice of you about any such report; confiscation of any Fiat Currencies, property, proceeds, or Digital Assets in any Digital Assets Wallet that you have on the Website; and, suspending or terminating your access to any Services or Fiat Currencies, property, or Digital Assets from any Digital Assets Address or Digital Assets Wallet. The Operator may, at its sole and absolute discretion, seize and deliver your property to any applicable Government, law enforcement, or other authorities where circumstances warrant. In addition, should your actions or inaction result in Loss being suffered by the Operator or any of its Associates, you shall pay an amount to the Operator or the Associate so as to render the Operator or the Associate whole, including, but not limited to, the amount of taxes or penalties that might be imposed on the Operator or the Associate. - -3.3 **Trading Activities**. The Website is a trading environment for the purchase and sale of Digital Assets. Purchases are fully funded by trading participants through Fiat Currencies deposited by you from a Digital Assets Address or otherwise into a Digital Assets Wallet. Purchases and sales of Digital Assets Wallet on the Website are settled by actual delivery of the full amount of the Digital Assets by the seller to the purchaser’s Digital Assets Wallet against payment in full by the purchaser to the seller’s Digital Assets Wallet. - -3.4 **Withdrawals and Deposits**. In the course of processing and sending any withdrawals in Fiat Currencies or one or more Digital Assets, or when processing and receiving deposits, Digital Assets Wallet, the Operator may be required to share your user information with other contractual parties, including, but not limited to, financial institutions, or as required under applicable Laws or demanded upon a lawful request by any Government. You hereby irrevocably grant full permission and authority for the Operator to share this information with such contractual third parties, or as required under applicable Laws or demanded upon a lawful request by any Government, and release the Operator from any liability, error, mistake, or negligence related thereto. - -3.5 **Fees and Collaterals**. You may be obliged to pay appropriate trading fees in forms and amounts determined by Layer3 Fintech Ltd. to provide trading activities, access the Website, or use the Services. Also, you may be required to put up collaterals in forms and amounts determined by Layer3 Fintech Ltd. to provide trading activities or use the Services. - -3.6 **Third-Party Services**. The Operator and its Affiliates contract with Persons to provide certain data, information, insights, analysis, and articles that are made available through the Website and the Services, and may also provide links to third-party websites or services that are not under the control of the Operator or its Associates (such information and services collectively, “**Third-Party Services”.**) In addition to the Terms of Service, you may be bound by any additional terms required by providers of Third-Party Services. The Operator and its Associates make no representations about and accept no liability for, any Third-Party Services. The Operator and its Associates are not responsible for the accuracy or reliability of any information, data, opinions, advice, or statements contained in Third-Party Services, the services offered thereby or for their privacy and security policies and procedures. - -**4. Your Eligibility to Use the Website and the Services** - -4.1 **Your Representations and Warranties** \ -You represent and warrant to the Operator on the date of your acceptance or deemed acceptance of these Terms and each day on which you access the Website and/or utilize the Services, in each case with reference to the facts and circumstances existing at such date, as follows: - -a) that, if you are an individual user, you are 21 years of age or older and that you have the capacity to contract under applicable Laws. - -b) that, if you are registering to use or using the Website on behalf of a legal entity, (i) such legal entity is duly organized and validly existing under the applicable laws of the jurisdiction of its organization; and (ii) you are duly authorized by such legal entity to act on its behalf. - -c) that you understand the risks associated with using the Website, that you are not prohibited or restricted from using the Website by these Terms, that you are not otherwise prohibited by applicable Laws from using the Website and that you have had the opportunity to seek legal, accounting, taxation and other professional advice regarding these Terms of Service and the Services; - -d) that you will not use the Website or any Services in order to conceal or disguise the origin or nature of proceeds of crime or terrorist financing, or to further, any breach of applicable AML Laws or CTF Laws, or to deal in any unlawful Digital Assets, Fiat Currencies, property, funds, or proceeds; - -e) that you will not trade or otherwise transact on the Website or use any Services with anything other than Fiat Currencies, or Digital Assets that have been legally obtained by you and that belong to you; - -f) that you are currently in compliance with, and must, at your own cost and expense, comply with all Laws that relate to or affect the Services conducted under these Terms of Service; - -g) that you consent to any and all tax and information reporting under AML Laws, CTF Laws, Anti-Corruption Laws, Economic Sanctions Laws, Tax Information Exchange Laws or other tax Laws as the Operator may reasonably determine; - -h) that neither you nor any of your Affiliates shall use any Digital Assets, Fiat Currencies, property, proceeds or funds subject to the Services of the Website directly or indirectly (i) on behalf of or for the benefit of a Prohibited Person or any Person subject to the jurisdiction of a Prohibited Jurisdiction, except where authorized under any Government Approval or not restricted by applicable Laws; (ii) in violation of or as prohibited, restricted, or penalized under applicable Economic Sanctions Laws; or (iii) in any way that would violate, be inconsistent with, penalized under, or cause the omission of filing of any report required under applicable AML Laws, CTF Laws, or Economic Sanctions Laws; - -i) that you have not (i) violated; (ii) been fined, debarred, sanctioned, the subject of Economic Sanctions-related restrictions, or otherwise penalized under; (iii) received any oral or written notice from any Government concerning actual or possible violation by you under; or (iv) received any other report that you are the subject or target of sanctions, restrictions, penalties, or enforcement action or investigation under, any applicable Laws, including, but not limited to, AML Laws, CTF Laws, Anti-Corruption Laws, or Economic Sanctions Laws; - -j) that neither you nor any of your Affiliates are (i) itself or owned (beneficially or of record) or controlled by a Sanctioned Person; (ii) involved in any transaction, transfer, or conduct, whether or not by using or receiving the Services from any Digital Assets Wallet or Digital Assets Address, that is likely to result in you or your Associates becoming a Sanctioned Person; (iii) residing or domiciled in, or transferring Digital Assets, Fiat Currencies, funds, or property to, from, or through any Digital Assets Wallet, or Digital Assets Address, or engaging in any transaction on the Website from a Prohibited Jurisdiction; or (iv) a Government or Government Official of a Prohibited Jurisdiction; - -k) that neither you nor any of your Associates have directly or indirectly offered, promised, given, or authorized any payment, or offered, promised, given, or authorized the giving of anything else of value, including, but not limited to, any Digital Assets or Fiat Currencies, to a Government Official or individual employed by another entity in the private sector in violation of any applicable Anti-Corruption Laws; - -l) that you will not falsify any Digital Assets Wallet or registration or administration details provided to the Operator; - -m) that you will not falsify or materially omit any information or provide misleading or inaccurate information requested by the Operator in the course of, directly or indirectly relating to, or arising from your activities on the Website or use of any Services, including, but not limited to, at registration or during administration or other due diligence processes, and that if any information provided to the Operator becomes incorrect or outdated, including, but not limited to, information relating to your beneficial ownership, you will promptly provide corrected information to the Operator; - -n) that you shall employ reasonable anti-virus, anti-malware and other software and techniques to protect you and your Digital Assets Wallet from being the victim of a hack or of other malicious actions, so as to protect the integrity of your Digital Assets Wallet and to keep such Digital Assets Wallet and the access to the Website out of the reach of other Persons; - -o) that you acknowledge and agree that Fiat Currencies, Digital Assets or other property reflected in your Digital Assets Wallet are not segregated assets held in your name or for your benefit but reflected only in the books and records of the Operator; - -p) that you acknowledge and agree that any trading or other instructions received or undertaken through your login credentials or from your authorized email address on file with the Operator are deemed to be valid, binding, and conclusive, and that the Operator may act upon those instructions without any liability or responsibility attaching to it; - -q) that you will fairly and promptly report all income associated with your activity on the Website pursuant to applicable Laws and pay any and all taxes thereon; - -r) that you will accurately and promptly inform the Operator if you know or have reason to know whether any of the foregoing representations or warranties no longer is correct or becomes incorrect. - -4.2 **Due Diligence, Anti-Money Laundering and Counter-Terrorist Financing**. The Operator is committed to providing safe, compliant, and reputable services to identify, detect, prevent, and report on money laundering, terrorist financing, and other improper activities under applicable AML Laws, CTF Laws, Anti-Corruption Laws, and Economic Sanctions Laws. Accordingly, the Operator insists on a comprehensive and thorough user due diligence process implementation and ongoing analysis and reporting. By agreeing to these Terms, you shall affirmatively certify that (i) you are not a Prohibited Person and (ii) are not utilizing a Digital Assets Wallet for the benefit of a Prohibited Person, and (iii) must provide promptly all information requested and necessary to satisfy due diligence requirements and obligations pursuant to applicable Laws and the compliance policies or procedures of the Operator or any of its Associates. The Operator reserves the right to bar transactions from or to, to undertake enhanced due diligence, or to freeze, suspend or terminate the administration of Services, or the creation or administration of any Digital Assets Wallet for or with, any user for any reason (or for no reason) at any time, subject to any limitations imposed by applicable Laws. Without limiting the generality of the foregoing, this includes, but is not limited to, any transfer, transaction, business, or dealing with - -a) a Sanctioned Person; - -b) a Prohibited Jurisdiction or a citizen or resident of, Government or Government Official of, or Person in or subject to the jurisdiction of, any Prohibited Jurisdiction; - -c) a Person from or in any jurisdiction that does not meet international AML–CTF standards; - -d) a Person that is a Government Official or Politically Exposed Person; - -e) a Person that presents a risk of any exposure to penalties, sanctions, or other liabilities under AML Laws, CTF Laws, Anti-Corruption Laws, Economic Sanctions Laws, or tax Laws that may apply; - -f) a U.S. Person; - -g) a Person that the Operator determines is acting in the United States or territory or insular possession of the United States (whether or not by, to, through, or from a U.S. Financial Institution) in violation of, causing any other Person, including, but not limited to, any of the Associates, to violate, attempting or conspiring to violate, or evading or circumventing these Terms of Service or applicable Laws; and - -h) a Person that fails to meet any user due-diligence standards, requests, or requirements of the Operator, or otherwise appears to be of high risk, including, but not limited to, any of the foregoing factors. - -**5. Risks and Limitation of Liability** - -**5.1 Risks and Limitation of Liability**. Trading in Digital Assets is volatile and markets shift quickly in terms of price, liquidity, market depth, and trading dynamics. The information presented on or through the Website is made available solely for general information purposes and the Operator does not warrant the accuracy, completeness, or usefulness of this information. You are solely responsible and liable: for any and all trading and non-trading activity on the Website and for your Digital Assets Wallet on the Website, even if presented incorrectly by the Website at any time. In the event of any conflict between the information reflected in your Digital Assets Wallet or elsewhere on the Website and information on the books and records of the Operator, the books and records of the Operator shall control, even if this results in Losses to you or increases your Losses. You acknowledge and agree: to be fully responsible and liable for your trading and non-trading actions and inactions on the Website and all gains and Losses sustained from your use of the Website and any of the Services; to be responsible for any negative balance in your Digital Assets Wallet on the Website and to be fully responsible for safeguarding access to, and any information provided through, the Website and any of the Services, including, but not limited to, Digital Assets Wallet, Digital Assets Address, private keys, usernames, passwords, and bank account details. You have no right whatsoever to claim damages, specific performance, or compensation in any form from the Operator as a result of actions it takes in its administration of the Digital Token market. There is no guarantee against Losses on the Website. - -**5.2 Limitation of Liability and Release**. The Operator assumes no liability or responsibility for and shall have no liability or responsibility for any Losses directly or indirectly arising out of or related to: - -a) these Terms of Service; - -b) the Website, and your use of it; - -c) the Services, and your use of any of them; - -d) any information or materials available through the Website, whether originating from the Operator, its Associates or any other Person; - -e) the real or perceived value of any currencies or Digital Assets traded or utilized on the Website, or the price of any Digital Token displayed on the Website at any time; - -f) any inaccurate, misleading, or incomplete statement by the Operator or on the Website regarding your Digital Assets Wallet, whether caused by the Operator’s negligence or otherwise; - -g) any failure, delay, malfunction, interruption, or decision (including, but not limited to, any decision by the Operator to vary or interfere with your rights) by the Operator in operating the Website or providing any Service; - -h) any stolen, lost, or unauthorized use of your Digital Assets Wallet information, any breach of security or data breach related to your Digital Assets Wallet information, or any criminal or other third-party act affecting the Operator or any Associate; or, - -i) any offer, representation, suggestion, statement, or claim made about the Operator, the Website, or any Service by any Associate. - -You hereby agree to release the Associates from liability for any and all Losses, and you shall indemnify and save and hold the Associates harmless from and against all Losses. The foregoing limitations of liability shall apply whether the alleged liability or Losses are based on contract, negligence, tort, unjust enrichment, strict liability, violation of law or regulation, or any other basis, even if the Associates have been advised of or should have known of the possibility of such Losses and damages, and without regard to the success or effectiveness of any other remedies. - -**5.3 No Waiver and Available Remedies:** Any failure by the Operator to exercise any of its rights, powers, or remedies under these Terms of Service, or any delay by the Operator in doing so, does not constitute a waiver of any such right, power, or remedy. The single or partial exercise of any right, power, or remedy by the Operator does not prevent either from exercising any other rights, powers, or remedies. The remedies of the Operator are cumulative with and not exclusive of any other remedy conferred by the provisions of these Terms of Service, or by law or equity. You agree that the remedies to which the Operator is entitled include, but are not limited to, (i) injunctions to prevent breaches of these Terms of Service and to enforce specifically the terms and provisions hereof, and you waive the requirement of any posting of a bond in connection with such remedies, (ii) the right to recover the amount of any Losses by set off against any amounts that the Operator would otherwise be obligated to pay to you, and (iii) the right to seize and recover against any of your Digital Assets, or your interests therein, that are held by the Operator or any of its Associates. - -5.4 **Role of the Operator**. The Operator does not generally act as principal, counterparty, or market-maker in the transactions effected through trading on the Website or using the Services. However, from time to time, the Operator may choose to do so. When the Operator is transacting on the Website or Services, its orders, trades and other transactions will be treated the same as or provided lower priority than, other user's orders, trades or other transactions. In the event a dispute arises among parities in respect of the Services, the Operator may, at its sole discretion, suspend the provision of Services to you, in whole or in part, pending resolution of the dispute. - -5.5 **No Representations and Warranties by the Operator**. The Operator makes no representations, warranties, or guarantees to you of any kind and, to the extent permitted by applicable Laws, the Operator expressly disclaims all representations, warranties or guarantees, express, implied or statutory, with respect to the Website and the Services. The Website and the Services are offered strictly on an as-is, where-is basis and, without limiting the generality of the foregoing, are offered without any representation as to merchantability or fitness for any particular purpose. - -5.6 **No Advice**. The Operator does not provide any investment, portfolio management, legal, accounting, tax or other advice, or advice on trading techniques, models, algorithms, or any other schemes. - -**6. Intellectual Property** - -6.1 **General Provisions.** The Website and Services are protected by copyright, trademark, and other intellectual property or proprietary rights laws in various jurisdictions. All rights not expressly granted to you in these Terms are reserved. - -6.2 **Marks**. The Marks are used by the Operator under license. You agree not to appropriate, copy, display, or use the Marks or other content without express, prior, written permission from the Operator or the owner of the Marks, including, but not limited to, as a domain name, as social media profile/handle, on a website, in an advertisement, as or in connection with a phone number, as or in connection with an email address, in Internet search results, in metadata or code, or in any other manner. - -6.3 **Copyrights**. Unless otherwise indicated, Copyrights on the Website are used by the Operator under license. You agree not to copy, display, or use the Copyrights or other content without express, prior, written permission from the Operator or the third-party owner; - -6.4 **Limited Licit Use**. You may link to the Website’s homepage or other pages, provided you do so in a way that is fair and legal and does not damage the Operator’s reputation or take advantage of it, but you must not establish a link in such a way as to suggest any form of association, approval, or endorsement on the Operator’s part without prior, express, written consent. - -6.5 **User Submissions**. The Website or certain Services may contain User Submissions on or through the Website. You hereby grant the Operator and its Affiliates a worldwide, perpetual, irrevocable, non-exclusive, royalty-free license (with the right to sublicense) to use, copy, reproduce, modify, publish, transmit, broadcast, display, and distribute the User Submissions in any and all media or distribution methods, whether now known or later developed. You agree that you are responsible for, indemnify and save and hold harmless the Operator and its Associates from, any User Submissions you submit or contribute, and you, not the Operator or its Associates, have full responsibility for such content, including its legality, reliability, accuracy, and appropriateness. The Operator and its Associates are not responsible, or liable to any Person, for the content or accuracy of User Submissions posted by you or other users of the Website. - -6.6 **User Feedback and Suggestions**. By sharing feedback and suggestions with the Operator or its Associates, you grant the Operator and its Associates a worldwide, perpetual, irrevocable, non-exclusive, royalty-free license to any intellectual property rights you may have in the feedback and suggestions you share with the Operator or its Associates to use, including to improve the Services, copy, reproduce, modify, publish, transmit, broadcast, display, and distribute. You agree that by submitting feedback or suggestions to the Operator or its Associates you are not entitled to any form of compensation should the Operator or its Associates consider or develop technology that is the same or similar to such feedback or suggestions. - -**7. Resolution of Disputes, Jurisdiction and Force Majeure** - -7.1 **Resolution of Disputes**. If you are a Customer, any dispute, claim, controversy or action arising out of or related to (a) the Terms of Service or the existence, breach, termination, enforcement, interpretation or validity thereof, or (b) your Digital Assets Wallet, the operations and Services of the Website, or (c) your access to or use of the Services at any time, shall be subject to the exclusive jurisdiction of the courts of the British Virgin Islands. For the avoidance of doubt, and without limiting the generality of the foregoing, this provision expressly applies to any claim, whether in tort, contract or otherwise, against the Operator. You irrevocably and unconditionally agree and consent to the jurisdiction and venue of the courts of the British Virgin Islands, and you waive any objections thereto. You and the Operator agree that any Party hereto may bring claims against the others only on an individual basis and not as a plaintiff or class member in any purported class or representative action or proceeding. No adjudicator may consolidate or join more than one Person’s or party’s claims and may not otherwise preside over any form of a consolidated, representative, or class proceeding. Any relief awarded to any one user cannot and may not affect any other users. - -7.2 **Jury Trial waiver**: to the fullest extent permitted by applicable law, the parties hereby irrevocably and unconditionally waive all right to trial by jury in any legal action or proceeding of any kind whatsoever arising out of or relating to these terms of service or any breach thereof, any use or attempted use of the site or the services by you, and/or any other matter involving the parties. - -7.3 **Governing Law**. These Terms shall be governed by and construed and enforced in accordance with the Laws of the British Virgin Islands, and shall be interpreted in all respects as a British Virgin Islands contract. Any dispute, controversy, claim or action arising from or related to your access or use of the Website or these Terms of Service likewise shall be governed by the Laws of the British Virgin Islands, exclusive of choice-of-law principles. - -7.4 **Force Majeure**. The Operator is not responsible for damages caused by delay or failure to perform undertakings under these Terms of Service when the delay or failure is due to fires; strikes; floods; power outages or failures; acts of God or the state’s enemies; acts of any Government or Government Official; any and all market movements, shifts, or volatility; computer, server, or Internet malfunctions; security breaches or cyberattacks; criminal acts; delays or defaults caused by common carriers; acts or omissions of other Persons; or, any other delays, defaults, failures or interruptions that cannot reasonably be foreseen or provided against. In the event of force majeure, the Operator is excused from any and all performance obligations under these Terms of Service. - -**8. Miscellaneous** - -8.1 **Assignment**: These Terms of Service, and any of the rights, duties, and obligations contained or incorporated herein, are not assignable by you without prior written consent of the Operator. These Terms of Service, and any of the rights, duties, and obligations contained herein, are freely assignable by the Operator without notice or your consent. Any attempt by you to assign these Terms of Service without written consent is void. - -8.2 **Severability**: If any provision of these Terms of Service or part thereof, as amended from time to time, is determined to be invalid, void, or unenforceable, in whole or in part, by any court of competent jurisdiction, such invalidity, voidness, or unenforceability attaches only to such provision to the extent of its illegality, unenforceability, invalidity, or voidness, as may be, and everything else in these Terms of Service continues in full force and effect. - -8.3 **Electronic Communications and Acceptance**: You agree and consent to receive electronically all communications, agreements, documents, receipts, notices and disclosures that the Operator may provide in connection with these Terms of Service through publication on any part of the Website or to your authorized email address on file with the Operator. - -8.4 **Reporting Suspected Violations**: If you encounter activity or materials on the Website or the Services that you believe violate these Terms of Service, please report the suspected violation via our Support Center. The Operator and its Affiliates have a process to investigate such reports and will take such action as it deems appropriate. diff --git a/docs/legacy/resources/legal/privacy-policy.md b/docs/legacy/resources/legal/privacy-policy.md deleted file mode 100644 index 46f5abe..0000000 --- a/docs/legacy/resources/legal/privacy-policy.md +++ /dev/null @@ -1,226 +0,0 @@ ---- -description: 'Last revised: Nov 19, 2022' ---- - -# 🔏 Privacy Policy - -:::info -Yellow Network is a project in development. Not all solutions presented in the following (sub)sections are implemented at this stage. The current, and all subsequent sub-pages, are subject to change. - -For more information, visit the [Roadmap](../../about/roadmap.md) -::: - -Thank you for visiting [https://www.yellow.org/](https://www.yellow.org/) (**"Website"**) - -The Website is owned and operated by Layer3 FinTech Ltd. and its affiliates (together **"Operator"**, **"we"**, **"our"**, or **"us"**). - -This Privacy Policy (**"Privacy Policy"**) sets out the basis on which any Personal Data we collect from you (**"you"** or **"your"**), or that you provide to us, will be processed. - -Please read the following carefully to understand what data we collect, how that data is used and how it can be shared by us. If you do not wish for your Personal Data to be used in the ways described within this Privacy Policy then you should not access or use the Website or use the services, functions, or features offered from time to time on the Website. - -### 1. What information do we collect? - -#### **1.1. Personal Data** - -Personal data or personal information means any information that relates to an identified or identifiable living individual. It does not include data which cannot be used to identify an individual person, such as a company registration number. A “data subject” is an individual who can be identified, directly or indirectly, by personal data. This is usually by reference to an identifier such as a name, identification number, location data, email address, an online identifier or to one or more factors specific to the physical, physiological, genetic, mental, economic, cultural or social identity of that natural person. Different pieces of information which are collected together can lead to the identification of a particular person and also constitute personal data. It does not include data where the identity has been removed and this data is no longer capable of identifying an individual (“Anonymous Data”). - -#### **1.2. Information that you provide** - -This is information about you that you give us by (i) registering for an account; (ii) using the Support Center on the Website; or (iii) corresponding with us by phone, email, or otherwise. - -#### **1.3. Information we may collect about you** - -Every time you use the Services, we may collect the following information, which may be considered to be Personal Data when combined with other information: - -
Category of Personal DataExamples of specific pieces of personal data
Identity Data
  • name
  • username or similar identifier
  • title
  • date of birth and gender
  • biometric information, including a visual image of your face
  • national identity cards
  • passports, driving licenses or other forms of identification documents
Social Identity Data
  • your group/company data
  • information on referrals related to you
  • behavioral data
  • risk assessment
  • compliance assessment
  • your user-generated content
Contact Data
  • residence details
  • home address
  • work address
  • email address and telephone numbers
  • proof of address documentation
Financial Data
  • payment details
  • Digital Assets Wallets
  • balances associated with Digital Assets Wallets
  • orders and trades associated with Digital Assets Wallets
  • source of funds and related documentation
Transactional Data
  • details about payments to and from you
  • other details of any transactions you enter into using the Services or Website
Metamask Data
  • authorization information
  • public MetaMask wallet address
Technical Data
  • internet connectivity data
  • internet protocol (IP) address
  • operator and carrier data
  • login data
  • browser type and version
  • device type, category and model
  • time zone setting and location data
  • language data
  • application version and SDK version
  • browser plug-in types and versions
  • operating system and platform
  • diagnostics data such as crash logs and any other data we collect for the purposes of measuring technical diagnostics
  • other information stored on or available regarding the devices you allow us access to when you visit the Website or use the Services
Profile Data
  • your username and password
  • your identification number as our user
  • your email associated with your accounts
  • requests by you for products or services
  • your interests, preferences and feedback
  • other information generated by you when you communicate with us, for example when you address a request to our customer support
Usage Data
  • information about how you use the Website, the Services, and other offerings made available by us, including
  • device download time
  • interaction type and time
  • event time, name and source
Marketing and Communications Data
  • your preferences in receiving marketing from us or third parties
  • your communication preferences
  • your survey responses
- -#### **1.4. Information we DO NOT collect about you** - -We do not collect any special categories of Personal Data about you (this includes details about your race or ethnicity, religious or philosophical beliefs, sexual orientation, political opinions, information about your health, and genetic and biometric data). However, you may be required to send us information relevant to establishing your identity such as photographs and copies of your government-issued identification documents. - -#### **1.5. Information we may collect from third-party sources** - -We may receive information about you from other sources, including (i) third parties that help us update, expand, and analyze our records; prevent or detect fraud; process payments; or analyze your use of our Services, and (ii) third parties with whom you choose to link with the Services through functionality we make available to you. Our Services may also include integrated content or links to content provided by third parties (such as live chat, social media content, plug-ins, and applications). Additional third parties may include our affiliated entities. - -#### **1.6. Information we collect automatically** - -The Operator’s web servers automatically log standard access information including browser type and URL requested. This information is not shared with third parties and is used only within the Operator on a need-to-know basis. The Operator reserves the right to block access for any customer accessing the Website via a proxy service intending to conceal originating identity. This includes access via the Tor anonymity network. - -#### **1.7. Cookies** - -We may use cookies to collect the information to identify user behavior and to serve content and offers based on your profile, and for the other purposes described below, to the extent legally permissible in certain jurisdictions. You can set your browser to refuse all or some browser cookies, or to alert you when websites set or access cookies. If you disable or refuse cookies, please note that some parts of the Website may become inaccessible or not function properly. - -#### **1.8. Children’s Personal Data** - -We do not knowingly request to collect personal information from any person under the age of 18. If a user submitting personal information is suspected of being younger than 18 years of age, we will require the user to close his or her account and will not allow the user to continue using our Website and/or the Services. We will also take steps to delete the information as soon as possible. Please notify us if you know of any individuals under the age of 18 using our Website and/or the Services so we can take action to prevent access to our Website and/or the Services. - -### **2. Why do we collect your information?** - -#### **2.1 Personal Data usage** - -Information you provide to us and/or we collect may be used for - -* Transaction services. We use your information to process your orders and to communicate with you about orders and Services -* Communication with you. We use your information to communicate with you in relation to us -* Complying with our Know Your Customer (“KYC”) obligations under applicable laws and regulations, and Anti-Money Laundering laws and regulations -* Provide, troubleshoot, and improve the Website and the Services. We use your information to provide functionality, analyze performance, fix errors, and improve the usability and effectiveness of the Website and the Services -* Fraud prevention and credit risks. We process information to prevent and detect fraud and abuse in order to protect the security of our users, us and others. We may also use scoring methods to assess and manage credit risks -* Improve our services. We process information to improve our services and for you to have a better user experience -* Recommendations and personalization. We use your information to recommend features and services that might be of interest to you, identify your preferences, and personalize your experience with the Website and the Services; -* Analyzing and administrating. We use your information to analyze trends, administrate the Website access and Services usage, gather information for aggregate use, systems administration, and for detecting usage patterns and troubleshooting purposes - -#### **2.2. Anonymous Data usage** - -Anonymous Data may cover patterns of usage of information and data that you provide to us, and we reserve the right to use this Anonymous Data for the purposes of improving and enhancing our Services, generating insights, for use in marketing to other users and current and potential partners, and otherwise for the purposes of our business. Provided that such Anonymous Data does not directly or indirectly identify you as an individual, this data is not considered to be Personal Data for the purpose of this Privacy Policy. - -### 3. Legal Basis for our use of your Personal Data - -#### **3.1. Legal Basis** - -We will process your Personal Data on the following grounds: - -* Performance of a contract when we provide you with access to the Website or the Services or communicate with you about them. This includes when we use your Personal Data to take and handle orders, and process payments -* To comply with our legal obligations under applicable laws and regulations, and Anti-Money Laundering laws and regulations -* Our legitimate interests and the interests of our users when, for example, we detect and prevent fraud and abuse in order to protect the security of our users, ourselves, or others -* Our legitimate interest to improve our Website and Services -* When we ask for your consent to process your personal information for a specific purpose that we communicate to you. When you consent to allow us to process your Personal Data for a specified purpose, you may withdraw your consent at any time and we will stop processing your data for that purpose. - -#### **3.2. Limitation of Personal Data usage** - -We ensure that we balance any potential impact on you and your rights before we process your Personal Data for our legitimate interests. We do not use your Personal Data for activities where our interests are overridden by the impact on you (unless we have your consent or are otherwise required or permitted to by law). You can obtain further information about how we assess our legitimate interests against any potential impact on you in respect of specific activities by contacting us. - -#### **3.3 Consent for Personal Data usage** - -Generally, we do not rely on consent as a legal basis for processing your Personal Data other than in relation to our use of cookies or when we send third-party direct marketing communications to you via email or text message. However, your consent for your Personal Data usage can be used as a legal basis for Personal Data usage by us. - -### 4. Security and confidentiality - -#### **4.1. General provisions** - -We work to protect the security of your personal information during transmission by using encryption protocols and software. We maintain physical, electronic and procedural safeguards in connection with the collection, storage and disclosure of your personal information. Our security procedures mean that we may ask you to verify your identity to protect you against unauthorized access to your account password. We recommend using a unique password for your Binance account that is not utilized for other online accounts and signing off when you finish using a shared computer. - -#### **4.2. Confidentiality** - -The Operator is committed to protecting your privacy. Internally, only people with a business need to know Personal Data, or whose duties reasonably require access to it, are granted access to customers’ Personal Data. Such individuals will only process your Personal Data on our instructions and are subject to a duty of confidentiality. - -#### **4.3. No Guarantee** - -We make every legitimate and possible effort to provide security and confidentiality of the information, but no information system can be fully secure. We cannot guarantee the absolute security of your information. Moreover, we are not responsible for the security of information you transmit to us over networks that we do not control, including the internet and wireless networks. - -### 5. Disclosures - -#### **5.1. Internal Personal Data Disclosure** - -For the purposes of Personal Data usage, you agree that we have the right to share your Personal Data with - -* Any member of our group, which means our subsidiaries, our ultimate holding company and its subsidiaries including their respective contractors, affiliates, employees or representatives -* Our service providers, to the extent necessary to supply the Services to you -* Selected third parties, including analytics and search engine providers that assist us in the improvement and optimization of the Services -* Authorities and law enforcement agencies worldwide, either when ordered to do so or on a voluntary basis if this appears reasonable and necessary to us - -#### **5.2. Personal Data Disclosure to Third Parties** - -You agree that we can also disclose your Personal Data to third parties - -* If the Operator or substantially all of its assets are acquired by a third party, in which case Personal Data held by it about its customers will be one of the transferred assets. -* If we are under a duty to disclose or share your Personal Data in order to comply with any legal obligation, in order to enforce or apply our Terms of Service and other agreements; or to protect the rights, property, or safety of us, our clients, or others. - -### 6. International Transfers - -#### **6.1. International Transfer of Personal Data** - -Personal Data and other data may therefore be exported outside of the jurisdiction in which you reside. Your Personal Data may be processed and stored in a foreign country or countries. Under those circumstances, the governments, courts, law enforcement, or regulatory agencies of that country or those countries may be able to obtain access to your Personal Data through foreign laws. You need to be aware that the privacy standards of those countries may be lower than those of the jurisdiction in which you reside. - -#### **6.2. No Guarantee** - -Unfortunately, the transmission of information via the Internet is not completely secure. While we do our utmost to protect your Personal Data, we cannot guarantee the security of your data transmitted to us over email or through the Website; any transmission is at your own risk. Once we have received your data, we will use strict procedures and security features to try to prevent unauthorized access. - -### 7. Your Privacy Rights - -#### **7.1. Access** - -You may access and verify your Personal Data held by the Operator by submitting a written request using our Support Center. - -#### **7.2. Rectification of Incomplete or Inaccurate Personal Data** - -You may request us to rectify or update any of your personal information held by us that is inaccurate. You may do this at any time by logging in to your account and updating your profile information. - -#### **7.3. Withdraw consent** - -To the extent that the processing of your personal information is based on your consent, you may withdraw your consent at any time. Your withdrawal will not affect the lawfulness of the Operator’s processing based on consent before your withdrawal. - -#### **7.4. Erasure** - -You may request to erase your Personal Data, subject to applicable law. If you close your account, we will mark your account in our database as closed but will keep certain account information, including your request to erase it, in our database for a period of time. This is necessary to deter fraud, by ensuring that persons who try to commit fraud will not be able to avoid detection simply by closing their account and opening a new account and complying with our legal obligations. However, if you close your account, your personal information will not be used by us for any further purposes, nor shared with third parties, except as necessary to prevent fraud and assist law enforcement, as required by law, or in accordance with this Privacy Policy. - -#### **7.5. Restriction of processing** - -In some jurisdictions, applicable law may give you the right to restrict or object to our processing or transferring your personal information under certain circumstances. We may continue to process your personal information if it is necessary for the **defense** of legal claims, or for any other exceptions permitted by applicable law. - -#### **7.6. Marketing communications** - -If you no longer wish to receive marketing communications from us, you can also let us know via the methods stated below. The electronic marketing communications we send to you also contain opt-out mechanisms that allow you to opt-out from receiving those communications, update your contact information or change your preferences at any time. We will honor your choice and refrain from sending you such announcements. You may also opt back in to receive those communications at any time. - -### 8. Other Websites and protecting your Personal Data - -#### **8.1. Privacy Policy Restrictions** - -This Privacy Policy and the use of your Personal Data only apply to the information you provide to us. You are cautioned that if you disclose Personal Data or personally sensitive data through the use of the Internet, such as through chat rooms, communities, or other public online forums, this information may be collected and used by other persons or companies over which the Operator has no control. Our Website and other Services may include integrated content or links to content provided by third parties (such as video materials, social media content, plug-ins and applications). Please note that the websites, applications and services of third parties (including affiliate entities, associated companies, sponsors, advertisers or other persons) will be governed by the privacy settings, policies, and/or procedures of the third party, which may differ from this Privacy Policy. This Privacy Policy does not address, and we are not responsible for or able to control, the privacy, security, or other practices of any third parties. It is your responsibility to review the privacy statements, policies, terms, and conditions of any person or company to whom you choose to link or with whom you choose to contract. The Operator is not responsible for the privacy statements, policies, terms, conditions, or other content of any Website not owned or managed by the Operator. - -#### **8.2. Your obligation to protect Personal Data** - -The Operator takes all reasonable efforts to protect and safeguard Personal Data, but there are protective measures you should take as well. Do not share your Personal Data with others unless you clearly understand the purpose of their request for it and you know with whom you are dealing. Do not keep sensitive Personal Data in your email inbox. If you are asked to assign passwords to connect you to your Personal Data, you should use a secure password and always use two-factor authentication (2FA), where available. You should change your password regularly. - -### 9. Changes to Our Privacy Policy - -#### **9.1. Amendments, Changes, or Updates** - -Any amendments, changes, or updates we make to our Privacy Policy in the future will be posted on this page and, where appropriate, notified to you by email. Please check the Privacy Policy as frequently as possible to see any updates or changes to our Privacy Policy. Your non-termination or continued access to the Website and/or use of any Services after the effective date of any amendments, changes, or updates constitutes your acceptance of this Privacy Policy, as modified by such amendments, changes, or updates. - -### 10. Contact - -#### **10.1. Support Center** - -Questions, comments and requests regarding this Privacy Policy should be addressed using our Support Center or via email: legal@layer3.foundation - -### NOTICE TO CALIFORNIA RESIDENTS - -Under California Civil Code Section 1789.3, California users are entitled to the following consumer rights notice: California residents may reach the Complaint Assistance Unit of the Division of Consumer Services of the California Department of Consumer Affairs by mail at 1625 North Market Blvd., Sacramento, CA 95834, or by telephone at (916) 445-1254 or (800) 952-5210. - -This section provides additional details about the personal information we collect about California consumers and the rights afforded to them under the California Consumer Privacy Act or “CCPA”. - -For more details about the personal information we collect from you, please see the “What information do we collect?” section above. We collect this information for the business and commercial purposes described in the “Why do we collect your information?” section above. We share this information with the categories of third parties described in the “Disclosures” section above. Company does not sell (as such term is defined in the CCPA) the personal information we collect (and will not sell it without providing a right to opt-out). - -Subject to certain limitations, the CCPA provides California consumers the right to request to know more details about the categories or specific pieces of personal information we collect (including how we use and disclose this information), to delete their personal information, to opt-out of any “sales” that may be occurring, and to not be discriminated against for exercising these rights. - -California consumers may make a request pursuant to their rights under the CCPA by contacting us at legal@layer3.foundation. Please note that you must verify your identity and request before further action is taken. As a part of this process, government identification may be required. Consistent with California law, you may designate an authorized agent to make a request on your behalf. In order to designate an authorized agent to make a request on your behalf, you must provide a valid power of attorney, the requester’s valid government-issued identification, and the authorized agent’s valid government-issued identification. - -### NOTICE TO EU DATA SUBJECTS - -**Personal Information**\ -With respect to EU data subjects, “personal information,” as used in this Privacy Policy, is equivalent to “personal data” as defined in the European Union General Data Protection Regulation (GDPR). - -**Sensitive Data**\ -Some of the information you provide us may constitute sensitive data as defined in the GDPR (also referred to as special categories of personal data), including identification of your race or ethnicity on government-issued identification documents. - -**Legal Bases for Processing**\ -We only use your personal information as permitted by law. We are required to inform you of the legal bases of our processing of your personal information, which are described in the “Legal Basis for our use of your Personal Data” section above. If you have questions about the legal bases under which we process your personal information, contact us at legal@layer3.foundation. - -**Use for New Purposes**\ -We may use your personal information for reasons not described in this Privacy Policy, where we are permitted by law to do so, and where the reason is compatible with the purpose for which we collected it. If we need to use your personal information for an unrelated purpose, we will notify you and explain the applicable legal basis for that use. If we have relied upon your consent for a particular use of your personal information, we will seek your consent for any unrelated purpose. - -**Your Rights**\ -Under the GDPR, you have certain rights regarding your personal information. Additionally to the rights mentioned in the “Your Privacy Rights” section above, you may ask us to take the following actions in relation to your personal information that we hold: - -* **Opt-out:** Stop sending you direct marketing communications which you have previously consented to receive. We may continue to send you Service-related and other non-marketing communications. -* **Access:** Provide you with information about our processing of your personal information and give you access to your personal information. -* **Correct:** Update or correct inaccuracies in your personal information. -* **Delete:** Delete your personal information. -* **Transfer:** Transfer a machine-readable copy of your personal information to you or a third party of your choice. -* **Restrict:** Restrict the processing of your personal information. -* **Object:** Object to our reliance on our legitimate interests as the basis of our processing of your personal information that impacts your rights. - -You can submit these requests by email to legal@layer3.foundation. We may request specific information from you to help us confirm your identity and process your request. Applicable law may require or permit us to decline your request. If we decline your request, we will tell you why, subject to legal restrictions. If you would like to submit a complaint about our use of your personal information or response to your requests regarding your personal information, you may contact us at legal@layer3.foundation or submit a complaint to the data protection regulator in your jurisdiction. - -**Cross-Border Data Transfer**\ -Please be aware that your personal data will be transferred to, processed, and stored in the United States. Data protection laws in the U.S. may be different from those in your country of residence. You consent to the transfer of your information, including personal information, to the U.S. as set forth in this Privacy Policy by visiting our Website or using our Services. Whenever we transfer your personal information out of the EEA to the U.S. or countries not deemed by the European Commission to provide an adequate level of personal information protection, the transfer will be based on a data transfer mechanism recognized by the European Commission as providing adequate protection for personal information. Please contact us if you want further information on the specific mechanism used by us when transferring your personal information out of the EEA. diff --git a/docs/legacy/resources/legal/usdyellow-t-and-c.md b/docs/legacy/resources/legal/usdyellow-t-and-c.md deleted file mode 100644 index 7e77405..0000000 --- a/docs/legacy/resources/legal/usdyellow-t-and-c.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -description: $YELLOW Token specific Terms and Conditions ---- - -# 🪙 $YELLOW T&C - -:::info -Yellow Network is a project in development. Not all solutions presented in the following (sub)sections are implemented at this stage. The current, and all subsequent sub-pages, are subject to change. - -For more information, visit the [Roadmap](../../about/roadmap.md) -::: - -## _**The $YELLOW token T\&C will be published one day prior to the announced public round release.**_ diff --git a/docs/legacy/resources/tokenomics.md b/docs/legacy/resources/tokenomics.md deleted file mode 100644 index 1114a13..0000000 --- a/docs/legacy/resources/tokenomics.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -description: Learn everything you need to know about our token ---- - -# 🪙 $YELLOW - -:::info -Yellow Network is a project in development. Not all solutions presented in the following (sub)sections are implemented at this state. The current, and all subsequent sub-pages, are subject to change. -::: - -* **Token Name:** YELLOW -* **Token Ticker:** $YELLOW -* **Blockchain Network:** Ethereum, Base, Arbitrum, Linea, BNB, Polygon -* **Max Supply:** 10,000,000,000 - -## **Token Utility**[**​**](https://www.yellow.org/docs/litepaper/yellow-token#token-usage) - -We are committed to giving our token simple yet effective utility right out of the gate. Over time we intend to broaden the use of $YELLOW with our partners and more. - - - -### ➤ Paying blockchain TX fees - -On the Yellow network, every participant is identified using a Yellow Smart Account (YSA), which implements ERC-4337 (Account Abstraction). When a user submits a blockchain transaction through his Yellow account, fees are paid in YELLOW tokens using a Paymaster. The YSA allows posting TX across multiple chains and supports WalletConnect. - -### ➤ Network Access - -Our token is the key to accessing Yellow Network. Brokers are required to lock $YELLOW tokens as collateral and, in turn, get the ability to open trading channels. - -Network participants must meet the lock requirements set by their counterparts, and this safety deposit can be slashed if one of the parties misses a settlement in the Time-to-settle (TTS). - -Tokens collected from the penalty are collected into the **Yellow Reserve Vault**. - -Learn more about [$YELLOW as Collateral](../../architecture/risk-management.md#network-access-collateral)\ -Learn more about [Trading Channels](../../architecture/smart-clearing-protocol.md#state-channels) - -### ➤ Clearing fees - -When two participants execute a batch settlement, both sides pay a clearing fee on the USD evaluation of the settlement size (for example, 1% on each side of $20,000 worth of assets swapped). - -This Clearing fee is also an incentive to optimize the size of batching. Clearing fees are collected and locked into the Yellow Community Vault. - -Learn more about the [Clearing Fee](../../finance/fee-structure/layer-2-clearing-fee.md) - -### ➤ Yellow Community Vault - -The Yellow Reserve Vault or (Yellow Community Vault) is our concept of a treasury to secure Yellow Network. As the network is growing so will the Reserve Vault, providing security and comfort to all participants. - -Learn more about the [Reserve Vault](../../finance/yellow-reserve-vault.md) - -## Token Distribution - -* 30% will be dedicated to ecosystem projects development (Community Fund) -* Funds from that pool will be allocated based on community proposals; 25% will be allocated for growth-hacking rewards. -* 20% will be proportionally vested to the investors over a three-year period -* 10% will be proportionally vested to the founders and team over a five-year period -* 12.5% will be allocated for Yellow Treasury and for future growth -* 2.5% will be allocated for liquidity provision. diff --git a/docs/legacy/resources/yellowpaper.md b/docs/legacy/resources/yellowpaper.md deleted file mode 100644 index f88522a..0000000 --- a/docs/legacy/resources/yellowpaper.md +++ /dev/null @@ -1,266 +0,0 @@ -# Technical Paper - Yellow Network - -## 1. Introduction to Yellow Network: Problems and Solution - -### 1.1 Problems facing the crypto industry - -As a new form of distributed ledger technology (DLT), Bitcoin has set out to decentralize the issuance of money as well as the transfer thereof through [a peer-to-peer electronic cash system](https://bitcoin.org/bitcoin.pdf)[^1]. Ensuing DLT systems like Ethereum generally referred to as [smart contract](https://ethereum.org/en/whitepaper/)[^2] or [general-purpose](https://www.oreilly.com/library/view/mastering-ethereum/9781491971932/ch01.html) blockchains,[^3] have been designed to decentralize trading and finance at large. - -While blockchain technology has reliably enabled decentralized computation, current manifestations have yet to be able to scale to match the needs of traditional finance. Decentralized computation on a base layer blockchain, although secure, must be faster and improve the scalability of crypto trading. We are faced with an inherent [scalability trilemma](https://vitalik.eth.limo/general/2021/04/07/sharding.html)[^4], as of the end of February 2023, [126](https://blockchain-comparison.com/blockchain-protocols/)[^5] layer-1 blockchain protocols have been competing and experimenting in an attempt to find a solution. - -Although we are convinced that much innovation will spring from this vibrant competition, the current blockchain environment must address three main problems. These are: - -- Market and liquidity fragmentation - -- Lack of decentralization - -- Lack of regulatory frameworks - -### 1.2 Market and Liquidity Fragmentation - -Due to the proliferation of blockchains, there has been a fragmentation of assets and liquidity across different layer-1 protocols and increasingly [layer-2 chains](https://l2beat.com/scaling/tvl/)[^6]. Their interoperability is limited, having hitherto been dependent on centralized cross-chain bridges that have emerged as a [top security risk](https://blog.chainalysis.com/reports/cross-chain-bridge-hacks-2022/)[^7] due to the many substantial hacks that have [occurred](https://twitter.com/tokenterminal/status/1582376876143968256/photo/1)[^8] since September 2020. - -Centralized crypto exchanges (CEXs) have rushed onto the scene to counteract market fragmentation. Over the last few years, [more than 200](https://coinmarketcap.com/rankings/exchanges/)[^9] CEXs have emerged worldwide. While many of them allow for the trading of digital assets across various blockchains, these CEXs remain isolated silos that trap liquidity. They all have their list of markets, which, unlike traditional finance, are neither global nor aggregated. Some exchanges even choose a set of blockchains they more closely work with, amplifying the overall market's fragmentation. - -The dominance of CEXs in crypto trading has been hailed as one of the [big ironies](https://www.coindesk.com/markets/2019/03/30/the-ultimate-irony-of-crypto-trading/)[^10] of a world that wants to achieve decentralization. Thus, decentralized crypto exchanges (DEXs) have gained in popularity and volume, at one point in time even [driving on-chain transaction volumes past](https://blog.chainalysis.com/reports/defi-dexs-web3/)[^11] that of centralized platforms. - -Although DEXs may provide many benefits over CEXs in terms of censorship resistance or accessibility, they are not yet of [sufficient quality to compete](https://www.snb.ch/n/mmr/reference/sem_2022_06_03_barbon/source/sem_2022_06_03_barbon.n.pdf)[^12] with the largest CEXs. One of their main problems is the fact that a DEX's blockchain-enabled transparency lends itself to [front-running](https://link.springer.com/chapter/10.1007/978-3-030-43725-1_13)[^13]. Also, they need more speed and have difficulty competing regarding transaction costs and price efficiency. - -DEXs, characterized by their on-chain infrastructure, are not optimized for high-frequency trading operations. Compared to their centralized counterparts, DEXs often demonstrate a pronounced lack of market depth. The constrained market-making in DEXs can be attributed to liquidity providers accounting for volatility and potential security concerns associated with decentralized protocols. As a result, these providers often commit a restricted amount of capital in alignment with their risk assessment. It's also noteworthy that DEXs face challenges in maintaining consistent liquidity in the prevailing competitive landscape. A significant portion of the capital provided is transient, aptly termed [mercenary capital](https://www.mechanism.capital/native-token-liquidity/)[^14], which is prone to migrating swiftly in pursuit of superior short-term returns from competing platforms. - -A recent analysis purports to [show](https://blog.bitfinex.com/media-releases/hodlers-put-faith-in-centralised-exchanges-as-platforms-flex-high-tech-security/)[^15] that crypto traders are more comfortable trading on CEXs given the growing threat of hacks that have materialized in the decentralized finance (DeFi) space over the course of this year. In the aftermath of the [FTX collapse](https://www.investopedia.com/what-went-wrong-with-ftx-6828447)[^16], this could be changing, as the inherent count party risk coming with CEXs could increasingly be seen as a significant disadvantage. While CEXs are striving to provide transparency by incorporating [proof of reserves](https://niccarter.info/proof-of-reserves/)[^17], in which a custodian transparently attests to the existence of on-chain reserve assets (but not liabilities), DEXs are working towards solving their [blockchain-based scalability issues](https://www.researchgate.net/publication/342639281_Scaling_Blockchains_A_Comprehensive_Survey)[^18]. - -### 1.3 Lack of decentralization and distribution - -As the current situation reveals, even though decentralization is considered the driving force within the crypto space, it is far from reality. What is referred to as "[decentralization theater](https://www.imf.org/en/Publications/fandd/issues/2022/09/Defi-promise-and-pitfalls-Fabian-Schar)[^19]" creates a risk of deception as, in many cases, DeFi protocols remain heavily centralized. - -Even with most DEXs, there is no genuinely decentralized trading. For example, some DEXs may still rely on a central entity to control the flow of buy and sell orders, which allows them to prevent users from placing orders. Others use third-party accounts to facilitate transactions, rendering them custodial in nature. Regarding their underlying technology, blockchain computing is not distributed, as all machines re-compute the same code to reach a consensus. Liquidity in DEXs is concentrated within a single chain, limiting the extent of decentralization. In stark contrast, the global shipping industry exemplifies genuine decentralization. It comprises a vast interconnected network of companies, each playing a distinct role, collectively ensuring the industry's seamless operation without central oversight. - -### 1.4 Lack of regulatory frameworks - -Undeniably, DEXs with centralized components must be subject to the regulatory standards that CEXs must follow. However, this is not the case, as specific crypto industry regulations are still missing. Consequently, this lack of regulatory frameworks leads to the fact that there is no separation of responsibilities -- mostly among CEXs. They are doing everything: Managing their security in-house, doing their custody, sometimes issuing their stablecoin, launching investment products, or acting as a launchpad. Those practices not only create a conflict of interest since CEXs act as marketplaces, market makers, liquidity providers, and custodians, but with this concentration in services, much trust ends up being placed in CEXs - the opposite of what the blockchain space is about. - -The three problems described above have ailed the crypto industry ever since, leading to inefficient processes and high costs. Running an exchange across many blockchains and markets requires costly market makers providing crucial liquidity. The more fragmented the liquidity, the higher the costs to make markets. - -DEXs lack legal protections as they do not fall under any regulatory scrutiny and oversight. CEXs do abide by some regulations. However, they remain [shadow banks](https://corporatefinanceinstitute.com/resources/cryptocurrency/shadow-banking-and-cryptocurrencies/)[^20] concerning traditional regulations. Moreover, complying with local regulations comes with high costs for a CEX, especially when applying for business in many nations. Some CEXs choose to register in a country that allows them to operate with almost any regulations, or they operate offshore and offer barely any consumer protection. The latest exposes users to the platform's goodwill and can lead to further costs once the CEX is forced to reduce or even cut user access due to non-compliance with regulations—lastly, hacks resulting from backdoors due to insufficient protocol decentralization cause costs for users and the industry. - -### 1.5 Solution for the problems - -[Yellow Network](https://www.yellow.org/)[^21] is designed to solve these problems. The decentralized model Yellow envisions is one in which businesses work together, utilizing a shared backbone for liquidity, similar to how thousands of internet service providers and network firms are interconnected and regulated in their respective countries. - -By connecting brokers and exchanges, Yellow Network acts as a blockchain-agnostic mesh network of connected nodes that aggregate liquidity cross-chain, increasing efficiency, lowering slippage, and allowing for best trades execution. To unlock high-speed trading, Yellow Network uses a layer-3 state channel infrastructure, allowing for communication and trading between brokers and exchanges in a decentralized way. In other words, Yellow Network is a broker-to-broker liquidity channel infrastructure. - -As such, Yellow Network is not based on any single blockchain but a network of different intermediate nodes powered by Yellow Network code and run by brokers and exchanges connected. This way, Yellow Network participants can do high-frequency trading among each other in a peer-to-peer way, using a smart clearing protocol to pool on-chain collateral that minimizes counterparty risks and protects broker-to-broker liabilities exchanged off-chain. - -Yellow Network's centerpiece is its state channel smart clearing protocol, which is fully decentralized. The collateral locked in a state channel is controlled by a smart contract that is ultimately controlled by the parties that have opened the state channels. Thus, no funds are ever under the control of Yellow Network, making the system non-custodial from the perspective of its participants. - -By creating a clearing and settlement system for communicating trading liabilities, updating states within state channels, and carrying out state channel challenges, Yellow Network is a combination of the [SWIFT](https://www.swift.com/about-us/discover-swift/messaging-and-standards)[^22] messaging protocol as well as an [ECN](https://www.angelone.in/knowledge-center/share-market/ecn-electronic-communication-network)[^23] direct order matching protocol. While SWIFT and ECN facilitate a broker's access to global financial markets of traditional markets, Yellow Network does the same for digital assets. Through this clear-cut setup, Yellow Network separates powers, duties, and responsibilities by mimicking one essential part of the traditional finance stack -- the clearing house. - -## 2. Yellow Network: High-level Explanation - -To grasp the intricacies of the Yellow Network protocol, one must first gain a broad overview of its components. This can be effectively achieved by distinguishing between three distinct protocol layers within the Yellow Network: - -1. Blockchain Layer Protocol: This section hosts the ClearSync, a smart clearing method. Its main job is to begin, watch over, and end state channels between trade partners. It works by putting in and taking out a security deposit. This deposit acts as shared protection when trading. Even though this deposit is on the Ethereum blockchain, partners can trade digital assets on many other blockchains. - -2. Margin call protocol: This is specific to Yellow Network. The protocol updates the collateral state in the state channels agreed between trading partners through an off-chain RPC protocol. - -3. Trading protocol: This protocol is not specific to Yellow Network and can be proprietary software. It can be FIX, Rest-JSON, Binance API, Bitfinex API, or any banking protocol. - -**[Figure: Stack Overview - Yellow Network's different layers are visualized]** - -As we can see, Yellow Network is bringing a smart clearing protocol based on state channels, combined with an off-chain RPC protocol connected to proprietary trading software. At its core, Yellow Network is simply a protocol based on smart contract technology to track trading liabilities between Yellow Network trading parties. It is designed to be flexible, simple, and agnostic--- all following the [KISS design principle](https://www.interaction-design.org/literature/article/kiss-keep-it-simple-stupid-a-design-principle)[^24]. This way, existing institutions don't need to change their systems and can use their proprietary trading, settlement, and custody protocols to adopt Yellow Network. - -## 3. How does Yellow Network work? - -### 3.1 Overlay mesh network for high-frequency trading - -As a clearing and settlement network, Yellow Network connects multiple brokers and exchanges into one shared order platform. This platform spans multiple blockchains. By sitting on top of a network of blockchains, Yellow Network brings all parties like brokers, trading firms, exchanges, and blockchains together, creating a decentralized, global trading network that gives rise to a more efficient trading infrastructure supporting high-frequency trading. - -The connection points to each blockchain are established through custodians on all the various chains -- they act as gateways, enabling Yellow Network participants to trade with one another across chains seamlessly. The brokers using Yellow Network are connected to these different custodians, and the latter maintains a direct connection to the different blockchains, as they are the ones storing the on-chain assets on behalf of brokers. Thus, through its network of custodians, Yellow Network is integrated with every connected blockchain, which allows for asset virtualization in each chain. - -End users willing to get a specific asset from any supported blockchain need to withdraw it directly from the relevant custodian integrated with the specific blockchain. Significantly, brokers automate and hide this part, the same way users can conveniently withdraw any cryptocurrency from Binance. This setup makes Yellow Network a layer-3 for fast clearing trades on top of a blockchain. It is not a blockchain itself but uses blockchain technologies at its core. - -This blockchain-agnostic layer-3 overlay mesh network of connected nodes run by brokers, exchanges, and trading firms aggregating liquidity cross-chain reduces overall market fragmentation, market depth is added, and best trade execution is made possible. Ultimately, smaller, more specialized trading venues profit from liquidity aggregation as it helps them offer better pricing and handle larger trading volumes. Also, end users can trade additional token pairings because exchanges, brokers, and trading firms are connected through one mesh network. - -### 3.2 State channels infrastructure and multi-chain support - -Yellow Network's state channel infrastructure and the multi-chain support are two different things that need to be distinguished -- yet they are both part of the overall system. Through its multi-chain support, Yellow Network is not based on a single blockchain but allows to trade, clear, and settle assets in any tokenized asset on various blockchains. Thus, Yellow Network participants can trade assets across blockchain and cryptocurrencies, DeFi tokens, NFTs, or even real-world assets (RWA) tokens. - -The state channel infrastructure makes up the backbone or nervous system of the Yellow Network and allows for the locking and unlocking of collateral in state channels integrated into the Ethereum blockchain (though the Canary test might take place on Polygon). Importantly, liabilities exchanged between state channel trading participants are not written into state channels. Only the collateral that resides within state channels is on-chain. - -Liabilities are exchanged, and settlements, including asset transfers, occur outside the state channel framework via direct transactions between custodians. To confirm a settlement, both participants in a state channel must show consensus by endorsing the updated balance sheet. This action ensures that the state channel reflects the most recent status. - -If a Yellow Network member fails to settle based on the agreed liabilities, the collateral secured in a smart contract can be claimed by the party owed. This mechanism is facilitated by the on-chain 'adjudicator' smart contract, which manages collateral according to specific protocol rules. All parties consent to utilize the state channel smart contract protocol, termed ClearSync, for dispute resolution. The collateral is represented as ERC-20 tokens on Ethereum. As a result, only Ethereum-based assets like WBTC, WETH, USDT, USDC, or DAI are used as collateral and for dispute resolution. - -### 3.3 Decentralized trading through an aggregated order book - -Yellow Network applies a multi-layered order book anatomy to facilitate decentralized trading, aggregating order books across participants into one global network. Starting from their local order book, each Yellow Network participant can synchronize their order book with the overall network, giving rise to an aggregated Yellow Network order book. - -With its network of brokers and custodians, integrated with today's wide variety of blockchains, and its state-channels-powered smart clearing protocol for collateral underwriting trading relationships, Yellow Network can allow decentralized trading. All institutions can efficiently utilize Yellow Network with their proprietary trading software, making it possible to trade digital assets and any other tokenized asset like gold, stocks, or bonds. - -Making such a decentralized trading infrastructure more accessible and reliable will encourage the development of Internet-native finance, giving rise to what is generally called the Internet of value across the entire spectrum of today's economic actors and institutions. Not only will traditional players be able to provide products and services related to the Internet of value, but such an Internet-native financial infrastructure will enable thousands of startups to tap into, utilize, and innovate. Similarly to how Amazon Web Services spawned the development of the Web 2.0 ecosystem or Google Cloud is contributing to the development of artificial intelligence. - -## 4. The technical basis of Yellow Network - -### 4.1 Why state channels? - -Enhancing blockchain scalability remains a critical advancement in the crypto realm to achieve mass adoption. The Ethereum Network handles \~15 TPS (transactions per second), considerably below the rate required to serve millions of users effectively and dependably. Still, as the most significant smart contract blockchain, Ethereum is building a scalable unified settlement and data availability layer. - -In doing this, Ethereum [has pivoted](https://members.delphidigital.io/reports/the-hitchhikers-guide-to-ethereum)[^25] to a rollup-centric roadmap. This fact is [reflected](https://www.theblock.co/data/scaling-solutions/scaling-overview/value-locked-of-ethereum-scaling-solutions)[^26] in the value locked in Ethereum scaling solutions, which are dominated by the rollup type. Nonetheless, Yellow Network operates on state channel technology because its decentralized, global trading network is optimized for low-latency and high-frequency attributes rollups cannot provide. - -In comparison to state channels, rollups are limited in what they can optimize for. For example, they are not optimized for ERC-20 transfers, in which the majority of transaction volume is in. [Rollups](https://members.delphidigital.io/reports/the-hitchhikers-guide-to-ethereum)[^27] work by moving heavy and resource-intensive smart contract computations from the main chain to a separate layer, or "rollup". This offloading reduces the load on the main chain and allows for faster processing of transactions. However, ERC20 transfers, which only involve state modifications of a balance, are not considered heavy computations. Thus, rollups do not offer any advantages in that regard. - -Furthermore, the performance of rollups is far from what state channels offer. They are not only slower but not as scalable as state channels. With state channels, one is limited by hardware and network latency regarding transaction throughput. Rollups, on the other hand, need a separate architecture for advanced verification. Also, rollups are not cross-chain, while state channels are. Last, state channels allow transactions between two or more parties without involving any third party, unlike rollups, whose transactions are [processed](https://ethereum.org/en/developers/docs/scaling/optimistic-rollups/)[^28] by an operator at present. - -The high performance, the absence of third parties, and the suitability for a wider variety of use cases, as the cross-chain aspect, are all attributes Yellow Network is maximizing for, which is why state channel technology is used as the preferred scaling solution type. - -### 4.2 What are state channels? - -The concept of state channels was [introduced](https://ieeexplore.ieee.org/document/9627997)[^29] in 2015. An off-chain scaling mechanism enables transacting parties to interact without touching the blockchain. Only the final state between them is broadcasted and settled on-chain. The most prominent peer-to-peer state channel network in action is the [Bitcoin Lightning Network](https://lightning.network/)[^30], a second-layer protocol that was [introduced](https://lightning.network/lightning-network-paper.pdf)[^31] in 2016. It is based on payment channels, which are payment-specific state channel applications. Nonetheless, the Bitcoin Lightning Network is an excellent demo of how state channels work. - -Typically, a channel can be built upon [threshold signatures](https://ieeexplore.ieee.org/document/4118696)[^32]--- often referred to as multi-signature or multisig --- and instructions for timelocks. Channel participants sign a multi-signature smart contract and lock in funds to participate. Following the lock-up of funds, any number of states can be exchanged among participants. Such states can [represent](https://arxiv.org/pdf/2204.08032.pdf)[^33] any generalized application, enabling state channels to enable many use cases. Because state exchanges happen off-chain, they allow for fast transactions and high throughput. - -In the context of trading, for example, traders can make x number of off-chain transactions between each other during the day, and by the evening, all parties involved can mutually settle trades by officially posting the final net balance between them. Every trader would get what is due to him. - -### 4.3 The Benefits of State Channels - -As a blockchain scaling solution, state channels [offer](https://docs.ethhub.io/ethereum-roadmap/layer-2-scaling/state-channels/)[^34] various benefits. Among them are: - -- State channels are ultra-fast and massively scalable - -- State channels are blockchain agnostic - -- State channels offer confidentiality - -- State channels are Web2 compatible - -Yellow Network has identified that state channels, thanks to their advantages, provide the necessary solution to address the current challenges Web2 companies are facing when wanting to interact with blockchain technology. Because of path dependency, it is unlikely that today \'s [highly developed internet infrastructure](https://www.internetlivestats.com/)[^35], [with its](https://everysecond.io/the-internet)[^36] billions of websites, millions of servers, and thousands of Web2 companies, will go through a complete overhaul to become blockchain-compatible. It is much more likely that state channels will act as a middleware solution between blockchains and legacy information systems. - -Through its state channel-based layer-3 technology, Yellow Network enables Web2 companies to have a more straightforward way to connect legacy internet infrastructure to the new Internet of value powered by blockchains. This way, smart contracts will make up a more significant part of existing web companies and become more accessible to operate for them. At the same time, thanks to Yellow Network's integrated state channels technology, these companies do not need to wait for node validation or block creation when having blockchain-based transactions processed. - -Instead, any Web2 company can easily integrate with blockchains and use them in their day-to-day business efforts. To become a peer in Yellow Network's peer-to-peer (P2P) trading platform, they must open a state channel with other participants through a Yellow Network node. - -## 5. Yellow Network's Solution explained and Architecture deep dive - -**[Figure: Virtual State Channels - Yellow Network's overlay mesh network of Yellow network nodes]** - -### 5.1 Running a Yellow Network Node - -The Yellow Network enables peer-to-peer trading by connecting its members via Yellow Network nodes. This results in an expansive trading ecosystem with numerous participants contributing to and pooling liquidity on the network. Each participant operates a high-performance Yellow Network node, vital to the platform's trading functionality. These nodes seek out other Yellow Network nodes, facilitating communication among participants. - -Furthermore, Yellow Network nodes are crucial for setting up state channels, locking collateral, and making the logic eligible for both state channel parties. A protocol like [LibP2P](https://libp2p.io/) is most likely used for communication among Yellow Network nodes. This protocol allows nodes to discover other nodes and send messages to them. As such, it is a way to connect servers in a mesh network, thereby giving rise to Yellow's peer-to-peer network. - -### 5.2 A world map of Yellow Network's Liquidity - -Yellow Network relies on an aggregated orderbook shared across network participants to facilitate decentralized trading. This shared orderbook has unlimited capacity for the participants' requests. Because the orderbook is hosted with individual participants, it resists any work interruptions. Should any network participants go down, the globally shared orderbook would still be accessible to traders on Yellow Network. - -This aggregated orderbook is established when Yellow Network participants synchronize their orderbook with the network, giving rise to the aggregated order book of Yellow Network. "Aggregated" means that Yellow Network collects and orders feeds that Yellow Network participants get from other participants and their counterparties. - -This is accomplished by utilizing LibP2P to create a peer-to-peer network among Yellow Network nodes that facilitates communication and discovery. Within LibP2P, the [publish-subscribe](https://docs.libp2p.io/concepts/pubsub/overview/)[^37] feature is utilized to relay real-time price quotes happening across the network, providing a live stream map of liquidity and prices globally. - -This information can be used as a routing table to decide the optimal node connections. Upon connecting to the network, each node subscribes to the quotes it wishes to track, for example, WBTC/USDT. It then receives price updates from all nodes in the global network and can compute a routing table based on the state channels it has already established. A Yellow network node may create additional direct or virtual channels to access attractive prices or spreads. - -**[Figure: Topic PubSub - Yellow Network provides a world map of liquidity participants can tap into]** - -So, by joining Yellow Network, every participant is provided with a world map of liquidity, showing where it is, what prices there are, and how this liquidity can be accessed most efficiently. It is similar to how [BitTorrent](https://web.cs.ucla.edu/classes/cs217/05BitTorrent.pdf)[^38] maps all files. Yellow Network does the same for trading data instead of files. Joining Yellow Network gives access to this map, making it easier to find and access liquidity. - -### 5.3 State Channels Smart Clearing Protocol: ClearSync - -At the heart of Yellow Network is its smart clearing protocol. It exists as a set of automated smart contracts that allow participants to lock and unlock collateral through state channels to protect the clearing and settlement of assets. - -This state channels protocol allows Yellow Network participants to minimize risks when exchanging trading liabilities or assets owned and owed from one participant to another. When an exchange trades with another broker, they exchange liabilities using Yellow Network's protocol, ensuring mutual consent regarding the accounting side. - -The distribution ratio within the state channels operated by participants is updated continuously (preferably every second). This way, both participants can constantly monitor the most current state within their channel, thereby preventing either participant from being defrauded. Should counterparty settlement risk become imbalanced, the trading party carrying the risk can ask the other party to provide more collateral using a margin call. - -**[Figure: Brokers can trade with one another, while Yellow Network acts as the clearing house between them]** - -Thus, Yellow Network also provides the option for unilateral collateral settlement, whereby if a broker's balance sheet is \$5,000 higher than that of his trading partner, inequalities can be rebalanced by having the trading partner with the lower balance sheet provide the necessary collateral to settle the difference and re-equalize the trading liabilities. This process would result in a partial settlement, enabling both brokers to readjust the margin of collateral and continue trading. - -Should either party not agree to rebalance or settle the liabilities, the defrauded party can refer to the latest state within the state channel and have the smart contract to release the collateral in their favor. As a result, the party that has been defrauded will get the necessary funds to cover up for what is entitled to them. The participants can use those funds to buy the assets not provided through the other party's settlement. - -One must remember that the actual trading, clearing, and settlement of assets between Yellow Network participants are not directly initiated by the state channels protocol. It is done by either broker, exchange, or trading firm, moving owed funds between one another. It means that, technically, liabilities are not written into state channels but kept in the database of the respective parties. They use a system of gossip-to-gossip communication to determine the amount of collateral required to continue their business activities and ensure that both parties and potential risks are protected. - -**[Figure: Three crucial components comprise the Yellow Network: Trading and Clearing (off-chain) and settlement (on-chain)]** - -It is only the collateral that resides within state channels. Therefore, state channels do neither know about the liabilities that are being traded nor do they know about their prices. They know the distribution ratio of the collateral provided and signed by the different state channel participants. Liabilities will be exchanged off-chain using Yellow Network's protocol, not on-chain transactions. However, the state channels smart clearing protocol Clear Sync helps accurately monitor and thus rebalance collateral positions atomically between trading partners. - -To perform actual settlement of on-chain assets, brokers will have different ways to proceed: - -- Using proper off-chain database and API infrastructure - -- Using on-chain escrow smart contract or HTLC - -If two trading partners within Yellow Network have the same custodians, the assets don't need to be moved on-chain but can be cleared by updating the mutual custodian's accounting database. This mechanism is similar to how money is moved between people who have the same bank and transfer money amongst each other. While the owner changes and accounting states are adjusted, no money is moved around. - -Using on-chain escrow smart contracts or HTLC instead allows for [atomic settlement](https://r3.com/everyday-blockchain/atomic-settlement-if-you-have-amazon-prime-you-already-understand-the-process/)[^39]. HTLCs are referred to as [Hashed TimeLock Contracts (HTLCs)](https://medium.com/hackernoon/what-are-hashed-timelock-contracts-htlcs-application-in-lightning-network-payment-channels-14437eeb9345)[^40] and are popularly used in the context of the Lightning Network. They are a smart contract that ensures that a transfer between parties, performed before an expiration time, allows these parties to carry out an atomic swap of assets without a third party. [Using an HTLC](https://www.researchgate.net/publication/358898825_Generalized_HTLC_for_Cross-Chain_Swapping_of_Multiple_Assets_with_Co-Ownerships)[^41] for the settlement process can move funds from one broker \'s custody to another on an atomic level and multiple blockchains. - -## 6. How to Participate in Yellow Network - -Participants must provide and lock Yellow Network tokens to participate in Yellow Network. To fund the collateral in a state channel, participants need to supply the collateral as stablecoins. The amount of collateral deposited into a state channel is called a [state deposit](https://eprint.iacr.org/2019/219)[^42]. Once both parties agree on the collateral amount and have deposited the stablecoins to the smart contract, funds will be locked in the adjudicator smart contract called ClearSync. This smart contract sits in between Yellow Network participants. Through the adjudicator smart contract, Yellow Network's smart clearing protocol takes care of brokers\' collateralization levels and liability risk management in real-time. - -With the funds locked by the adjudicator smart contract, the state channel is opened, and its participants can start trading. With every act of trading, the state channel receives state updates from either participant, upgrading the state channel according to the most recent trading activity. Closing a state channel is done by producing a final state transition. Closing a channel will cause an automatic settlement of all open positions and clear liabilities and lead to unlocking each participant's collateral if no dispute about the final state within the channel is in progress. - -## 7. Yellow Network Application - -As already indicated, there will be an application to run the Yellow Network node so interested parties can run it on their servers. This software will handle network-related activities like communicating liabilities, updating states within state channels, and resolving disputes. Brokers, exchanges, and trading firms can become Yellow Network participants through this gateway. They are the primary target audience that Yellow Network is trying to reach. - -While big exchanges and trading firms are welcome to join and profit from the network effects of Yellow Network, and Openware will work on onboarding big players that bring liquidity and users, smaller- and middle-tier exchanges represent ideal participants of Yellow Network. Because of increased competition and liquidity fragmentation, smaller players might be unable to keep up with the fierce competition in the mid to long run, making them ideal candidates to use Yellow Network. - -Thus, Yellow Network offers a survival solution to them by letting them team up and combine their powers with other exchanges. By uniting different exchange small- and middle-tier exchanges through Yellow Network, this network of exchanges can gain more liquidity, making them fit to compete with behemoth exchanges like Binance or Huobi. Therefore, the primary value proposition of the Yellow Network lies in offering small to mid-sized exchanges an opportunity to offer their liquidity to the network. Concurrently, they benefit from the liquidity provided by other participants in the Yellow Network, ensuring they remain competitive in the market. - -## 8. Technology Partners - -### 8.1. Openware with OpenDAX - -[Openware](https://www.openware.com/)[^43], Inc. is a United States multinational blockchain infrastructure development company headquartered in South San Francisco, California, that designs, develops, and sells computer software and online services. They focus on building secure and scalable solutions for Web3 and the Internet of finance. - -[OpenDAX](https://www.openware.com/product/opendax)[^44] is Openware's flagship product and stands for \ 'Open-Source Digital Assets Exchange\'. It is a hybrid software consisting of public and private libraries, designed to build a fully-featured exchange service to facilitate trading digital assets, cryptocurrencies, and security tokens. OpenDAX^TM^ is cloud-based, and while it comes as a plug-and-play solution that can easily be deployed, it is possible to customize the solution per one's needs. - -Through operating and selling OpenDAX^TM^, the need for Yellow Network has become apparent. The idea for starting Yellow Network came from Openware's clients who have been starting their exchange using OpenDAX^TM^. They have always been facing the issue of raising and obtaining sufficient liquidity. - -Building out Yellow Network as a built-in solution and natively supported platform for OpenDAX^TM^ users would help brokers and clients efficiently source deep pockets of liquidity, thereby solving their bootstrapping problem that has so far hampered the adoption of OpenDAX^TM^ and thus the creation of more brokers and exchanges within the crypto trading space. While the need for some primary market-making will persist, creating Yellow Network will simplify things and cut costs for brokers and smaller exchanges wanting to do business in crypto trading. - -[^1]: Nakamoto Satoshi, "Bitcoin: A Peer-to-Peer Electronic Cash System." October 2008: [bitcoin.org/bitcoin.pdf](https://bitcoin.org/bitcoin.pdf) -[^2]: Buterin Vitalik, "Ethereum White paper." November 2014: [ethereum.org/en/whitepaper/](https://ethereum.org/en/whitepaper/) -[^3]: Antonopouos Andreas, Wood Gavin, "Mastering Ethereum." O\'Reilly Media, Inc., November 2018: [oreilly.com](https://www.oreilly.com/library/view/mastering-ethereum/9781491971932/) -[^4]: Buterin Vitalik, "Why sharding is great: demystifying the technical properties." April 2021: [vitalik.eth.limo](https://vitalik.eth.limo/general/2021/04/07/sharding.html) -[^5]: Blockchain Comparison: [blockchain-comparison.com](https://blockchain-comparison.com/blockchain-protocols/) -[^6]: L2beat: [l2beat.com/scaling/tvl/](https://l2beat.com/scaling/tvl/) -[^7]: Chainalysis Team, "Vulnerabilities in Cross-chain Bridge Protocols Emerge as Top Security Risk." Chainalysis Blog, August 2022: [blog.chainalysis.com](https://blog.chainalysis.com/reports/cross-chain-bridge-hacks-2022/) -[^8]: Token Terminal, "Bridge exploits account for \~50% of all DeFi exploits, totaling \~\$2.5B in lost assets." Token Terminal Twitter, October 2022: [twitter.com/tokenterminal](https://twitter.com/tokenterminal/status/1582376876143968256) -[^9]: Coinmarketcap, "Top Cryptocurrency Spot Exchanges." Coinmarketcap Website: [coinmarketcap.com](https://coinmarketcap.com/rankings/exchanges/) -[^10]: Weisberger David, "The Ultimate Irony of Crypto Trading." Coindesk, September 2021: [coindesk.com](https://www.coindesk.com/markets/2019/03/30/the-ultimate-irony-of-crypto-trading/) -[^11]: Chainalysis Team, "DeFi-Driven Speculation Pushes Decentralized Exchanges' On-Chain Transaction Volumes Past Centralized Platforms." Chainalysis Blog, June 2022: [blog.chainalysis.com](https://blog.chainalysis.com/reports/defi-dexs-web3/) -[^12]: Barbon Andrea , Ranaldo Angelo, "On The Quality Of Cryptocurrency Markets: Centralized Versus Decentralized Exchanges." SNP Paper, April 2022: [snb.ch](https://www.snb.ch/n/mmr/reference/sem_2022_06_03_barbon/source/sem_2022_06_03_barbon.n.pdf) -[^13]: Eskandari, S., Moosavi, S., Clark, J.: SoK: Transparent Dishonesty: Front-Running Attacks on Blockchain. In: Financial Cryptography. pp. 170--189. Springer International Publishing, Cham (2020): [link.springer.com](https://link.springer.com/chapter/10.1007/978-3-030-43725-1_13) -[^14]: Wu, Eva, "The Art and Science of Native Token Liquidity" Mechanism Capital, August 2021: [mechanism.capital](https://www.mechanism.capital/native-token-liquidity/) -[^15]: Bitfinex, "Hodlers Put Faith in Centralised Exchanges as Platforms Flex High-Tech Security." Bitfinex Blog, October 2022: [blog.bitfinex.com](https://blog.bitfinex.com/media-releases/hodlers-put-faith-in-centralised-exchanges-as-platforms-flex-high-tech-security/) -[^16]: Reiff Nathan, "The Collapse of FTX: What Went Wrong with the Crypto Exchange?" Investopedia, December 2022: [investopedia.com](https://www.investopedia.com/what-went-wrong-with-ftx-6828447) -[^17]: Carter Nic, "Nic's PoR: Wall of Fame" Nic Carter Website: [niccarter.info](https://niccarter.info/proof-of-reserves/) -[^18]: Hafid, Abdelatif, Senhaji Hafid Abdelhakim, Samih Mustapha, "Scaling Blockchains: A Comprehensive Survey." IEEE Access, July 2020: [researchgate.net](https://www.researchgate.net/publication/342639281_Scaling_Blockchains_A_Comprehensive_Survey) -[^19]: Schär Fabian, "DeFi's Promise and Pitfalls." IMF, September 2022: [imf.org](https://www.imf.org/en/Publications/fandd/issues/2022/09/Defi-promise-and-pitfalls-Fabian-Schar) -[^20]: CFI Team, "What is Shadow Banking in the Cryptocurrency World?", Corporate Finance Institute, February 2023: [corporatefinanceinstitute.com](https://corporatefinanceinstitute.com/resources/cryptocurrency/shadow-banking-and-cryptocurrencies/) -[^21]: Yellow Network: [yellow.org](https://www.yellow.org/) -[^22]: Discover Swift: [swift.com](https://www.swift.com/about-us/discover-swift/messaging-and-standards) -[^23]: What is ECN: [angelone.in](https://www.angelone.in/knowledge-center/share-market/ecn-electronic-communication-network) -[^24]: Kiss Design Principle: [interaction-design.org](https://www.interaction-design.org/literature/article/kiss-keep-it-simple-stupid-a-design-principle) -[^25]: Charbonneau, Jon, "The Hitchhiker \'s Guide to Ethereum." Delphi Digital, May 2022: [members.delphidigital.io](https://members.delphidigital.io/reports/the-hitchhikers-guide-to-ethereum) -[^26]: The Block: "Value Locked in Ethereum Scaling Solutions by Type." [theblock.co](https://www.theblock.co/data/scaling-solutions/scaling-overview/value-locked-of-ethereum-scaling-solutions) -[^27]: Thibault Louis Tremblay, Sarry Tom, Hafid Abdelhakim Senhaji, "Blockchain Scaling Using Rollups: A Comprehensive Survey" IEEE Access, August 2022: [ieeexplore.ieee.org](https://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=9862815) -[^28]: Isthedoom, "Optimistic Rollups." November 2022: [ethereum.org](https://ethereum.org/en/developers/docs/scaling/optimistic-rollups/) -[^29]: Negka Lydia, Spathoulas Georgios, "Blockchain State Channels: A State of the Art." IEEE Access, November 2021: [ieeexplore.ieee.org](https://ieeexplore.ieee.org/document/9627997) -[^30]: Lightning Network: [lightning.network](https://lightning.network/) -[^31]: Poon Joseph, Dryja Thaddeus, "The Bitcoin Lightning Network: Scalable Off-Chain Instant Payments." January 2016: [lightning.network](https://lightning.network/lightning-network-paper.pdf) -[^32]: Van Der Merwe Johann, Dawoud, McDonald Stephen, "A Fully Distributed Proactively Secure Threshold-Multisignature Scheme." IEEE Access, March 2007: [ieeexplore.ieee.org](https://ieeexplore.ieee.org/document/4118696) -[^33]: Gangwal Ankit, Gangavalli Haripriya, Thirupathi Apoorva, "A Survey of Layer-Two Blockchain Protocols." Elsevier Journal of Network and Computer Applications, April 2022: [arxiv.org](https://arxiv.org/pdf/2204.08032.pdf) -[^34]: "State Channels." Docs EthHub: [docs.ethhub.io](https://docs.ethhub.io/ethereum-roadmap/layer-2-scaling/state-channels/) -[^35]: Internet Live Stats: [internetlivestats.com](https://www.internetlivestats.com/) -[^36]: The Internet -- Every Second: [everysecond.io](https://everysecond.io/the-internet) -[^37]: Docs.libp2p - What is Publish/Subscribe: [docs.libp2p.io](https://docs.libp2p.io/concepts/pubsub/overview/) -[^38]: Johnsen Jahn, Karlsen Lars, Birkeland Sebjørn, "Peer-to-peer networking with BitTorrent." Department of Telematics, December 2005: [web.cs.ucla.edu](https://web.cs.ucla.edu/classes/cs217/05BitTorrent.pdf) -[^39]: R3, "Atomic settlement: if you have Amazon Prime, you already understand the process", February 2022: [r3.com](https://r3.com/everyday-blockchain/atomic-settlement-if-you-have-amazon-prime-you-already-understand-the-process/) -[^40]: Vohra Arnav, "What Are Hashed Timelock Contracts (HTLCs)? Application In Lightning Network & Payment Channels." May 2018: [medium.com/hackernoon](https://medium.com/hackernoon/what-are-hashed-timelock-contracts-htlcs-application-in-lightning-network-payment-channels-14437eeb9345) -[^41]: Krishnasuri Narayanam, Ramakrishna Venkatraman, Dhinakaran Vinayagamurthy, Sandeep Nishad, "Generalized HTLC for Cross-Chain Swapping of Multiple Assets with Co-Ownerships." February 2022: [researchgate.net](https://www.researchgate.net/publication/358898825_Generalized_HTLC_for_Cross-Chain_Swapping_of_Multiple_Assets_with_Co-Ownerships) -[^42]: Close Tim, "Nitro Protocol" February 2019: [eprint.iacr.org](https://eprint.iacr.org/2019/219) -[^43]: Openware: [openware.com](https://www.openware.com/) -[^44]: OpenDAX: [openware.com/product/opendax](https://www.openware.com/product/opendax) diff --git a/docs/legacy/testnet/yellow-canary-testnet.md b/docs/legacy/testnet/yellow-canary-testnet.md deleted file mode 100644 index 738a8d6..0000000 --- a/docs/legacy/testnet/yellow-canary-testnet.md +++ /dev/null @@ -1,32 +0,0 @@ -# 🐤 Yellow Canary Testnet - -Yellow Canary Testnet is designed to test the innovations of Yellow Network in a real-world environment, including the latest versions of smart contracts and software components. - -Canary Network will be used for trading tangible assets like on the production Yellow Network, but with smaller transaction value. It minimizes the risk of releasing vulnerabilities while risking small amounts of money. The $DUCKIES token is the token used on the canary testnet to connect to the network and pay the fees, acting like the $YELLOW token for Yellow Network. - -Visit [Yellow Duckies](https://www.yellow.org/duckies) - -## What Yellow Canary Testnet Puts Forward - -### **Identify and address issues** - -By creating a canary network for Yellow, the team can identify and address issues in a testing environment before deploying new features and upgrades to the main network. - -### **Iterative development process** - -Canary testing is part of an iterative development process that allows developers to identify and address issues promptly and quickly. This agile process allows for continuous improvement, ensuring the network is constantly improving and evolving. - -### **Community engagement** - -The environment is built to be a highly engaging and reward-based community for developers, validators, and users who participate in testing and provide feedback. It was designed to be an environment that allows developers to test new features and upgrades in a real-world environment. - -## How to Join Yellow Canary Testnet - -* Become a [Beta Tester](https://forms.yellow.org/join_canary_testnet) if you want to be among the first to test Yellow Network's core stack. -* [**Become an Evangelist**](https://forms.yellow.org/ambassador) if you want to be the community force that spreading the word about Yellow. -* [**Become a Broker**](https://forms.yellow.org/canary_brokers) if you want to help test and grow Yellow Network and the technology behind it. - -### **Or explore other opportunities to contribute:** - -* Join the hunt for Ducklings NFTs and [**start minting your Duckies**](https://www.yellow.org/canarynet/duckies) collection to get more $DUCKIES to be used on the canary network. -* Join the [**Yellow community on Discord**](https://discord.gg/yellownetwork) to find more opportunities to contribute and keep up with the news. diff --git a/docusaurus.config.ts b/docusaurus.config.ts index 29d9d50..cb4aad0 100644 --- a/docusaurus.config.ts +++ b/docusaurus.config.ts @@ -68,19 +68,14 @@ const config: Config = { sidebarCollapsed: false, sidebarCollapsible: false, breadcrumbs: true, - // includeCurrentVersion: true, - // lastVersion: '0.5.x', - // versions: { - // current: { - // label: require('./package.json').version, - // path: 'next', - // banner: 'unreleased', - // }, - // '0.5.x': { - // label: 'v0.5.x', - // path: '', - // }, - // }, + includeCurrentVersion: true, + versions: { + current: { + label: require('./package.json').version, + path: '', // Root path (docs/) + banner: 'none', + }, + }, }, blog: false, theme: { @@ -121,27 +116,32 @@ const config: Config = { }, items: [ { - to: '/docs/learn', + type: 'doc', + docId: 'learn/index', label: 'Learn', position: 'left', }, { - to: '/docs/build/quick-start', + type: 'doc', + docId: 'build/quick-start/index', label: 'Build', position: 'left', }, { - to: '/docs/protocol/introduction', + type: 'doc', + docId: 'protocol/introduction', label: 'Protocol', position: 'left', }, { - to: '/docs/manuals', + type: 'doc', + docId: 'manuals/index', label: 'Manuals', position: 'left', }, { - to: '/docs/guides', + type: 'doc', + docId: 'guides/index', label: 'Guides', position: 'left', }, @@ -156,6 +156,11 @@ const config: Config = { className: 'header-github-link', 'aria-label': 'GitHub repository', }, + { + type: 'docsVersionDropdown', + position: 'right', + className: 'navbar-version-dropdown', + }, ], }, footer: { diff --git a/scripts/release-version.js b/scripts/release-version.js index be37515..e6730c7 100644 --- a/scripts/release-version.js +++ b/scripts/release-version.js @@ -36,10 +36,45 @@ try { pkg.version = nextDevVersion; fs.writeFileSync(packageJsonPath, JSON.stringify(pkg, null, 2)); + // 3. Automate docusaurus.config.ts update to avoid "Duplicate routes" warnings + const configPath = path.join(rootDir, 'docusaurus.config.ts'); + if (fs.existsSync(configPath)) { + let configContent = fs.readFileSync(configPath, 'utf8'); + + // We want to insert the new version config BEFORE the closing brace of the versions object. + // Look for the 'current' block's closing brace, then comma, then insert. + // Or simpler: Look for "current: {" block, find its closing "},", and append after it. + + // This snippet formats the entry for the frozen version + const newVersionEntry = ` + '${versionToFreeze}': { + label: '${versionToFreeze}', + path: '${versionToFreeze}', + banner: 'none', + },`; + + // Regex to find the end of the 'current' block inside 'versions' + // Pattern: inside versions { ... current: { ... }, } + // We look for the closing brace of 'current' followed by comma + const currentVersionEndRegex = /(current:\s*{[\s\S]*?},)/; + + if (currentVersionEndRegex.test(configContent)) { + // Check if already exists to avoid duplication + if (!configContent.includes(`'${versionToFreeze}': {`)) { + const newContent = configContent.replace(currentVersionEndRegex, `$1${newVersionEntry}`); + fs.writeFileSync(configPath, newContent, 'utf8'); + console.log(`Updated docusaurus.config.ts: Added configuration for version '${versionToFreeze}'.`); + } + } else { + console.warn('Warning: Could not auto-update docusaurus.config.ts. Please verify versions config.'); + } + } + console.log('---------------------------------------------------'); console.log(`Release Complete!`); console.log(`- Frozen Version: ${versionToFreeze} (saved in versioned_docs/)`); console.log(`- Created Next Version: ${nextDevVersion} (active in docs/)`); + console.log(`- Configuration: Auto-updated docusaurus.config.ts`); } catch (error) { console.error('Release failed:', error.message); diff --git a/scripts/reset-versions.js b/scripts/reset-versions.js index 0e21678..22bb000 100644 --- a/scripts/reset-versions.js +++ b/scripts/reset-versions.js @@ -42,9 +42,38 @@ if (fs.existsSync(packageJsonPath)) { console.log(`Updated package.json version to ${targetVersion}`); } +// Helper to update docusaurus.config.ts +const configPath = path.join(rootDir, 'docusaurus.config.ts'); +if (fs.existsSync(configPath)) { + try { + let configContent = fs.readFileSync(configPath, 'utf8'); + + // Regex to match the versions object and replace it with the single-version default + // Matches "versions: { ... }" including nested braces for current version + // This regex assumes standard formatting as seen in the file + const versionsRegex = /versions:\s*{[\s\S]*?},\s*},/m; + + const cleanVersionsBlock = `versions: { + current: { + label: require('./package.json').version, + path: '', // Root path (docs/) + banner: 'none', + }, + },`; + + if (versionsRegex.test(configContent)) { + const newContent = configContent.replace(versionsRegex, cleanVersionsBlock); + fs.writeFileSync(configPath, newContent, 'utf8'); + console.log(`Updated docusaurus.config.ts: Reset "versions" configuration.`); + } else { + console.warn('Warning: Could not auto-update docusaurus.config.ts (regex match failed). Please check manually.'); + } + } catch (err) { + console.warn(`Warning: Failed to update docusaurus.config.ts: ${err.message}`); + } +} + console.log('---------------------------------------------------'); console.log(`Reset Complete. The project is now single-version: ${targetVersion}`); -console.log('The "Next" version in the dropdown will now show this version.'); -console.log(''); -console.log('IMPORTANT: You must manually update docusaurus.config.ts to disable default versioning'); -console.log('configuration (comment out "lastVersion", "versions", etc.) until you serve a new version.'); +console.log(`The "Next" version in the dropdown will now show this version.`); +console.log(`docusaurus.config.ts has been automatically updated.`); diff --git a/sidebars.ts b/sidebars.ts index 644ab70..3c59742 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -113,14 +113,6 @@ const sidebars: SidebarsConfig = { }, ], - // Legacy section sidebar - legacySidebar: [ - { - type: 'autogenerated', - dirName: 'legacy', - }, - ], - // Default sidebar for standalone pages defaultSidebar: [ ], diff --git a/src/css/custom.css b/src/css/custom.css index bca37e0..b4556df 100644 --- a/src/css/custom.css +++ b/src/css/custom.css @@ -107,19 +107,19 @@ a.menu__link--active { /* Remove hover effects for menu items and add text darkening */ .menu__list-item:hover, -.menu__list-item:hover > .menu__link { +.menu__list-item:hover>.menu__link { background: transparent !important; background-color: transparent !important; } -.menu__list-item:hover > .menu__link { +.menu__list-item:hover>.menu__link { color: #333333 !important; } /* Dark mode hover text */ [data-theme='dark'] .theme-doc-sidebar-item-link:hover, [data-theme='dark'] .menu__link:hover, -[data-theme='dark'] .menu__list-item:hover > .menu__link { +[data-theme='dark'] .menu__list-item:hover>.menu__link { color: #cccccc !important; } @@ -281,7 +281,7 @@ a.table-of-contents__link.table-of-contents__link--active code { margin-bottom: 8px; } -.theme-doc-sidebar-item-category > .theme-doc-sidebar-item-link { +.theme-doc-sidebar-item-category>.theme-doc-sidebar-item-link { font-weight: 600; padding: 8px 0; } @@ -297,8 +297,8 @@ a.table-of-contents__link.table-of-contents__link--active code { .theme-doc-sidebar-item-category:hover, .menu__list-item--collapsed:hover, .menu__list-item--collapsible:hover, -.menu__list-item--collapsed:hover > .menu__link, -.menu__list-item--collapsible:hover > .menu__link { +.menu__list-item--collapsed:hover>.menu__link, +.menu__list-item--collapsible:hover>.menu__link { background: transparent !important; background-color: transparent !important; color: #333333 !important; @@ -307,8 +307,8 @@ a.table-of-contents__link.table-of-contents__link--active code { /* Dark mode category hover */ [data-theme='dark'] .theme-doc-sidebar-item-category .theme-doc-sidebar-item-link:hover, [data-theme='dark'] .theme-doc-sidebar-item-category .menu__link:hover, -[data-theme='dark'] .menu__list-item--collapsed:hover > .menu__link, -[data-theme='dark'] .menu__list-item--collapsible:hover > .menu__link { +[data-theme='dark'] .menu__list-item--collapsed:hover>.menu__link, +[data-theme='dark'] .menu__list-item--collapsible:hover>.menu__link { color: #cccccc !important; } @@ -369,7 +369,7 @@ a.menu__link.menu__link--sublist.menu__link--active:hover { /* Move expand/collapse icon to the left side of text */ .menu__link--sublist, -.menu__list-item-collapsible > .menu__link { +.menu__list-item-collapsible>.menu__link { display: flex !important; flex-direction: row !important; align-items: center !important; @@ -390,7 +390,7 @@ a.menu__link.menu__link--sublist.menu__link--active:hover { /* Add arrow icon before sidebar items with subitems */ .menu__link--sublist::before, -.menu__list-item-collapsible > .menu__link::before { +.menu__list-item-collapsible>.menu__link::before { content: '>' !important; margin-right: 8px !important; font-size: 24px !important; @@ -410,19 +410,19 @@ a.menu__link.menu__link--sublist.menu__link--active:hover { /* Rotate arrow when expanded */ .menu__link--sublist[aria-expanded="true"]::before, -.menu__list-item-collapsible:not(.menu__list-item--collapsed) > .menu__link::before { +.menu__list-item-collapsible:not(.menu__list-item--collapsed)>.menu__link::before { transform: rotate(90deg) !important; } /* Dark mode arrow color */ [data-theme='dark'] .menu__link--sublist::before, -[data-theme='dark'] .menu__list-item-collapsible > .menu__link::before { +[data-theme='dark'] .menu__list-item-collapsible>.menu__link::before { color: #a0a0a0 !important; } /* Category title when expanded */ -.theme-doc-sidebar-item-category-level-1 > .theme-doc-sidebar-item-link { +.theme-doc-sidebar-item-category-level-1>.theme-doc-sidebar-item-link { padding: 10px 0; font-size: 1rem; font-weight: 700; @@ -763,8 +763,8 @@ input[type="search"]::placeholder, [class*="search"] path, .navbar button svg, .navbar button path, -input[type="search"] ~ svg, -input[type="search"] ~ svg path, +input[type="search"]~svg, +input[type="search"]~svg path, button[title*="Search"] svg, button[title*="Search"] path, .navbar__item svg, @@ -785,8 +785,8 @@ button[title*="Search"] path, [data-theme='dark'] [class*="search"] path, [data-theme='dark'] .navbar button svg, [data-theme='dark'] .navbar button path, -[data-theme='dark'] input[type="search"] ~ svg, -[data-theme='dark'] input[type="search"] ~ svg path, +[data-theme='dark'] input[type="search"]~svg, +[data-theme='dark'] input[type="search"]~svg path, [data-theme='dark'] button[title*="Search"] svg, [data-theme='dark'] button[title*="Search"] path, [data-theme='dark'] .navbar__item svg, @@ -975,8 +975,8 @@ span, } /* Code blocks font styling */ -pre[class*="language-"] *, -.prism-code *, +pre[class*="language-"] *, +.prism-code *, [class*="codeBlock"] *, code { font-family: 'Menlo', Monaco, 'Courier New', monospace !important; @@ -1049,7 +1049,7 @@ pre.codeBlock_bY9V[style*="background-color"], } /* Code block with title adjustments */ -.theme-code-block .codeBlockTitle + .codeBlockContent .prism-code { +.theme-code-block .codeBlockTitle+.codeBlockContent .prism-code { border-radius: 0 0 8px 8px !important; margin-top: 0 !important; } @@ -1065,7 +1065,8 @@ pre.codeBlock_bY9V[style*="background-color"], border-right: none !important; margin-right: 1.5em !important; padding-right: 1em !important; - font-size: 0.72em !important; /* 20% smaller: 0.9em * 0.8 = 0.72em */ + font-size: 0.72em !important; + /* 20% smaller: 0.9em * 0.8 = 0.72em */ background: #FFFFFF !important; background-color: #FFFFFF !important; } @@ -1162,4 +1163,103 @@ pre.codeBlock_bY9V[style*="background-color"], [data-theme="dark"] .git-diff-add { background-color: rgba(26, 255, 0, 0.15); border-left: 3px solid rgba(26, 255, 0, 0.6); +} + +/* Version Switcher Styles */ +.navbar-version-dropdown { + margin-right: 0.5rem; +} + +.navbar-version-dropdown>a.navbar__link { + display: flex !important; + align-items: center; + height: 32px; + padding: 0 12px !important; + border-radius: 4px; + font-weight: 500; + transition: all 0.2s ease; +} + +/* Light Mode */ +[data-theme='light'] .navbar-version-dropdown>a.navbar__link { + background-color: #FFF9E6 !important; + /* Light yellow/beige from screenshot */ + color: #0d0d0d !important; +} + +[data-theme='light'] .navbar-version-dropdown>a.navbar__link:hover { + background-color: #FDF2C8 !important; + color: #0d0d0d !important; +} + +/* Dark Mode */ +[data-theme='dark'] .navbar-version-dropdown>a.navbar__link { + background-color: #383125 !important; + /* Dark brown from screenshot */ + color: #E6E6E6 !important; +} + +[data-theme='dark'] .navbar-version-dropdown>a.navbar__link:hover { + background-color: #4A4031 !important; + color: #E6E6E6 !important; +} + +/* Chevron/Icon adjustment */ +.navbar-version-dropdown>a.navbar__link::after { + margin-left: 6px; + border-color: currentColor transparent transparent transparent; +} + +/* Mobile Sidebar Tweaks */ +/* Hide duplicate items in the mobile menu list (they are now in the header) */ +.navbar-sidebar__items .header-github-link, +.navbar-sidebar__items .menu__list-item:has(.navbar-version-dropdown), +.navbar-sidebar__items .navbar-version-dropdown { + display: none !important; +} + +/* Ensure header items have correct spacing */ +.navbar-sidebar__brand .header-github-link { + margin-right: 8px !important; +} + +.navbar-sidebar__brand .navbar-version-dropdown { + margin-right: 4px !important; +} + +.navbar-sidebar__brand .clean-btn.navbar-sidebar__close { + margin-left: 12px; +} + +/* Redefine brand header to support multi-row layout */ +.navbar-sidebar__brand { + flex-direction: column !important; + height: auto !important; + padding: 0 !important; + /* Remove padding from container to let rows handle it */ + align-items: flex-start !important; + box-shadow: none !important; + /* Remove default shadow */ +} + +/* Add shadow to the top row (Logo + Close) */ +.navbar-sidebar__brand-row-main { + padding: 16px 17px; + box-shadow: 0 1px 2px 0 rgba(0, 0, 0, 0.1); + margin-bottom: 16px; + /* Space between line and tools */ +} + +.navbar-sidebar__tools-row { + padding: 0 17px 16px; +} + +/* Force navbar items (like version dropdown) to be visible in mobile header */ +.navbar-sidebar__brand .navbar__item, +.navbar-sidebar__tools-row .navbar__item { + display: flex !important; +} + +.navbar-sidebar__tools-row .header-github-link { + margin-right: 12px; } \ No newline at end of file diff --git a/src/theme/DocSidebar/index.tsx b/src/theme/DocSidebar/index.tsx deleted file mode 100644 index 1caeed6..0000000 --- a/src/theme/DocSidebar/index.tsx +++ /dev/null @@ -1,91 +0,0 @@ -import React, { type ReactNode } from 'react'; -import OriginalSidebar from '@theme-original/DocSidebar'; -import { useVersions, useActiveVersion } from '@docusaurus/plugin-content-docs/client'; -import useDocusaurusContext from '@docusaurus/useDocusaurusContext'; -// @ts-ignore - CSS modules are not typed by default in docusaurus setup without extra config -import styles from './styles.module.css'; -import type { PropSidebar } from '@docusaurus/plugin-content-docs'; - -type Props = { - path: string; - sidebar: PropSidebar; - onCollapse: () => void; - isHidden: boolean; - [key: string]: any; -}; - -function VersionSwitcher() { - const { siteConfig } = useDocusaurusContext(); - const versions = useVersions(); - const activeVersion = useActiveVersion(); - const currentVersionLabel = (siteConfig.customFields?.packageVersion as string) || 'Next'; - - return ( -
- - - - - - -
- ); -} - -export default function DocSidebarWrapper(props: Props): ReactNode { - return ( - <> - - - - ); -} \ No newline at end of file diff --git a/src/theme/DocSidebar/styles.module.css b/src/theme/DocSidebar/styles.module.css deleted file mode 100644 index 642a884..0000000 --- a/src/theme/DocSidebar/styles.module.css +++ /dev/null @@ -1,47 +0,0 @@ -.versionSwitcher { - display: flex; - align-items: center; - gap: 8px; - padding: 12px 16px; - border-bottom: 1px solid var(--ifm-color-emphasis-200); - margin-bottom: 8px; - /* Fix for overlapping with fixed Navbar */ - margin-top: calc(var(--ifm-navbar-height) + 1rem); - background-color: var(--ifm-background-surface-color); - z-index: 100; - position: relative; -} - -.githubLink { - display: flex; - align-items: center; - color: var(--ifm-color-emphasis-700); - transition: color 0.2s; -} - -.githubLink:hover { - color: var(--ifm-color-primary); -} - -.versionSelect { - background: transparent; - border: none; - font-size: 14px; - font-weight: 500; - cursor: pointer; - padding: 4px 8px; - color: var(--ifm-font-color-base); - /* appearance: none; Was hiding the arrow. Removing it to show default browser arrow for now. */ -} - -/* Custom dropdown arrow styling to match wireframe "v0.53 ▼" */ -.versionDropdown { - position: relative; - display: inline-flex; - align-items: center; - cursor: pointer; -} - -.versionSelect:focus { - outline: none; -} \ No newline at end of file diff --git a/src/theme/Navbar/MobileSidebar/Header/index.tsx b/src/theme/Navbar/MobileSidebar/Header/index.tsx new file mode 100644 index 0000000..e5040d5 --- /dev/null +++ b/src/theme/Navbar/MobileSidebar/Header/index.tsx @@ -0,0 +1,66 @@ +import React, {type ReactNode} from 'react'; +import {useNavbarMobileSidebar} from '@docusaurus/theme-common/internal'; +import {translate} from '@docusaurus/Translate'; +import NavbarColorModeToggle from '@theme/Navbar/ColorModeToggle'; +import IconClose from '@theme/Icon/Close'; +import NavbarLogo from '@theme/Navbar/Logo'; +import DocsVersionDropdownNavbarItem from '@theme/NavbarItem/DocsVersionDropdownNavbarItem'; + +function CloseButton() { + const mobileSidebar = useNavbarMobileSidebar(); + return ( + + ); +} + +function GitHubLink() { + return ( + + ); +} + +export default function NavbarMobileSidebarHeader(): ReactNode { + return ( +
+
+ + +
+
+
+ +
+ +
+
+ +
+
+ ); +}