Developer FAQ

A guide to help developers start interacting with Synthetix V3

Testnet Assets

Where can I get assets on OP Goerli?

  • ETH: Optimism Goerli ETH is available from various faucets. We recommend the official Optimism faucet but there are also other faucets available.

  • snxETH: You can wrap OP Goerli ETH into snxETH on "Spot" tab of the market prototype. This is the easiest way to get assets for testing if you have testnet ETH.

  • snxUSD: snxETH acquired through wrapping can be sold for snxUSD on the spot market prototype.

Where can I get assets on Base or Arbitrum Goerli?

  • Testnet stablecoins can be acquired on Base Sepolia or Arbitrum Seplia. Use the function deposit_eth, specify the address of the stablecoin (snxUSD, fUSDC, sUSDC) and send some ETH to receive stable coins. Note that for perp integrators, you can use snxUSD as margin. If you want to have sETH for using as margin sUSD can easily be swapped to sETH with the Spot Market.

Smart Contracts

  • All v3 contracts are under proxy, to find which you have to check the cannon file.

  • Cannon is the tooling used to define v3, see https://usecannon.com/packages/synthetix

  • Owner is the address indicated by the owner function, depends on network.

  • Function to use for enabling feature flag to all is setFeatureFlagAllowAll I believe

  • Decide any error from v3 with cannon decode synthetix-omnibus --chain-id 1 {paste 0x error code here}

Spot Market

How can I swap assets?

  1. Navigate to the spot market prototype

  2. Prepare your order and click "Submit order". If a token approval is required, you will be prompted with two transactions.

  3. Wait 10 seconds and refresh the page

  4. Click "View Pending Orders", open the "Committed" tab, and check the "My Orders" button

  5. When the "Settle" button is enabled, click it and submit the transaction.

Sample Applications

Ideas for things to build to get to know the protocol (optional!)

  • Execute trading strategies similar to the funding rate arbitrage bot. Consider simplified strategies like price triggers, or triggers based on market conditions.

  • Automate functions around the contracts similar to the sample liquidation or order keepers.

  • Build Telegram or Discord bots for tracking market conditions, traders, and market activity.

  • Build a command line interface for the SDK, improving the user experience.

PreviousSpot MarketNext101

Last updated