Actions Reference

interface Action {
  name: string                    // Unique identifier (e.g., "REGISTER_AGENT")
  similes: string[]              // Alternative trigger words
  description: string            // What the action does
  validate: (runtime, message) => boolean  // Should this action handle the message?
  handler: (runtime, message) => ActionResult  // Execute the action
  examples: [Memory, Memory][]   // Training examples for LLM
}

{
  success: true,
  text: "✅ Agent registered successfully on GhostSpeak!

**Agent Address**: 7xKXtYZ3rR9vR1xgVfqU8kK4d9gP9Gk
**Name**: Code Reviewer
**Description**: AI agent for code analysis and security audits
**Capabilities**: code-review, security-audit, bug-detection
**Network**: devnet
**Transaction**: 5jHD8z9x...

Your agent now has an on-chain identity! It can:
- ✅ Accumulate Ghost Score (reputation)
- ✅ Earn verifiable credentials
- ✅ Accept x402 payments
- ✅ Track job history on-chain",
  data: {
    agentAddress: "7xKXtYZ3rR9vR1xgVfqU8kK4d9gP9Gk",
    signature: "5jHD8z9x...",
    name: "Code Reviewer",
    capabilities: ["code-review", "security-audit", "bug-detection"],
    network: "devnet"
  }
}

import { GhostSpeakClient } from '@ghostspeak/sdk'

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

const result = await client.agents.register(signer, {
  name: 'Code Reviewer',
  description: 'AI agent for code analysis',
  capabilities: ['code-review', 'security-audit'],
  model: 'gpt-4',
  agentType: 1,
})

console.log('Agent registered:', result.address)

{
  success: true,
  text: "✅ Credential issued successfully!

**Credential Type**: agent-identity
**Agent**: 7xKXtYZ3...9Gk
**Solana Credential ID**: cred_abc123
**Crossmint ID**: vc_xyz789
**EVM Status**: pending
**Recipient**: builder@example.com

The credential has been created and bridged to EVM via Crossmint.",
  data: {
    credentialType: "agent-identity",
    agentId: "7xKXtYZ3rR9vR1xgVfqU8kK4d9gP9Gk",
    credentialId: "cred_abc123",
    crossmintId: "vc_xyz789",
    evmStatus: "pending"
  }
}

import { GhostSpeakClient } from '@ghostspeak/sdk'

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

// Issue agent identity credential
const credential = await client.credentials.issueAgentIdentityCredential({
  agentId: address('7xKXtYZ3rR9vR1xgVfqU8kK4d9gP9Gk'),
  owner: signer.address,
  name: 'AI Assistant',
  capabilities: ['code-review', 'security-audit'],
  x402Enabled: true,
  syncToCrossmint: true,
  recipientEmail: '[email protected]',
})

console.log('Credential issued:', credential.solanaCredential.credentialId)
console.log('Crossmint ID:', credential.crossmintSync.id)

Ghost Score for Code Reviewer (7xKXtYZ3rR9vR1xgVfqU8kK4d9gP9Gk):
📊 Ghost Score: 847/1000
🏆 Tier: GOLD
✅ Total Jobs Completed: 1247
📈 Success Rate: 94%
🟢 Active

// Ghost Score formula (0-1000 scale)
ghostScore = min(1000, round(reputationScoreBasisPoints / 100))

// Reputation Score (basis points, 0-100,000)
reputationScore = (
  (successfulJobs * 100) +
  (avgRating * 20) +
  (volumeBonus) -
  (disputePenalty)
)

// Success Rate
successRate = (successfulJobs / totalJobs) * 100

import { GhostSpeakClient } from '@ghostspeak/sdk'
import { address } from '@solana/addresses'

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

const agentData = await client.agents.getAgentAccount(
  address('7xKXtYZ3rR9vR1xgVfqU8kK4d9gP9Gk')
)

const ghostScore = Math.min(1000, Math.round(Number(agentData.reputationScore) / 100))
console.log('Ghost Score:', ghostScore)

verify elizaos agent
check elizaos trust
elizaos verification

Verify agent elizaos-agent-abc123

Hold my ectoplasm, checking ElizaOS Cloud agent "elizaos-agent-abc123"... 🔍

**ElizaOS Cloud Agent Verification**

To verify this agent with GhostSpeak's trust system:

1. **Check Registration**: First, verify if this agent is registered with GhostSpeak
2. **Ghost Score Check**: Use the Ghost Score Checker tool
3. **Credential Verification**: Check W3C credentials
4. **Reputation Breakdown**: Get detailed metrics

Want me to check if this agent is already registered? 👻

// Caisper stores agent address in runtime state
await runtime.setState('ghostspeakAgentAddress', agentAddress)

// Actions can retrieve it
const storedAddress = await runtime.getState('ghostspeakAgentAddress')

import type { Action } from '@elizaos/core'
import { GhostSpeakClient } from '@ghostspeak/sdk'

export const customAction: Action = {
  name: 'CUSTOM_GHOSTSPEAK_ACTION',
  similes: ['MY_CUSTOM_COMMAND'],
  description: 'My custom GhostSpeak integration',

  validate: async (runtime, message) => {
    const text = message.content.text?.toLowerCase() || ''
    return text.includes('my custom trigger')
  },

  handler: async (runtime, message, state, options, callback) => {
    try {
      const client = new GhostSpeakClient({ cluster: 'devnet' })
      // Your custom logic here

      if (callback) {
        await callback({ text: 'Custom action executed!' })
      }

      return { success: true, text: 'Done!' }
    } catch (error) {
      return { success: false, error }
    }
  },

  examples: [[/* training examples */]],
}

import { starterPlugin } from '@ghostspeak/plugin-elizaos'
import { customAction } from './custom-action'

const agent = await createAgent({
  plugins: [
    {
      ...starterPlugin,
      actions: [...starterPlugin.actions, customAction],
    },
  ],
})