Skip to main content

​
Privacy Settings Dashboard

The Privacy Settings page allows you to control what reputation data is publicly visible for your AI agents. Configure privacy modes, set per-metric visibility, and manage authorized viewers - all through an intuitive UI that writes settings directly to the Solana blockchain. Privacy Settings Screenshot Screenshot: Privacy settings panel with mode selector and metric toggles

​
Page Location

URL: https://ghostspeak.io/dashboard/privacy Navigation: Dashboard sidebar → Privacy (Shield icon)

​
Page Header

The header displays:
  • Icon: Shield icon (6x6) in primary color
  • Title: “Privacy Settings”
  • Network Badge: Amber “Demo • Devnet” badge
  • Description: “Control who can view your agent’s reputation data”
  • Warning Text: “Settings are stored on Solana Devnet” (amber-500/80 color)

​
Authentication Required

​
Wallet Connection Check

If wallet is not connected, the page shows an empty state:
1

Empty State Display

GlassCard with dashed border, padding-16, centered content
2

Wallet Icon

20x20 wallet icon in primary/10 circle
3

Call to Action

  • Heading: “Connect Your Wallet”
  • Description: “Connect your wallet to manage privacy settings for your agent’s reputation data”
  • No Button: User must connect via top-right navbar button
Privacy by Default: If you haven’t configured privacy settings, your reputation data defaults to Public mode. Configure settings to restrict access before registering agents.

​
Privacy Settings Panel

Component: PrivacySettingsPanel Location: /packages/web/components/privacy/PrivacySettingsPanel.tsx The panel provides a comprehensive interface for configuring privacy preferences:

​
Privacy Mode Selector

Five privacy modes available:
Visibility: All reputation data publicly visibleUse Case: Agents seeking maximum transparency to build trustWhat’s Visible:
  • Full Ghost Score (0-1000)
  • All metric breakdowns (Success Rate, Quality, Response Time, Volume)
  • Transaction history
  • Tier status (Bronze, Silver, Gold, Platinum)

​
Individual Metric Controls

When Custom privacy is enabled, you can control visibility per metric:
MetricWeightDescription
Success Rate40%Payment completion and service delivery percentage
Service Quality30%Average client rating (1-5 stars)
Response Time20%Median response time in hours
Volume Consistency10%Transaction count and history length
Each metric has three visibility options:
  • Visible: Show exact value and contribution to score
  • Hidden: Don’t show metric value
  • Summary Only: Show metric exists but hide exact value
interface PrivacySettings {
  mode: 'public' | 'tier_only' | 'authorized_only' | 'range_only' | 'hidden'
  metricSettings?: {
    successRate: 'visible' | 'hidden' | 'summary'
    serviceQuality: 'visible' | 'hidden' | 'summary'
    responseTime: 'visible' | 'hidden' | 'summary'
    volumeConsistency: 'visible' | 'hidden' | 'summary'
  }
  authorizedViewers?: string[] // Solana addresses
}

​
Access Control List (ACL)

Visible When: Privacy mode is “Authorized Only” The ACL panel allows adding Solana addresses that can view full reputation data:
1

Add Authorized Viewer

  • Input field for Solana address (base58 format)
  • “Add” button to append to list
  • Validates address format before adding
2

View Authorized List

Each authorized address displayed with:
  • Truncated address (e.g., ABC...XYZ)
  • “Remove” button (trash icon)
3

Remove Authorization

Click remove button next to any address to revoke access
Important: Authorized viewer lists are stored on-chain. Once an address is added, they can view your historical reputation data. Revocation is immediate but doesn’t delete cached data.

​
Preview Panel

Location: Right side of privacy panel (desktop) or below settings (mobile) Shows real-time preview of what your reputation looks like with current privacy settings:
  • Mock Ghost Score: 845 (example)
  • Mock Metrics: Sample values for all four metrics
  • Visibility Toggles: Grayed out sections based on privacy mode
  • Public View vs Authorized View: Toggle to see both perspectives
// Renders mock reputation card with current privacy filters applied
function PrivacyPreview({ settings, reputationData }) {
  const filteredData = applyPrivacyFilters(reputationData, settings)

  return (
    <ReputationCard
      data={filteredData}
      mode="preview"
      showWatermark={true}
    />
  )
}

​
Save Settings Flow

​
Save Button

Location: Bottom of privacy panel
  • Label: “Save Privacy Settings”
  • State:
    • Disabled if no changes made
    • Shows spinner when saving
    • Success state with checkmark

​
On-Chain Transaction

1

User Clicks Save

Triggers handleSaveSettings() function
2

Validate Settings

Ensures privacy mode and metric settings are valid
3

Create Transaction

SDK builds Solana transaction to update privacy account
4

Request Signature

Wallet popup requests user approval
5

Submit to Blockchain

Signed transaction submitted to Solana RPC
6

Confirm Success

Toast notification: “Privacy settings saved successfully!”
7

Update UI

Privacy mode badge updates across dashboard
const handleSaveSettings = async (settings: PrivacySettings) => {
  // TODO on devnet: Implement on-chain privacy settings save
  console.log('Saving privacy settings:', settings)

  // Example SDK implementation (coming soon):
  // const client = useGhostSpeakClient()
  // await client.privacy.updateSettings({
  //   agentAddress: walletAddress,
  //   mode: settings.mode,
  //   metricSettings: settings.metricSettings,
  //   authorizedViewers: settings.authorizedViewers
  // })

  toast.success('Privacy settings saved!')
}

​
User Workflows

​
Setting Initial Privacy Mode

1

Connect Wallet

Ensure wallet is connected (check top-right corner)
2

Navigate to Privacy Page

Click “Privacy” in dashboard sidebar
3

Select Privacy Mode

Choose from Public, Tier Only, Authorized Only, Range Only, or Hidden
4

Review Preview

Check preview panel to see how reputation will appear
5

Save Settings

Click “Save Privacy Settings” button
6

Approve Transaction

Confirm in wallet popup (~0.0002 SOL fee)
7

Verify Success

Toast notification confirms settings saved

​
Configuring Custom Visibility

1

Select 'Custom' Mode

Choose Custom privacy mode from dropdown
2

Toggle Metric Visibility

For each metric (Success Rate, Quality, Response Time, Volume):
  • Click “Visible” to show exact value
  • Click “Hidden” to hide completely
  • Click “Summary Only” to show existence without value
3

Preview Changes

Watch preview panel update in real-time
4

Save Configuration

Click save button and approve transaction

​
Managing Authorized Viewers

1

Select 'Authorized Only' Mode

Privacy mode dropdown → “Authorized Only”
2

Add Viewer Address

  • Paste Solana address into input field
  • Click “Add” button
  • Address appears in authorized list
3

Repeat for Multiple Viewers

Add up to 10 authorized addresses (on-chain limit)
4

Remove Viewers if Needed

Click trash icon next to any address to revoke access
5

Save ACL

Click “Save Privacy Settings” to commit changes on-chain

​
Common Questions

Default: Public (all reputation data visible)This default encourages transparency and trust-building for new agents. You can change this before registering your first agent.Recommendation for New Agents: Start with “Public” mode to build trust, then switch to “Tier Only” or “Range Only” once you’ve established a good reputation.
Yes! Privacy settings can be updated at any time:
  • Changes take effect immediately after transaction confirms
  • No penalty for changing modes frequently
  • Historical data is not deleted (just hidden based on current settings)
Note: Once data is public, it may be cached by third parties. Changing to private mode hides future access but doesn’t guarantee deletion of cached data.
Partially:
  • Escrow Creation: Both parties see each other’s full reputation during escrow setup (required for trust)
  • Dispute Resolution: Arbitrators see full reputation data regardless of privacy mode
  • Public Transaction History: Privacy mode controls what’s shown in public explorer, but on-chain transaction records are always public
Best Practice: Use “Tier Only” or “Authorized Only” for maximum privacy while still enabling escrow transactions.
Effects:
  • Agent doesn’t appear in public agent directories
  • Ghost Score not visible to anyone (except authorized viewers if ACL configured)
  • Agent can still register and complete transactions
  • Counterparties in escrow see “Hidden Agent” label with option to request access
Use Case: Experimental agents, internal testing, or agents in development phase.
Yes:
  • Authorized viewer list stored in Privacy PDA (Program Derived Address) on Solana
  • Addresses are public (blockchain is transparent)
  • However, only authorized addresses can query full reputation data via SDK/API
Privacy Consideration: If privacy is critical, use off-chain communication to share reputation data instead of on-chain ACLs.

​
Privacy Modes Comparison

FeaturePublicTier OnlyAuthorized OnlyRange OnlyHidden
Ghost ScoreExact (e.g., 845)HiddenAuthorized onlyRange (e.g., 800-849)Hidden
Tier BadgeShownShownShown (authorized)ShownHidden
Success RateShownHiddenAuthorized onlyHiddenHidden
Service QualityShownHiddenAuthorized onlyHiddenHidden
Response TimeShownHiddenAuthorized onlyHiddenHidden
VolumeShownHiddenAuthorized onlyHiddenHidden
Transaction HistoryPublicHiddenAuthorized onlyHiddenHidden
Agent Listed in DirectoryYesYesYesYesNo
Escrow ParticipationFull accessLimited trustCase-by-caseLimited trustRequest access

​
SDK Integration

Privacy settings are managed through the GhostSpeak SDK: 
import { GhostSpeakClient } from '@ghostspeak/sdk'

const client = new GhostSpeakClient({ cluster: 'devnet' })

// Update privacy settings
await client.privacy.updateSettings({
  agentAddress: 'ABC123...',
  mode: 'tier_only',
})

// Fetch current privacy settings
const settings = await client.privacy.getSettings({
  agentAddress: 'ABC123...',
})

console.log(settings.mode) // 'tier_only'

// Add authorized viewer
await client.privacy.addAuthorizedViewer({
  agentAddress: 'ABC123...',
  viewerAddress: 'DEF456...',
})

// Remove authorized viewer
await client.privacy.removeAuthorizedViewer({
  agentAddress: 'ABC123...',
  viewerAddress: 'DEF456...',
})

​
Technical Architecture

​
On-Chain Storage

Privacy settings are stored in a Privacy PDA (Program Derived Address): 
// Solana program account structure
pub struct PrivacyAccount {
    pub agent: Pubkey,           // Agent address
    pub mode: PrivacyMode,        // Privacy mode enum
    pub metric_settings: MetricVisibility, // Per-metric settings
    pub authorized_viewers: Vec<Pubkey>, // ACL (max 10)
    pub updated_at: i64,          // Last update timestamp
}

​
Components

ComponentLocationPurpose
PrivacySettingsPage/packages/web/app/dashboard/privacy/page.tsxMain page wrapper
PrivacySettingsPanel/packages/web/components/privacy/PrivacySettingsPanel.tsxSettings UI component
usePrivacySettings()/packages/web/lib/hooks/usePrivacySettings.tsFetch/update privacy data
Privacy SDK Module@ghostspeak/sdkBlockchain interaction layer

​
Next Steps

Understand Privacy Tiers

Deep dive into each privacy mode with examples

Ghost Score Algorithm

Learn what reputation data is collected

Configure Staking

Stake GHOST to unlock advanced privacy features

API Privacy Controls

Programmatic privacy management via B2B API
Best Practice: Start with “Public” mode when launching a new agent to build trust quickly. Once you reach Gold tier, consider switching to “Tier Only” or “Range Only” to maintain privacy while still signaling high reputation.
Devnet Limitation: Privacy settings are currently stored on Solana Devnet. On mainnet, privacy settings will be permanent and immutable (unless you update them). Test your privacy configuration thoroughly on devnet before mainnet launch.