The Synthetix ecosystem has been progressively moving towards reliance on ENS/IPFS over DNS/HTTP for web hosting. For example, Kwenta is available via eth.limo at kwenta.eth.limo, and you can access it directly in Brave or Opera at kwenta.eth. Synthetix’s Core Contributors are also using IPFS to store and share protocol deployment data using Cannon.
The Synthetix ecosystem has created an IPFS Cluster to coordinate pinning these files.
If you are involved in the Synthetix ecosystem and interested in pinning web apps (or any other data) in the cluster, start a discussion in the #dev-portal channel in the Synthetix Discord server. Also, check out the ipfs-deploy repository.
You can support greater decentralization, reliability, performance, and censorship-resistance by running an IPFS node that follows the cluster. When using a pinned front-end, it will also load faster (as you’ll have the latest version available locally).
Anyone with a computer and an internet connection can join the swarm. It’s fine if you don’t have 100% uptime.
On macOS, open your terminal and run the following command:
curl https://synthetixio.github.io/synthetix-node/install-macos.sh | bashThis will download the correct release of SynthetixNode.app to your Applications directory and start it.
On Windows, open PowerShell as Administrator and run the following command:
iwr -useb https://synthetixio.github.io/synthetix-node/install-win32.ps1 | iexThis will download the correct release of synthetix-node.exe to your Program Files directory and start it.
On Linux, open your terminal and run the following command:
curl https://synthetixio.github.io/synthetix-node/install-ubuntu.sh | bashThis will download the correct release of synthetix-node package, install it, and start it on your system.
Download the macOS app from the Latest release page. ( Linux versions are in development.) Select the ARM64 version if you are using a Mac with Apple silicon.
Unzip and copy SynthetixNode to your Applications folder. There will be no pop-up to do so. Make sure to move it manually before proceeding to the next step.
Due to the latest MacOS security policies, it is no longer possible to execute unsigned apps. Therefore, you should clear the quarantine flag from the app before running it. Run the following command in terminal:
xattr -d com.apple.quarantine /Applications/SynthetixNode.appDownload the Windows app from the Latest release page. Please note that the application supports only Windows 64-bit.
Unzip and run synthetix-node.exe to start the application.
Download the .deb package from
the Latest release page. Navigate to the folder
that contains synthetix-node_1.7.0_arm64.deb.
Run the following command to install the application:
sudo dpkg -i synthetix-node_1.7.0_arm64.debAfter installation, launch the application using:
synthetix-nodeIf you are concerned with security, clone this repository, review the implementation, and use the instructions below * Development* to start a development build.
If you would rather run this in a Docker container or run scripts manually, check out the ipfs-follower repository.
yarn install
yarn startyarn iconsgenexport NEXT_VERSION=$(npm version minor)
git push --follow-tags
# build app
export CSC_IDENTITY_AUTO_DISCOVERY=false
yarn make
# create release and upload artifacts
gh release create $NEXT_VERSION --generate-notes ./out/make/**/*.zip
# re-upload artifacts if needed
gh release upload $NEXT_VERSION ./out/make/**/*.zip# 1. Ensure you have IPFS_USER and IPFS_PASS env vars set
export IPFS_USER=
export IPFS_PASS=
# 2. Use `synthetix-node-app-config` IPNS key
export IPNS_KEY=synthetix-node-app-config
# 3. Add and pin config.json to IPFS node
export IPFS_CID=$(curl -u "$IPFS_USER:$IPFS_PASS" 'https://ipfs.synthetix.io/api/v0/add' -F file=@config.json --silent | jq -r '.Hash')
# 4. Publish config.json to Synthetix IPNS key
curl --silent --request POST --user "$IPFS_USER:$IPFS_PASS" "https://ipfs.synthetix.io:5001/api/v0/name/publish?key=$IPNS_KEY&arg=$IPFS_CID&ttl=5m&lifetime=168h" | jq