# Wallet Partnership Proposal

### 1. Background & Partnership Goals

#### 1.1 Background

CatFee Staking Vault is a yield-generating product designed to provide users with stable returns through on-chain resource delegation mechanisms.

Wallets serve as strong distribution channels with user traffic, asset storage, and ecosystem reach. By integrating CatFee Staking Vault, wallets can enrich their wealth product offerings and improve user retention.

#### 1.2 Partnership Goals

This partnership aims to achieve:

* **Fast launch of a new earning product** for the wallet
* **Improved user engagement & retention** through yield products
* **Scalable distribution** for CatFee through wallet channels
* **Transparent and automated revenue sharing** between users and wallet partners

***

### 2. Partnership Model Overview (Wallet Channel)

In this partnership model, the wallet acts as a distribution partner by listing and promoting CatFee Staking Vault products. Users participate through the wallet interface by delegating resources to a CatFee receiving address.

CatFee will then automatically calculate and distribute yield according to the agreed revenue split.

> ✅ Key Highlights: **Non-locking delegation** (flexible user participation) + **Automated revenue sharing** (no manual settlement).

***

### 3. Revenue Split Structure (Example)

The yield payout follows a **tiered revenue-sharing model**, where the wallet proposes an expected split, and both parties confirm it before execution.

#### 3.1 Example Split

Assume CatFee’s total payout ratio is **16%**:

| Receiver       | Share | Description                         |
| -------------- | ----: | ----------------------------------- |
| User           |   10% | Yield paid directly to the user     |
| Wallet Partner |    6% | Channel revenue share to the wallet |
| Total          |   16% | Total payout from CatFee            |

> Note: Final split can be adjusted based on traffic contribution, volume, and long-term cooperation.

***

### 4. Wallet Partnership Workflow (Business Flow)

#### 4.1 Workflow Summary

1. **Wallet provides the expected revenue split**, e.g., from CatFee’s 16% payout: user 10% + wallet 6%
2. **CatFee provides the receiving address** for resource delegation
3. Wallet lists the CatFee Staking Vault earning product
4. Users browse the earning product in the wallet
5. Users delegate resources via the wallet to CatFee’s receiving address (**non-locking**)
6. After **24 hours**, CatFee automatically settles and distributes yield:
   * **10% yield paid to the user address**
   * **6% revenue share paid to the wallet’s designated receiving address**

***

### 5. Sequence Diagrams (Business Version)

#### 5.1 User Participation Sequence

```mermaid
sequenceDiagram
    autonumber

    participant Wallet as Wallet Partner
    participant CatFee as CatFee System
    participant User as User

    Wallet->>CatFee: Provide revenue split proposal<br>(16% = User 10% + Wallet 6%)
    CatFee-->>Wallet: Return resource receiving address

    Wallet->>User: Display earning product<br>(returns, rules, product overview)
    User->>Wallet: Select product and confirm participation
    User->>CatFee: Delegate resources via wallet to<br>CatFee receiving address\n(non-locking)
```

#### 5.2 24-Hour Yield Settlement & Revenue Sharing

```mermaid
sequenceDiagram
    autonumber

    participant CatFee as CatFee Settlement Engine
    participant User as User Address
    participant Wallet as Wallet Receiving Address

    Note over CatFee: Delegation reaches 24 hours

    CatFee->>CatFee: Calculate yield and apply split<br>User 10% / Wallet 6%
    CatFee-->>User: Auto transfer yield (10%)
    CatFee-->>Wallet: Auto transfer revenue share (6%)

    Note over User,Wallet: Settlement completed
```

***

### 6. Roles & Responsibilities

#### 6.1 Wallet Partner Responsibilities

* Provide the expected revenue split proposal and wallet receiving address
* List and display CatFee Staking Vault earning products inside the wallet
* Guide users through participation steps (delegation / staking)
* Support marketing distribution (banner placements, push notifications, campaigns — optional)

#### 6.2 CatFee Responsibilities

* Provide resource receiving address and settlement rules
* Calculate yield and execute automated settlement
* Distribute yield to users and revenue share to wallet partner
* Provide reporting and reconciliation support (periodic performance summaries)

***

### 7. Key Benefits for Wallet Partners

#### 7.1 Rapid Product Integration

Wallet partners can launch a new earning product without building complex yield infrastructure.

#### 7.2 Increased Asset Retention

Yield offerings improve long-term asset deposits and strengthen wallet user stickiness.

#### 7.3 Stable Revenue Stream

Wallets earn recurring revenue share based on user participation and volume.

#### 7.4 Automated Settlement at Scale

CatFee performs automated calculations and payouts, minimizing manual operational costs.

***

### 8. Optional Expansion Opportunities (Advanced Cooperation)

This model can be upgraded into deeper and more flexible cooperation options, including:

* **Tiered revenue upgrades** based on daily volume / user growth metrics
* **Co-branded promotions** (limited-time bonus yield, campaigns, special events)
* **Agency & sub-channel revenue sharing** under the wallet distribution system
* **Shorter settlement cycles** (e.g., daily settlement, hourly settlement — negotiable)

***

### 9. Settlement & Reporting (Business View)

#### 9.1 Settlement Cycle

Default: **Yield settlement after 24 hours** of successful delegation\
(Upgradeable to daily / more frequent settlement by agreement)

#### 9.2 Settlement Receivers

* User address: provided by the user (or generated by wallet)
* Wallet receiving address: provided by wallet partner for revenue share

#### 9.3 Reporting Support

CatFee can provide periodic summaries including:

* Total participating users from wallet channel
* Total delegated volume
* Total yield paid to users
* Total revenue share paid to wallet partner

***

### 10. Risk Control & Compliance Notes (Light Version)

To ensure stable and sustainable cooperation:

* Wallet partner should clearly display product rules and yield structure
* Wallet acts as a distribution and UI channel only, without custody of user funds
* CatFee handles yield settlement and on-chain payout, with transparent tracking


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.catfee.io/en/staking-vault/wallet-partnership-proposal.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
