> ## Documentation Index
> Fetch the complete documentation index at: https://thrackle.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Calling Contract Admin

> The Admin with the ability to configure the policies applied to a contract.

## What is a Calling Contract Admin?

A **Calling Contract Admin** is a special role that manages which policies are checked when a contract interacts with the rules engine. Think of it as a "policy manager" for a specific contract.

### Key Responsibilities

* **Policy Selection**: Decides which rules and policies should be applied when the contract makes requests to the rules engine
* **Configuration Management**: Sets up what gets checked during policy evaluations
* **No Policy Creation**: Cannot create or modify the actual policies themselves - only chooses which ones to use

### Important Rules

* Each calling contract can have **no more than one** Calling Contract Admin
* One person/address can be the Calling Contract Admin for **multiple different contracts**
* Only the Calling Contract Admin can configure which policies are checked for their specific contract
* Calling Contract Admin may renounce their role

#### What Happens When the Admin Renounces Their Role?

If the Calling Contract Admin renounces their role, the contract will temporarily have **no admin**. During this period:

* No one can configure or change which policies are checked for the contract.
* Policy management functionality becomes unavailable until a new admin is assigned.
* Only the contract owner (or another authorized party, depending on your access controls) can assign a new Calling Contract Admin using the `setCallingContractAdmin()` function.
* It is recommended to promptly assign a new admin to restore policy management capabilities.

Renunciation is irreversible for the previous admin; they must be re-assigned if they wish to regain the role.

## Setting Up a Calling Contract Admin

### Step 1: Prepare Your Contract

Your contract must inherit from the `RulesEngineClient` abstract contract, which is available in the `forte-rules-engine` npm package.

### Step 2: Deploy and Assign

After deployment, the contract owner can assign a Calling Contract Admin using the `setCallingContractAdmin()` function (inherited from `RulesEngineClient`).

### Step 3: Secure the Function

**Important**: You must override the `setCallingContractAdmin()` function with proper access controls to prevent unauthorized users from changing the admin. It's recommended that only the current Calling Contract Admin should be able to invoke this function.

## Transferring the Role

The Calling Contract Admin role can be transferred to another address, but there's a safety mechanism:

1. The current admin initiates the transfer
2. The new admin must **accept** the role
3. Only after acceptance is the transfer completed

This two-step process ensures that roles aren't transferred to unwilling recipients.