Starcoin Native Bridge Guide
Overview
This document describes the cross-chain process guide for the Halley–Sepolia networks: the Ethereum side is the Sepolia network, and the Starcoin side is the Halley network.
Preparation
Install wallets:
For Ethereum, install the MetaMask wallet extension:
MetaMask — Chrome Web Store
For Starcoin, install the Starmask wallet extension:
StarMask — Chrome Web Store
Starcoin Preparation
Get STC from the Halley faucet
Use the @StarcoinHalleyFaucet_bot on Telegram to claim STC. Example:
Ethereum Preparation
Switch network to Sepolia
Click the menu and select Network
Scroll to the bottom and enable “Show test networks”
Click the network selection dropdown
In the pop-up list, select Sepolia as the network.
Add USDT token to the list
USDT token address on Sepolia:0xaA8E23Fb1079EA71e0a56F48a2aA51851D8433D0
Select the Sepolia network and enter the address into the input field.
Get Sepolia ETH
Obtain it from the following faucet:Sepolia PoW Faucet or from this one (Ethereum Sepolia Faucet)
Get USDT
Swap on Uniswap V2. First, switch the network to the testnet.
Select ETH on the Sepolia network as the token to sell.
Select USDT as the token to buy, and enter the address 0xaA8E23Fb1079EA71e0a56F48a2aA51851D8433D0.
Enter the amount to swap and proceed with the exchange.
After a successful swap, the wallet will show the corresponding test USDT.
Cross-chain Test
After obtaining the tokens as described above, we have sufficient USDT and STC to run a cross-chain test.
Our STC won’t have USDT out of thin air, so we must first bridge a certain amount of USDT from Ethereum to Starcoin. The typical test flow is to bridge USDT from Ethereum to Starcoin first, then bridge it back from Starcoin to Ethereum. The current version supports bridging only the USDT token.
Open https://bridge.starswap.xyz and connect wallets on both sides.
Enter the amount you want to bridge.
Click the Bridge asset button to start the cross-chain transfer.
After submitting the transaction, wait about ten minutes for the Sepolia network to confirm the block. Continue waiting until the transaction’s block reaches the finalized status.
During this period, the following prompts may appear. Don’t worry — the service is waiting for the transaction to be finalized. Refresh the page after a while. If Starmask disconnects, first confirm you are logged in to the Starmask account via the top-right wallet menu, then refresh the page to reload the wallet state and click the Connect button again.
Once the on-chain data is ready, the page will request the validator nodes to sign this transaction. After collecting all validator signatures, your wallet will automatically submit the aggregated signatures to the contract for verification. The screenshot shows the wallet confirmation dialog that pops up when the data is ready. Note: in the red highlighted field, manually enter 10,000,000 (ten million), and do it for every showing confirming gas input, Dont heartache for that, we have sufficient STC supplying; otherwise, the transaction may fail due to insufficient gas. This issue is a quirk of wallets on the testnet and does not occur on mainnet.
After a valid signature, the contract creates a cross-chain record. You will then need to perform a Claim action, which also requires signing in your wallet.
After a successful signature, the following view appears: the left side shows the transaction you submitted on Ethereum, and the right side shows the transaction you submitted on Starcoin.
You can see the bridged USDT balance in your wallet; the reverse direction works the same way.
Building the Future of Move Ecosystem, Together.
The launch of the Starcoin Native Bridge Testnet is more than just a technical milestone; it’s the cornerstone of a boundless liquidity era for Starswap. By participating in this testnet, you are not just testing a product — you are helping us forge a more secure, native, and seamless path between Starcoin and the broader Web3 world.
Your feedback is our fuel. If you encounter any issues or have suggestions to make the experience even smoother, please join our community and let us know.
Let’s ignite the stars. 🌌
— The Starswap Team
