poseidon-otc

What This Skill Does

The poseidon-otc skill provides a robust, trustless architecture for peer-to-peer (P2P) asset exchange on the Solana blockchain. By abstracting complex escrow logic into an agent-friendly SDK, this skill enables AI agents to autonomously negotiate, verify, and execute atomic swaps of SPL tokens. It eliminates counterparty risk by leveraging on-chain escrow contracts that hold assets until both parties have cryptographically signed off on the trade terms. Whether you are dealing with large liquidity positions or niche assets, this skill ensures that swaps are finalized only when all conditions are met.

Installation

To integrate this skill into your OpenClaw environment, execute the following command via your terminal:

clawhub install openclaw/skills/skills/romovow/poseidon-otc

Once installed, ensure your environment variables are configured with a valid burner wallet (using the POSEIDON_BURNER_KEY variable) to authorize transactions on the Solana network.

Use Cases

• Decentralized Agent Commerce: Facilitate direct trade between two independent AI agents without needing a central exchange or liquidity pool.
• Slippage-Free Large Swaps: Execute large OTC trades without impacting the market price or suffering from the high slippage associated with traditional AMMs.
• Escrow-Based Transactions: Securely swap assets with untrusted third parties where the code acts as the escrow agent, ensuring funds are not released unless the swap is atomic.
• Multi-Token Bundling: Bundle up to four different SPL tokens into a single transaction package to simplify complex portfolio rebalancing.

Example Prompts

1. "Create a new OTC room for a trade and send the link to the address 8wP92...1z, then notify me when the counterparty joins."
2. "Update my offer in room 'xyz-123' to include 500 USDC and 10 SOL, then confirm the first step of the trade."
3. "Check the status of my current trade in room 'abc-456' and proceed to execute the atomic swap if the counterparty has locked their tokens."

Tips & Limitations

• Token Precision: Always ensure you are calculating the correct number of decimals for the mint you are trading to prevent under-funding the escrow.
• Network Costs: As this is an on-chain protocol, ensure your burner wallet maintains a sufficient balance of SOL to cover transaction fees.
• Atomic Guarantee: The swap is atomic, meaning it either succeeds for both parties or fails entirely; there is no risk of losing tokens in a partial swap.
• WebSocket Monitoring: For production environments, utilize the real-time WebSocket capabilities to listen for events like 'CounterpartyJoined' or 'OfferUpdated' to reduce polling latency.