@digix/etc-redemption0.0.11 • Public • Published
Digix ETC Redemption Process
This repository contains contracts and scripts for the deployment and execution of Digix's proposed ETC redemption mechanism.
Activation block is set to 3800000. DGDR on the ETC will be credited to DGD holders on this block shortly after it passes.
- READ THIS: DGDR to ETC User Guide
- Spectrum Dapp UI
- View Contract Code
- ETC Faucet (1-time use for DGD holders only): https://digixparity04.digix.io/faucet/0x_YOUR_ADDRESS_HERE
- 30/05 - [CH] Updated guide with deployed address
- 30/05 - [AE] No longer using MultiSig wallet contract to avoid potential 0-day exploits
Digix recently outlined a proposal to allow DGD holders to redeem ETC. Since this proposal, with feedback from the DGD holder community, it has evolved into a less complex redemption process (by removing the voting step). This repository has been produced to describe and provide all the tools needed perform this updated redemption process.
The proposed contracts and process details are presented to the community for discussion, questions and criticisms. The current codebase is subject to change pending code review.
Changes to Proposal v1
This updated includes some changes to the previously announced proposal - please view the previous version for additional context.
No More Voting
The main change is that we've decided to skip the carbonvote step. After gauging sentiment from DGD holders (including 'whales' and the general DGD community), there was no resistance to the principal of returning ETC to DGD holders. Therefore we have determined it would be better to forego the voting process as it would yield additional development time and reach a non-controversial already-known outcome (the motion to refund ETC to DGD holders).
ETC Redemption Contract
The redemption contract allows users to claim an ETC balance by redeeming tokens that are issued to them automatically on the ETC chain.
Each redemption token represents 1:1 equivalent of DGD balances. These redemption tokens are known as
DGDR, which is an EIP20 token.
To claim ETC, holders of
DGDR should call a method on the
DGDR contract to burn their holdings in return of an ETC value. At the point of burning, the balance of
DGDR drops to 0, and a fixed rate will be used to convert this balance into ETC.
For example, a user has 100 DGD, gets 100
DGDR, and burns it for ~22.3 ETC.
The conversion rate to ETC used will be close to 100% of the original ETC pool, but with an additional fee deduced from the pool based on the gas used for testing, deployment and minting (which could amount to around a few USD cents per user).
See Redemption Token Contract section for more details.
A 'top-up' system will be used when passing funds to the redemption contract to reduce the effects of any unforeseen exploits. Batches of 100,000 ETC (?) will be added to the redemption contract as required (and topped up as the remaining balance reaches 10,000).
The ETC batches will be kept on separate keys and transferred to the redemption contract when the DGDR reserve balance reaches near the highest unclaimed DGDR balance.
Additional End User Resources
As development focus shifted a carbonvote process to the redemption contract, some additional end-user requirements were identified to enable DGD holders to perform the redemption on the ETC chain with ease.
- Instructions for MEW / CLI / Mist
- Public ETC RPC Node (compatible with MEW / Spectrum / web3-console)
- Instructions for installing local ETC Node (as fallback for public node)
- Spectrum UI for redemption process (on ETC chain)
- Best practices for hardware / offline signing
The new redemption process is split roughly into the following steps:
This stage is managed by DigixGlobal and will not require interaction from DGD holders
- Public announcement of snapshot and activation block made
- After the snapshot block, redemption contract is deployed to ETC and balances are minted
- Balances published to IPFS, confirmed by script & community
- Activation block is set, admin changed to new (more secure) key
- DGDR is funded (using top-up keys)
- Activation block occurs (within 24 hours)
After the activation block is reached, users with a
DGDR balance will be able to proceed with redemptions; (optionally trading and then) burning their
DGDR tokens in return for ETC using one of the following ways:
- Use a local ETC Node
- Use MEW + RPC Node
- Depositing to an exchange during the snapshot block
- Use Spectrum Alpha + RPC Node
Note for DGD holders using smart contracts for holding
For those who hold their DGD balances in a contract address that may does not exist on ETC chain, two options are provided:
- Ensure the contract can execute other contracts (to call the redeem method)
- Move the DGDs into a regular address before the Snapshot Block
- Move the DGDs into an Exchange before the Snapshot Block
- Contact Digix to manually process redemption
Note to Exchanges
After discussing how exchanges can optimally engage with the redemption process, we identified the following general pattern that should be adopted by exchanges to ensure an easy:
- Before the snapshot block, disable deposits, redemptions and trading of DGD
- On the snapshot block, move DGD into a standard account
- After the activation block, call the redeem method on the token
- Credit DGD holders with their proportion of the redeemed ETC
- Re-open trading, deposits and redemptions
After 1 Year
DGD holders perform a vote to determine action on unclaimed ETC
- Extend the balance 1 year
- Extend the redemption indefinitely (switch owner to
- Other options to be determined by DGD holders
Redemption Token Contract
For full documentation on the methods please see the contract docs. The redemption contract is an extended EIP20 tradable token with the additional features:
- Owned by one admin
- Admin can transfer ownership
- Admin can control the activation block / mint tokens / drain contract
- Disables transfers / redemptions until a specific (activation) block is reached
- Admins can fund (ETC) value to the contract
- Admins can set the rate of ETC redeemed for each token
- Users with a balance can call 'redeem' (or proxy via default function) to burn balance in return for ETC
- The redeem function can be passed a different address (uses
msg.senderif using the default function)
A test suite with 100% method coverage has been added to this repository under
./test, they can be run with
This repository contains a series of scripts to facilitate the backend process.
The the parameters can be configured in
||Get the Snapshot (run this with multiple clients & Etherscan)|
||Confirm the Balance Reports are the same|
||Publish report to IPFS|
||Migrate the Contracts to ETC Chain|
||Mint the Tokens on ETC Chain (optional resume from tx#)|
||Confirm the balances on ETC Chain (do this before and after step 7)|
||Migrate Contracts to Kovan (for testing)|
||Mint the Tokens on Kovan (optional resume from tx#)|
||Confirm balances on Kovan|
||Estimate total ETC requirements|
contract: 0x1312f9ec97a2377c8e2ba6f088afdfedfe59398c deployer / minter / admin 1: 0x7ecdc55af01cd035279916c76cad9d9771faf45a admin 2: 0x4F143b42D1D7a80b946600990450DDef44e6e5BA top up 1: 0xA876e0Bb91a5277be74b340De60c7BE818DC37e8 top up 2: 0xEB11C580781B9339fD0668A3883f7fe1dB38B592 top up 3: 0x6dF098fEc80FC5Fec8D045c4eA8cc9429C90A357 top up 4: 0x50092395418bE5f4Ad1E720a0724F334758C3158
Please join the Digix slack channel #etc-redemption