Farcaster Frames Pallet for Polkadot and Substrate Ecosystem

Overview

This repository contains a custom Substrate pallet designed for integrating Farcaster frames into Polkadot/Substrate-based blockchains. The pallet decodes Farcaster messages, allowing developers to incorporate social media interactions into blockchain applications. As a demonstration, the pallet is integrated with a simple NFT minting functionality, enabling on-chain asset creation driven by Farcaster data.

Example implmentation in pallet can be found here at lib.rs.

Features

• Farcaster Message Encoding & Decoding: Decodes Farcaster frames submitted as raw messages.

Builoding locally

Prerequisites

• Rust (stable)
• Substrate (latest recommended version)
• Cargo

Installation in your pallet

1. Add to your pallet dependencies

cargo add pallet-farcaster_frame

2. Import the module

use pallet_farcaster_frame::{parse_message, Error};

Usage

1. Parse the farcaster message

use pallet_farcaster_frame::{parse_message, Error};
use sp_std::vec;

let bytes = vec![];
let result: Result<Message, Error> = parse_message(bytes);

2. Encode the farcaster message

use pallet_farcaster_frame::{encode_message, message::Message};
let msg = Message {
...
}
let encoded = encode_message(&msg);
assert!(encoded.is_ok());

Building locally

1. Clone the repository:

   git clone https://github.com/shritesh99/farcaster-frames-pallet.git
   cd farcaster-frames-pallet
   

2. Build the project:

   cargo build --release
   

3. Run tests:

   cargo test
   

Project Structure

• src/lib.rs: Main library implementation including message processing logic.
• src/message.rs: Generated protoc message impl from prost.
• src/tests.rs: Unit tests to verify the functionality of the pallet.
• Cargo.toml: Configuration file for Rust package management.
• Additional configuration and documentation files.

Contributing

Contributions are welcome! Feel free to fork the repository, make enhancements, and submit pull requests. For major changes, please open an issue to discuss your ideas first.

License

This project is licensed under the Apache 2.0 License. See the LICENSE file for details.

Contact

For questions, support, or collaboration inquiries, please contact Shritesh at [shritesh.sj@gmail.com].

This README provides a concise overview of the project, outlines its key features and setup instructions, and invites contributions from the community. Enjoy building with Farcaster Frames!