# Welcome

{% hint style="info" icon="signal-stream" %}

## Hera V3 beta is finally on Solana

During beta, you can jump into the interface, check routes and quotes, and feed us with your feedback. Execution will stay disabled for now, and both the pathfinder and the UI will keep getting better every single day.\
\
Bad routes, broken stuff, weird behavior, or anything you think should be improved, all of it is valuable.\
\
Take a look now: [**beta.hera.ag**](https://beta.hera.ag/)
{% endhint %}

Hera is an AI-powered multichain dex aggregator offering the widest range of tokens and the best route discovery between any token pairs.

We aim to provide the friendliest UX for users and the most powerful tools for developers to allow them to access the best-in-class swap in their application, interface, or on-chain programs.

Hera Aggregator is a project that is constantly being developed and spans the entire crypto ecosystem. By accessing many chains and the liquidity resources within, it can offer swap transactions that provide the maximum return to users.

With its user-friendly interface and advanced features, Hera offers an all-in-one access solution.

<figure><img src="/files/GjVnScIGazuVIO7H6AVq" alt=""><figcaption><p>Hera Dex Aggregator | Workflow v2.1.7</p></figcaption></figure>

Hera Aggregator provides maximum output in swap transactions for traders with AI powered **pathfinder**. Briefly, aggregator works like this:

1. Connect wallet to Hera Dex Aggregator
2. Select tokens for swap
3. Pathfinder create the best route for max output amount
4. Confirm and complete swap progress!

### Why Hera Aggregator?

Integrate with Hera in order to:

* Offer best price for swaps
* Available for any token to token swap
* Fast, user friendly UX and gas optimization
* All-in-one access to decentralized finance
* Ai powered pathfinder and chainfinder
* Hera Guard feature: Zero slippage swap option
* Automatically stay up to date with the latest tokens and liquidity sources
* Make swaps a revenue source by adding your own platform fee to the transaction
* Set their caching options to make their swap as speedy or as precise they wish to be.

#### Developer Support

Developing can be difficult at times. On our end, we aim to make creating a superb swap interface or program as seamless and magical as possible. We do this by:

* Removing key barriers to providing a good UX, including having clear instructions for issues like ATAs and open orders.
* Providing various methods of accessing the swap, so all apps, dapps, and programs can use it seamlessly
* Providing updated liquidity sources, token lists, and possible UX improvements as soon as possible.

> **EmporiaSDK has been successfully released!** [<mark style="color:green;">**Check Now!**</mark>](/developers/emporia-sdk/overview)

> If you are a protocol developer or project manager and looking for a communication way to integrate into Hera Aggregator; please contact us via Twitter, Telegram, Discord or mail. Thanks!


# About Aggregator

Hera Aggregator is a protocol that aims to provide the best swap return by scanning multiple liquidity provider markets. It uses trade splitting and multi-hop features to find the best route.

Sometimes it interacts directly with a single AMM to find the best route. Depending on need, it operates on multiple AMMs. It creates new paths by dividing it according to the input amount. Each road creates the best route independently of each other, therefore, the maximum output amount is made. In other words, both maximum income is obtained and a balance is created in the pools.

![](/files/AnwBzsw9mTukVBL7tSex)

Hera has an artificial intelligence powered off-chain calculation program that creates routes. The AI makes 750,000+ calculation attempts on each query. It finds all liquidity pools and creates routes without over draft scenarios.

It compiles all routes and approves them in a single transaction safely and efficiently.

### multi-hop routes. <img src="/files/E29v7p6TgQZKHMpbGfQk" alt="" data-size="line">

Hera connects all DEX markets and AMM pools no matter the provider and finds all direct and 2-hop to 5-hop routes between any two tokens on integrated networks. There can be up to 5 tokens included in a transaction path. Therefore, it supports a maximum of 5-hops currently.

Not only does Hera Aggregator compare the prices between markets on different DEXes it also can discover best priced routes through indirect markets. Instead of traditional methods, Hera may find the best price by routing through an intermediary token, e.g. "X>Z>Q>Y" instead of "X>Y". This method may be applied due to price inefficiencies and/or volatility in the various markets that Hera Aggregator routes through.

Here are some key features for how Hera Aggregator discovers the best priced trades.

### trade splitting. <img src="/files/IuAfqLVwZBZexiwAqR2S" alt="" data-size="line">

Hera Aggregator will split your trade into smaller trade sizes. For example, if you want to make a 100 USDC-ETH trade, it may distribute your trade into a 30 USDC-ETH trade on AMM1 and a 70 USDC-ETH trade on AMM2.

The percent distribution of a trade is dynamically determined to give you the best price. Trade splitting helps get better prices for large size trades and trades with tokens where there is shallow liquidity spread out across a number of DEXes.

### other key features of Hera <img src="/files/qbwr6OFlKzuoSaFAfIaY" alt="" data-size="line">

**Automatically lists new tokens**

The number of new tokens being added is increasing at an ever faster pace. This means you can be assured that you'll be able to trade new tokens as they launch on integrated networks.

**Lists new markets rapidly**

The number of markets and liquidity pools that are launching is also increasing. So, Hera instantly picks up any market or pool for any of the DEXes it currently aggregates. This ensures that Hera always has the latest liquidity for any token that is listed as soon as it is available.

**Swap in a single transaction**

Hera has worked to optimize its swap aggregation so that it all fits with the transaction limits so that swapping can be done in one transaction. This is important to handle cases where the price for the token you are buying has changed and no longer fits your slippage limit. If Hera Aggregator cannot make the trade with your slippage limit, it rollsback the transaction and return an error.


# AI Powered Pathfinder

### Find the best route with | AI-Powered Pathfinder

Hera Aggregator is built on a unique architecture with a pathfinder algorithm. Our unique algorithm's structure can be developed, re-programmed, and has self-learning capabilities.

![](/files/Zs5uhBhP3dvzNKmj184O)

### **Features**

#### Homogeneous Liquidity

Integrating with dozens of different market models, the pathfinder ensures nearly 99.99% convergence on accessible liquidity sources, creating flawless routing for execution. By homogenizing liquidity, our AI core provides a seamless trading experience, ensuring optimal rates for every transaction.

#### Dynamic Routing

For the best swap execution, our pathfinder can connect directly to a single liquidity asset or integrate dozens of sources into a single route. With multihop capabilities, it can insert additional token routes between tokens, breaking down the route for greater output. It also presents you with real-time on-chain arbitrage opportunities within the route, ensuring maximum efficiency and profitability.

#### Hera Data Repository

The Core-AI's offchain modules fetch the necessary onchain data simultaneously with chain data. Integrated market makers, liquidity models, liquidity pools, tokens, and chain data are all served on a large database, encompassing both dynamic and static data. This comprehensive database ensures that our system remains up-to-date and highly efficient, providing seamless integration across multiple blockchain networks.

#### Distributed Processing Module

Utilizes the Distributed Processing Module for robust and scalable deployment and management of applications. This ensures our platform remains stable and responsive even under high demand.

***

### **Pathfinder Structure:**&#x20;

#### 01. Max Output Equation

A mathematical equation is created to get the maximum output from the integrated liquidity providers. The result of this equation gives the best received amount.

It creates an equation in accordance with the pathfinder route finding structure by controlling all liquidity pools. This equation is not fixed, it changes itself according to the terms and conditions. Therefore, it uses many data types as input.

#### 02. HCA Data Processing

All required data is instantly accessed and converted to High Conversion Argument (HCA). This converted data is sent to the max output equation.

The data needed to solve the equation are provided. It is then finalized using the HCA module powered by artificial intelligence. It is then forwarded to the next step to find the max output figure.

#### 03. Find All Paths

It searches and finds all possible routes between two tokens and filters out unnecessary routes by filtering within certain criteria.

Pathfinder, which is prepared to take a maximum of 5 tokens between the input token and the output token, performs a filtering to reduce the almost infinite number of outputs. It eliminates very low liquidity pools, identifies tokens that can be matched between them, and prepares them to offer a multiple path.

#### 04. Hera Pathfinder: Assemble&#x20;

All obtained data and formulas are sent to AI powered pathfinder algorithm.

All data is assembled at this stage. After many calculations and formula analysis, it brings together the scattered data and creates the data needed to confirm the swap transaction.

### Capacity and Development Qualifications

{% tabs %}
{% tab title="Upgradeable Abilities" %}

* AMM Integrations
* Data Filter
* Scaning Features
* Pathfinding Methods
* Liquidity Splitting
* Route Splitting
* Task Distributions
* Workload Reduction
* Route Optimization
* Algorithm Update
  {% endtab %}

{% tab title="Sheltered Areas" %}

* Fee Rates
* Liquidity Reserves
* Token Details
* Calculation Algorithms
* Route Rules
* Calldata Attributes
* Input/Output Amount Controller
  {% endtab %}

{% tab title="Learnable Areas" %}

* Route Finding
* Using Previously Routes
* Defining Liquidity Quality
  {% endtab %}
  {% endtabs %}


# Interoperability

### Connecting offchain power with onchain trustless.

> ```html
> unified execution, unlimited possibilities
> ```

Combining onchain trustless architecture with offchain computational power, Hera lays the foundation for the envisioned interoperability model. Hera core-pathfinder combines the power of CPU and GPU to process data offchain and send it onchain for execution.

![](/files/tCIT0i5Yc85CX4M1w4Mh)

The core protocol, consisting of a total of 12 different nodes, encompasses multiple languages and processing types. Different servers are deployed for computational tasks and AI management and training processes.

#### Execution and Sustainability

Today's blockchain technologies are not capable of handling complex transaction models alone and thus rely on the support of centralized protocols. Hera's core-pathfinder model and AI modules are run off-chain.

One of the ultimate goals is to package Hera's core pathfinder model so that it can be deployed by anyone in the future, contributing to its processing power. This way, the community can directly support or benefit from this technology.

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


# Optimization

### Optimized for Excellence

At Hera, we are committed to pushing the boundaries of what's possible, continuously optimizing our systems to provide unmatched efficiency and performance in the DeFi.

> Maximizing Efficiency, Minimizing Costs!

![](/files/YUz8VQ9eskOltugSvJEW)

### **Features**

#### Assembly Coding

We've employed assembly coding for router, executor, manager, and adapter contracts to ensure unparalleled efficiency. By utilizing low-level code, we streamline data transfer, fetching, and calldata creation processes.

#### Direct Data Access

When processing a token LP into the database, we access only the necessary data, eliminating redundant queries and excessive call data. This approach targets maximum speed and minimum data bytes.

#### Offchain Optimization

Offchain data prepared for onchain execution is created entirely in low-level code, minimizing byte size. This ensures that routing involves no unnecessary data, resulting in lower transaction gas costs.

#### Seamless Integration

Our optimization strategies are designed to provide a seamless and efficient experience, both on-chain and off-chain, ensuring optimal performance for all operations.


# Chain Agnostic Core

### Modular Flexibility Across All Blockchains

Hera's pathfinder core modules are engineered for modularity and adaptability, ensuring seamless integration with any blockchain architecture, including both EVM and Non-EVM chains like Solana etc.

> Broad Compatibility, Limitless Potential

![](/files/0qhRGev2P6VzRyyU2law)

#### Broad Compatibility

Our Chain Agnostic Core supports not just the well-known blockchains, but it is also engineered to be compatible with any emerging or existing blockchain. This flexibility ensures that Hera remains at the forefront of blockchain interoperability, providing users with a truly decentralized and versatile DeFi experience.

#### Innovative Architecture

Our innovative architecture allows for easy deployment and scaling across different blockchain networks. By leveraging both CPU and GPU processing capabilities, our pathfinder core can handle the complexities of multiple chains, providing efficient and effective routing and execution.


# Interchain

### One Route, All Liquidity

Hera's interchain technology enables access to all onchain liquidity through a single route. This is not just a need of today but a necessity for the future, and Hera's research team has been preparing for this extensively.

> Maximize your DeFi potential with Hera's innovative interchain solutions.

![](/files/L9vW6MGnmnTijEMJ1dKL)

As numerous new Layer 1 and Layer 2 solutions emerge, liquidity is distributed across different chains. This has caused significant issues in swap performance. The solution lies in running cross-chain communication protocols and core-pathfinder modules together.

The primary goal of interchain technology is to aggregate liquidity from multiple chains into a single route. This requires well-designed cross-chain communication and asset transfer protocols, an area where Hera's R\&D team has been diligently preparing.

***

#### Universal Liquidity

Hera provides access to Ethereum, major Layer 1 chains, and many Layer 2 chains. It aggregates offers from market makers across these chains and compiles them for the best swap execution. This is the most comprehensive definition of liquidity access in the DeFi space.

#### Advanced Routing

Imagine a single route incorporating multiple chains and multiple AMMs. Now, elevate this concept where the route completes on the execution chain, utilizing liquidity from a Layer 1 and returning to the Layer 2 execution layer. The routing structure is fully user-controlled, allowing flexibility and optimization.

#### Communication Protocols

The cornerstone of the interchain model is efficient data transmission across chains. Technologies such as LayerZero, Wormhole, Chainlink, and Axelar are combined in a cumulative approach to achieve seamless cross-chain communication.

#### Asset Transfers

Achieving access to all liquidity through a single route requires robust cross-chain asset transfer protocols. Hera addresses this through two approaches: utilizing existing bridge protocols and designing a proprietary interchain assets bridge protocol, aiming for the maximum accessible bridge assets.

{% tabs %}
{% tab title="Operational Architecture" %}
Hera Interchain is the primary goal following the V3 deployment. Once V3 is deployed across key chains, the interchain process will commence, enabling the core-pathfinder modules deployed on different chains to communicate via bridges and communication protocols.
{% endtab %}

{% tab title="Compatibility Sustainability" %}
A few years ago, the concept of cross-chain interoperability was hardly discussed. Today, we see tokens on multiple chains, symbolizing an inevitable convergence. The Hera team is committed to building a central swap protocol for DeFi, ensuring compatibility and sustainability across various blockchain networks.
{% endtab %}
{% endtabs %}


# Utility Token

Hera Token is the governance token of Hera ecosystem. Asides from voting, the token is used in many other areas in the ecosystem.

Hera Token lies at the core of the Hera ecosystem and directly impacts the entire protocol economy in a positive way. It's quite simple: The protocol generates revenue and shares it with its stakeholders like a next-generation dividend.

### Utility Areas

#### 01. Buy-Back Progress

In certain periods Hera tokens are purchased from the market at the rate determined by the platform's revenue and VaultManager's recommendations. This is used to add liquidity on AMMs and exchanges, transfer to the market-maker wallet, or sent to Staking Portal as a reward to participants.

#### 02. Stake and Earn

More Hera Tokens can be earned by staking. Rewards are funded by protocol revenue. Therefore, APY rates are variable.

{% embed url="<https://portal.hera.finance>" %}

#### 03. Swap Fee Reduce (soon)

Aggregator platform charges a fee for swap transactions. The current rate is 0.3% from input token. For people who stake Hera Token, swap fee rate decreases gradually according to the stake amount and HeraPower.

#### 04. Hera DAO & Governance (soon)

Proposals will be submitted to the community to make decisions concerning the platform. Hera Token holders have voting rights. Studies on a fair management structure continue.


# Swap Fee Distribution

Protocol's revenues from swap transactions are transferred to the Hera Treasury. AI-powered **VaultManager** handles the distribution of these revenues.

## Distribution Planning

### 30% - Ecosystem Funding

Hera's treasury project helps to develop and maintain revenue collection. It is designed to cover many facets of Hera's ecosystem.

Hera Protocol must be an absolute treasure for its survival, and this treasure must be strengthened as much as possible. In this regard, 30% of the income from the protocol earnings is transferred to the treasury to cover possible expenses and expand the Hera project.

### 20% - Marketing & Development

The expenses required for the healthy operation of the aggregator and auxiliary applications are covered. It also provides the necessary funds for marketing activities.

Hera project provides off-chain services both on the blockchain and on off-chain servers. There is a significant expense in terms of data center and processing capacity. A 20% share is taken from this distribution in order to cover the expenses and introduce it to more people.

### Buy-Back and Liquidity Provide

**(Rate: 0-50%  |  Decision Maker: AI Powered VaultManager)**

According to the report recommendations presented by VaultManager, Hera tokens may be subject to buybacks from the market. Bought tokens can be held in the treasury, added to liquidity or transferred to the Staking Portal.

We have programmed a unique artificial intelligence module to reduce the initiative of the team and turn their decisions into a positive direction. By making a detailed analysis about Hera Token, it reports how much buyback should be made to the team and how much it should add to the liquidity. It also instantly examines treasury resources for liquidity. These reports are presented off-chain, buyback and liquidity addition transactions are done on-chain with the VaultManager contract.

Transactions are public on the contract.

### Rewards Pool Funding

**(Rate: 0-50%  |  Decision Maker: AI Powered VaultManager)**

Funds are provided for staking portal rewards and rewards for app usage. It only trades for certain periods so that the pool can pay out sustainably. These transactions also include buy-back.

According to the VaultManager decision, a determined number of tokens are sent to the Staking Portal to be distributed to users. Protocol revenues and distribution are directly proportional. For this reason, the APR rates of staking and farming pools vary periodically.

### Periods of Distribution

**(Decision Maker: AI Powered VaultManager)**

Just like the distribution percentages, the artificial intelligence algorithm decides when the distribution will be made. Performs market analysis, checks token price and liquidities, monitors volumes and examines funds in the treasury; After all this, it sends a report to the team to take action.


# Overview

<figure><img src="/files/23K6VAj9dngpFKfPpntl" alt=""><figcaption></figcaption></figure>

The Hera core team, with full support from the community, decided to launch the V3 release on Solana before rolling it out across EVMs, and this process officially began in September 2025.

The Solana version will run directly on **hera.ag**, and all documentation and details will continue to be published there. Under this menu, you’ll find everything from contract information and product details to API routes and other useful resources.

***

{% hint style="info" icon="signal-stream" %}

## Hera V3 beta is finally on Solana

During beta, you can jump into the interface, check routes and quotes, and feed us with your feedback. Execution will stay disabled for now, and both the pathfinder and the UI will keep getting better every single day.\
\
Bad routes, broken stuff, weird behavior, or anything you think should be improved, all of it is valuable.\
\
Take a look now: [**beta.hera.ag**](https://beta.hera.ag/)

<p align="right"><sub><em>08 April 2026</em></sub></p>
{% endhint %}

#### Updates about v3 beta release and upcomings

Hera V3 core has its own internal LM, and during beta it’s going through heavy training. On top of that, the API side is now plugged into an AI managed layer running on AWS. The heavy math load is handled by Graviton4 machines, one of the big upsides of building the whole thing from scratch in rust, while the AI-agent layer has been reworked around Kubernetes.

At this stage, we’ll be collecting reports for both load optimization and scaling. We’ll also be locking in the stability and error profile of multi worker task sharing and parallel compute modules as training continues.

We’re still not connected to every single onchain liquidity source yet. We integrated them, but routing is not fully where we want it to be. That part will be improved step by step, so you’ll be able to watch routes get better day by day.

At the same time, we’ll also be working through new propAMMs and new liquidity providers. All accessible liquidity will be pulled into what we call a homogenized pool, which we believe is a pretty revolutionary approach. The goal is not just to show the best quote. The goal is to actually deliver the best quote.

And throughout beta, our full focus will be on finding the cleanest possible balance on execution.

Also, before we forget, we want to give a special shoutout to both the Helius and Jupiter guys. We got a genuinely warm welcome here and real support from both sides.

Last but not least, huge thanks to the community for the insane patience. We really hope we earn the right to deliver a product that lives up to expectations by the end of this process, because you guys kept supporting us all the way through.

Please don’t hesitate to send us every flaw you spot or every feature you want to see, because this is exactly what beta is for. If you run into bugs, don’t get tilted, just let us know so we can fix them and make this thing better.

We’ll keep everyone updated and fully in the loop throughout the beta.


# How it works

updating ...


# Swap API

updating ...


# Roadmap

```
// Last update: 13 Apr 2026
```

Blockchain is a living construct, so staying up to date is crucial.

The roadmap is constantly updated in terms of the development of the project. We recommend that you visit this page frequently to keep track of changes.

***

#### `Hera x Solana [hera.ag]`

* [x] Initiation of chain research and testing processes
* [x] Improvements required for migration
* [x] Upgrade of new v3 modules
* [x] Configuration of the Hera v3
* [x] Complete rewrite of the routing algorithms from scratch
* [x] Optimization and management of the AI agents
* [x] Interoperability improvements
* [x] Building the offchain architecture and setting up Kubernetes
* [x] Starting the training of the AI-native protocol
* [x] Core: Release Hera.ag Interface
* [x] Core: Launch Hera v3 beta - \[beta.hera.ag] ✅
* [ ] Completing the training of the AI-native protocol and integrating it
* [ ] Preparation of contracts
* [ ] Improvements for fee model
* [ ] Addition of security layers
* [ ] Official audit for final smart contracts
* [ ] Core: Hera v3 on mainnet (Solana) for hera.ag
* [ ] Providing public and enterprise API access

***

#### Planned Developments:

* [ ] Features: AI Powered VaultManager
* [ ] Hera: Release Pathfinder-VM for Developers
* [ ] Core: Limit Order Protocol for Solana & EVMs
* [ ] Hera: Governance & DAO

#### Ongoing Developments:

* [ ] Features: Hera Analytics Dashboard
* [ ] Core: Hera V3 deployment - all major EVMs

#### Interchain Stage:

* [ ] Features: Interchain Messenger Protocol
* [ ] Launch: Emporia SDK v2.0&#x20;
* [ ] Features: Limit Order Aggregation
* [ ] Launch: Interchain dApp UI
* [ ] Core: **Interchain** Dex Aggregator ✨

***

#### H1 / 2026

* [x] Core: Quote & Request Sequencer w AWS
* [x] Upgrade: AI integration into the RS/QS
* [x] Upgrade: Deep Search Model for Solana
* [x] Completion of liquidity sources
* [x] Core: Dynamic Pathfinder
* [x] UI development and improvements

#### H1 / 2025

* [x] Hera Rebranding Release
* [x] New Landing Website Deployment
* [x] Announcement of the New Hera Vision
* [x] Core: Low Level Optimization for V3

#### H2 / 2024

* [x] Core: Internal RPC Aggregator *(multichain support)*
* [x] Core: Offchain Load Rebalance Modules (+AI)
* [x] Core: Homogeneous Liquidity Approach
* [x] Features: Token Quality Detector *<mark style="color:blue;">for v3 UI</mark>*

#### H1 / 2024

* [x] Core: Rebuilding Pathfinder Arch from Scratch (V3)
* [x] Upgrade: LLM Core Upgrade *<mark style="color:blue;">for Interchain</mark>*
* [x] Core: Data Management API *<mark style="color:blue;">for Interchain</mark>*
* [x] Features: Dynamic Liquidity Management Robot (Beta)

#### Q4 / 2023

* [x] Research: Interchain Compatibility
* [x] Core: Onchain Data Optimization *<mark style="color:blue;">for Interchain</mark>*
* [x] Feature: New Generation Price Aggregator *<mark style="color:blue;">for Interchain</mark>*
* [x] Core: New HeraOFT Token Deployment
* [x] Features: Omnichain Staking Portal
* [x] Features: Bridge Portal
* [x] Upgrade: Update HCA Modules *<mark style="color:blue;">for Interchain</mark>*

#### Q3 / 2023

* [x] Core: Integration of Hera into New Liquidity Sources
* [x] Core: Messenger Protocol Development (V3)
* [x] Research: Using LayerZero for Interchain
* [x] Upgrade: Deep Search Model (V3)
* [x] Research: Double-sided Messenger and Transactions

#### Q2 / 2023

* [x] Core: Upgrade Hera Core to v2.7 (beta)
* [x] Core: Upgrade HCA Modules to v3.0
* [x] Launch: Arbitrum Release
* [x] Launch: Hera Aggregator on Arbitrum (Pathfinder: v2.7.5)
* [x] Core: Metis Release Upgrade (Pathfinder: v2.7.5)
* [x] Core: Offchain Scaling Modules Update
* [x] Core: AI Training Upgrades *(0bcf201d)*

#### Q1 / 2023

* [x] Core: Upgrade HCA Modules to v2.0
* [x] Core: AI-Pathfinder v2.5 Upgrade
* [x] Core: Major-II Update for Offchain Load-Balancer
* [x] Core: Upgrade Executor Contracts
* [x] Launch: Hera Aggregator v2.5 'Beta' on Metis

#### Q4 / 2022

* [x] Staking Portal: Update Single Staking Pool
* [x] Core: EmporiaSDK - Hera Swagger API Release
* [x] Core: Pathfinder Minor-II Update
* [x] Features: ChainFinder by Hera Rebuilt

#### Q3 / 2022

* [x] Core: RPC Model Upgrade
* [x] Live: New Website and Docs
* [x] Audit: Hera Aggregator V2 with HashEx
* [x] Upgrade: AI Powered Pathfinder
* [x] Core: New AMM Integrations
* [x] Launch: Hera Aggregator v2 on Metis:tada:

#### Q2 / 2022

* [x] Hera Dex Aggregator Launch :tada:
* [x] Launch: Swap Distribution Flow
* [x] Launch: Staking Portal
* [x] Staking Portal: Hera Single Staking

#### Q1 / 2022

* [x] Branding Creation
* [x] Live: Website and Docs :tada:
* [x] Establishment of the Early Community
* [x] Smart Contracts and Multihops ready
* [x] Testnet: Hera Dex Aggregator
* [x] Event: Hera Token Seed & Private Sale
* [x] Audit: Hera Aggregator V1 with Armors
* [x] Event: Hera Token Public Sale
* [x] Launch: Hera Token


# Trade Mining

AI Driven Trade Mining

Hera is the first to develop a new abstraction layer of economic incentive for its end users. This is made possible by superior rates sourced from the combination of chainfinder data retrieval fed into the [AI Pathfinder](/features/ai-powered-pathfinder) as a data source. Such technology has enabled the collection of a sub fractional fee structure which is distributed to its ecosystem and participants.

Unlike proof of work, this new age mining model can be facilitated on gas optimized Layer2s as well as Layer1s. As each trade is processed by the composability of this defi front end, which scours all major liquidity networks on all major chains, funds are collected and forwarded to the home treasury on Metis chain. The staking portal’s APY is reflexive based on a couple factors.

APY and trade mining difficulty influences:

* Staking Participation
* Revenue Generated

In the case of diminished APY, it is important to realize that Hera is a scarce asset and that its inflation rates can drop lower than some major proof of work tokens. Trade mining difficulty over time will increase as the available Hera that is tradeable on the open market reduces.

This concept is analogous to the possibility of mining on lesser hardware in days past.


# Staking Portal

Hera Finance has an A.I. assisted VaultManager that controls protocol revenue collected from all supported chains. Proceeds from swap transactions are used to develop and manage Hera's ecosystem. At the same time, a portion of all revenue can be transferred by the VaultManager based on recommendations from artificial intelligence to Hera Token ($HERA) holders through various methods.

Token buybacks are made possible with protocol revenue earned through exchange fees. Purchased tokens can then be burnt or added to the staking pool as a reward so that the holders can earn real yield.

Staking is a utility that allows Hera token holders to share in socialized protocol revenue.

Functionality Explained:

* **Claim:** Collects earned yield and sends it to your wallet
* **Compound:** Collects earned yield and adds it to your staked base principal.
* **Auto Compound:** Coming soon...
* **Staking Period:** The set time window rewards are obtainable. Date extensions are made regularly
* **HeraPower:** (Under Development): Participants will receive swap fee reductions based on their level of interaction and commitment to the ecosystem. This feature is exclusive to Metis Layer2.

***

### Move: New Omnichain Staking Portal ✔

{% embed url="<https://portal.hera.finance>" %}

Details for new staking portal 👇

{% content-ref url="/pages/GBVoocKn2UQIRIqljTda" %}
[Omnichain Staking](/general/omnichain-staking)
{% endcontent-ref %}

{% hint style="info" %}
Old Staking Portal: [<mark style="color:green;">**staking.hera.finance**</mark>](https://staking.hera.finance/)\
Stake your tokens to earn real yield!
{% endhint %}


# Omnichain Staking

Introducing the omni-chain Hera Staking Portal!&#x20;

The $HERA staking model has now completely transformed and can be used independently across networks. With Hera Token's OFT upgrade, its dependency on specific chains has been reduced, creating a model that can expand to all networks. If Hera Token is deployed to a new chain, staking will be available shortly.

The new staking model is building on LayerZero, and the interchain messenger protocol is working seamlessly. Like OFT contracts, the staking protocol is distributed and managed from the Metis chain.

Function definitions and details:

* **Stake:** You can stake your Hera Tokens on one of the active chains.
* **Unstake:** You can withdraw your assets from the staking pool.
* **Claim:** Use the claim function to transfer your staking rewards to your wallet.
* **Compound:** It's a quick solution to claim and restake your staking rewards.
* Some more features coming soon ...

**Notice:**&#x20;

Metis is defined as the main chain for staking pools. So, if you stake Hera Tokens on other networks, the tokens will be moved to the Metis network after communicating with proxy and bridge contracts. During this process, gas/tx fees and transaction times may vary due to the involvement of bridge contracts. The same considerations apply to unstaking, claiming, and compounding. Therefore, if you want to save time and fees, you can continue to use the staking portal on Metis.

You will use the existing token for staking on Metis, while for new networks introduced with the OFT expansion, tokens with ownership of the OFT token contract will be valid.

***

{% embed url="<https://portal.hera.finance>" %}

#### Omnichain Staking Contracts

<table><thead><tr><th width="276">Name</th><th>Address</th></tr></thead><tbody><tr><td>HeraStakingProxy</td><td>0x1a404ca2f355141EB9Ef1d5fe872bFC8511f19e1</td></tr><tr><td>HeraStakingLocal</td><td>0x9abB8642ab4B184F2a56340C2766cdc0f357500E</td></tr></tbody></table>


# Audits

**Your security is our priority!**

An independent audit is always important.\
Now, **Hera Aggregator V2** upgrade has been audited by [**HashEx**](https://hashex.org)**.**

{% embed url="<https://github.com/heraaggregator/HeraAggregatorV2-Contracts>" %}

### <mark style="color:green;">Active: Hera Aggregator V2 Contracts</mark> <a href="#undefined" id="undefined"></a>

Audit results: <mark style="color:green;">**Passed**</mark> <img src="/files/KmL6VRS36yLLJD1PzQSS" alt="" data-size="line">

* HeraAggregatorV2 (Router): **Passed** <mark style="color:green;">✅</mark>
* HeraFeeSequencer: **Passed** <mark style="color:green;">✅</mark>
* HeraExecutor: **Passed** <mark style="color:green;">✅</mark>
* ExecutorManagement: **Passed** <mark style="color:green;">✅</mark>
* Queen: **Passed** <mark style="color:green;">✅</mark>

**Audit Reports:**&#x20;

{% file src="/files/OD2Yuoquk1otqCI339oS" %}
HeraAggregatorV2 Audit Report - HashEx
{% endfile %}

{% hint style="success" %}
Also, check Hera Aggregator V2 audit reports page in HashEx website -> <https://hashex.org/audits/conducted-audits/319>
{% endhint %}

### Old: Hera Aggregator V1 Contracts

Audit results: Passed ✅

* Hera Aggregator Contract ✅
* Fee Organizer Contract ✅

**Check audit reports:**

Hera Aggregator Router: 0xAfCB0803F96dC1e9768d14ce55b1a46b26deb24c
\\

Proof: <http://odex.vip/?sign=a3a99d09d0c20d4306da1ca6daf835b7>

{% file src="/files/SklN2J05akV7Rn7javVF" %}
Aggregator Router Contract
{% endfile %}

Hera Fee Organizer: 0xff2e95d887c426d724B3A873fe33D554A10f2fA5\\

Proof: <http://odex.vip/?sign=8eba4e3e16e6e5a1fd8a7147c829d69e>

{% file src="/files/Awkyv2zX4ybjfibaR9m6" %}
Fee Organizer *Contract*
{% endfile %}


# Token Overview

Hera Token is the governance and utility token of Hera Finance.

We believe in a more active Hera Token usage model. We have done so by creating usage areas within our entire ecosystem. Being a decision maker in the management of the project and sharing protocol revenues is the beginning. This is only one of the first stages for token usage areas.

### Token Details

Symbol: **HERA**\
Name: **Hera Token**\
Chain: **Metis**\
Token Contract: **0x6F05709bc91Bad933346F9E159f0D3FdBc2c9DCE**\
Explorer: <https://explorer.metis.io/token/0x6F05709bc91Bad933346F9E159f0D3FdBc2c9DCE>

**Hera Token now live on Ethereum, please check new token details:**

{% content-ref url="/pages/wKHwkWSxBA5TgG9jmfqN" %}
[Hera OFT Token](/hera-token/hera-oft-token)
{% endcontent-ref %}

### OFT Token Details

Symbol: **HERA**\
Name: **Hera Token**\
Active Chains: **Ethereum**\
Token Contract: 0xA2c2C937333165d4c5f2dC5f31a43E1239FeCfeB\
Explorer: <https://etherscan.io/token/0xA2c2C937333165d4c5f2dC5f31a43E1239FeCfeB>

***

#### Hera Token - Utility Areas

* Share protocol revenues using the Staking Portal
* Participate in the governance of the project (DAO)
* Swap fee reduction -soon-
* Earning airdrops based on dex aggregator usage -soon-


# Hera OFT Token

The Hera OFT Token is a token model that is built and deployed on LayerZero. It is linked to the token on Metis and can be deployed to other chains as desired. The existing token contract will be valid on the Metis chain, and the newly deployed tokens alongside will utilize the OFT contract. This process confirms that the token contract on Metis will not change.

In the initial stage, the Hera OFT Token has been deployed to Ethereum and can be expanded to other chains supported by LayerZero.

The token information for Hera Token on Metis will remain unchanged, and the contract addresses for Hera Token deployed on all networks, including Ethereum, will be the same as the OFT contract. The management of all tokens will be done on the Metis side.

Additionally, a bridge has been launched with the Hera OFT Token to enable asset transfers between chains.

### OFT Token Details

Symbol: **HERA**\
Name: **Hera Token**\
Active Chains: **Ethereum**\
Token Contract: 0xA2c2C937333165d4c5f2dC5f31a43E1239FeCfeB\
Explorer: <https://etherscan.io/token/0xA2c2C937333165d4c5f2dC5f31a43E1239FeCfeB>

#### Hera OFT Token Contracts

<table><thead><tr><th width="259">Name</th><th>Address</th></tr></thead><tbody><tr><td>HeraOFTToken</td><td>0xA2c2C937333165d4c5f2dC5f31a43E1239FeCfeB</td></tr><tr><td>HeraTokenProxy</td><td>0x9C598Da94c840147C9a1eaBE1aE8DF750674ddF6</td></tr></tbody></table>

Buy Hera Token 👇

{% content-ref url="/pages/e96E1pkE47oMJT8QdNid" %}
[Buy Hera Token](/hera-token/buy-hera-token)
{% endcontent-ref %}

{% hint style="danger" %}
*Please beware of fake tokens and refrain from interacting with any unofficial contracts!*
{% endhint %}


# Tokenomics

#### Our Tokenomics and Vesting Details <a href="#our-tokenomics-and-vesting-details" id="our-tokenomics-and-vesting-details"></a>

![Hera Finance Tokenomics - Updated : "31.12.2022"](/files/3mrQ3geSRY5xdV9ftxiL)

<table><thead><tr><th width="178">Tokenomics</th><th align="center">Supply %</th><th width="122" align="center">Tokens</th><th width="374">Vesting</th></tr></thead><tbody><tr><td>Public Sale</td><td align="center">10,00%</td><td align="center">1.000.000</td><td>40% at TGE, then linear vesting for 3 months</td></tr><tr><td>Seed Sale</td><td align="center">5,00%</td><td align="center">500.000</td><td>40% at TGE, then linear vesting for 3 months</td></tr><tr><td>Private Sale</td><td align="center">4,00%</td><td align="center">400.000</td><td>20% at TGE, then linear vesting for 8 months</td></tr><tr><td>Team</td><td align="center">9,00%</td><td align="center">900.000</td><td>0% at TGE, then linear vesting for 36 months</td></tr><tr><td>Hera Ecosystem</td><td align="center">10,00%</td><td align="center">1.000.000</td><td>1m cliff, then vesting for 36m</td></tr><tr><td>Treasury</td><td align="center">40,00%</td><td align="center">4.000.000</td><td>DAO Desicion - Locked</td></tr><tr><td>Marketing &#x26; Development</td><td align="center">9,00%</td><td align="center">900.000</td><td>1m cliff, then vesting for 36m</td></tr><tr><td>Partners &#x26; Advisors</td><td align="center">3,20%</td><td align="center">320.000</td><td>1m cliff, then vesting for 36m</td></tr><tr><td>Rewards &#x26; Grants</td><td align="center">1,80%</td><td align="center">180.000</td><td>1m cliff, then vesting for 36m</td></tr><tr><td>Liquidity Incentives</td><td align="center">8,00%</td><td align="center">800.000</td><td>62,5% at TGE, then vesting for 24m</td></tr><tr><td>Total:  </td><td align="center">100,00%</td><td align="center">10.000.000</td><td></td></tr></tbody></table>

<details>

<summary>Circulation Supply API</summary>

URL: <https://supply.hera.finance/v1.0/supply/circulation>

</details>

#### Token Release Schedule

![Hera - Token Release Schedule](/files/Q4umHCykbC4fwqN6jg9d)

#### Token Release Schedule

![](/files/vMgCDWYKzfHqnRqv7tAl)


# Buy Hera Token

#### Hera Token Details:

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td></td><td><strong>Hera Token on Metis</strong></td><td></td><td><a href="/pages/c8SVwzySvpHNuUPT7HFp">/pages/c8SVwzySvpHNuUPT7HFp</a></td><td></td></tr><tr><td></td><td><strong>Hera Token on Ethereum</strong></td><td></td><td><a href="/pages/wKHwkWSxBA5TgG9jmfqN">/pages/wKHwkWSxBA5TgG9jmfqN</a></td><td></td></tr></tbody></table>

#### Buy Hera Token now on Metis & Ethereum 👇

<table data-full-width="true"><thead><tr><th width="153" align="center">Chain</th><th width="141" align="center">App</th><th width="255" align="center">URL</th><th>Contract Address</th></tr></thead><tbody><tr><td align="center">Metis</td><td align="center">Hera</td><td align="center"><a href="https://app.hera.finance/"><mark style="color:green;"><strong>app.hera.finance</strong></mark></a></td><td>0x6F05709bc91Bad933346F9E159f0D3FdBc2c9DCE</td></tr><tr><td align="center">Ethereum</td><td align="center">Uniswap</td><td align="center"><a href="https://app.uniswap.org/"><strong>app.uniswap.org</strong></a></td><td>0xA2c2C937333165d4c5f2dC5f31a43E1239FeCfeB</td></tr></tbody></table>


# About OFT Upgrade

This update covers three key features. First off, we'll be deploying the OFT Token. Don't worry, Metis' existing token address and liquidity won't change. However, we're introducing the Hera Token, set to deploy on Ethereum and subsequent chains, rocking a single contract address. After the Ethereum expansion, get ready for a HERA/USDC pool on Uniswap v3. All contract addresses will be revealed post-announcement; stick to the official details to avoid any confusion.

Now, let's talk about the OFT burn/mint feature. It's designed to expand an existing token, and here's the scoop. When the Hera Token hits Ethereum, the supply starts at zero and mints Hera proportional to the tokens bridged from Metis. On Metis, those tokens chill in a Proxy contract. Bridge them to Ethereum, and voila! Tokens burn on the OFT contract, Metis Proxy reimburses. It's a zero-accounting magic trick.

The bridge and inter-chain transactions vary, taking 15s to 4m, depending on each chain's quirks. We'll keep an eye on it and roll updates as needed.

Now, let's talk omnichain staking, the complex beast. No matter which chain you transact from, tokens funnel straight to the Metis chain's contract. Staking from Metis? Direct drop into the pool. Other chains? After bridging. It's an omni-staking pool, serving any future chain expansions. It operates independently across chains. We've got four main functions: stake, unstake, claim, and compound. All real-time for Metis, variable for OFT chains.

***

**Got questions?** Here are some FAQs 👇

* If your tokens are on Metis and you want to stake, no need to bridge. Start staking directly from the Portal. OFT chains are a secondary option.
* We've crafted a fresh portal for bridge and staking. Ditch the old frontend for the new portal. If you've staked in old pools, unstake there and hop on the new portal. We'll keep the old frontend alive for a bit.
* After the bridge cooldown, OFT tokens will mint to your wallet from the 0x000...00 address. No need for a secondary claim or mint action.
* Initial liquidity on Uniswap in Ethereum. Balanced liquidity shift from Metis pools—HERA and USDC—to Ethereum. Gradually optimized.
* Post-OFT upgrade, you can still enjoy Hera features on Metis without using any bridges.
* Portal functions on Ethereum may see high fees at times. For gas savings, it's smarter to use these features on Metis.
* V3 update pending, so Hera Dex Aggregator isn't available for Hera trades on Ethereum. Use Uniswap or other swap protocols for now.


# LayerZero

### Hera Contracts on LayerZero <a href="#undefined" id="undefined"></a>

We have listed the contract addresses for tokens and protocols deployed on LayerZero here.

<table><thead><tr><th width="263">Name</th><th>Contract Address</th></tr></thead><tbody><tr><td>HeraOFT Token</td><td>0xA2c2C937333165d4c5f2dC5f31a43E1239FeCfeB</td></tr><tr><td>HeraTokenProxy</td><td>0x9C598Da94c840147C9a1eaBE1aE8DF750674ddF6</td></tr><tr><td>HeraStakingProxy</td><td>0x1a404ca2f355141EB9Ef1d5fe872bFC8511f19e1</td></tr><tr><td>HeraStakingLocal</td><td>0x9abB8642ab4B184F2a56340C2766cdc0f357500E</td></tr></tbody></table>

{% content-ref url="/pages/wKHwkWSxBA5TgG9jmfqN" %}
[Hera OFT Token](/hera-token/hera-oft-token)
{% endcontent-ref %}

{% content-ref url="/pages/GBVoocKn2UQIRIqljTda" %}
[Omnichain Staking](/general/omnichain-staking)
{% endcontent-ref %}


# Metis

### Hera Aggregator Contracts on Metis <a href="#undefined" id="undefined"></a>

**Chain:** Metis\
**Version:** 2.7.7 Beta

<table><thead><tr><th width="263">Name</th><th>Contract Address</th></tr></thead><tbody><tr><td>Hera Token</td><td><a href="https://explorer.metis.io/token/0x6F05709bc91Bad933346F9E159f0D3FdBc2c9DCE">0x6F05709bc91Bad933346F9E159f0D3FdBc2c9DCE</a></td></tr><tr><td>HeraAggregatorV2: Router <mark style="color:green;">*</mark></td><td><a href="https://explorer.metis.io/address/0x0000000000924fb1969e719edeD2feD54AFB183A">0x0000000000924fb1969e719edeD2feD54AFB183A</a></td></tr><tr><td>Fee Sequencer <mark style="color:green;">*</mark></td><td><a href="https://explorer.metis.io/address/0x000000fEe322aAA0a5772e7F92DE10180f9fAB15">0x000000fEe322aAA0a5772e7F92DE10180f9fAB15</a></td></tr><tr><td>Hera Executor <mark style="color:green;">*</mark></td><td><a href="https://explorer.metis.io/address/0xd51732b8A666831688D0bb20c7907F11119729bF">0xd51732b8A666831688D0bb20c7907F11119729bF</a></td></tr><tr><td>Staking Portal v2 <mark style="color:green;">*</mark></td><td><a href="https://explorer.metis.io/address/0x2508965Ec75498c451B9e325B7A09288f27762D8">0x2508965Ec75498c451B9e325B7A09288f27762D8</a></td></tr><tr><td>Deployer MultiSig</td><td><a href="https://explorer.metis.io/address/0xE089A4EFa2dA690f21a3ea682cb36Dc4AC007995">0xE089A4EFa2dA690f21a3ea682cb36Dc4AC007995</a></td></tr><tr><td>HeraSecurity Timelock</td><td><a href="https://explorer.metis.io/address/0x6da6317e819d6a19c28f0a59291F85FB41b02225">0x6da6317e819d6a19c28f0a59291F85FB41b02225</a></td></tr><tr><td>Router: HeraAggregatorV1 <mark style="color:orange;">*</mark></td><td><a href="https://explorer.metis.io/address/0xAfCB0803F96dC1e9768d14ce55b1a46b26deb24c">0xAfCB0803F96dC1e9768d14ce55b1a46b26deb24c</a></td></tr><tr><td>Executor <mark style="color:orange;">*</mark></td><td><a href="https://explorer.metis.io/address/0x852d1fDd3982D8e21145845af74Db7ae37D1F383">0x852d1fDd3982D8e21145845af74Db7ae37D1F383</a></td></tr><tr><td>Executor <mark style="color:orange;">*</mark></td><td><a href="https://explorer.metis.io/address/0xB4801c4407d0D967eAF10981fB689C9DA50a7127">0xB4801c4407d0D967eAF10981fB689C9DA50a7127</a></td></tr></tbody></table>

> <mark style="color:green;">\*</mark>: Live     <mark style="color:orange;">\*</mark>: Out-of-date\
> Last update: Nov-24 2023


# Arbitrum

### Hera Aggregator Contracts on Arbitrum <a href="#undefined" id="undefined"></a>

**Chain:** Arbitrum\
**Version:** 2.7.7 - Beta

<table><thead><tr><th width="263">Name</th><th>Contract Address</th></tr></thead><tbody><tr><td>HeraAggregatorV2: Router</td><td><a href="https://arbiscan.io/address/0x0000000000924fb1969e719edeD2feD54AFB183A">0x0000000000924fb1969e719edeD2feD54AFB183A</a></td></tr><tr><td>Fee Sequencer</td><td><a href="https://arbiscan.io/address/0x699127412aC7304F3897F410974677F747f2e9DF">0x699127412aC7304F3897F410974677F747f2e9DF</a></td></tr><tr><td>Hera Executor</td><td><a href="https://arbiscan.io/address/0x1bd717c5cDd133E1985628e1e194B0ED9C9047E7">0x1bd717c5cDd133E1985628e1e194B0ED9C9047E7</a></td></tr><tr><td>Deployer MultiSig</td><td><a href="https://arbiscan.io/address/0xCA0dfC4e1935fFa0019AA760DB0564b8CDD96e6E">0xCA0dfC4e1935fFa0019AA760DB0564b8CDD96e6E</a></td></tr><tr><td>HeraSecurity Timelock</td><td><a href="https://arbiscan.io/address/0xCE3759244610Fc69F95db143338c9ED0Dc356fd0">0xCE3759244610Fc69F95db143338c9ED0Dc356fd0</a></td></tr></tbody></table>


# Solana

### Hera Aggregator v3 Contracts on Solana <a href="#undefined" id="undefined"></a>

**Chain:** Solana\
**Version:** 3.0 - beta

<table><thead><tr><th width="263">Name</th><th>Program Type</th></tr></thead><tbody><tr><td>Router</td><td>coming soon ...</td></tr></tbody></table>


# Emporia SDK

{% content-ref url="/pages/gmjP0zs9gPK58DtZqMbi" %}
[Overview](/developers/emporia-sdk/overview)
{% endcontent-ref %}

{% content-ref url="/pages/CTkSruqUqo8eHV3Qyp5F" %}
[Swagger API](/developers/emporia-sdk/swagger-api)
{% endcontent-ref %}

{% content-ref url="/pages/Chd1v0Iw217twz0jroSR" %}
[Swagger API (Arbitrum)](/developers/emporia-sdk/swagger-api-arbitrum)
{% endcontent-ref %}

{% content-ref url="/pages/SHcnY4HOXpOrLC0o4qO4" %}
[Examples](/developers/emporia-sdk/examples)
{% endcontent-ref %}


# Overview

{% hint style="danger" %}
Datasets providing access to the SDK have not been updated for a long time. Please note that the SDK may not function properly until the completion of the V3 upgrade!
{% endhint %}

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

Emporia got its name from Greek Mythology and means "the place where merchants traded."

EmporiaSDK is built on top of Hera Dex Aggregator and is recommended for developers or traders. Project developers can quickly incorporate Hera Aggregator into their ecosystem and start using it instantly.

Swagger API gives access to 3rd parties to find the best swap rate. This enables integrations to respond in the fastest way and streamline the process phase all the way to the point of being ready for swap. Some of the example paths are allowance, quote, and swap. Get started now to integrate easily!

> Get started now to integrate easily!&#x20;

{% content-ref url="/pages/CTkSruqUqo8eHV3Qyp5F" %}
[Swagger API](/developers/emporia-sdk/swagger-api)
{% endcontent-ref %}

{% content-ref url="/pages/Chd1v0Iw217twz0jroSR" %}
[Swagger API (Arbitrum)](/developers/emporia-sdk/swagger-api-arbitrum)
{% endcontent-ref %}


# Swagger API

EmporiaSDK Swagger API - v1.1

{% hint style="danger" %}
Datasets providing access to the SDK have not been updated for a long time. Please note that the SDK may not function properly until the completion of the V3 upgrade!
{% endhint %}

## Hera Dex Aggregator - Swap Protocol API

### Metis Mainnet Release

Using Hera Aggregation protocol API, you can find the best route to exchange assets and make the exchange.\
\
Progressing:

1. Lookup addresses of tokens you want to swap, for example ‘0xxx’ , ‘0xxxx’ for USDC -> METIS
2. Check for allowance and if necessary give approval for HeraAggregatorV2 contract to spend token (/allowance)
3. Monitor the best exchange route using (/quote)
4. When you ready use to perform swap (/swap)

{% hint style="info" %}
**EmporiaSDK is now available on Metis Mainnet.** Other chains are coming soon!
{% endhint %}

<details>

<summary><strong>Built with OpenAPI &#x26; Swagger!</strong></summary>

Design, describe, and document your API on the first open source editor supporting multiple API specifications and serialization formats. The Swagger Editor offers an easy way to get started with the OpenAPI Specification (formerly known as Swagger) as well as the AsyncAPI specification, with support for Swagger 2.0, OpenAPI 3.0, and AsyncAPI 2.\* versions.

</details>

### Swagger Paths:

#### Allowance&#x20;

{% openapi src="/files/lqZFMH1uPGH5AyXvwled" path="/allowance" method="get" expanded="true" %}
[EmporiaSDK-Metis-v1-1.json](https://468680357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRPd6E8y8uIj9QOgICwhl%2Fuploads%2F1Ez7x7M8GFPcrisX6sA8%2FEmporiaSDK-Metis-v1-1.json?alt=media\&token=d6b75e97-c3ed-4b3a-b311-8722b3bdc9c0)
{% endopenapi %}

{% code overflow="wrap" %}

```
// Example Query:

GET https://pathfindersdk.hera.finance/allowance?account=0x0000000000000000000000000000000000000000&amount=1000000&tokenInAddress=0xEA32A96608495e54156Ae48931A7c20f0dcc1a21
```

{% endcode %}

#### Quote (Pathfinder)

{% openapi src="/files/lqZFMH1uPGH5AyXvwled" path="/quote" method="get" expanded="true" %}
[EmporiaSDK-Metis-v1-1.json](https://468680357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRPd6E8y8uIj9QOgICwhl%2Fuploads%2F1Ez7x7M8GFPcrisX6sA8%2FEmporiaSDK-Metis-v1-1.json?alt=media\&token=d6b75e97-c3ed-4b3a-b311-8722b3bdc9c0)
{% endopenapi %}

{% code overflow="wrap" %}

```
// Example Query:

GET https://pathfindersdk.hera.finance/quote?account=0x0000000000000000000000000000000000000000&tokenInAddress=0xDeadDeAddeAddEAddeadDEaDDEAdDeaDDeAD0000&tokenInChainId=1088&tokenOutAddress=0xEA32A96608495e54156Ae48931A7c20f0dcc1a21&tokenOutChainId=1088&amount=100000000000000000000&type=exactIn
```

{% endcode %}

#### Swap

{% openapi src="/files/lqZFMH1uPGH5AyXvwled" path="/swap" method="get" expanded="true" %}
[EmporiaSDK-Metis-v1-1.json](https://468680357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRPd6E8y8uIj9QOgICwhl%2Fuploads%2F1Ez7x7M8GFPcrisX6sA8%2FEmporiaSDK-Metis-v1-1.json?alt=media\&token=d6b75e97-c3ed-4b3a-b311-8722b3bdc9c0)
{% endopenapi %}

{% code overflow="wrap" %}

```
// Example Query:

GET https://pathfindersdk.hera.finance/swap?account=0x0000000000000000000000000000000000000000&tokenInAddress=0xDeadDeAddeAddEAddeadDEaDDEAdDeaDDeAD0000&tokenInChainId=1088&tokenOutAddress=0xEA32A96608495e54156Ae48931A7c20f0dcc1a21&tokenOutChainId=1088&amount=100000000000000000000
```

{% endcode %}


# Swagger API (Arbitrum)

EmporiaSDK Swagger API - v2.1

## Hera Dex Aggregator - Swap Protocol API

### Arbitrum Mainnet Release

*Details coming soon!*

{% hint style="warning" %}
**EmporiaSDK is not available on Arbitrum yet!**
{% endhint %}


# Examples

{% hint style="info" %}
Under development!
{% endhint %}


# Tokenomics API

Hera Token Supply API Endpoints

<table data-header-hidden><thead><tr><th width="163.06846656800838"></th><th></th></tr></thead><tbody><tr><td>Circulation Supply</td><td><a href="https://supply.hera.finance/v1.0/supply/circulation">https://supply.hera.finance/v1.0/supply/circulation</a></td></tr><tr><td>Total Supply</td><td><a href="https://supply.hera.finance/v1.0/supply/total">https://supply.hera.finance/v1.0/supply/total</a></td></tr></tbody></table>


# Logo Types

In July 2024, a rebranding effort was undertaken for Hera, and since then, the new logo has been in use. To avoid any confusion, we are also displaying our old logo below.

{% hint style="info" %}
Please take care to keep the original logo in your content.
{% endhint %}

## Hera Logo Assets

<div><figure><img src="/files/WZ1QqvIFzcOnBusj8W2e" alt=""><figcaption></figcaption></figure> <figure><img src="/files/yBZlbqZoMunZuXjiZI2v" alt=""><figcaption></figcaption></figure> <figure><img src="/files/sptkpXMRswn94Fx8CqG1" alt=""><figcaption></figcaption></figure> <figure><img src="/files/dfOnUT0Rk8OQKQg17gvZ" alt=""><figcaption></figcaption></figure></div>

Download the branding package to directly access the logo versions and different file types.

{% file src="/files/rBp6MDo6JCHMAv80Vh4K" %}
New Hera Logo Pack
{% endfile %}

***

#### Pre-July 2024 Logo

![](/files/U7jwW9wkVTu7511wLbqX) ![](/files/SCRtOTkKiLhOMfFOaL1G) ![](/files/xXJs4pxM0rz6LjjfO4c2)

{% file src="/files/1e5IttFEY9806PkBakfE" %}
Pre-July 2024 Logo Pack
{% endfile %}


# Media Assets

In July 2024, a rebranding effort was undertaken for Hera, and since then, the new logo has been in use. To avoid any confusion, we are also displaying our old logo below.

## Hera Logo Assets

<div><figure><img src="/files/WZ1QqvIFzcOnBusj8W2e" alt=""><figcaption></figcaption></figure> <figure><img src="/files/yBZlbqZoMunZuXjiZI2v" alt=""><figcaption></figcaption></figure> <figure><img src="/files/sptkpXMRswn94Fx8CqG1" alt=""><figcaption></figcaption></figure> <figure><img src="/files/dfOnUT0Rk8OQKQg17gvZ" alt=""><figcaption></figcaption></figure></div>

Download the branding package to directly access the logo versions and different file types.

{% file src="/files/rBp6MDo6JCHMAv80Vh4K" %}

## Hera Branding Assets

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

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

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

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

***

### Pre-July 2024 Logo

![](/files/U7jwW9wkVTu7511wLbqX) ![](/files/SCRtOTkKiLhOMfFOaL1G) ![](/files/xXJs4pxM0rz6LjjfO4c2)


# Help

To reach out to us, please use one of the channels of communication listed below. In regards to inquiries/questions, protocol integration requests, to add your token to Hera token list, or anything else; please don't hesitate to contact us. Our team will get back to you as soon as possible.

* DM on Twitter
* Mail to <info@hera.finance>
* PM to Telegram community managers

{% hint style="success" %}
**Attention!** Please don't attempt to get help from non-official groups. Also, no community manager or team member will ever directly message you first.
{% endhint %}