Important

This project is no longer maintained and the repository is archived.

Nobody is shipping updates to either app store. The Android listing is gone from Google Play, and while the iOS listing is still up, it is not being updated. Uploading is expected to fail: the share flow was built against the old web3.storage upload API, which was deprecated in 2023 (#47) and no longer exists at that address. durin.site is offline too.

The ipfs:// and ipns:// handling still shows a reasonable pattern to copy, so the code is worth reading. Treat it as a reference, not something to install.

The repository can be unarchived, but only for a named maintainer who commits to keeping it up, which here also means owning the app store listings. If that is you, reach out to the IPFS Foundation. Forking is fine too.

Availability

Durin is an iOS and Android app for exploring IPFS use-cases. Initially with read and share flows, but a place where we can experiment with light client protocol implementation, proximity transports and the "where's my stuff" problem.

Project Details

Created using ionic.

• Handles ipfs:// URLs and kicks them to dweb.link
  • ipfs://bafybeihju6xivs4ipvfljsdgp4t4lfxgln3s464ie2pw5fxodgkr23pfzy/E85BE0E1-32B9-410F-87EB-4A8C882ECA12.png to https://bafybeihju6xivs4ipvfljsdgp4t4lfxgln3s464ie2pw5fxodgkr23pfzy.ipfs.dweb.link/E85BE0E1-32B9-410F-87EB-4A8C882ECA12.png
• Handles ipns:// URLs and kicks them to dweb.link
  • ipns://en.wikipedia-on-ipfs.org/wiki/ to https://en-wikipedia--on--ipfs-org.ipns.dweb.link/wiki/

Installation

• Make sure you have Xcode installed
• Create a new f ile .env.local - replace YOUR_TOKEN with one from web3.storage

REACT_APP_WEB3_STORAGE_TOKEN=YOUR_TOKEN

• Run the following commands:

xcode-select --install # Install Command Line Tools if you haven't already.
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

brew install --cask android-studio
sudo gem install cocoapods
npm i -g @ionic/cli
npm install
npm run sync
npx ionic capacitor run ios --livereload # Opens and runs the iOS app - you will pick which device to run it on. If you have a physical device plugged in, you can select that as well.

Then add export JAVA_HOME=/Applications/Android\ Studio.app/Contents/jre/Contents/Home/ to your .bashrc or .zshrc.

Apple Silicon

If you are using Apple silicon, you will need to follow this first: https://armen-mkrtchian.medium.com/run-cocoapods-on-apple-silicon-and-macos-big-sur-developer-transition-kit-b62acffc1387

Testing

When making changes or running for the first time, run npm run sync to update the native applications.

iOS

To test on iOS, run npm run ios which will open XCode, then using the UI run it in an emulator.

Note: Firefox and Chrome for iOS do not support custom protocols being typed into the address bar. Clicking links should work fine, however.

Android

To test on Android, run npm run android which will open the studio, then using the UI run it in an emulator.

Note: Android chrome does not support custom protocols - you will need to type intent://durin/CID_GOES_HERE#Intent;scheme=ipfs;end

Publishing

Apple: ios/App/App/info.plist version string needs to be bumped after each release. This prevents testflight from pulling and failing on already published version numbers.

Android: android/app/build.gradle versionName needs to be bumped for new publishing. Also versionCode needs to be bumped with each manual upload of the signed bundle.

Credits

Made with ❤️ by Justice Engineering & Trigram