Contracts Deployment

Creating a new AVS requires deploying contracts on-chain.

Overview

Othentic CLI streamlines the deployment of contracts and allows users to configure various operations.

Layer 1 contracts

The following contracts are deployed:

1. AvsGovernance for managing operators and governance policies.

2. L1MessageHandler endpoint for broadcasting messages to L2 contracts.

3. L1AvsTreasury contract for managing rewards and handling protocol fee.

Layer 2 contracts

The following contracts are deployed:

1. AttestationCenter for task verification and historical footprint.

2. OBLS implements Multisig operations and handles BLS signature aggregation.

3. L2MessageHandler complementary to l1MessageHandler , used for communicating with L1 components

4. L2AvsTreasury contract for managing rewards and handling protocol fee.

5. InternalTaskHandler contract for managing and handling Internal Tasks.

To minimize costs and availability associated with running your AVS, AvsGovernance and AttestationCenter are being deployed on L1 and L2 (respectively). The Othentic Stack utilizes DVN to exchange messages between the layers. L1MessageHandler interacts directly with AvsGovernance and L2MessageHandler interacts directly with AttestationCenter.

---

Deploy AVS Contracts

Configuration

Othentic CLI uses .env files for configuration. For the deployment, you need following variables in your .env file:

PRIVATE_KEY_DEPLOYER=...
L1_CHAIN=17000

L2_CHAIN=80002 # If deploying to a single L2
# or:
L2_CHAIN=80002,84532 # If deploying to multiple L2s

• The private key should be a 64-character hex string without the "0x" prefix.

• Specify L2_CHAIN and L1_CHAIN in the .env file to avoid needing to add --l2-chain to every command. The configuration follows this priority:

  • If both --l1-chain (command) and L1_CHAIN (.env) are set, the command flag will override the .env value.

  • If neither is provided, the default value of 17000/holesky (or 80002/amoy for L2) is applied.

• For multichain deployment, specify chainIds separated by commas.

Using CLI

othentic-cli network deploy [options]

The contract cloning process uses SSH to clone a private github repository. Make sure your SSH keys are configured properly on Github before running the deployment process.

Define the following command options:

Chains

--l1-chain and --l2-chain define the L1/L2 chains for AVS contracts deployment. For multi-L2 deployment, you can specify multi L2 networks, separating each chain name with a comma.

--l1-chain holeksy
--l2-chain base-sepolia,amoy # If deploying to multiple L2s
# or:
--l2-chain base-sepolia # If deploying to a single L2

For a complete list of supported networks, refer to the Supported Networks page.

AVS rewards token

--rewards-token Defines the token used to reward Operators. Values can be eth or the address of an ERC-20 token.

--rewards-token eth # For native ETH
--rewards-token 0x94373a4919B3240D86eA41593D5eBa789FEF3848 # ERC20 WETH Contract

Initial Deposit

--l1-initial-deposit and --l2-initial-deposit Defines the initial deposit amounts for cross-chain messaging costs between L1 <> L2s (in wei)

Note: In the case of Multichain deployment, the amount passed to the `--l2-initial-deposit` flag will be deposited separately to all L2 chains.

--l1-initial-deposit 1000000000000000000
--l2-initial-deposit 2000000000000000000

AVS Governance Multisig Owner

--avs-governance-multisig-owner Defines the address of the AVS Governance Multisig role. If not specified, the deployer address is set as the default owner.

--avs-governance-multisig-owner 0xAbC1234567890DefABC1234567890defABC12345

L2 rewards [Optional]

Specifying the --l2-rewards flag enables reward distribution to operators on L2 instead of L1. If not specified, rewards will be distributed on L1 by default.

Note: When specifying this flag for an AVS which has multiple L2 deployments, each deployment manages its own accounting and reward flows separately.

--l2-rewards

---

Deployment Command Examples

1. Using ERC-20 token for rewards distribution:

othentic-cli network deploy \
    --l1-chain holesky \
    --l2-chain base-sepolia,amoy \
    --reward-token 0x94373a4919B3240D86eA41593D5eBa789FEF3848 \
    --l1-initial-deposit 1500000000000000000 \
    --l2-initial-deposit 2500000000000000000 \
    --avs-governance-multisig-owner <OWNER_ADDRESS> \
    --name test-avs-name

1. Using native ETH for rewards distribution:

othentic-cli network deploy \
    --l1-chain holesky \
    --l2-chain base-sepolia,amoy \
    --reward-token eth \
    --l1-initial-deposit 1500000000000000000 \
    --l2-initial-deposit 2500000000000000000 \
    --avs-governance-multisig-owner <OWNER_ADDRESS> \
    --name test-avs-name

1. Using rewards on L2 instead of L1:

othentic-cli network deploy \
    --l1-chain holesky \
    --l2-chain amoy \
    --reward-token eth \
    --l1-initial-deposit 1500000000000000000 \
    --l2-initial-deposit 2500000000000000000 \
    --avs-governance-multisig-owner <OWNER_ADDRESS> \
    --name test-avs-name 
    --l2-rewards

After execution, the deployment details including all the contract addresses will be stored in the following file:

cat .othentic/contracts/script/data/state.output.json

---

View AVS Deployed Addresses

Use this command to display the deployed addresses associated with the AVS:

othentic-cli network contracts

---

Managing AVS Flows: Pause/Unpause

The Othentic CLI allows managing AVS network flows through pause-flow and unpause-flow commands. These commands enable AVS governance multi-sig to halt or resume specific flows across Layer 1 and Layer 2.

By default all the flows are unpaused, except the Payments and Batch Payments.

Pause Flow

This command pauses specific AVS operations. It lists all available flows, allowing you to select and pause a specific flow.

othentic-cli network pause-flow

Un-pause Flow

This command resumes previously paused AVS operations. It lists all available flows, allowing you to select and un-pause a specific flow.

othentic-cli network unpause-flow

Usage

othentic-cli network pause-flow

When prompted, enter the private key of the AVS governance multi-sig address and select the flow.

If the selected flow is already paused, the system throws: Error: Selected Flow is already paused

List of flows

L1 Flows

• Operator Registration: Pausing prevents new operators from registering on the AVS.

• Operator Updating Receiver: Pausing disables the ability to update the operator's reward receiver.

• Update AVS Strategies: Pausing prevents any updates to the AVS strategies.

L2 Flows

• EigenLayer Payments: Pausing halts EigenLayer Rewards distribution.

• Batch Payments: Pausing disables Batch payments to operators.

• Update AVS Logic: Pausing prevents changes to the AVS logic.

• Create AVS Task Definition: Pausing disables the creation of new Task Definitions.

• Task Submission: Pausing prevents on-chain task submissions.

---

Set Staking Contracts

The Othentic CLI enables you to configure staking contracts for an AVS. It internally calls `setSupportedStakingContracts` method on AVSGovernance contract.

Usage

othentic-cli network set-staking-contracts

Follow these steps when prompted:

1. Provide the private key of the multi-sig address.

2. Enter the AVS governance address

3. A list of supported staking contracts will be displayed. Select one or more from the list and confirm your selection.

Set Custom Staking contract

othentic-cli network set-staking-contracts --staking-contracts-address <address1>,<address2> 

Use the --staking-contracts-address flag (or -sca) to specify staking contract addresses, separated by commas.

Configure a New Staking Strategy

If you need to deploy a new strategy through a shared security provider (e.g., EigenLayer), follow these steps:

1. Use the shared security provider's deployNewStrategy method to deploy the strategy for an ERC20 token.
2. Ensure the newly deployed strategy is whitelisted.

3. Once whitelisted, run the othentic-cli network set-staking-contracts command to set the new strategy to your AVS.

At the end, the CLI will display the transaction hash.

---

Set Minimum Stake for a Staking Contract

Othentic CLI enables you to configure minimum stake for a staking contract. It internally calls setMinSharesForStrategy method on the AVS governance contract.

Usage

othentic-cli network set-min-shares

Follow these steps when prompted:

1. Provide the private key of the multi-sig address.

2. Enter the AVS governance address

3. A list of supported staking contracts will be displayed, select a staking contract.

4. Enter the minimum share value in Wei units. It must be a positive number.

At the end, the CLI will display the transaction hash.

---

Set Minimum Voting Power

Othentic CLI enables you to set minimum voting power for an AVS. This ensures that only operators with sufficient voting power can influence the consensus. It internally calls setMinVotingPower method on the AVS governance contract. By default, the minimum voting power is set to 0.

Usage

othentic-cli network set-min-voting-power

Follow these steps when prompted:

1. Provide the private key of the multi-sig address.

2. Enter the AVS governance address

3. Enter the minimum voting power value.

At the end, the CLI will display the transaction hash.

---

Register

Othentic CLI enables you register your AVS to Eigen layer. It internally calls registerAvsToEigenLayer method on the AVS governance contract. The registration details should follow the format specified in the Onboard AVS Dashboard Metadata URI.

Usage

othentic-cli network register

For mainnet, Add --l1-chain mainnet

Follow these steps when prompted:

1. Provide the private key of the multi-sig address.

2. Enter the AVS governance address

3. Select the shared security provider

4. Enter all the details such as AVS Name, Description, Website, Logo URL, etc.

5. The CLI will display the transaction hash.

---

Staking Contracts Multiplier

A staking multiplier is a configurable weight assigned to a specific staking contract. It determines how much voting power stakers receive per token in that contract and can be adjusted based on trust, risk, or strategic considerations.

The multiplier must be a positive, non-zero number.

Learn more about staking multipliers and their influence in voting power here.

Set Staking Contract Multiplier

Othentic CLI enables you set voting power multiplier for staking contracts. It internally calls setStakingContractMultiplier method on the AVS governance contract.

Usage

othentic-cli network set-staking-contract-multiplier

Follow these steps when prompted:

1. Provide the private key of the multi-sig address.

2. Enter the AVS governance address

3. Enter Staking Contract address and multiplier

4. The CLI will display the transaction hash.