> For the complete documentation index, see [llms.txt](https://documents.geb.network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documents.geb.network/build/bitagere/agere-auditor.md).

# Agere Auditor

### Transfer GEB from EVM to Wasm

{% content-ref url="/pages/lYZeHK0f9MR2xR52clfC" %}
[Transfer(EVM<-->Wasm)](/use/bridge/transfer-evm-less-than-greater-than-wasm.md)
{% endcontent-ref %}

## Auditor Overview

{% content-ref url="/pages/gX2wxQ0QAFGBMADoVcQK" %}
[RelayAgere](/build/bitagere/relayagere.md)
{% endcontent-ref %}

## Quick Join RelayAgere

{% hint style="success" %}
Recommended System: Ubuntu 22.04 LTS +
{% endhint %}

### **Preparation Work**&#x20;

{% stepper %}
{% step %}
**Clone the repository**

```bash
git clone https://github.com/GEBcore/RelayAgere.git && cd RelayAgere
```

{% endstep %}

{% step %}
**Install the dependencies**

```bash
bash install.sh
```

{% endstep %}

{% step %}
**Activate the virtual environment**

```bash
source .venv/bin/activate
```

{% endstep %}

{% step %}
**Create Wallet**

```
./wallet.sh <cold_wallet_name>
```

{% hint style="info" %}
The process will generate two wallets: **a cold wallet** and **a hot wallet**. \
If you choose to create wallets, there will generate two wallets: **a cold wallet** and **a hot wallet**. \
In the current script, the cold wallet is associated with the hot wallet automatically. The following operations will require using **the name of the cold wallet**. Both the **cold and hot wallets** are very important, and you need to securely save the wallet's mnemonic phrase to prevent loss.
{% endhint %}

{% hint style="success" %}
You need to import both your **cold wallet** and **hot wallet** into the [BEVM Wallet](https://wallet.bevm.io/) for easier subsequent operations.
{% endhint %}
{% endstep %}

{% step %}
**Register to the agere**

{% hint style="success" %}
Please [deposit](https://wallet.bevm.io/)  GEB token  larger than register fee (at least 10 tokens ) to your cold wallet to register and join the agere.&#x20;
{% endhint %}

{% hint style="info" %}
Your stake amount must rank in the top 64 in the agere to be eligible to run as an auditor.
{% endhint %}

{% hint style="success" %}
**After registration, you need to wait for the `auditor permit` parameter to become `yes`.&#x20;***<mark style="color:orange;">**The waiting time is one epoch, approximately 10 minutes.**</mark>*
{% endhint %}

```bash
./register.sh <cold_wallet_name>
```

{% endstep %}

{% step %}
**Register as a delegate**

After your registration, if you want to work as an auditor, you need to register as a delegate on GEB Wallet.&#x20;

{% hint style="success" %}
If you want to become an auditor, you'll also need to stake sufficient tokens in your hot address.&#x20;
{% endhint %}

*Router: Agere->User->Agere Participants->Delegate*

<figure><img src="/files/8U2LYYLUhkpGONmrs2Vf" alt=""><figcaption></figcaption></figure>

The first option selects the cold address, and the second option selects the corresponding hot address.

<figure><img src="/files/ZGdZxOcKTLXVjPQ9IR7D" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Check your auditor permit

Open GEB Wallet, ensure that the **auditor permit** is set to **yes**, and then proceed with the following operations.

Router：Ager&#x65;*->User->*&#x41;gere *Participants->Your* Agere *Pariticipants status->auditor permit*

<figure><img src="/files/W2iKVYwQLAmmT9iE9dPI" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Run an Auditor Progarm

{% hint style="info" %}
**Before running the program, you need to deposit some tokens to your hot address as transaction fees so the program can send transactions normally.**
{% endhint %}

**Query your wallet balance**

```bash
./get_balance.sh <cold_wallet_name>
```

#### **Running as an Auditor**&#x20;

{% stepper %}
{% step %}
**Stake your tokens to become an auditor**

```bash
./stake.sh add <cold_wallet_name>
```

{% endstep %}

{% step %}
**Run the auditor program**

```bash
./auditor.sh -d <cold_wallet_name>
```

{% endstep %}

{% step %}

### Check Auditor run status

```
tail auditor.log
```

The above code allows you to view the most recent auditor logs, but to ensure that the auditor program is truly running successfully on the agere, you need to wait until the **auditor status** parameter changes to **active**. <mark style="color:orange;">**This will probably take about 10-60 minutes.**</mark>

<figure><img src="/files/mk4lOv0Js4kt7cSOAdh1" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### **Set Commission**

Maximum value is 11796, calculate "commission = take/65535\*100%"

**Increase(required to be greater than previous)**

<figure><img src="/files/plxZ67mXv710rOoB4n0X" alt=""><figcaption></figcaption></figure>

**Decrease(required to be less than previous)**

<figure><img src="/files/ic6jTZabdaUEgGuTqFnL" alt=""><figcaption></figcaption></figure>

### **Claiming Rewards**&#x20;

Except for agere creators, other users' BitAgere incentives are stored in stakes and need to be unstaked to receive actual tokens.

**Using scripts to unstake**

```bash
./stake.sh remove <cold_wallet_name>
```

**Unstaking via BEVM Wallet**&#x20;

*Router: Agere->User Dashboard->Agere Participants->Unstake*

<figure><img src="/files/K2qujKFgw9fp65vWA9JF" alt=""><figcaption></figcaption></figure>