Tencent SkillHub · Finance & Trading

Poseidon OTC

Execute trustless P2P token swaps on Solana via the Poseidon OTC protocol. Create trade rooms, negotiate offers, lock tokens with time-based escrow, and execute atomic on-chain swaps. Supports agent-to-agent trading with real-time WebSocket updates.

skill openclawclawhub Free

0 Downloads

0 Stars

0 Installs

0 Score

High Signal

⬇ 0 downloads ★ 0 stars Unverified but indexed

Install for OpenClaw

Quick setup

Download the package from Yavira.
Extract the archive and review SKILL.md first.
Import or place the package into your OpenClaw setup.

Requirements

Target platform: OpenClaw
Install method: Manual import
Extraction: Extract archive
Prerequisites: OpenClaw
Primary doc: SKILL.md

Package facts

Download mode: Yavira redirect
Package format: ZIP package
Source platform: Tencent SkillHub
What's included: SKILL.md, tsconfig.json, README.md, package.json, src/index.ts

Validation

Use the Yavira download entry.
Review SKILL.md after the package is downloaded.
Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

Download the package from Yavira.
Extract it into a folder your agent can access.
Paste one of the prompts below and point your agent at the extracted folder.

New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.

Open Send to Agent page Open JSON manifest Open Markdown brief

Trust & source

Release facts

Source: Tencent SkillHub
Verification: Indexed source record
Version: 1.0.0

Provenance

Publisher: Romovow
Source page: View original listing
Canonical URL: Open canonical page

Documentation

ClawHub primary doc Primary doc: SKILL.md 23 sections Open source page

Poseidon OTC Skill

TL;DR for Agents: This skill lets you trade tokens with humans or other agents on Solana. You create a room, both parties deposit tokens to escrow, confirm, and execute an atomic swap. No trust required - it's all on-chain.

When to Use This Skill

Trading tokens P2P - Swap any SPL token directly with another party Agent-to-agent commerce - Two AI agents can negotiate and execute trades autonomously Large OTC deals - Avoid slippage from DEX trades by going direct Protected trades - Use lockups to prevent counterparty from dumping immediately Multi-token swaps - Trade up to 4 tokens per side in one atomic transaction

1. Initialize (requires wallet)

import { PoseidonOTC } from 'poseidon-otc-skill'; const client = new PoseidonOTC({ burnerKey: process.env.POSEIDON_BURNER_KEY // base58 private key });

2. Create a Trade Room

const { roomId, link } = await client.createRoom(); // Share `link` with counterparty or another agent

3. Wait for Counterparty & Set Offer

// Check room status const room = await client.getRoom(roomId); // Set what you're offering (100 USDC example) await client.updateOffer(roomId, [{ mint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC mint amount: 100000000, // 100 USDC (6 decimals) decimals: 6 }]);

4. Confirm & Execute

// First confirmation = "I agree to these terms" await client.confirmTrade(roomId, 'first'); // After deposits, second confirmation await client.confirmTrade(roomId, 'second'); // Execute the atomic swap const { txSignature } = await client.executeSwap(roomId);

Complete Trade Flow

┌─────────────────────────────────────────────────────────────────┐ │ TRADE LIFECYCLE │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ 1. CREATE ROOM │ │ └─> Party A calls createRoom() │ │ Returns: roomId, shareable link │ │ │ │ 2. JOIN ROOM │ │ └─> Party B calls joinRoom(roomId) │ │ Room now has both participants │ │ │ │ 3. SET OFFERS │ │ └─> Both parties call updateOffer(roomId, tokens) │ │ Each specifies what they're putting up │ │ │ │ 4. FIRST CONFIRM (agree on terms) │ │ └─> Both call confirmTrade(roomId, 'first') │ │ "I agree to swap my X for your Y" │ │ │ │ 5. DEPOSIT TO ESCROW │ │ └─> Tokens move to on-chain escrow │ │ (Handled by frontend or depositToEscrow) │ │ │ │ 6. SECOND CONFIRM (verify deposits) │ │ └─> Both call confirmTrade(roomId, 'second') │ │ "I see the deposits, ready to swap" │ │ │ │ 7. EXECUTE SWAP │ │ └─> Either party calls executeSwap(roomId) │ │ Atomic on-chain swap via relayer │ │ Returns: txSignature │ │ │ │ [OPTIONAL] LOCKUP FLOW │ │ └─> Before step 4, Party A can proposeLockup(roomId, secs) │ │ └─> Party B must acceptLockup(roomId) to continue │ │ └─> After execute, locked tokens claimed via claimLockedTokens │ │ │ └─────────────────────────────────────────────────────────────────┘

Room Management

MethodParametersReturnsDescriptioncreateRoom(options?){ inviteCode?: string }{ roomId, link }Create new roomgetRoom(roomId)roomId: stringTradeRoomGet full room stategetUserRooms(wallet?)wallet?: stringTradeRoom[]List your roomsjoinRoom(roomId, inviteCode?)roomId, inviteCode?{ success }Join as Party BcancelRoom(roomId)roomId: string{ success }Cancel & refundgetRoomLink(roomId)roomId: stringstringGet share URL

Trading

MethodParametersReturnsDescriptionupdateOffer(roomId, tokens)roomId, [{mint, amount, decimals}]{ success }Set your offerwithdrawFromOffer(roomId, tokens)roomId, tokens[]{ success }Pull back tokensconfirmTrade(roomId, stage)roomId, 'first'│'second'{ success }Confirm stageexecuteSwap(roomId)roomId: string{ txSignature }Execute swapdeclineOffer(roomId)roomId: string{ success }Reject terms

Lockups (Anti-Dump)

MethodParametersReturnsDescriptionproposeLockup(roomId, seconds)roomId, seconds{ success }Propose lockacceptLockup(roomId)roomId: string{ success }Accept lockgetLockupStatus(roomId)roomId: string{ canClaim, timeRemaining }Check timerclaimLockedTokens(roomId)roomId: string{ txSignature }Claim after expiry

Utility

MethodParametersReturnsDescriptiongetBalance()none{ sol: number }Check SOL balanceisAutonomous()nonebooleanHas signing wallet?getWebSocketUrl()nonestringGet WS endpoint

WebSocket Real-Time Updates

Don't poll. Subscribe. Instead of repeatedly calling getRoom(), connect to WebSocket for instant updates: Endpoint: wss://poseidon.cash/ws/trade-room

Subscribe to Room Events

const { unsubscribe } = await client.subscribeToRoom(roomId, (event) => { switch (event.type) { case 'join': console.log('Counterparty joined!'); break; case 'offer': console.log('Offer updated:', event.data.tokens); break; case 'confirm': console.log('Confirmation received'); break; case 'execute': console.log('Swap complete! TX:', event.data.txSignature); break; case 'cancel': console.log('Trade cancelled'); break; } });

Event Types

EventWhen It Firesfull-stateImmediately on subscribe - complete room statejoinCounterparty joined the roomofferSomeone updated their offerconfirmSomeone confirmed (first or second)lockupLockup proposed or acceptedexecuteSwap executed successfullycancelRoom was cancelledterminatedRoom expired or terminatederrorSomething went wrong

WebSocket Actions (Faster than HTTP)

await client.sendOfferViaWs(roomId, tokens); // Update offer await client.sendConfirmViaWs(roomId, 'first'); // Confirm await client.sendLockupProposalViaWs(roomId, 3600); // Propose 1hr lock await client.sendAcceptLockupViaWs(roomId); // Accept lock await client.sendExecuteViaWs(roomId); // Execute swap

Agent-to-Agent Trading Example

Scenario: Agent A wants to sell 1000 USDC for 5 SOL to Agent B

Agent A (Seller):

// 1. Create room const { roomId } = await client.createRoom(); // 2. Set offer (1000 USDC) await client.updateOffer(roomId, [{ mint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', amount: 1000000000, // 1000 USDC decimals: 6 }]); // 3. Share roomId with Agent B via your inter-agent protocol // 4. Subscribe to updates await client.subscribeToRoom(roomId, async (event) => { if (event.type === 'offer') { // Check if Agent B's offer is acceptable (5 SOL) const room = await client.getRoom(roomId); if (room.partyBTokenSlots?.[0]?.amount >= 5 * 1e9) { await client.confirmTrade(roomId, 'first'); } } if (event.type === 'confirm' && room.partyBFirstConfirm) { await client.confirmTrade(roomId, 'second'); } });

Agent B (Buyer):

// 1. Join the room await client.joinRoom(roomId); // 2. Set offer (5 SOL) await client.updateOffer(roomId, [{ mint: 'So11111111111111111111111111111111111111112', // wSOL amount: 5000000000, // 5 SOL decimals: 9 }]); // 3. Subscribe and react await client.subscribeToRoom(roomId, async (event) => { if (event.type === 'confirm') { const room = await client.getRoom(roomId); if (room.partyAFirstConfirm && !room.partyBFirstConfirm) { await client.confirmTrade(roomId, 'first'); } if (room.partyASecondConfirm && room.partyBSecondConfirm) { // Both confirmed, execute! await client.executeSwap(roomId); } } });

Common Token Mints

TokenMint AddressDecimalsUSDCEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v6USDTEs9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB6wSOLSo111111111111111111111111111111111111111129BONKDezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB2635

Environment Variables

POSEIDON_BURNER_KEY=<base58-private-key> # Required for autonomous mode POSEIDON_API_URL=https://poseidon.cash # API endpoint (default: mainnet) POSEIDON_RPC_URL=https://api.mainnet-beta.solana.com # Solana RPC

Security Notes

Escrow is on-chain - Funds are held by the Solana program, not the API Atomic swaps - Either both sides complete or neither does Signatures expire - Auth signatures valid for 24 hours Lockups are enforced on-chain - Can't bypass the timer Hot wallet warning - Only fund your burner wallet with amounts you're comfortable risking

Program ID

Mainnet: AfiRReYhvykHhKXhwjhcsXFejHdxqYLk2QLWnjvvLKUN

Links

Website: https://poseidon.cash Docs: https://docs.poseidon.cash

Category context

Trading, swaps, payments, treasury, liquidity, and crypto-financial operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package

2 Docs2 Config1 Scripts

SKILL.md Primary doc
README.md Docs
src/index.ts Scripts
package.json Config
tsconfig.json Config