Getting Started

SMv3 Step-by-Step Guide

Quick Start Overview

This simplified guide provides a streamlined approach for interacting with SMv3. Note that "Proxy" refers to the Synthetix Perps v3 market proxy.

Initial Setup

1. Account Creation: Initiate a Synthetix v3 Account using Proxy.createAccount.

2. Permission Granting: Assign admin permission to Kwenta's Engine via Proxy.grantPermission.

   • Efficiency Tip: Steps 1 and 2 can be combined into a single transaction using Synthetix v3's TrustedMulticallForwarder, a feature co-developed by Kwenta.

Trading Preparation

3. Collateral Approval: Approve the Engine to manage your trading collateral (e.g., $USDC, $snxUSD, $snxBTC, $snxETH) using IERC20.approve.

4. Collateral Deposit: Deposit your trading collateral with Engine.modifyCollateral.

Trading Execution

5. Commit Async Order: Execute trades (one at a time, as per Synthetix restrictions) using Engine.commitOrder.

   • Batching Capability: Steps 4 and 5 can be processed together, thanks to the multicall functionality of the Kwenta Engine.

Programmatic Interaction Guide

For those looking to interact programmatically, here are detailed steps with corresponding code examples:

1. Creating a Synthetix v3 Account

2. Granting Kwenta's Engine Admin Permission

3. Approving Engine for Collateral Spend

4. Depositing Supported Collateral

5. Opening a Position via Async Order

6. Credit Funding for Conditional Order Execution

7. Debiting Account to Return Credited Funds

8. Defining a Conditional Order

9. Executing a Valid Conditional Order

This guide aims to facilitate a clear and efficient journey through SMv3’s setup and trading processes.