Direct user interactions
Deposits and trades
To trade against the Ecosystem Book, users must deposit funds into our Smart Contract. Once the deposit transaction is successfully mined by the Starknet sequencer, users will have funds in the Exchange and can engage in various trading activities.
Additionally, users need to execute an on-chain binding by invoking bind_to_signer. This process binds a particular trading account address to the signer responsible for signing messages (such as orders) on behalf of the user.
Users interact with our Exchange through specified endpoints and each user's request for any action undergoes validation. For instance, if a user lacks sufficient funds to execute a trade or if the user provides an invalid signature, our Exchange will reject the user's request.
Our Exchange will ensure that the strong execution semantics will not be broken. Our Smart Contract additionally guarantees the validity of actions preventing any malicious activity either by a user or our Exchange itself.
Actions that do not require funds to perform:
order placement*
order cancellation and cancel all for particular ticker
retrieving balances and other order information
*although order placement is in itself gasless, the user must have sufficient funds to fulfil the trade and the taker must have enough funds to cover the gas of the completed transaction
Actions that require funds to perform:
withdrawals
force cancel all (push increase nonce on-chain, so orders with less nonce became invalid)
Withdrawals
To withdraw funds from our Exchange via the Ecosystem Book, users have two options:
Direct On-Chain Withdrawal: This involves two transactions with a slight time delay to prevent malicious activity by the user that could lead to the failure of trade settlement on the chain. This delay allows the exchange to process the withdrawal request and cancel any passive orders affected by this withdrawal.
Withdrawal Through the Exchange: Users can submit a withdrawal request through the Exchange's endpoint, and the Exchange will handle the withdrawal without delays. Users must cover the gas fee costs for this withdrawal. It's important to note that our Exchange does not have access to user funds, preventing it from impeding on-chain withdrawals.
Last updated