Skip to content

Depot: Exchanging ETH for sUSD

The Depot is a place to deposit any excess sUSD for others to purchase it with ETH. On testnets it also allows you to exchange testnet ETH for SNX.

Notice

The Depot also supports exchanging SNX for ETH via any SNX the contract holds, however it will send all proceeds to the contract's fundsWalet, so it's only used on testnets to allow developers to purchase testnet SNX (see testnets)

Note: while the depositing of sUSD can be done in Mintr, the exchanging of ETH for sUSD has no corresponding controls in the Synthetix dApps (it is however used in third parties aggregators).

Exchange ETH for sUSD API

Contract

Destination contract (address & ABI): Depot

Methods

Events Emitted

On a successful transaction, the following events occur:

For each deposit paid through, the following two events are emitted:

name emitted on address fromAddress address toAddress uint fromETHAmount uint toAmount uint depositIndex
ClearedDeposit Depot msg.sender the current depositor in the queue the amount of ETH the toAddress has been paid the amont of sUSD the msg.sender will received the depositIndex that was accessed in this exchange
name emitted on address from address to uint value
Transfer ProxysUSD Depot msg.sender an amount of sUSD

Following all deposits paid though, emits the following event:

name emitted on string fromCurrency uint fromAmount string toCurrency uint toAmount
Exchange Depot ETH fromAmount of ETH sent by msg.sender sUSD toAmount of sUSD the sender was sent

Example Transactions on Mainnet

  • Depot.exchangeEtherForSynths() (with a single deposit accessed)
  • sending ETH to Depot (with two deposits accessed)

Code Snippets

Exchanging ETH for sUSD

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
const { SynthetixJs } = require('synthetix-js');
const privateKey = '0x' + '1'.repeat(64); // don't actually put a private key in code obviously

// parameters: default provider, default networkId, private key as a string
const networkId = 3; // ropsten, (use 1 for mainnet)
const signer = new SynthetixJs.signers.PrivateKey(null, networkId, privateKey);
const snxjs = new SynthetixJs({ signer, networkId });

(async () => {
  try {
    // send transaction
    const txn = await snxjs.Depot.exchangeEtherForSynths({
      value: snxjs.utils.parseEther('0.01'), // Send 0.01 ETH
    });

    console.log('hash is mining', txn.hash);

    // wait for mining
    await txn.wait();

    // fetch logs of transaction
    const { logs } = await signer.provider.getTransactionReceipt(txn.hash);

    // show them
    console.log(JSON.stringify(logs, null, '\t'));
  } catch (err) {
    console.log('Error', err);
  }
})();
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
const synthetix = require('synthetix'); // nodejs
const ethers = require('ethers'); // nodejs
// or using ES modules:
// import synthetix from 'synthetix';
// import ethers from 'ethers';

const network = 'ropsten';
const provider = ethers.getDefaultProvider(network === 'mainnet' ? 'homestead' : network);

const contract = 'Depot';

const { abi } = synthetix.getSource({ network, contract });
const { address } = synthetix.getTarget({ network, contract });

const privateKey = '0x' + '1'.repeat(64); // don't actually put a private key in code obviously
const signer = new ethers.Wallet(privateKey).connect(provider);

// see https://docs.ethers.io/ethers.js/html/api-contract.html#connecting-to-existing-contracts
const Depot = new ethers.Contract(address, abi, signer);

(async () => {
  try {
    // send transaction
    const txn = await Depot.exchangeEtherForSynths({
      value: ethers.utils.parseEther('0.01')
    });
    // wait for mining
    await txn.wait();
    // fetch logs of transaction
    const { logs } = await provider.getTransactionReceipt(txn.hash);
    // display
    console.log(JSON.stringify(logs, null, '\t'));
  } catch (err) {
    console.log('Error', err);
  }
})();
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
pragma solidity 0.5.16;

import "synthetix/contracts/interfaces/IAddressResolver.sol";
import "synthetix/contracts/interfaces/IDepot.sol";

contract MyContract {

  // This should be instantiated with our ReadProxyAddressResolver
  // it's a ReadProxy that won't change, so safe to code it here without a setter
  // see https://docs.synthetix.io/addresses for addresses in mainnet and testnets
  IAddressResolver public synthetixResolver;

  constructor(IAddressResolver _snxResolver) public {
      synthetixResolver = _snxResolver;
  }

  function synthetixExchangeETHForSynths() external {
    IDepot depot = synthetixResolver.getAddress("Depot");
    require(depot != address(0), "Depot is missing from Synthetix resolver");

    uint etherAmount = 1e15; // 0.001 ETH

    // Either
    depot.exchangeEtherForSynths.value(etherAmount)();

    // or simply
    depot.transfer(etherAmount);
  }

}