# CyLoans Instructions

![Typical CyLoans Flow](https://documents.lucid.app/documents/66b23b94-d6f5-4e68-87b6-d1ea0cf7d4b7/pages/LWe_PLpNqf6q?a=29520\&x=2238\&y=2207\&w=1362\&h=579\&store=1\&accept=image%2F*\&auth=LCA%20a53064c1d034bef480711f4615ceaee449f495f4-ts%3D1645326793)

{% hint style="success" %}
**Definitions**

* Wallet: List of CyBlocs (owned by user/lender) which are available for listing on CyLoans Market
* Listed: List of CyBlocs which are listed on CyLoans Market but have not been borrowed/leased by anyone yet
* Recalling: List of CyBlocs which have been recalled/cancelled and are waiting for 24h timelock to finish before lender can officially remove them to receive back into Wallet
* Leased: List of CyBlocs which are on lease i.e. borrowed by somebody and are playable (by the borrower)
* Borrowing: List of CyBlocs that user is borrowing from CyLoans Market
* CyLoans Market: Marketplace for all available CyLoans Listings ready to be borrowed, separated into Whitelist and Free-for-All
  {% endhint %}

{% hint style="info" %}
**Note:**

CyLoans function is located within the **Profile** tab of the CyBall web-app.

As a reminder, CyBloc's level currently gets reset upon any transfer, including in and out of CyLoans Market.
{% endhint %}

## Lender (Owner)

### 1.  List your CyBlocs:

![Free-for-All Example in Wallet](/files/TRFjPAmcQF3LZycJ8Eop)

![Whitelist Example in Wallet](/files/PuhFTB052TJrZjjXt56s)

* Under **CyLoans**, navigate to **Wallet**
* Select the relevant CyBlocs that you would like to list on CyLoans
* Enter the percentage (%) rewards split to borrower and (optional) whitelist details (login email of borrower)
* Click **List** and confirm the transaction in your crypto wallet
* You may choose to list multiple CyBlocs altogether, or one at a time

### 2. Manage Listed CyBlocs

![Listed CyBloc](/files/cDlY3iEVxKGhxplQ9Q1e)

* Navigate to **Listed**
* All CyBlocs which have been successfully listed on CyLoans Market but have yet to be borrowed by other users will be displayed in this section
* To edit the percentage (%) rewards split or whitelist details, click the appropriate text box, enter the new details and click save
* To cancel a listing, select the relevant CyBlocs and click "Delist"
* Confirm the transaction in your crypto wallet to delist from CyLoans Market

{% hint style="info" %}
**Note:**

To prevent abuse of CyLoans and the game's energy system, there is a 24h timelock delay before your CyBlocs can be removed from CyLoans and returned to your wallet.

Navigate to **Recalling** to check the cancellation status.
{% endhint %}

### 3. Manage Leased CyBlocs

![Leased CyBlocs (which have been borrowed by other users)](/files/ln9fi1yy4kIx7T8KHwUG)

* Navigate to **Leased**
* The **Owner Reward** column is displaying two things:
  * White: total owner (lender)'s rewards earned by a certain borrower using the relevant CyBloc regardless of listing/leased time; and
  * <mark style="color:green;">Green</mark>: total rewards earned by this CyBloc since first listing on CyLoans by the current owner (in green), regardless of who the current and past borrowers are.
* To cancel a loan, select the relevant CyBlocs and click "Cancel"
* Confirm the transaction in your crypto wallet to recall it from the borrower

{% hint style="info" %}
**Note:**

To prevent abuse of CyLoans and the game's energy system, there is a 24h timelock delay before your CyBlocs can be removed from CyLoans and returned to your wallet.

Navigate to **Recalling** to check the cancellation status.
{% endhint %}

### **4. Manage CyBlocs which are being Recalled**

![CyBloc being cancelled/recalled by Lender from CyLoans in Recalling (24h delay)](/files/X5voRMEqzzqYupkwu53n)

* Navigate to **Recalling**
* All CyBlocs which are serving the 24h timelock delay as part of the cancellation/recall process will be displayed in this section
* When the current time has gone past "Cancel Tim&#x65;*"* (i.e. 24h have passed), you can select the relevant CyBlocs and click "Cancel" / "Cancel Lending"
* Confirm the transaction in your crypto wallet to receive the CyBlocs back into your **Wallet**

## Borrower

### 1. Borrow CyBlocs from CyLoans Market

![CyBlocs available for loan in CyLoans Market](/files/SQxY3hZbbpsRU2qZE8BC)

* Navigate to **CyLoans Market**
* Within the relevant tab (Whitelist or Free For All), select CyBlocs which you would like to borrow
* Click Borrow

### 2. Manage CyBlocs which you are Borrowing

![CyBlocs which you are Borrowing (from CyLoans Market)](/files/CpWcpn4VQ5qbbW3Qfuzj)

* Navigate to **Borrowing**
* All CyBlocs which you are borrowing from CyLoans Market will be displayed in this section
* These are the CyBlocs which you can use to play and should be displayed within Collections inside the CyBall game
* To cancel a loan, select the relevant CyBlocs and click "Cancel"
* The CyBlocs which just got cancelled (by the Borrower) will automatically be listed back onto CyLoans Market under Whitelisted or Free For All, depending on how it was listed up originally by the Lender.

{% hint style="info" %}
**Note:**

Cancellations triggered by the Lender (Owner) will be shown in **Recalling**.

Cancellations triggered by the Borrower will automatically be listed back on **CyLoans Market** under Whitelisted or Free For All, depending on whether it was a Whitelist or Free For All loan originally.
{% endhint %}

## Rewards

When a Borrower play the CyBall game and earns rewards, the game will automatically distribute the rewards in-game to the relevant Lender an Borrower's game accounts.


---

# 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.cyball.com/ecosystem/cyloans/cyloans-instructions.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.
