> For the complete documentation index, see [llms.txt](https://docs.dexpay.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dexpay.io/dexpay-protocol/state-functions-and-variables.md).

# State Functions & Variables

### **Multi-Sig (DeFault-Admin)** 

This is the master wallet for the smart contract which has the defaultAdmin role and is responsible for granting and revoking other roles in the smart contract, as well as pausing and unpausing the smart contract. This is a multi-sig wallet.

`GrantRole:` This function is used to set roles. Only the `DaFault_Admin_Role` can call this function.

`RevokeRole:` This function is used to revoke roles. Only the `DaFault_Admin_Role` can call this function.

### Verified Request 

This struct represents a verified request, which is used for signature generation and verification.

* `from`: The address from which the request originates. This would always be considered as the verifiedSigner in the wallet
* `to`: The address to which the request is being sent.
* `nonce`: A unique nonce value for each request.
* `validUntil`: A timestamp indicating the validity of the request.

**Nonce:** This returns the nonce of a user in the smart contract which is used in the signature generation process. This value increments for every user after executing authorized transactions.

### **Verified\_Signer**

The role grants permission to the user to sign smart contract signatures generated for the user's wallet transaction request. For the following methods: `sellEscrowLockNative`, `sellNative`, `buyEscrowLockNative`. This method returns a unique bytes32 representing the key of verified signers in the protocol.

### Executor(s)

This is a delegated wallet address that executes transactions on behalf of the user's signed request on the smart contract. 

The executor role grants permission to trigger smart-contract transactions on the following methods: `sellEscrowLock`, `sellEscrowCancel`, `sellEscrowApprove`, `sell`, `buyEscrowLock`, `buyEscrowApprove`, and `buyEscrowCancel`. 

The executor can be multiple wallets assigned by the multi-sig (DeFaultAdmin). Currently, we use one executor wallet which serves as the trade moderator during disputes. In the future, we intend to make this function to more moderators who can serve as the executors.

### Whitelisted

This returns `yes` or `no` if `token` is whitelisted or not. Only whitelisted tokens can be bought/sold

### Whitelist

This function is used to whitelist or remove addresses from the whitelist. Only the `DeFault_Admin_Role` can call this function

* `addrs`: To get the list of token addresses to be whitelisted or removed from the whitelist
* `_whitelist`: indicating whether to whitelist (`true`/`false`)

emits `whitelist` event

### Pauser

**Pauser (Admin):** This is a delegated wallet address that can initiate the pause function on the smart-contract and it can only be set by the `DeFault_Admin_Role` 

### Payment

**Payment Wallet (Fee Wallet):** This is a delegated wallet for collecting fees and can only be set by the `DeFault_Admin_Role`

**Claimable Fees:** This returns the available fees claimable in the contract. Get's claimed during trade approvals executed by the Payment Wallet.

**ClaimFee:** This function is used to claim the accumulated fees for a specific token. Only the ADMIN can call this function. It takes the address of the token for which the fees will be claimed. See claimableFees.

emits `ClaimFee` event.

**Gas Estimation:**  `(const gasToPay = gasUnit * gasPrice)` This is the gas fee needed to execute a transaction on the network.

\
\
\ <br>