Skip to content
Skillpedia
Agents48k · #4216

soroban-liquidity-pool

Helps your agent register and configure liquidity pools in Soroban. It's useful for creating cryptocurrency exchange systems.

What it does

This system helps organize and record information about 'liquidity pools' on financial networks called Soroban. It tracks how digital assets are exchanged and how fees are calculated.

When to use it

  • ✓When defining rules and limits for how digital assets are exchanged.
  • ✓When experts from different areas need to review how a digital financial system works.
  • ✓When creating organized lists (in formats like CSV or SQL) to check if everything is working correctly.

Example of what to ask your AI

“How do I configure and track Soroban Liquidity Pools for our production environment?”

Want more? Open the sections below.

How to use

The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.

Skill link

https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/soroban-liquidity-pool/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/soroban-liquidity-pool/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
How it works

You define important details like the types of currencies and fees. Then, the system helps create standardized and verifiable records so everything functions as expected.

Installation

Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.

In the terminal (Claude Code, Codex, Cursor), in your project folder:

npx skills add sickn33/agentic-awesome-skills --skill soroban-liquidity-pool

Or download just the file:

curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/soroban-liquidity-pool/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

Soroban Liquidity Pool Architecture

What it is: Tracks automated market maker (AMM) liquidity pools, mathematical invariant boundaries, and token reserve ratios on Soroban DeFi networks.

Overview

Provides a standardized, auditable framework and data model for Soroban Liquidity Pool Architecture operations across distributed engineering and decentralized application systems.

When to Use This Skill

  • When formalizing architectural contracts, security invariants, or operational limits for Soroban Liquidity Pool Architecture.
  • When cross-functional review is required between protocol developers, smart contract auditors, and AI engineering agents.
  • When generating reproducible CSV, SQL DDL, JSON Schema, and Notion property registers for tracking compliance.

How It Works

  1. Define the parameters, thresholds, and identity bindings required for the target operational register.
  2. Select appropriate boundary enforcement values from validated enum select sets.
  3. Export standardized artifacts (CSV table, SQL DDL, JSON Schema) to integrate into validation CI pipelines.

Field Reference

# Field Name Type SQL Type JSON Schema Type Notion Property Type Example Value
1 Pool Pair ID id SERIAL PRIMARY KEY integer Text POOL-001
2 Token A Contract text VARCHAR(56) string Text CASWAP1...
3 Token B Contract text VARCHAR(56) string Text CASWAP2...
4 Invariant Model select VARCHAR(32) string Select Constant Product (xy=k)
5 Fee Basis Points number INTEGER number Number 30
6 Token A Reserve currency NUMERIC(24,7) number Number 250000.0000000
7 Token B Reserve currency NUMERIC(24,7) number Number 125000.0000000
8 Total LP Shares Issued currency NUMERIC(24,7) number Number 176776.6952966
9 Slippage Tolerance Bps number INTEGER number Number 50
10 Pool Health Status select VARCHAR(32) string Select Balanced
11 Last Rebalance Date date DATE string, format: date Date 2026-10-01

Select Options

Invariant Model

Constant Product (xy=k) | StableSwap Curve | Concentrated Liquidity

Pool Health Status

Balanced | Impermanent Divergence | High Volatility | Frozen

Relations

  • Audit Reference -> links to the formal review documentation or test repository.
  • Target Architecture -> links to the deployed contract or autonomous agent runtime component.

Examples

Prompt

How do I configure and track Soroban Liquidity Pool Architecture for our production environment?

Recommended Next Step

Generate the unified field schema, SQL DDL migration, and JSON validation schema to register into your system catalog.

Workflow: Define criteria -> Run automated verification -> Record baseline -> Monitor invariants.

Best Practices

  • Enforce strict typing on numerical bounds and currency amounts; avoid unstructured free-text fields for critical states.
  • Re-run validation test suites on every state-altering commit or parameter change.
  • Keep example data synthetic and isolated from production cryptographic keys or private endpoints.

Limitations

  • Provides architectural specifications, data models, and verification schemas; does not execute direct transaction signing without authorized external tooling.
  • Requires network connectivity and valid RPC credentials when querying on-chain states.

Security & Safety Notes

  • All parameters declare risk: safe. No unauthorized state modification or privileged credential access is performed.
  • Use synthetic dummy keys and mock addresses in test suites and local verification scripts.

Common Pitfalls

  • Problem: Mismatched decimal precision between contract runtime and database register. Solution: Always verify decimals using the explicit field mapping in this reference.
  • Problem: Missing authorization checks prior to state update. Solution: Cross-validate against the Security Audit register before deployment.

Related Skills

  • @soroban-contract-audit - provides the security checklist and vulnerability categorization.
  • @soroban-token-minter - covers SEP-41 token supply, admin and event modelling.

…

FAQ

What is a 'liquidity pool'?

It's a place where people can swap one digital asset for another, with automatic rules that set the price based on the amount of each asset available.

What does 'constant-product invariant' mean?

It's a mathematical rule (x * y = k) that ensures the total value in the pool remains constant, adjusting asset prices when trades happen.

Does this system trade the currencies for me?

No, it organizes and records the information about how trades should work, but it doesn't perform the trades directly. Other tools are needed for that.

Details

Original description by the author

Automated market maker liquidity pool register: constant-product invariant curves, swap fee tiers, and LP token shares for Soroban DeFi.

repo: sickn33/agentic-awesome-skills

Popularity

GitHub stars
48k
Ranking position
#4216
License
MIT
Updated
10/15/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills