OWS Quickstart

Open Wallet Standard + Observer Protocol

Already using OWS? Register your OWS-provisioned agent on Observer Protocol in under 5 minutes. One vault, one identity, one delegation the wallet enforces on every chain.

🔐 OWS Compatible

Install OWS

If you haven't already, install the Open Wallet Standard CLI:

# Install OWS
curl -fsSL https://openwallet.sh/install.sh | bash

# Create your agent treasury vault
ows wallet create --name "agent-treasury"
        

Install the OWS adapter

Add the Open Wallet Standard verification adapter to your project. This page previously said @observer-protocol/sdk, which is deprecated and unmaintained — the adapter below is what this quickstart actually uses:

npm install @observer-protocol/ows-op-verify

Register Your Agent

Use your OWS-derived keys to register on Observer Protocol:

import { ObserverClient } from '@observer-protocol/sdk';
import { OWSWallet } from '@openwallet/sdk';

// Load your OWS vault
const wallet = await OWSWallet.load('agent-treasury');

// Derive Solana key for OP registration
const solanaKey = await wallet.derivePath("m/44'/501'/0'/0'");

// Create OP client
const client = new ObserverClient({
  baseUrl: 'https://api.observerprotocol.org'
});

// Register your agent with the OWS-derived public key
const agent = await client.registerAgent({
  publicKey: solanaKey.publicKey,         // hex-encoded ed25519 pub
  agentName: 'My OWS Agent',
  alias: 'my-ows-agent',
  framework: 'ows'
});
// → { agent_id, agent_did, ... }
        

Sign the Challenge

Complete registration by signing the verification challenge:

// Get challenge from server
const challenge = await client.requestChallenge(agent.agent_id);
// → { challengeId, nonce, expiresAt }

// Sign the nonce with your OWS-derived ed25519 key
const signedChallenge = await solanaKey.sign(challenge.nonce);

// Verify ownership
await client.verifyAgent(agent.agent_id, signedChallenge);
        

View Your VAC

Your Verifiable Agent Credential is now live:

// Get your VAC
const vac = await client.getVAC(agent.agent_id);
console.log('VAC URL:', `https://api.observerprotocol.org/vac/${agent.agent_id}`);

// Response includes:
// - OWS badge
// - Supported chains
// - Delegation status
// - Vault name
        

🔑 OWS Derivation Paths: Use these BIP-44 paths for deriving chain-specific keys from your OWS vault.

Chain	Derivation Path	Curve
EVM	m/44'/60'/0'/0/0	secp256k1
Solana	m/44'/501'/0'/0'	Ed25519
Bitcoin	m/84'/0'/0'/0/0	secp256k1

🔐

Your OWS Agent is Verified

Your OWS-provisioned agent can now attest payments across all supported chains, each one a signed record it carries.

View Registry