Creating Posts

Posts are central to Sage Protocol’s content interactions, enabling rich markdown formatting and transparent blockchain-native interactions across channels and user profiles.

Posting in Channels

Users must follow a channel before creating posts within it. React Hook Example for Posting in Channels:

import { usePost } from '@sageprotocol/sdk/react';
import { useWallet } from '@suiet/wallet-kit';

function CreateChannelPost({ channelId, ownedUserId }) {
  const { postToChannel } = usePost();
  const { account, signAndExecuteTransaction } = useWallet();

  async function handleCreatePost() {
    const result = await postToChannel({
      amounts: [0, 0],                                // Required protocol fees
      appId: 'your-app-id',                           // Required application ID
      network: 'testnet',                             // 'testnet' or 'mainnet'
      channelId,                                      // Target channel ID
      title: 'Sui vs Ethereum: An In-Depth Analysis', // Post title in markdown
      description: 'Comparing scalability, security, and more.', // Markdown summary
      data: 'Sui provides high throughput and low latency compared to Ethereum...', // Main markdown content
      ownedUserId,                                    // Poster's owned user ID
      self: account.address                           // Poster's wallet address
    });

    if (result.ok) {
      await signAndExecuteTransaction({ transaction: result.transaction });
      console.log("Channel post created successfully!");
    } else {
      console.error("Error creating channel post:", result.err);
    }
  }

  return <button onClick={handleCreatePost}>Create Channel Post</button>;
}

export default CreateChannelPost;

Direct JavaScript Example for Posting in Channels

import { SageClient } from '@sageprotocol/sdk';

const sageClient = new SageClient({
  appId: 'your-app-id',                     // Required application ID
  channelRegistryId: 'your-registry-id',    // Required channel registry ID
  network: 'testnet'                        // 'testnet' or 'mainnet'
});

await sageClient.initialize();

async function postToChannel(channelId, ownedUserId, walletAddress) {
  const result = await sageClient.postToChannel({
    amounts: [0, 0],                                 // Required protocol fees
    channelId,                                       // Target channel ID
    title: 'Sui vs Ethereum: An In-Depth Analysis',  // Post title in markdown
    description: 'Comparing scalability, security, and more.', // Markdown summary
    data: 'Sui provides high throughput and low latency compared to Ethereum...', // Main markdown content
    ownedUserId,                                     // Poster's owned user ID
    self: walletAddress                              // Poster's wallet address
  });

  if (result.ok) {
    await signAndExecuteTransaction({ transaction: result.transaction });
    console.log("Channel post created successfully!");
  } else {
    console.error("Error creating channel post:", result.err);
  }
}

postToChannel('your-channel-id', 'your-owned-user-id', walletAddress);

Posting on User Profiles

Users can directly post onto profiles for personal interactions, endorsements, or recommendations. React Hook Example for Posting to User Profiles:

import { usePost } from '@sageprotocol/sdk/react';
import { useWallet } from '@suiet/wallet-kit';

function PostToUser({ targetSharedUserId, ownedUserId }) {
  const { postToUser } = usePost();
  const { account, signAndExecuteTransaction } = useWallet();

  async function handlePostToUser() {
    const result = await postToUser({
      amounts: [0, 0],                                 // Required protocol fees
      appId: 'your-app-id',                            // Required application ID
      network: 'testnet',                              // 'testnet' or 'mainnet'
      sharedUserId: targetSharedUserId,                // Target user's shared user ID
      title: 'Professional Endorsement',               // Post title in markdown
      description: 'Recognizing outstanding contributions', // Markdown summary
      data: 'Thanks for your amazing support and mentorship!', // Main markdown content
      ownedUserId,                                     // Poster's owned user ID
      self: account.address                            // Poster's wallet address
    });

    if (result.ok) {
      await signAndExecuteTransaction({ transaction: result.transaction });
      console.log("Posted to user profile successfully!");
    } else {
      console.error("Error posting to user profile:", result.err);
    }
  }

  return <button onClick={handlePostToUser}>Post to User</button>;
}

export default PostToUser;

Direct JavaScript Example for Posting to User Profiles

import { SageClient } from '@sageprotocol/sdk';

const sageClient = new SageClient({
  appId: 'your-app-id',                    // Required application ID
  channelRegistryId: 'your-registry-id',   // Required channel registry ID
  network: 'testnet'                       // 'testnet' or 'mainnet'
});

await sageClient.initialize();

async function postToUser(targetSharedUserId, ownedUserId, walletAddress) {
  const result = await sageClient.postToUser({
    amounts: [0, 0],                                  // Required protocol fees
    sharedUserId: targetSharedUserId,                 // Target user's shared user ID
    title: 'Professional Endorsement',                // Post title in markdown
    description: 'Recognizing outstanding contributions', // Markdown summary
    data: 'Thanks for your amazing support and mentorship!', // Main markdown content
    ownedUserId,                                      // Poster's owned user ID
    self: walletAddress                               // Poster's wallet address
  });

  if (result.ok) {
    await signAndExecuteTransaction({ transaction: result.transaction });
    console.log("Posted to user profile successfully!");
  } else {
    console.error("Error posting to user profile:", result.err);
  }
}

postToUser('target-shared-user-id', 'your-owned-user-id', walletAddress);

Content Guidelines and Best Practices

Markdown Formatting:

Posts support rich markdown: text, headers, images, and embedded links.

Example:

# Heading
**Bold Text**  
![Image](https://example.com/image.png)  
[Link](https://example.com)

Always sanitize markdown inputs to prevent security risks like Cross-Site Scripting (XSS).

Threaded Conversations:

Clearly visualize comment threads in the UI for conversational clarity.
Comments are structured as blockchain-native posts explicitly linked to parent posts.

Moderation:

Leverage built-in moderation tools (addModerator, removeModerator) to proactively manage content quality.

Encouraging Engagement:

Clearly display user incentives and rewards linked to valuable interactions via Proof of Social Contribution (PoSC).

Common Use Cases:

Technical Discussions: Comparing technologies, best practices, research sharing.
Community Updates: Announcements, news, progress reports.
Professional Endorsements: Public recommendations and acknowledgments.

Introduction

Primitives

Posting in Channels

Posting on User Profiles

Content Guidelines and Best Practices

Common Use Cases:

​Posting in Channels

​Posting on User Profiles

​Content Guidelines and Best Practices

​Common Use Cases:

Posting in Channels

Posting on User Profiles

Content Guidelines and Best Practices

Common Use Cases: