Project guide: How to integrate dual distributions with Astroport Generators

Note: This is a technical article aimed at the creators and contributors of other projects on Terra. It summarises the steps necessary to integrate with Astroport’s dual distribution functionality. The text was updated on Nov. 5, 2021 to more accurately describe the ASTRO Generators as distributing governance awards.

What are ASTRO Generators?

The Astroport protocol will have its own governance token, ASTRO, which will also be distributed to Astroport LPs through liquidity mining, as determined by the Astral Assembly governance process.

ASTRO Generators are architected to enable an LP to claim the dual governance awards of both ASTRO and the tokens of the extrinsic DeFi communities associated with the pool (e.g. MIR or ANC) where available.

Dual distributions should benefit both Astroport and third party projects. LPs receive more tokens than they would otherwise (since they’re receiving two tokens). Exposure on Astroport’s Generator UI could garner more liquidity for Terra projects, and LPs will have a better user experience with fewer steps and transactions.

As explained in the Litepaper:

Rather than depositing their Astroport LP tokens in the third-party staking contract directly, LPs can deposit their Astroport LP tokens into one of Astroport’s ASTRO Generators. Through a proxy contract architecture, the ASTRO Generators forward the LP tokens into the relevant third-party staking contract. Because the user is liquidity mining on third-party contracts through an ASTRO Generator, the same LP-tokens can be tracked both by those third-party contracts and Astroport. Therefore, LPs accrue both sets of grants (both ASTRO and the third-party protocol tokens). When an LP wishes to claim these granted tokens, (1) the ASTRO generator transfers the appropriate amount of ASTRO to the LP, and (2) the proxy contract claims the third-party tokens due to the LP and transfers them as well.

This and associated mechanisms are explained fully in the Astroport Litepaper.

How to Integrate with an ASTRO Generator

There are four main steps a project should take:

  1. Ensure your token already has an existing Astroport pool
  2. Create a liquidity mining mechanism to distribute your governance token to LPs in the Astroport pool
  3. Deploy a generator proxy contract specific to your liquidity mining mechanism and Astroport pool
  4. Reach out to the Astrochads via Discord, Twitter or any other channel

We will go into detail for each below.

Note: prior to Astroport’s launch you will need to be added to the git repository in order to see the example contracts. Reach out to the community on Discord with details of your project in order to be added.

1. Ensure your token already has an existing Astroport pool

If a suitable pool doesn’t exist for the relevant asset pair then one will need to be created. Pool creation is permissionless.

See here for the relevant documentation:

Or alternatively reach out to the Astroport contributors.

2. Create a liquidity mining mechanism

Astroport provides an example generator proxy contract compatible with the Mirror staking contracts. For new projects that want their liquidity mining mechanism to integrate with Astroport generators, the simplest path is basing your liquidity mining contracts on the Mirror design.

Alternatively Anchor’s liquidity mining mechanism is simpler and should not require big changes to the example generator proxy contract.

Generator integration is still possible if you have a different liquidity mining mechanism but it requires a custom generator proxy contract in the next step.

3. Deploy a generator contract

The generator proxy contract acts as an adaptor between the ASTRO generator and your liquidity mining mechanism. You can create and deploy this yourself.

Astroport provides a proxy template which you can customise:

Astroport also provides a full example proxy contract designed for the Mirror liquidity mining mechanism:

If you plan to deploy your own contract, please make sure you read and understand Mirror’s contracts, and feel free to contact the Astroport contributors if you have any questions.

4. Reach out to the Astrochads

The final step is for the new proxy contract to be registered with the generator. Eventually this will be done via a governance vote, but for now a multisig transaction is required.

Reach out to an Astroport contributor on Discord or any other channel and they can add you to the appropriate group to discuss your contract.

Onwards and upwards

With benefits for DEXes, third party projects and LPs, we believe dual distributions will become an industry standard. We look forward to connecting with other projects in the Terra ecosystem to push the concept forward and help Astroport bring massive liquidity to all Terra tokens and beyond.

DISCLAIMER: This article does not constitute investment advice. Before interacting with Astroport, review the project disclaimers here.

Follow Astroport on twitter to receive all of the latest transmissions from the fringes:




An automated, decentralised exchange protocol on the Terra blockchain.

Love podcasts or audiobooks? Learn on the go with our new app.

Recommended from Medium


Muckis — crackme#1

📝Collaborative governance with HyperDAO’s Supernode📝

Aprendizajes de la NASA sobre Desarrollo de Software Crítico

The Advantages of Using Kafka for Real-Time Data Streams

Developing a Production Realtime Application on RethinkDB

Can’t connect to local MySQL server through socket ‘/var/run/mysqld/mysqld.sock’

Voice-driven mobile apps with Ionic and the speech recognition cordova plugin

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store


An automated, decentralised exchange protocol on the Terra blockchain.

More from Medium

THORSynths are here: Mint, Redeem, and Swap Synthetic assets

Stake-to-Subscribe (S2S) and the Future of PoS Validators

CT enters Warzone, Terra buidls

THORChain Address Clusters