Uniswap Wallet is the simplest, safest, and most powerful self-custodial crypto wallet. It is developed by the Uniswap Labs team, inventors of the Uniswap Protocol.
If you have suggestions on how we can improve the app, or would like to report a bug or a problem, check out the Uniswap Help Center.
This guide assumes that:
- You are using a Mac (you will need a Mac computer in order to run the Xcode iOS Simulator)
- You are using an Apple Silicon Mac (if you’re not sure, go to → About this Mac and check if the chip name starts with "Apple")
Note: if you are indeed using an Apple Silicon Mac, we recommend setting up your environment without using Rosetta. Some instructions on how to do that can be found here.
You should start with downloading Xcode if you don't already have it installed, since the file is so large. You can find it here: developer.apple.com/xcode
Note: The version shouldn’t matter too much for Xcode, but at the time of writing, the app is built using version 14.2.
We’ll be using Homebrew to install many of the other required tools through the command line.
- Open a terminal
- Copy and paste the command from brew.sh into your terminal and run it
nvm is the Node Version Manager. While not required, it makes it easy to install Node and switch between different versions. A minimum Node version of 16 is required to use this repository.
Copy the curl command listed under Install & Update Script on this page and run it in your terminal.
To make sure nvm installed correctly, try running nvm -v (you may need to quit and re-open the terminal window). It should return a version number. If it returns something like zsh: command not found: nvm, it hasn’t been installed correctly.
Now we want to use nvm to install a specific version of node.
Run the following command in your terminal:
nvm install 16
and then when it’s finished, run:
nvm use 16
Quit and re-open the terminal, and then run:
node -v
to make sure you get a version number that starts with v16..
We use yarn as our package manager and to run scripts.
Run the following command to install it:
npm install --global yarn
(npm comes with node, so it should work if the above step has been completed correctly)
Then run:
yarn -v
to see if it installed correctly.
Run brew install cocoapods
Open Xcode and go to:
Preferences → Locations → Command Line Tools
And select the version that pops up.
We do not check Flipper into source. To prevent pod install from adding Flipper, set an environment variable in your .bash_profile or .zshrc or .zprofile:
# To enable flipper inclusion (optional)
export USE_FLIPPER=1
Note: To disable Flipper, the whole line should be commented out, as setting this value to 0 will not disable Flipper.
Once all the steps above are completed, you're ready to try running the app locally!
Clone this repository locally to your machine if you haven't already.
Note: The app will likely have limited functionality when running it locally with the default environment variables.
Use the environment variables defined in the .env.development file to run the app locally.
Before the code will compile you need to generate types for the smart contracts the wallet interacts with. Run yarn contracts:compile. Re-run this if the ABIs are ever changed.
In the root directory, run yarn to install all the necessary npm packages.
Then run yarn pod to install all the necessary pods.
Finally, run yarn ios to boot up the iOS Simulator and run the app inside it. The JS bundler (metro) should automatically open in a new terminal window. If it does not, start it manually with yarn start.
Or you can use one command to run them all one after the other: yarn && yarn pod && yarn ios
You can also run the app from Xcode, which is necessary for any Swift related changes. Xcode will automatically start the metro bundler.
Hopefully you now (after a few minutes) see the Uniswap Wallet running in the iOS Simulator!
These are some tools you might want to familiarize yourself with to understand the codebase better and how different aspects of it work.
- Redux and Redux Toolkit: state management
- redux-saga & typed-redux-saga: Redux side effect manager -- used for complex/stateful network calls
- ethers
- Shopify/restyle: UI framework
- React navigation: routing and navigation with animations and gestures
- react-i18next: i18n
We use redux-persist to persist Redux state between user sessions. When the Redux state schema is altered, a migration may be needed to transfer the existing persisted state to the new Redux schema. Failing to define a migration results in the app defaulting to the persisted schema, which will very likely cause undefined errors because the code has references to Redux state properties that were dropped in favor the the persisted schema.
Anytime a required property is added or any property is renamed or deleted to/from Redux state. Migrations are not necessary when optional properties are added to an existing slice. Make sure to always add new required properties to the schema.ts file as well.
- Increment the
versionofpersistConfigdefined withinstore.ts - Create a migration function within
migrations.ts. The migration key should be the same as theversiondefined in the previous step - Write a test for your migration within
migrations.test.ts - Create a new schema within
schema.tsand ensure it is being exported by thegetSchemafunction at the bottom of the file
Stubs for new i18n strings used throughout the app can be generated automatically. Use the string as you would normally (e.g. t('id')) and then run yarn i18n:extract.
If Typescript in VSCode is slow to see the change, you can restart the typescript server.
See e2e/README.md
-
zsh: command not found: [package name]This means whichever package you're trying to run ([package name]) wasn’t correctly installed, or your Terminal can’t figure out how to run it. If you just installed it, try quitting terminal and re-opening it. Otherwise try reinstalling the package. -
unable to open file (in target "OneSignalNotificationServiceExtension" in project "Uniswap"). Resolve this issue by navigating to theios/directory and runningpod update.
If something isn’t working the way it should or you’re getting a weird error when trying to run the app, try the following:
- Quit the terminal
- Quit Metro terminal
- Open Finder and navigate to the
mobiledirectory - Delete the
node_modulesfolder - Navigate into the
iosfolder - Delete the
Podsfolder - Open XCode
- Go to Product → Clean Build Folder
- Open your terminal again
- Navigate to the
mobiledirectory in the terminal - Run
yarn && yarn podagain - Run
yarn ios
Your shell profile file is most likely one of: .bash_profile, .zshrc, or .zprofile, and will be located in /Users/[username]/. You can reveal hidden files in Finder by pressing ⌘ + Shift + ..
If issues with your terminal or shell seem to be the cause of some of your problems, here is an example of what that file may look like in order for your terminal to be able to run the app locally:
eval "$(/opt/homebrew/bin/brew shellenv)"
export NVM_DIR="$HOME/.nvm"
[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh" # This loads nvm
[ -s "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" ] && \. "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" # This loads nvm bash_completion
# To enable flipper inclusion (optional)
export USE_FLIPPER=1
export PATH="/opt/homebrew/opt/ruby/bin:$PATH"
# ruby things
export LDFLAGS="-L/opt/homebrew/opt/ruby/lib"
export CPPFLAGS="-I/opt/homebrew/opt/ruby/include"
export GEM_HOME="$(ruby -e 'puts Gem.user_dir')"
export PATH="$PATH:$GEM_HOME/bin"
export GEM_HOME=$HOME/.gem
export PATH=$GEM_HOME/bin:$PATH
gem install cocoapods --user-install