Workflows¶

Step-by-step guides for common Sage Protocol operations. Each workflow covers the CLI commands, SDK calls, and contract interactions involved.

Publishing¶

Get content from your local workspace to an on-chain governed library.

Guide	Description
First Library	Wallet setup, workspace init, first publish
Publishing & Versioning	IPFS pinning, governance proposals, version management
Premium Prompts	Pricing, Lit Protocol access, SXXX payments

Quick path:

sage prompts init                              # Create workspace
# Add prompts to prompts/
sage project push                              # Pin to IPFS
sage project propose manifest.json --dao 0x...  # Create proposal

DAO Setup¶

Deploy and configure a DAO for your team or community.

Guide	Description
Creating a DAO	Playbook selection, deployment, initial config
Managing Members	Roles, permissions, Safe multisig
Creating Bounties	Posting rewards, reviewing submissions

Quick path:

sage dao create-playbook --playbook council-closed \
  --name "Team Library" \
  --owners "0xAlice,0xBob,0xCarol" \
  --threshold 2

sage dao doctor --subdao 0x...   # Verify wiring

Governance¶

Participate in DAO decision-making.

Guide	Description
Joining a DAO	Discovery, membership, governance
Delegation & Voting Power	Delegation, vote gates, multipliers
Voting on Proposals	Casting votes, queue/execute

Quick path:

sage sxxx delegate-self                    # Enable voting power
sage governance vote <proposal> --support for
sage governance queue <proposal>           # After vote passes
sage governance execute <proposal>         # After timelock delay

Agent Integration¶

Build AI agents that discover and use governed content.

Guide	Description
Agent Workflows	End-to-end agent patterns, sage-skill
MCP Server	Starting server, available endpoints
Subgraph & Discovery	GraphQL queries, indexing events
SDK Integration	Node.js and browser SDK usage

Quick path:

sage mcp start                             # Start MCP server

# Agents should prefer MCP tools over inventing custom endpoints:
# - search_prompts / search_onchain_prompts
# - get_prompt
# - generate_publishing_commands

Workflow Comparison¶

Task	CLI Command	SDK surface
Discover libraries	`sage dao list`, `sage prompts search`	`sdk.subgraph.*`, `sdk.DiscoveryClient`
Fetch manifest/prompt by CID	`sage ipfs fetch <cid>`	`sdk.services.IPFSService.fetchByCID`
Build a proposal transaction	`sage project propose`	`sdk.governance.buildProposeTx`
Build a vote transaction	`sage governance vote`	`sdk.governance.buildCastVoteTx`
Build queue/execute transactions	`sage governance queue\|execute`	`sdk.governance.buildQueueTx`, `sdk.governance.buildExecuteTx`

Prerequisites¶

All workflows assume:

CLI installed: npm install -g @sage-protocol/cli
Wallet connected: sage wallet init
Test SXXX: sage sxxx faucet (Base Sepolia)
DAO selected: sage dao use 0x... or --dao flag

See CLI Quick Start for setup details.