Skip to main content

Freighter Wallet Installation

To interact with Equillar's blockchain features, you'll need a Stellar wallet that supports Soroban smart contracts. This guide uses Freighter wallet, which is ideal for learning and testing on Stellar's testnet.

What you'll learn: How to set up a Stellar wallet, fund it with test tokens, and add stellar-testnet assets (USDC, EURC) for blockchain transactions.

Install Freighter​

To install Freighter, go to the link: https://www.freighter.app/, click on the "Add To browser" button and follow the wallet instructions.

Check you are connected to testnet​

After finishing the installation and log-in the first time, you will notice that your account has no XML yet. If you are connected to testnet you will see a message informing you that you can fund your account with XLM using the FriendBot. First of all, let's ensure you are connected to testnet.

Freighter ensure you are in testnet

As you can see in the image, click on the second rounded button and make sure that the selected network is testnet. After checking it, fund your account with FriendBot and it will send 10000 XLM to your account.

Add a new asset​

Now, let's add a new asset so that we can receive tokens from that asset.

Internally, Freighter creates a Trustline between your account and the token of your choice. You can find more information about what a trustline is in the stellar docs.

To add a new token, click on the first rounded button on te top left corner and then click on the "Manage Assets" option.

Freighter manage assets option

This will list your current assets. In the bottom, you will see an button named "Add an Asset". Click on that button and enter the Asset ID or Soroban Contract ID of the token you want to add:

  • For Testnet USDC: CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA
  • For Testnet EURC: CCUUDM434BMZMYWYDITHFXHDMIVTGGD6T2I5UKNX5BSLXLW7HVR4MCGZ

Freighter Add Asset

Click on the asset "Add" button and follow the wallet instructions to add the asset. After doing it, freighter will list that asset.

If you cannot add the asset using the contract id, use the Assets ID instead:

  • For Testnet USDC: USDC-GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5
  • For Testnet EURC: EURC-GB3Q6QDZYTHWT7E5PVS3W7FUT5GVAFC5KSZFFLPU25GO7VTC3NM2ZTVO

Make a swap to get funds​

Finally, in order to get funds in USDC or EURC, we can swap some of our XLM. To do that, click on the Freighter "Swap" button:

Freighter Swap Button

Here you have to choose the source asset for the swap. Select XLM and continue. You should see the following page:

Freighter Swap Amount

Enter the XLM amount you want to swap and choose the receive asset (USDC or EURC). Then, click on the "Review Swap" button you will see at the bottom.

Freighter Review Swap

Confirm the swap and, after the swap finishes, you will see that you have already a possitive amount in the asset you swapped with.