# ViteX Gateway Integration Guide
# What is Cross-chain Gateway
Cross-chain Gateways provide a way to exchange digital assets between any blockchain (Source Chain) and digital assets on the Vite chain (Gateway Token).
For instance, if a user wants to trade BTC on the ViteX DEX, she will first convert BTC on the Bitcoin chain ("Native BTC") into a BTC coin on the Vite chain ("VBTC"). If after her trades, she still has an amount of VBTCs, then she can convert these coins back to Native BTC via the cross-chain Gateway. Between the two said conversions, the Native BTCs are locked inside the cross-chain Gateway.
Thanks to the protocol "ViteX Gateway Technical Specification" designed by Vite, anyone can operate a Gateway. This is how it works: Vite's official web wallet already implements this protocol. So a Gateway operator only needs to implement this protocol on their end to easily integrate with the web wallet.
# How to Create a Gateway
- Forge a new token on Vite chain to represent the digital asset in the Source Chain. See here for instructions of token forging. The new token should have the same total issuance amount and decimal places as the Source Chain asset.
- The operator must be able to verify and send transactions for Gateway Token. To do so, she can either run a Vite full node or use API from full nodes from Vite team.
- The operator must be able to verify and send transactions for Source Chain token as well. Similarly to the above bullet point, she can run a full node for the Source Chain, or use API provided by trustworthy full nodes on the Source Chain.
- Integrate with the interface as defined in the ViteX Gateway Technical Specification.
# How to Integrate
The developer would need to use a testing environment. (https://x-test.vite.net/assets (opens new window)).
Forge the coin in the testing environment. In the below screenshot, we assume ETH-0 as the token forged.
# Tips for Properly Operating a Gateway
# Asset Custody
- Private keys should be stored in cold wallets
- Strategy for managing hot wallets (Holding period of assets, upper limit for amount of assets in custody)
- Management of private keys (components of secrets shared across multiple people and stored in multiple locations)
- Distribution of assets amongst multiple locations ("Don't put all your eggs in one basket")
- Real-time reconciliation
# Deposits and Withdraws
- Wait for reasonable number of confirmations prior to transfers
- Temporary halt of deposit/withdrawal functions during forks
- Pay attention to users who withdraw for the first time, and addresses used for withdrawal for the first time
- Regularly check-in on internal monitoring process
- Frequent and timely analyses of transfer data
- Monitoring and confirmation for large deposits and withdrawals
The following illustrates the workflow of an Ethereum Gateway.
# Gateway Addresses
The Gateway needs to maintain the following types of addresses:
- Cold wallet addresses, including ETH addresses and VITE addresses. Large amounts of assets should be stored in the cold wallet to ensure asset safety.
- Hot wallet addresses, including ETH addresses and VITE addresses. They are used to accommodate daily transfers.
- One ETH address for each VITE address, to facilitate deposits into the Gateway.
- User's own ETH address and VITE address.
# Business Workflow
# Cross-Chain Deposits
- Assignment of user addresses. When a user initiates a cross-chain deposit, the Gateway assigns an ETH address dedicated to this user's deposit process. This address is shared with the user, and its private key is kept by the Gateway.
- Monitor the said ETH address and wait for a proper number of confirmations.
- Once the Gateway determines this ETH transaction as confirmed, transfer the appropriate amount of Gateway Tokens to the user's VITE address. If need be, transfer the Ether in said ETH address into the hot wallet.
- Monitor the VITE network and confirm this Gateway Token transaction. Update records for cross-chain deposits.
# Cross-Chain Withdraws
- The user provides an address for the withdraw and submits the withdraw request. At this point, the official web wallet will sign (on an offline basis) and send a VITE transaction (of the Gateway Token) from the user's VITE address to the Gateway's VITE hot wallet. The transaction will take into account the withdraw amount and transaction fees.
- The Gateway monitors for confirmations and waits until sufficient confirmations have taken place.
- Once the Gateway deems this transaction as confirmed, it transfers the appropriate amount of Ether from the ETH hot wallet into the user's ETH address
- Monitor the ETH network and update records for cross-chain withdraws once the transaction has been deemed confirmed.
# Transfer of Funds involving Cold Wallet
Allocate 20% of the funds in the hot wallet, and 80% in the cold wallet. The allocation decision will be driven by total token balance and the nature of the flow of funds through the Gateway.