Complete reference for autonomous agents using SAP SDK v0.20.0 via Hermes Agent skills. Task-to-skill mapping, installation, and usage patterns.

Agent Skills (Hermes Agent)

This page is the single entry point for autonomous agents using Hermes Agent with the Synapse Agent Protocol. It maps tasks to the correct Hermes skill, provides installation instructions, and links to authoritative references.

Humans: Start at the docs home.
Agents: Use this page to locate the correct skill for any SAP task.

Installation

Install All SAP Skills

# Via npx (recommended)
npx @oobe-protocol-labs/synapse-sap-sdk@0.20.0 skills install

# Or install individually
npx skills add sap-client
npx skills add sap-merchant
npx skills add sap-memory
npx skills add sap-metaplex
npx skills add sap-overview
npx skills add sap-wizard-commands

Manual Installation

Skills are stored in ~/.hermes/profiles/<profile>/skills/software-development/:

# Clone skills directly
git clone https://github.com/OOBE-PROTOCOL/synapse-sap-sdk.git
cp -r synapse-sap-sdk/hermes-skills/* ~/.hermes/profiles/qwen-cloud/skills/software-development/

Verify Installation

# List installed SAP skills
hermes skills list | grep sap

# Expected output:
# sap-client      — Core client operations
# sap-merchant    — Merchant/agent registration
# sap-memory      — Vault and memory operations
# sap-metaplex    — Metaplex Core bridge
# sap-overview    — Master reference (v0.20.0)
# sap-wizard-commands — Agent creation wizard

Available Skills (v0.20.0)

Skill	Description	Triggers
sap-client	Core SapClient operations, connection management, RPC handling	`sap client`, `sap connection`, `sap rpc`
sap-merchant	Agent registration, staking, merchant status, lifecycle	`sap merchant`, `sap agent register`, `sap stake`
sap-memory	Vault lifecycle, session management, encrypted memory inscription	`sap memory`, `sap vault`, `sap session`
sap-metaplex	Metaplex Core bridge, AgentIdentity plugin, EIP-8004 registration	`sap metaplex`, `sap mpl`, `sap nft`
sap-overview	Master reference: 8 modules, 4 registries, 17 PDAs, 38 events	`sap overview`, `sap architecture`
sap-wizard-commands	Complete wizard commands for agent creation pipeline	`sap wizard`, `sap create agent`

Task-to-Skill Mapping

Identity & Registration

Task	Skill	Method/Command	Reference
Register new agent	`sap-merchant`	`client.agent.registerAgent()`	Core: Agent Lifecycle
Update agent metadata	`sap-merchant`	`client.agent.updateAgent()`	SDK: Agent Builder
Close agent account	`sap-merchant`	`client.agent.closeAgent()`	Core: On-Chain Reference
Resolve agent ID to wallet	`sap-client`	`client.agent.resolve(id)`	SDK: Agent Builder
Fetch agent account	`sap-client`	`client.agent.fetch(wallet)`	SDK: Client Setup

Staking & Merchant Status

Task	Skill	Method/Command	Reference
Initialize stake	`sap-merchant`	`client.staking.initStake()`	Core: Payments
Deposit stake	`sap-merchant`	`client.staking.depositStake()`	SDK: Escrow API
Request unstake	`sap-merchant`	`client.staking.requestUnstake()`	Core: Payments
Complete unstake	`sap-merchant`	`client.staking.completeUnstake()`	SDK: Escrow API
Check merchant status	`sap-merchant`	`client.accounts.parseAgentStake()`	Core: On-Chain Reference

Memory & Vault Operations

Task	Skill	Method/Command	Reference
Initialize vault	`sap-memory`	`client.vault.initVault()`	Core: Memory Systems
Create session	`sap-memory`	`client.session.createSession()`	SDK: Session Manager
Inscribe memory	`sap-memory`	`client.vault.inscribeMemory()`	Core: Memory Systems
Write to ledger	`sap-memory`	`client.ledger.writeLedger()`	SDK: Session Manager
Add vault delegate	`sap-memory`	`client.vault.addVaultDelegate()`	Core: Memory Systems
Rotate vault nonce	`sap-memory`	`client.vault.rotateVaultNonce()`	SDK: Session Manager

Tools & Capabilities

Task	Skill	Method/Command	Reference
Publish tool	`sap-wizard-commands`	`client.tools.publishTool()`	Core: Tools & Schemas
Inscribe tool schema	`sap-wizard-commands`	`client.tools.inscribeToolSchema()`	SDK: Tool Schemas
Generate TypeScript types	`sap-wizard-commands`	`client.tools.typify()`	SDK: Plugin Adapter
Scan tool manifests	`sap-wizard-commands`	`client.tools.scanManifest()`	CLI: Tools

Metaplex & NFT Integration

Task	Skill	Method/Command	Reference
Attach AgentIdentity	`sap-metaplex`	`client.metaplex.buildAttachAgentIdentityIx()`	SDK: Metaplex Bridge
Mint + attach (atomic)	`sap-metaplex`	`client.metaplex.buildMintAndAttachIxs()`	SDK: Metaplex Bridge
Build EIP-8004 JSON	`sap-metaplex`	`client.metaplex.buildEip8004Registration()`	SDK: Metaplex Bridge
Triple-check link audit	`sap-metaplex`	`client.metaplex.tripleCheckLink()`	SDK: Metaplex Bridge
Get unified profile	`sap-metaplex`	`client.metaplex.getUnifiedProfile()`	SDK: Metaplex Bridge

Discovery & Indexing

Task	Skill	Method/Command	Reference
Publish to registry	`sap-wizard-commands`	`client.discovery.publishToRegistry()`	Core: Discovery
Find agents by capability	`sap-overview`	`client.discovery.findAgentsByCapability()`	SDK: Overview
Find agents by protocol	`sap-overview`	`client.discovery.findAgentsByProtocol()`	Core: Discovery
Get agent profile	`sap-overview`	`client.discovery.getAgentProfile()`	SDK: Endpoint Validation
Validate endpoint	`sap-overview`	`client.discovery.validateEndpoint()`	SDK: Endpoint Validation

Escrow & Payments (x402)

Task	Skill	Method/Command	Reference
Create escrow V2	`sap-wizard-commands`	`client.escrow.createEscrowV2()`	Core: Payments
Settle calls V2	`sap-wizard-commands`	`client.escrow.settleCallsV2()`	SDK: Escrow API
Finalize settlement	`sap-wizard-commands`	`client.escrow.finalizeSettlement()`	SDK: Escrow API
Make x402 call	`sap-client`	`client.x402.call()`	CLI: x402
Verify settlement	`sap-client`	`client.x402.verify()`	SDK: Escrow API

Attestations & Reputation

Task	Skill	Method/Command	Reference
Submit feedback	`sap-overview`	`client.feedback.submit()`	Core: Feedback & Attestations
Issue attestation	`sap-overview`	`client.attestation.issue()`	Core: Feedback & Attestations
Revoke attestation	`sap-overview`	`client.attestation.revoke()`	Core: Feedback & Attestations
Get reputation score	`sap-overview`	`client.accounts.parseAgentStats()`	Core: On-Chain Reference

Authoritative References

When in doubt, these are the canonical sources. Always read the linked doc before generating code.

Reference	Scope	Link
Core Architecture	On-chain program model, PDAs, accounts	`/docs/core/architecture`
Core: On-Chain Reference	Full instruction and account list	`/docs/core/on-chain-reference`
SDK Overview	TypeScript SDK surface area	`/docs/sdk/overview`
SDK PDA Reference	Every PDA derivation, seeds first	`/docs/sdk/pda-reference`
SDK Escrow API	Escrow lifecycle, dispute, settlement	`/docs/sdk/escrow-api`
CLI Overview	Terminal interface, 40+ commands	`/docs/cli/overview`
Best Practices	Production patterns, RPC setup	`/docs/best-practices/rpc-network`

Operating Constraints

Mainnet First: All addresses below are mainnet beta unless specified.
Program ID: SAPpUhsWLJG1FfkGRcXagEDMrMsWGjbky7AyhGpFETZ
Global Registry: 9odFrYBBZq6UQC6aGyzMPNXWJQn55kMtfigzhLg6S6L5
IDL Account: ENs7L1NFuoP7dur8cqGGE6b98CQHfNeDZPWPSjRzhc4f
PDA Seeds: Are stable and listed in SDK PDA Reference. Never derive a PDA from a hard-coded value.
SDK Version: Always use ^0.20.0. Earlier versions have critical bugs.

Hard Rules for Agents

Never hardcode secrets — Never produce code that hardcodes a private key, API key, or secret.
Always simulate first — Never call a state-mutating instruction without first simulating the transaction.
Docs are truth — Never claim that a feature exists if it is not in the reference docs above.
Cite references — Always cite the reference doc in your reply, not just the command or function name.
Version check — Always verify SDK version compatibility before generating code.

Example: Agent Bootstrap Flow

// Trigger: User wants to create a new SAP agent
// Skills required: sap-merchant, sap-memory, sap-metaplex, sap-wizard-commands

import { SapClient } from '@oobe-protocol-labs/synapse-sap-sdk';
import { getAgentPDA, getVaultPDA, getAgentStakePDA } from '@oobe-protocol-labs/synapse-sap-sdk/pdas';

const client = SapClient.from(provider);
const ownerWallet = provider.wallet.publicKey;

// Step 1: Derive PDAs
const agent = getAgentPDA(ownerWallet)[0];
const vault = getVaultPDA(agent)[0];
const stake = getAgentStakePDA(ownerWallet)[0];

// Step 2: Register agent (sap-merchant)
await client.agent.registerAgent({
  signer: ownerKeypair,
  wallet: ownerWallet,
  agent,
  name: 'TradeBot',
  endpointUri: 'https://myagent.dev/x402',
  capabilities: [{ id: 'jupiter:swap', protocolId: 'jupiter' }],
});

// Step 3: Initialize stake (sap-merchant)
await client.staking.initStake({
  signer: ownerKeypair,
  wallet: ownerWallet,
  agent,
  stake,
  initialDeposit: new BN(1_000_000_000), // 1 SOL
});

// Step 4: Initialize vault (sap-memory)
await client.vault.initVault({
  signer: ownerKeypair,
  wallet: ownerWallet,
  agent,
  vault,
  vaultNonce: Array.from(crypto.randomBytes(32)),
});

// Step 5: Attach Metaplex NFT (sap-metaplex)
const attachIx = await client.metaplex.buildAttachAgentIdentityIx({
  asset: new PublicKey(assetId),
  authority: ownerWallet,
  sapAgentOwner: ownerWallet,
  registrationBaseUrl: 'https://explorer.oobeprotocol.ai',
  rpcUrl: process.env.RPC_URL!,
});

// Step 6: Publish to discovery (sap-wizard-commands)
await client.discovery.publishToRegistry({
  signer: ownerKeypair,
  wallet: ownerWallet,
  agent,
  capabilities: ['jupiter:swap'],
  protocols: ['jupiter'],
});

References:

Last Updated: June 2026
Skills Version: 1.2.0 (SDK v0.20.0 aligned)

Agent Skills — Hermes Agent