#483 Upload StreamSwap Contract

Description Description

This proposal, upon acceptance, will upload the StreamSwap contract to the Osmosis Zone blockchain.

Abstract

StreamSwap is a protocol for time-based token swaps. In simple words, in an AMM pool, token swaps happen instantly. With StreamSwap, tokens are streamed and swapped over a fixed period of time.

Mechanism (short overview)

StreamSwap swaps require users to create Streams and lock a fixed number of tokens (T1) and swap them for an accepted token (T2) over a fixed-period of time (t)

T1 is added by the Streamer (stream creator) and can NOT be added or removed at any point in time until the end of the Streaming Phase (t)

T2 is the token that subscribers can add or remove at any point in time

Bootstrapping Phase — The duration from the stream creation until stream start time is the Bootstrapping Phase. This is when subscribers can use T2 to subscribe. During this phase, no swapping happens.

Streaming Phase — The duration from the stream start time to the stream end time is the stream duration (t) during which streaming starts & tokens are swapped.

T1 is streamed to subscribers that subscribed with T2. T2 is streamed to the user the locked T1. Both tokens can be redeemed only at the end of the stream.

The swaps do NOT happen instantly and take place linearly over the duration of the entire stream.

A constant number of T1 are streamed as they are locked and T2 are streamed based on the total time remaining and total unspent T2 tokens

At the end of the Streaming Phase, subscribers can redeem T1 based on their total contribution of T2 and the time at which they subscribed to the stream.

Price Discovery — The final price of locked T1 is determined by the total T2 received by the end of the stream.

Mechanism (in detail)

The mechanism enables communities/DAOs/builders to swap tokens at any stage of a project’s lifecycle — before, during or after the token launch. Of the many use cases, the first use case being explored and focused on is the StreamSwap Protocol for community-driven token launches.

1. About

StreamSwap is the protocol for time-based token swaps on Osmosis. It is developed using CosmWasm smart contracts and will be going through the governance process similar to other smart contract deployments on Osmosis Zone.

The protocol is built for token swaps and StreamSwap is being utilized initially for community-driven token launches as it enables fair price discovery for the token being streamed.

2. Stream Creation

DAOs/Communities/Users can create Streams by:

locking tokens to stream out (say, FLIX)

setting a token to stream in (say, OSMO)

setting the stream start time and stream end time

3. Phases of a stream

Streams have two phases:

Bootstrapping Phase

Streaming Phase

4. Deposits and Withdrawals Tokens being streamed out (FLIX in this case), are locked during the stream and can NOT be added or removed until the end of the stream.

After the stream ends, subscribers can redeem the token being streamed out (FLIX) based on the shares that they receive for the token streamed in

Tokens being streamed in (OSMO in this case), can be deposited or withdrawn at any point in time during the stream, giving subscribers the freedom to exit as they see fit.

5. Phase 1 — Bootstrapping Phase Bootstrapping Phase is the period from the “stream creation” time to the “stream start” time.

Subscribers can subscribe to the stream by depositing tokens being streamed in (OSMO) and receive shares proportionately. No swaps occur during this phase as the streaming does not start.

6. Phase 2 — Streaming Phase In the Streaming phase, tokens start getting swapped and are streamed at each other.

Tokens being streamed out (FLIX) and tokens being streamed in (OSMO) are swapped over the duration of the stream.

During the Streaming Phase, tokens being streamed in (OSMO) are spent when they are swapped. Spent tokens can not be withdrawn but unspent tokens can be withdrawn.

7. Price Discovery The final price of the tokens being streamed out (FLIX in this case) is determined by the total tokens streamed in (OSMO) during the Streaming Phase; enabling fair and transparent community-driven price discovery.

8. Token Distribution Once the Streaming Phase ends, subscribers can redeem the tokens streamed out (FLIX) while the tokens that were streamed in (OSMO) are transferred to the stream creator's treasury (as configured during the Stream creation).

9. Advantages when compared to the LBPv1 Capital Efficiency — No collateral token required

Participation Protection — No tokens are released/delivered before the Streaming Phase ends and hence, there is no way for folks to dump their tokens while the streaming happens (which is a major difference when compared to LBPs)

MEV — MEV will not affect participation, as tokens swaps do NOT happen instantly

Can’t time your participation right? DCA into a stream by subscribing to it right in the Bootstrapping Phase.

10. URLs App URL — Access the app under user research on beta.StreamSwap.io

Twitter — https://twitter.com/StreamSwap_io

Telegram — https://t.me/StreamSwap_io

11. Related URLs Codebase on GitHub - https://github.com/StreamSwapProtocol

Audit Report by Oak Security (linked here)

Commonwealth Proposal

Git Commit Hash

4e8e096bb2718c11a4144465925a056c9e87e053

GitHub URL

https://github.com/StreamSwapProtocol/cw-streamswap

Version of compiler used

cosmwasm/rust-optimizer:0.12.13

Checksum

54438e8d02610b16eef3241af03da67c7040caf025183d86fcd10660a0a611b0

Can't get enough?

OmniFlix is the first project launching via StreamSwap and there are more in the pipeline. If you are keen on using StreamSwap for your token launch you can reach out to us on Twitter or Telegram