SocialFi on Hedera

iBird is an Open-Source, Community-Driven, Web3 Social Media Built on Hedera

iBird - A Decentralized Social Media Platform

Introduction

iBird is a decentralized social media platform built on the Hedera Hashgraph network, leveraging its Hedera Consensus Service (HCS) and Hedera Token Service (HTS). The platform aims to provide a censorship-resistant, open-source, and user-controlled environment for social interactions, content creation, and sharing.

Key Features 🌟

Post Messages: Share your thoughts with text and media
Create Threads: Start conversations and discussions
Create Polls: Get community opinions
Tip Content Creators: Support your favorite creators directly
Own Your Profile: Your profile is an NFT that you control
Censorship Resistant: No central authority can remove your content
Media Storage: All media is stored on Arweave for permanence

Architecture

iBird consists of two main components:

Backend: Hedera Hashgraph Network
- Hedera Consensus Service (HCS): Used for creating decentralized, auditable logs of timestamped events.
- Hedera Token Service (HTS): Used for creating and managing user profile NFTs.
Frontend: User Interface and Logic
- Handles the interface and user interactions.
- Includes the logic for writing data to and reading data from the Hedera network.

Data Flow Architecture 🔄

Message Publishing Flow
- User creates content
- Content is serialized to JSON
- Media (if any) is uploaded to Arweave
- Message is submitted to appropriate HCS topic
- Message is mirrored across the network
- Client applications receive updates via mirror nodes

Topic Hierarchy

Root
├── Universal Explorer (0.0.4976953)
│   ├── Posts
│   ├── Thread References
│   └── Poll References
│
└── User Profiles
    ├── Profile Topic
    │   └── Profile Information
    └── User Messages Topic
        ├── Personal Posts
        ├── Thread Participations
        └── Poll Participations

NFT Profile System
- Metadata contains:
  - Profile Topic ID
  - User Messages Topic ID
  - Account ID
  - Creation timestamp

Data Structure and Communication

Universal Explorer

All posts, threads, and polls are recorded on this public topic.
Enables reading of all messages sent by users on iBird.

Explore Topic:

{
  "Type": "Post",
  "Message": "Free speech is paramount, but in our current landscape, it's under threat. iBird emerges as a sanctuary for unfiltered expression, protected by Hedera, ensuring our voices soar beyond the reach of censorship.🎙️",
  "Media": null
}

{ "Type": "Thread", "Thread": "0.0.5706419" }

{ "Type": "Poll", "Poll": "0.0.5679056" }

Message Types
- Posts
  - A simple way to broadcast your message on Hedera. Posts do not support interactive features like replies or likes.
  - Post in Explore Topic:
```
{
  "Type": "Post",
  "Message": "Free speech is paramount, but in our current landscape, it's under threat. iBird emerges as a sanctuary for unfiltered expression, protected by Hedera, ensuring our voices soar beyond the reach of censorship.🎙️",
  "Media": null
}
```
    - Total Network Fee: $0.0001
      
      Fee Type Amount
      
      Post $0.0001
- Threads
  - A thread enables users to engage in deeper, focused discussions on particular subjects. Each thread starts with an initial topic message and can encompass a wide range of responses and interactions.
  - Thread Topic in Explore Topic:
```
{ "Type": "Thread", "Thread": "0.0.5706419" }
```
  - Thread Topic:
```
{
  "Message": "On iBird, every conversation, every interaction, is a step towards a freer digital world. Engage, create, share, and do it on your terms. Welcome to the future of social networking.",
  "Media": null
}
```
    - Total Network Fee: $0.0104
      
      Fee Type Amount
      
      Creating Thread Topic $0.01
      
      Initiating Thread Topic $0.0001
      
      Publishing on Explore $0.0001
      
      Adding To User Messages $0.0001
      
      Sending Message $0.0001
  - Writing Comments:
```
{
  "Author": "0.0.123456",
  "Reply_to": "sequence Number of the message we want to write comment for",
  "Message": "Hi"
}
```
    - Total Network Fee: $0.0001
      
      Fee Type Amount
      
      Sending Comment $0.0001
  - Liking a Message:
```
{
  "Author": "AccountId1",
  "Like_to": "sequenceNumber of the message we want to like"
}
```
    - Total Network Fee: $0.0001
      
      Fee Type Amount
      
      Sending Like $0.0001
  - Disliking a Message:
```
{
  "Author": "AccountId1",
  "Dislike_to": "sequenceNumber of the message we want to dislike"
}
```
    - Total Network Fee: $0.0001
      
      Fee Type Amount
      
      Sending DisLike $0.0001
- Polls
  - Polls are used to gauge opinions or votes on specific questions or propositions. Similar to threads, each poll is associated with a unique topic where all votes and options are recorded.
  - Poll Topic in Explore Topic:
```
{
  "Type": "Poll",
  "Poll": "0.0.5679056"
}
```
  - Poll Topic:
```
{
  "Message": "Question?",
  "Media": "ar://bafkreicsd3imsxhqyjbew2uldrojftxkwcz2w2zjs2jjismdf4d75ns7hu",
  "Choice1": "A",
  "Choice2": "B",
  "Choice3": null,
  "Choice4": null,
  "Choice5": null
}
```
    - Total Network Fee: $0.0104
      
      Fee Type Amount
      
      Creating Poll Topic $0.01
      
      Initiating Poll Topic $0.0001
      
      Publishing on Explore $0.0001
      
      Adding To User Messages $0.0001
      
      Sending Message $0.0001
  - Voting:
```
{
  "Choice": "selectedChoice"
}
```
    - Total Network Fee: $0.0001
      
      Fee Type Amount
      
      Sending Vote $0.0001

Media Storage

All media files are stored on Arweave.

{
  "Type": "Post",
  "Message": "ASSET Token holders have just received their income share from iBird, the open-source, community-driven, web3 social media built on hedera.",
  "Media": "ar://bafkreic35uavltr2pb6gsoisv54fytj77felckswkzlglakt25vcbpil6y"
}

User Profiles

When a user creates a profile:

A USER MESSAGES topic is created to save the user's messages.
A USER PROFILE TOPIC is created to store user information and the USER MESSAGES topic.
A user profile NFT is minted, with the USER PROFILE TOPIC added as metadata.
The user has full control over their profile NFT, which is saved in their wallet.

To update profile information, the user sends a new message to the USER PROFILE TOPIC, and iBird reads the last message as the current user profile data.

User Profile Topic:

{
  "Identifier": "iAssets",
  "Type": "Profile",
  "Author": "0.0.5706201",
  "Name": "iAssets",
  "Bio": "iBird is an Open-Source, Community-Driven, Web3 Social Media Built on Hedera by iAssets.",
  "Website": "ibird.community",
  "Location": "",
  "UserMessages": "0.0.5706263",
  "Picture": "ar://bafkreieltouugsbgruyd7u2pbwlp2oe2xd7scmvjzdkgv6a7a6gosksram",
  "Banner": null
}

User Messages Topic is just like Explore Topic but only save user messages:

{
  "Type": "Post",
  "Message": "Free speech is paramount, but in our current landscape, it's under threat. iBird emerges as a sanctuary for unfiltered expression, protected by Hedera, ensuring our voices soar beyond the reach of censorship.🎙️",
  "Media": null
}

{ "Type": "Thread", "Thread": "0.0.5706419" }

{ "Type": "Poll", "Poll": "0.0.5679056" }

Total Network Fee: $1.0402

Fee Type	Amount
Creating User Messages Topic	$0.01
Initiating User Messages Topic	$0.0001
Creating User Profile Topic	$0.01
Initiating User Profile Topic	$0.0001
Creating User Profile NFT	$1
Minting User Profile NFT	$0.02

Transaction Flow

Content Creation

sequenceDiagram
User->>Wallet: Sign transaction
Wallet->>HCS: Submit to topic
HCS->>Mirror Nodes: Consensus & mirror
Mirror Nodes->>Client: Update feed

Tipping and Rewards

iBird supports user tipping, with 99% of each tip going to the content creator and 1% to iBird for platform improvement.

Open Source and Decentralization

iBird is open-source, allowing anyone to download and run the platform on their system.
The platform does not rely on centralized servers, making it fully decentralized.

Future Plans

Develop mobile applications for iBird.
Quote feature enabling users to share and comment on existing posts while preserving attribution.
Solve the challenge of storing follower and following relationships on-chain.

Getting Started 🚀

Connect your Hedera wallet
Create your profile (costs ~$1.04)
Start posting, commenting, and engaging!

Building Together

iBird leverages the power of the Hedera Hashgraph network to create a decentralized, censorship-resistant social media platform. By utilizing HCS for message ordering and timestamping, HTS for user profile management, and Arweave for media storage, iBird offers a unique and innovative approach to social networking. The open-source nature of the platform ensures transparency and allows for community-driven development, while the decentralized architecture provides users with control over their data and interactions. Feel free to participate in the project, propose improvements, or raise issues. Whether you're making changes to the existing code or suggesting new features, your contribution will shape the future!

License

This project is anchored by the Creative Commons Attribution-NonCommercial 4.0 International Public License - see the LICENSE file for details.

Name		Name	Last commit message	Last commit date
Latest commit History 63 Commits
android		android
ios		ios
public		public
src		src
.env		.env
.env.example		.env.example
.gitignore		.gitignore
LICENSE.md		LICENSE.md
README.md		README.md
capacitor.config.ts		capacitor.config.ts
next.config.js		next.config.js
package-lock.json		package-lock.json
package.json		package.json
server.js		server.js
tailwind.config.js		tailwind.config.js
tsconfig.json		tsconfig.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

SocialFi on Hedera

iBird is an Open-Source, Community-Driven, Web3 Social Media Built on Hedera

Introduction

Key Features 🌟

Architecture

Data Flow Architecture 🔄

Data Structure and Communication

User Profiles

Transaction Flow

Tipping and Rewards

Open Source and Decentralization

Future Plans

Getting Started 🚀

Building Together

License

About

Releases

Packages

Languages

Fee Type	Amount
Creating Thread Topic	$0.01
Initiating Thread Topic	$0.0001
Publishing on Explore	$0.0001
Adding To User Messages	$0.0001
Sending Message	$0.0001

Fee Type	Amount
Creating Poll Topic	$0.01
Initiating Poll Topic	$0.0001
Publishing on Explore	$0.0001
Adding To User Messages	$0.0001
Sending Message	$0.0001

License

iassetsorg/Project-Harriet

Folders and files

Latest commit

History

Repository files navigation

SocialFi on Hedera

iBird is an Open-Source, Community-Driven, Web3 Social Media Built on Hedera

Introduction

Key Features 🌟

Architecture

Data Flow Architecture 🔄

Data Structure and Communication

User Profiles

Transaction Flow

Tipping and Rewards

Open Source and Decentralization

Future Plans

Getting Started 🚀

Building Together

License

About

Topics

Resources

License

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages