@digix/etc-redemption

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

Recent Updates

• 30/05 - [CH] Updated guide with deployed address
• 30/05 - [AE] No longer using MultiSig wallet contract to avoid potential 0-day exploits

Overview

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.

Top-up System

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

Redemption Process

The new redemption process is split roughly into the following steps:

Set Up

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)

Redemption

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 0x0 address)
• 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:

• Permissioned
  • Owned by one admin
  • Admin can transfer ownership
  • Admin can control the activation block / mint tokens / drain contract
• Time-Lockable
  • Disables transfers / redemptions until a specific (activation) block is reached
• Redeemable
  • 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.sender if using the default function)

A test suite with 100% method coverage has been added to this repository under ./test, they can be run with truffle test.

Scripts

This repository contains a series of scripts to facilitate the backend process.

The the parameters can be configured in ./scripts/helpers/config.json.

npm run	args	Description
step-1		Get the Snapshot (run this with multiple clients & Etherscan)
step-2		Confirm the Balance Reports are the same
step-3		Publish report to IPFS
step-4		Migrate the Contracts to ETC Chain
step-5	<tx>	Mint the Tokens on ETC Chain (optional resume from tx#)
step-6		Confirm the balances on ETC Chain (do this before and after step 7)
step-4-test		Migrate Contracts to Kovan (for testing)
step-5-test	<tx>	Mint the Tokens on Kovan (optional resume from tx#)
step-6-test		Confirm balances on Kovan
estimate-gas		Estimate total ETC requirements

## Accounts

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

Questions

Please join the Digix slack channel #etc-redemption