# Overview

### What is StableLayer?

**StableLayer** is a **stablecoin‑as‑a‑service** infrastructure for Web3 teams. Inside your product, you can launch a **branded stablecoin (BrandUSD)** while routing the underlying **USDC** into the **USDC Yield Aggregator** to generate real yield. **All baseline yield accrues to the partner** and can be claimed from the **Admin Page** at any time to fund incentives, operations, or buybacks—turning capital inflows into a sustainable growth engine.

<figure><img src="https://1270916223-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvEiuSAUDIQTtYQn3D8B8%2Fuploads%2FkpIOJtInQMrNUrc09p0a%2Fimage.png?alt=media&amp;token=78cd8458-6502-4226-ba6f-b04274a4569f" alt="" width="563"><figcaption></figcaption></figure>

#### Why StableLayer

**Challenges**

* **Unstable and undiversified revenue**: over‑reliance on a single or purely endogenous incentive loop can spiral during market drawdowns—risking a **death spiral**.
* **Low capital efficiency**: stablecoins sitting in treasuries or user‑deposit contracts remain idle, incurring large opportunity costs.

**Solutions**

* **Bring in external yield sources**: StableLayer pipes assets into carefully selected external stablecoin yield channels (v1: **Bucket Savings Pool** with **auto‑compound**) to **stabilize and diversify** protocol revenue.
* **Keep user flows unchanged; strengthen protocol cash flow**: Users still interact with a stablecoin (BrandUSD) in your product, while the protocol captures a **new, independent cash flow** owned by you.

#### Who is this for

**Any product that can create a stablecoin use case** — including but not limited to games, perpetual DEXs, yield aggregators, derivatives, and other DeFi projects.

#### Architecture

<figure><img src="https://1270916223-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvEiuSAUDIQTtYQn3D8B8%2Fuploads%2FoVUZyx4QP5NDQ33ZAqPJ%2Ftelegram-cloud-document-5-6116010236680608759.jpg?alt=media&amp;token=4f2a01cd-b609-401a-9d4b-471ac74a1856" alt=""><figcaption></figcaption></figure>


# Core Concepts

#### BrandUSD (Partner-launched branded stablecoin)

* **Mint**: anyone can mint **BrandUSD** with **USDC**.
* **Burn**: anyone can burn **BrandUSD** to redeem **USDC**.
* **Specs**: **name / symbol / decimals are fully customizable**.
* **Redeemability:** **1 BrandUSD = 1 USDC** **Instantly**.

#### USDC Yield Aggregator

* **v1 source**: **Bucket Protocol Savings Pool**.
* **Extensibility**: more flexible stablecoin yield channels will be added over time(Coming soon).
* **Behavior**: **auto‑compounds** baseline yield to maximize long‑term value.

<figure><img src="https://1270916223-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvEiuSAUDIQTtYQn3D8B8%2Fuploads%2FEbp8M1cujmGe3sGo4YBK%2FCleanShot%202025-11-24%20at%2016.21.31%402x.png?alt=media&amp;token=e0dd32cc-172c-4410-afe6-f185f2b1c7f5" alt="" width="375"><figcaption></figcaption></figure>

#### Revenue Capture

* **Ownership**: **100% of baseline yield belongs to the partner**. You decide how to deploy it for growth (incentives, buybacks, operations...).
* **Claim**: yield **accrues continuously** and is **claimable at any time** from the **Admin Page** to an address you specify.
* **Performance fee**: StableLayer may charge a performance fee on aggregator yield; **intro period = 0%**.

#### Redeem

<table><thead><tr><th width="122.875">Channel</th><th width="144.43359375">Fee</th><th width="122.67578125">Settlement</th><th>Limits</th></tr></thead><tbody><tr><td><strong>Instant Redeem</strong></td><td><strong>Redeem fee (configurable)</strong></td><td>Immediate</td><td><strong>Daily redeem cap (configurable)</strong>; once reached, pauses until the next day</td></tr></tbody></table>


# Fees & Revenue

### Fees

* **Mint fee**: **0%**
* **Redeem fee (Instant)**: **charged** (configurable) with **daily cap** (configurable).
* **Performance fee**: StableLayer charges on aggregator yield, **intro promo = 0%**.
* **Other fees**: none.

### Revenue

* **Ownership**: **100% to partner**.
* **Usage**: you **freely deploy** it to grow your product (incentives, buybacks, operations, etc.).
* **Claim**: **any time** via **Admin Page** to your chosen address.


# Integration Guide

### Integration steps

1. **Apply** (Contact us): share product info and intended use case.
2. **Configure**:
   * Token specs: **name / symbol / decimals** (all customizable)
   * Redeem settings: **Instant**
   * Revenue recipient: address you provide (e.g., treasury/admin)
3. **Deploy BrandUSD (Sui)**: deployed by StableLayer.
4. **Integrate in product**:
   * **Mint**: USDC → BrandUSD (place entry points)
   * **Redeem**: BrandUSD → USDC
   * **Build BrandUSD use cases** (core)
5. **Go live**

### Admin Page

* **BrandUSD Dashboard**: Total Minted, Outstanding Supply, daily mint/redeem volumes...
* **Earnings Dashboard**: **Total earned, Unclaimed rewards, APY**.
* **Actions**: **Claim Revenue**.


# Integrated & Potential Playbooks

### Integrated (live) examples

<details>

<summary>Success Story: How DoubleUP Created a Value Flywheel</summary>

<figure><img src="https://1270916223-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvEiuSAUDIQTtYQn3D8B8%2Fuploads%2FgbAv7HEg6BsrlZDVkjfn%2FCleanShot%202025-11-12%20at%2017.26.48%402x.png?alt=media&amp;token=cba3977b-2e3b-4212-a24a-105d85085297" alt=""><figcaption></figcaption></figure>

#### Overview

[DoubleUP](https://www.doubleup.fun/), a major casino platform on Sui, is one of our premier launch partners. By issuing their branded stablecoin, `$upUSD`, they have elevated their platform's user experience and revenue model.

#### Use Case

* Users can play games with `$upUSD`
* Users can stake upUSD in the ["Unihouse"](https://www.doubleup.fun/unihouse/gUPUSD) pool to become part of the house, sharing in the casino's profits.
* User can hold upUSD to join the [“Lossless Lottery“](https://www.doubleup.fun/lossless-lottery)

#### Impressive Results

* Total Minted: Over 1,000,000 `$upUSD` were minted in just the first 2 months.
* Additional Revenue: The platform has already earned $18,000 in real, passive income in 2 months and is projected to generate over $150,000 in additional annual cash flow for the DoubleUP team.

#### The Flywheel Effect

DoubleUP uses this extra revenue to fund the development of new games and host marketing campaigns or even use it to buyback $UP token, successfully attracting new users and further driving demand for $upUSD in a virtuous cycle.<br>

</details>

### Potential Playbooks

**GameFi — gameUSD**

* **Positioning**: in‑game medium of exchange; optionally launch **gameUSD staking pools** to unlock player benefits (e.g., **stake to play / stake to earn** cosmetics).
* **Value**: players can obtain items **without spending real cash**, while the project **earns baseline yield** to fund content and operations.

**Strategy Vault / Yield Aggregator — stratUSD**

* **Positioning**: the vault **accepts USDC deposits and mints stratUSD**; **on top of the baseline yield that StableLayer provides to the vault**, it executes **advanced strategies**.
* **Value**: unlocks **higher total APY** while preserving principal stability at the base layer.

**Perpetual DEX — PerpUSD**

* **Positioning**: PerpUSD as margin collateral; idle collateral earns baseline yield.
* **Value**: a **second revenue line** (beyond trading fees) to fund insurance pools or programmatic incentives.
* **Implementation**: expose **USDC → PerpUSD** mint within open/adjust‑margin flows.


# Technical Resources

#### Audit <a href="#audit" id="audit"></a>

* [StableLayer audit report](https://github.com/StableLayer/stable-layer-audit/blob/main/Stable%20layer%20Smart%20Contract%20Audit%20Report%20-%20Final%20Report.pdf)

***

#### Contract Address <a href="#contract-address" id="contract-address"></a>

**Mainnet**

* Package ID

  `0x41e25d09e20cf3bc43fe321e51ef178fac419ae47b783a7161982158fc9f17d6`
* StableRegistry (InitialSharedVersion `696362017`)

  `0x213f4d584c0770f455bb98c94a4ee5ea9ddbc3d4ebb98a0ad6d093eb6da41642`

***

#### StableLayer SDK <a href="#virtue-sdk" id="virtue-sdk"></a>

* [stable-layer-sdk](https://www.npmjs.com/package/stable-layer-sdk?activeTab=versions)


# Official links

* Official Website: <https://stablelayer.site/>
* Documentation: <https://docs.stablelayer.site/>
* Twitter/X: <https://x.com/stable_layer>


# FAQ

### Q**1. Can we customize token specs?**

Yes—name, symbol, and decimals are fully customizable.

### **Q2. Who can mint and redeem?**

**Anyone** can mint BrandUSD with USDC and redeem USDC by burning BrandUSD.

### Q3. **Are there redeem fees?**

Instant has a fee and a daily cap; T+1 is 0 fee.

### Q4. How do we receive the yield?

Yield accrues over time. Partners **claim any time** on the **Admin Page** to their chosen address.

### Q5. What yield sources are supported today?

**v1** connects to the **Bucket Savings Pool** with **auto‑compound**. More flexible stablecoin yield channels will be added.