Contract interaction
On this page, you can find information on how to convert your ANTv1 to ANTv2 interacting directly with the smart contract. (For example, if your contract wallet can't send outward transactions).
This page contains technical information. It is provided for advanced users.
TL;DR
From a wallet holding ANTv1, you can upgrade all of its ANTv1 balance into ANTv2 by sending this approveAndCall()
transaction:
The ANTv2Migrator
contract
ANTv2Migrator
contractThe migration contract, deployed to 0x078BEbC744B819657e1927bF41aB8C74cBBF912D
, facilitates the official upgrade of ANTv1 to ANTv2.
When a wallet upgrades its ANT balance through an on-chain interaction with this contract, the following happens:
ANTv2Migrator
pulls the requested amount of ANTv1 from the wallet's balance into its own balanceANTv2Migrator
burns the pulled ANTv1 by transferring it to0x000000000000000000000000000000000000dEaD
From its own balance,
ANTv2Migrator
sends the equivalent amount of ANTv2 back to the wallet
Interacting with the ANTv2Migrator
ANTv2Migrator
approveAndCall()
approveAndCall()
The simplest approach to completing the migration is by sending a single transaction. Calling ANTv1.approveAndCall()
. approveAndCall()
allows you to create an allowance to a contract and spend it in the same transaction.
To create such a call, you may pull out your favourite tool and use the following ABI:
For the purposes of demonstration, I'll use the online ABI encoder provided by HashEx:
![](https://legacy-docs.aragon.org/~gitbook/image?url=https%3A%2F%2F1303901111-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FqkA65ZBta5cBbldyxyst%252Fuploads%252Fgit-blob-bc2f6c29d3702dba8cc006bf468177d0f7a8c2fd%252Fcontract%2520interaction%25201.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=e865e509&sv=1)
For the arguments, use:
_spender
:0x078BEbC744B819657e1927bF41aB8C74cBBF912D
(this is the migration contract's address)_amount
: amount of ANTv1 to upgrade, denominated in wei (i.e. multiply by 1e18 for "decimal-correct" amounts)_extraData
: can be left blank (not used)
Next, take the encoded data:
![](https://legacy-docs.aragon.org/~gitbook/image?url=https%3A%2F%2F1303901111-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FqkA65ZBta5cBbldyxyst%252Fuploads%252Fgit-blob-cd152ae1dd4227b9e4661361cd914800a41cfc30%252Fcontract%2520interaction%25202.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=613fca2e&sv=1)
In the above screenshot, we have specified to only upgrade one (1) ANTv1.
You may now take this data and use it in a transaction where the to
address is 0x960b236A07cf122663c4303350609A66A7B288C0
(this is ANTv1's address).
For example, to use the above data, you would send a transaction with the following data:
For contract-based smart accounts and multisig wallets, they will typically have functions specifying the to
and data
components of a transaction.
Specify those accordingly based on the above output.
If you would prefer to use Etherscan, you may submit the above arguments directly to their ANTv1 contract interface:
![](https://legacy-docs.aragon.org/~gitbook/image?url=https%3A%2F%2F1303901111-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FqkA65ZBta5cBbldyxyst%252Fuploads%252Fgit-blob-dbe7cdd8265760934a43ef246108b1c1337554fa%252Fcontract%2520interaction%25203.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=4fbf53d3&sv=1)
Separate token allowances
If you prefer to not use an approveAndCall()
transaction, you can upgrade in two steps by first creating an allowance (through ANTv1.approve()
) for at least the amount desired to the migration contract at 0x078BEbC744B819657e1927bF41aB8C74cBBF912D
, and then calling one of:
migrate(uint256)
: Allows you to directly specify how much you would like to upgrademigrateAll()
: Assumes you want to upgrade all of your balance (and that you have set an appropriate allowance)
Using an EscrowANTv2Migrator
contract
EscrowANTv2Migrator
contractIn some situations, you may prefer to complete the upgrade without ever creating a token approval and only using vanilla ANTv1.transfer()
interactions.
To do so, first deploy an EscrowANTv2Migrator
configured with your desired recipient of the upgraded tokens and the account allowed to initiate the migration.
Once this contract is deployed, simply transfer ANTv1 into the contract as desired and then call migrate()
to complete the upgrade.
The EscrowANTv2Migrator
contract does not contain logic to return any ANTv1 tokens transferred to it. All ANTv1 tokens transferred to it will be eventually converted to ANTv2 and returned to the configured recipient.
Last updated