# ZCN S.C.

### ZCN Smart Contract Functions

**`NewZCNSmartContract`**

Creates a new instance of the ZCN Smart Contract.

```go
goCopy codefunc NewZCNSmartContract() smartcontractinterface.SmartContractInterface {
	var contract = &ZCNSmartContract{
		smartcontractinterface.NewSC(ADDRESS),
		make(map[string]smartContractFunction),
	}

	contract.InitSC()
	contract.setSC(contract.SmartContract, &smartcontract.BCContext{})
	return contract
}
```

**`InitSC`**

Initializes smart contract functions within the ZCN Smart Contract, associating each function with a key.

```go
goCopy codefunc (zcn *ZCNSmartContract) InitSC()
```

#### **Key Functions**

* **Configuration**
  * `update-global-config`: Updates the global configuration of the smart contract.
  * `update-authorizer-config`: Configures specific authorizers for the smart contract.
* **Bridge-Related**
  * `mint`: Mints new ZCN tokens.
  * `burn`: Burns ZCN tokens, typically used for cross-chain interactions.
* **Authorizer Management**
  * `add-authorizer`: Adds a new authorizer.
  * `delete-authorizer`: Removes an existing authorizer.
  * `authorizer-health-check`: Conducts a health check on an authorizer.
* **Delegate Pools**
  * `add-to-delegate-pool`: Adds tokens to the delegate pool for staking.
  * `delete-from-delegate-pool`: Removes tokens from the delegate pool.
  * `update-authorizer-stake-pool`: Updates the stake pool for an authorizer.

***

### Execution Statistics

ZCN Smart Contract records metrics for each major function to track performance:

| Function Name               | Description                                                |
| --------------------------- | ---------------------------------------------------------- |
| `add-authorizer`            | Tracks time taken to add a new authorizer.                 |
| `delete-authorizer`         | Monitors time taken to delete an authorizer.               |
| `update-global-config`      | Tracks time taken to update the global configuration.      |
| `update-authorizer-config`  | Tracks time taken to update an authorizer's configuration. |
| `mint`                      | Measures the time taken for minting tokens.                |
| `burn`                      | Measures the time taken for burning tokens.                |
| `add-to-delegate-pool`      | Tracks the time taken to add to the delegate pool.         |
| `delete-from-delegate-pool` | Tracks the time taken to remove from the delegate pool.    |

***

### Core Functions

**`Execute`**

Executes a specified function within the ZCN Smart Contract based on the provided method name and input data.

**Function Signature:**

```go
goCopy codefunc (zcn *ZCNSmartContract) Execute(
	trans *transaction.Transaction,
	method string,
	input []byte,
	ctx cstate.StateContextI
) (string, error)
```

**Parameters:**

| Field    | Description                                              |
| -------- | -------------------------------------------------------- |
| `trans`  | Transaction to be executed.                              |
| `method` | Name of the method to execute within the smart contract. |
| `input`  | Input data for the method in byte format.                |
| `ctx`    | Blockchain state context interface.                      |

**Returns:**

* `string` - Result of the function execution.
* `error` - Error if the execution fails.

***

### Cost Table Retrieval

**`GetCostTable`**

Retrieves the cost table for the smart contract, containing configuration costs associated with each operation.

**Function Signature:**

```go
goCopy codefunc (zcn *ZCNSmartContract) GetCostTable(balances cstate.StateContextI) (map[string]int, error)
```

**Parameters:**

| Field      | Description                                                       |
| ---------- | ----------------------------------------------------------------- |
| `balances` | Blockchain state context interface used to retrieve global costs. |

**Returns:**

* `map[string]int` - A map containing the cost configuration for each function.
* `error` - Error if retrieval fails.


---

# 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.zus.network/zus-docs/system-overview/smart-contracts/zcn-s.c..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.