To run everything here, you’ll need fennel-api and fennel-protocol running as well. Instructions for these components can be found on the following Notion page:
Grant 2 Milestone 1 Testing Guide
The major changes to fennel-app this milestone covered changes in the way that Substrate keys are handled, and the addition of IPFS support so that large objects like public keys can be submitted to decentralized storage without needing to submit their full length to the chain.
You’ll either need to run our fennel-app Docker Compose configuration, which includes an IPFS container, or download and install IPFS Desktop from https://docs.ipfs.tech/install/ipfs-desktop/. Note that if you use IPFS Desktop you’ll need to copy the contents of fennel-app/ipfs/config into your IPFS node’s configuration file (under settings).
You’ll most likely need to run fennel-app without Docker, but you can run docker compose up ipfs -d to run a local IPFS node.
Rather than manually importing seed phrases, we’ve tied in the Polkadot.js browser extension. All you’ll need to do is download the extension from https://polkadot.js.org/extension/ and create an account. Fennel will take care of the rest!
This version of fennel-app introduces a new interface for committing variable-length text data to IPFS as a file. You can find it on the Manage Identity page under IPFS:
Here you’ll see a form with two text boxes and two buttons. To submit text to IPFS, enter it into the “Text” box and click “Save file”. This will return an IPFS CID. To get text back from a CID, put the CID in the “CID” box and click “Get File”. This will populate the “Text” box with the material saved at that IPFS hash.
Our changes to whiteflag-rust bring fennel-cli to full support for our Whiteflag implementation. The Whiteflag interface in fennel-app is the easiest way to fully test this through the WebSocket RPC exposed by fennel-cli.
To prepare the CLI for RPC use, run the following:
cargo update
cargo run -- start-rpc
IMPORTANT: To just run the test suite, always run our ./scripts/build-test.sh script.