dYdX Chain Technical Docs
  • πŸ‘‹dYdX Chain Technical Documentation
  • Getting Started
    • πŸ’‘Developer Tools
      • dYdX Chain Client for Javascript
        • Example #1: Accessing Subaccount Data
        • Example #2: Faucet Endpoints
        • Additional Javascript Client Examples
      • dYdX Chain Client for Python
        • Example #1: Placing, Replacing, and Canceling Orders
        • Exmaple #2: Trading with HRN
        • Additional Python Client Examples
      • dYdX CLI
        • Setup the dYdX CLI
        • EOA Wallets
        • Multisig wallet
        • Submit a governance proposal
    • ✨Developer Guides
    • 🦊User Guides
      • How to use Squid UI for cross-chain deposits to dYdX V4
      • How to use CCTP UI for cross-chain deposits to dYdX V4
      • How to withdraw and transfer funds from a subaccount using Command Line
    • ❓FAQ & Resources
    • πŸ–₯️Open Source Repositories
  • Validators
    • πŸ› οΈGetting set up
      • Hardware Requirements
      • Required Node Configs
      • Running a Validator
      • Running a Full Node
      • Snapshots
      • Validator Upgrades
    • ❓FAQ & Resources
    • πŸ§‘Active Validator Slack
  • Front End & Wallets
    • πŸ“šArchitecture Overview
    • 🌎Web Front End
    • ❓FAQ & Resources
  • Data Dashboards & Open APIs
    • πŸ“ŠPublic Dashboards
    • ❓FAQ & Resources
  • Disclaimers
    • πŸ“„Disclaimer
    • πŸ”“Privacy Policy
Powered by GitBook
On this page
  • Documentation & Repository FAQ
  • Token Information FAQ
  • Token Migration FAQ
  • Technology Stack FAQ
  • Security FAQ
  1. Getting Started

FAQ & Resources

PreviousHow to withdraw and transfer funds from a subaccount using Command LineNextOpen Source Repositories

Last updated 1 year ago

Documentation & Repository FAQ

Where to find mainnet documents?

Is the code open source and what is the Github link?
  • Yes, dYdX Chain Github repositories are fully public and can be found here

  • Also see Open Source Repositories

Is there a documentation available to send USDC to dYdX Chain?

You can find the instructions .

Token Information FAQ

What is the name of the project
  • dYdX Chain

What is the official website for the project?
What is the token name and symbol?

*DYDX is the native token of the dYdX Chain based on Cosmos SDK.*

If you have an existing token market for Ethereum ERC20 tokens, you shall change the ticker to ethDYDX for all ERC20 markets.

How many decimal places in the token?

18

What is the initial total supply set up when the mainnet is established?

1,000,000,000 or 1B tokens

What is the circulating and max supply of DYDX?

Circulating supply was 377,821,714 and Total supply was 691,508,237 as on 1st Jan 2024

What is the block explorer address?
What is the function and utility of the project tokens?
What is the token allocation?

50.0% (500,000,000 $ethDYDX) to the community as follows:

27.7% (277,295,070 $ethDYDX) to past investors of dYdX Trading Inc.,

15.3% (152,704,930 $ethDYDX) to founders, employees, advisors, and consultants of dYdX Trading Inc. or dYdX Foundation, and

7.0% (70,000,000 $ethDYDX) to future employees and consultants of dYdX Trading Inc. or dYdX Foundation.

Token Migration FAQ

Is the token chain-swapped and how was it decided by the community?

The community decided to adopt DYDX as the L1 token of the dYdX Chain, built using Cosmos SDK. The utility functionalities of the token have expanded to the dYdX Chain, the DYDX token can now be used for staking and contributing to the security and governance of the dYdX Chain.

What was the launch time of the mainnet?

dYdX Chain genesis happened on October 26th, at 17:00 UTC

Will dYdX continue supporting the old smart contract on Ethereum or at what time/block height will it stop?

DYDX is a native token powering the dYdX Chain, a standalone PoS blockchain network built using Cosmos SDK, which can be used for gas, staking and governance. ethDYDX will still exist on Ethereum until all tokens are migrated to dYdX Chain.

wethDYDX will continue existing as a governance token for dYdX v3, relevant until the v3 exchange is live. dYdX Trading team plans to sunset the v3 product in due course of time, though there is not fixed date announced on shutting down the v3 product yet.

If the old contract still running but without a long-term swap support, what's the solution of old token depositing into new contract?
What is the end date of the new contract migration?

There is no end date.

What is the method of token migration?

The ethDYDX tokens are bridged and locked on the Ethereum side and are distributed on the dYdX Chain by the validators reading the bridge transaction.

What is the exchange rate of old token to new token?

1:1 (Users receive 1 wethDYDX on Ethereum + 1 DYDX on the dYdX Chain in exchange for every ethDYDX sent to the wethDYDX Smart Contract).

Is there a bridge to migrate DYDX on dYdX Chain back to ethDYDX on Ethereum?

There is only a one-way bridge for migrating ethDYDX to DYDX and no smart contract for other way around.

Who is Bridge Module Authority Account? Is it Governance?

Gov module and delaymsg module are authorities of bridge module.

In the wethdydx, Bridge function does not verify if address is in type of bech32. What happens, If the user enters wrong bech32 address type through direct contract interaction?

Funds are unretrievable in that case.

Technology Stack FAQ

What is the chain ID of the mainnet?

dydx-mainnet-1

Is the node code open source?
What is the transaction model? (On-chain accounting model, e.g. BTC is a UTXO model and ETH is an Account model)

Account model

What is the consensus algorithm?

CometBFT consensus and dPoS for DYDX

What is the average block production speed?
How many block confirmations can ensure safe credit?

On Cosmos SDK-type chains block finality is 1-block. Finality comes as soon as a transaction and block are verified.

Is the dYdX v4 protocol developed based on other chain(s)?

DYDX is Cosmos SDK-based (dYdX Chain)

Is there a mechanism for super nodes on the chain?

No.

Is there a dividend mechanism such as voting, pledge, etc. on the chain?

No.

Whether the underlying layer of mainnet supports contract?

Not at the moment but we expect the ecosystem contributors will consider activating Cosmwasm on chain which can enable smart contract functionalities.

Are there other tokens apart from the mainnet token (eg. contract like token)?

No, not at the moment.

Does the public address or account needs to be activated on the chain after the public and private key is generated?

No.

Do transactions support multiple signatures?

Yes, signing with multiple signers is done with the tx multisign command.

Does the transaction expire after the broadcasting?

No.

Is there a fee on the transaction?

There is a gas fee usually in the range of 0.001 to 0.025 DYDX. Placing trades on the dYdX Chain incur trading fee in DYDX or USDC.

Does each block contain a BTC-like coinbase transaction?

No.

Are delayed transactions designed?

No.

Is it possible for signature transactions to be carried out offline?

Yes, and the flag to consider in the tx sign command is β€”offline.

Describe all types of transactions related to changes in account funds, such as dividends, fees, airdrops, etc.

IBC Transfers

After the transaction goes on chain, whether there will be possibilities that the execution fails? And how to judge the transaction is successful?
In the scenario of sending transactions, if the same sending address sends transactions continuously, is there a need to wait for the previous transaction to be confirmed before sending the next transaction?

It uses sequence_number like most other cosmos chains. This is the same as nonce in a transaction on Ethereum.

Please provide block data of mainnet or snapshots.
Is there a public API interface url?
Is there a account supporting memo function like EOS?

Yes.

Please provide more information on configuring file directory.
How to customize RPC Port and directory of block data?
What is the access point to the best height API?
How to access the account balance, history, and information of trade?
What are the suggestions for restoring and recovering accounts?

Importing secret phrase (24 words)

What are the rules of ab address? (such as start with 0x, max_length is 60, etc.)

dYdX Chain address starts with dydx, max length = 43.

Is it necessary to add our node IP into your whitelist when synchronizing?

No not necessary.

Is there a need for wallet node expose its port to outside? If so, is the machine with NAT IP is ok?

No.

What are the support transaction types from the x/bank module? (e.g. /cosmos.bank.v1beta1.MsgSend, /cosmos.bank.v1beta1.MsgMultiSend)

They are both supported on the dYdX chain.

How to change the USDC on the dYdX chain to the USDC on the ERC20 chain?
What version of Cosmos SDK do you have to use?

v0.47.4

Where can I find network constants and parameters?

Security FAQ

Is there a third-party security audit of the source code of the dYdX Chain protocol?
Is there a third-party security audit of the bridge smart-contract?

,

DYDX has Staking, Security, Governance utilities over dYdX Chain. Read the blog for more information .

25.0% (250,000,000 $ethDYDX) based on the ,

7.5% (75,000,000 $ethDYDX) to past users who complete certain trading milestones on the Layer 2 protocol (),

7.5% (75,000,000 $ethDYDX) based on the ,

5.0% (50,000,000 $ethDYDX) to a ,

2.5% (25,000,000 $ethDYDX) to users staking $USDC to a ,

2.5% (25,000,000 $ethDYDX) to users staking $ethDYDX to a ,

More information on the token allocation can be found .

ethDYDX is migrating to DYDX on dYdX Chain. Check the for latest numbers. Read more about the migration and bridging .

Users can convert their ethDYDX into (i) wethDYDX on Ethereum plus (ii) DYDX on the dYdX Chain anytime using the wethDYDX Smart Contract. Visit the front-end interface to interact with the bridge smart contract .

If a user interacts with the wethDYDX Smart Contract, then each dYdX Chain validator participating in the consensus process would read the event information of the wethDYDX Smart Contract and allocate DYDX tokens on the dYdX Chain to a given user’s dYdX Chain address. The wethDYDX Smart Contract emits an event log in order for the dYdX Chain to understand when a call to bridge() has occurred. You can read more about it .

Yes, read more to get started.

1.05 - 1.20 seconds, Check the latest blocktime on .

Transactions can fail. Examples of failed transactions and .

You can access the information by <BLOCK#>

You can access the indexer APIs at this .

Visit the page .

Check out the ports .

Use the link .

You can access the inform on .

There are 2 bridges, the first is the pure USDC bridge and second is the generic bridge . Both of these have different fees which is shown to you on the frontend.

You can find the params at

Yes, dYdX v4 protocol has been audited by Informal System. Audit report available .

The token bridge and governance contracts have been audited by Peckshield. Audit report available .

❓
https://docs.dydx.trade/
https://github.com/dydxprotocol/v4-chain
here
dydx.trade
dydx.foundation
https://www.mintscan.io/dydx
here
Trading Rewards Formula
Retroactive Mining Rewards
Liquidity Provider Rewards Formula(s)
Community Treasury
Liquidity Staking Pool
Safety Staking Pool
here
Dune dashboard
here
here
here
here
https://www.mintscan.io/dydx
here
here
https://dydx-ops-rpc.kingnodes.com/block_results?height=
link
here
here
https://docs.dydx.trade/developers/indexer/indexer_api#getheight
Mintscan
https://cctp.money/
https://app.squidrouter.com/
https://docs.dydx.trade/networks/network1/network_constants
here
here