# Gala developer docs

> Documentation for the Gala SDKs and tools, assembled from each package's own docs bundle.

Every page has a raw markdown twin (append `.md`). Per-package full text: `/<package>/llms-full.txt`. Machine-readable version index: `/versions.json`.

Use Gala from AI tools: [Use Gala from AI tools](/gala-mcp-server/next/ai-tools/overview.md), [MCP server setup](/gala-mcp-server/next/ai-tools/mcp-clients.md), [The omni-tool plugin for Claude Code](/gala-mcp-server/next/ai-tools/omni-tool-plugin.md), [Security and keys for agents](/gala-mcp-server/next/ai-tools/security.md), [Troubleshooting AI tool setups](/gala-mcp-server/next/ai-tools/troubleshooting.md)

Every error code of @gala-chain/gala-core-sdk, @gala-chain/gswap-sdk as data: /errors.json

## GalaChain core SDK (@gala-chain/gala-core-sdk 1.0.0-rc.8)

Signing, signers, gateway transport, token reads and writes, wallets, bridge and the shared error model every Gala SDK builds on.

- [Full text](/gala-core-sdk/llms-full.txt): every guide of this package in one file
- [Overview](/gala-core-sdk/next/index.md): install line, peers, page list
- [Agent guide](/gala-core-sdk/next/agents.md): For an AI agent: which package for which job, task recipes (sign, transfer, read), the invariants with the test that enforces each, and error codes with their fix.
- [GalaChain core SDK](/gala-core-sdk/next/overview.md): What the core SDK contains, how to install it (@next while only release candidates exist), and a short guide to each area: signers, bridge, wallet providers, React, gateway reads and writes.
- [Error catalog](/gala-core-sdk/next/error-catalog.md): Every error code the core SDK throws, its phase, params and when it is thrown.
- [Migrating from gswap-sdk 1.x](/gala-core-sdk/next/migrating-from-gswap.md): Every export that moved from gswap-sdk 1.x into core: old path to new path, renamed errors and brand identifiers.
- [Agent guide](/gala-core-sdk/agents.md): task recipes, invariants with the test that enforces each, error codes to fixes
- [/gala-core-sdk/next/data/errors.json](/gala-core-sdk/next/data/errors.json): Every error code the core SDK throws as data: phase, params, template, when thrown.
- [API reference](/gala-core-sdk/next/api/index.md): 389 generated pages; typedoc JSON at /gala-core-sdk/next/api.json

## gSwap SDK (@gala-chain/gswap-sdk 2.0.0-rc.4)

The TypeScript SDK for the GalaChain DEX contract: quoting, queued swaps, liquidity positions, market data and the realtime stream.

- [Full text](/gswap-sdk/llms-full.txt): every guide of this package in one file
- [Overview](/gswap-sdk/next/index.md): install line, peers, page list
- [Agent guide](/gswap-sdk/next/agents.md): For an AI agent: which package for which job, task recipes (quote, swap, confirm, add liquidity), the invariants with the test that enforces each, and error codes with their fix.
- [gSwap SDK](/gswap-sdk/next/overview.md): What the SDK is and its public surface (quoting, swaps, pools, positions, assets, symbols), how to install it (@next while only release candidates exist), a quick start for quoting and swapping, environment presets and the signers.
- [Getting started](/gswap-sdk/next/getting-started.md): Install, construct a GSwap client with a signer, and run a first quote and swap.
- [gSwap for Uniswap users](/gswap-sdk/next/uniswap-comparison.md): How gSwap's contract and transaction model differ from Uniswap V3 for someone who knows Uniswap.
- [Quoting](/gswap-sdk/next/tutorial/quoting.md): Quote exact-input and exact-output swaps against live pools and read the fee tier and amounts.
- [Trading](/gswap-sdk/next/tutorial/trading.md): Submit a queued swap, keep its unique key, confirm the applied outcome and recover an unknown one.
- [Asset balances](/gswap-sdk/next/tutorial/asset-balances.md): Read a user's token balances from the backend's public user-assets endpoint.
- [Market data and leaderboard](/gswap-sdk/next/tutorial/market-data.md): Prices, price series, platform volume and the trading-competition seasons and rankings, all public reads.
- [Liquidity management](/gswap-sdk/next/tutorial/liquidity-management.md): Add, adjust, remove and collect fees from liquidity positions, identified by owner, tokens, fee and tick range.
- [Realtime stream](/gswap-sdk/next/tutorial/realtime-stream.md): Subscribe to live swaps, liquidity events, pool and balance changes over the JSON-RPC websocket stream.
- [Transaction status](/gswap-sdk/next/tutorial/transaction-status.md): Read the status of a submitted transaction and interpret the applied or rejected outcome.
- [Slippage](/gswap-sdk/next/pool-concepts/slippage.md): What slippage is and how amountOutMinimum protects a swap from it.
- [Price impact](/gswap-sdk/next/pool-concepts/price-impact.md): How a trade moves a pool's price and how that differs from slippage.
- [Liquidity concentration](/gswap-sdk/next/pool-concepts/liquidity-concentration.md): How concentrated liquidity in a tick range works in gSwap, based on Uniswap V3.
- [Fees](/gswap-sdk/next/pool-concepts/fees.md): The pool fee tiers, in hundredths of a basis point, that the current contract supports.
- [Error handling](/gswap-sdk/next/other/error-handling.md): The DEX error catalog: every code, its params, phase and what an app should do; branch on code, never message.
- [Signing and identity](/gswap-sdk/next/other/signing-and-identity.md): How the SDK signs the unsigned DTO, which signer uses which scheme and how the chain resolves identity.
- [App and wallet integration](/gswap-sdk/next/other/app-integration.md): Platform-neutral building blocks for wallets and apps: confirmation polling, pending-swap storage, fee quotes, shadow swaps.
- [Tick and price math](/gswap-sdk/next/other/tick-and-price-math.md): The exported tick arithmetic, exact to 60 significant digits, including the contract's in-range rule.
- [Branded types](/gswap-sdk/next/other/branded-types.md): The TypeScript branded types that prevent mixing prices and amounts.
- [Bundle size](/gswap-sdk/next/other/bundle-size.md): Keeping an app shell small: the core wallet subpath and the shell-safe helpers.
- [Security notes](/gswap-sdk/next/security-notes.md): The production dependency audit and when read logging is safe to enable.
- [Migrating from earlier versions](/gswap-sdk/next/other/migration-from-0x.md): Upgrading between published versions: 0.x to 1.0, the 1.2.x to 2.0.0 move of signing into gala-core-sdk, and the changes between release candidates.
- [Agent guide](/gswap-sdk/agents.md): task recipes, invariants with the test that enforces each, error codes to fixes
- [/gswap-sdk/next/data/errors.json](/gswap-sdk/next/data/errors.json): Every error code the GSwap SDK throws as data: phase, params, template, when thrown (core codes are in the core package's file).
- [API reference](/gswap-sdk/next/api/index.md): 241 generated pages; typedoc JSON at /gswap-sdk/next/api.json

## Gala Launchpad SDK (@gala-chain/launchpad-sdk 9.0.0-rc.5)

The TypeScript SDK for the Gala Launchpad backend: token launches, bonding-curve trading, balances, bridging and real-time events.

- [Full text](/launchpad-sdk/llms-full.txt): every guide of this package in one file
- [Overview](/launchpad-sdk/next/index.md): install line, peers, page list
- [Agent guide](/launchpad-sdk/next/agents.md): For an AI agent: which package for which job, task recipes (read pools, buy, sell, create a token, bundle write, transfer), the invariants with the test that enforces each, and failures with their fix.
- [Gala Launchpad SDK](/launchpad-sdk/next/overview.md): Install the SDK (@next while only release candidates exist), create a client and make the first calls; what moved to gala-core-sdk and gswap-sdk in 9.0.
- [Usage examples](/launchpad-sdk/next/examples.md): Practical examples by category: reading pools and balances, buying and selling, launching tokens, bridging and streaming.
- [Migrating to 9.0](/launchpad-sdk/next/migrating-to-9.md): Where each export removed from launchpad-sdk 9.0 went: gala-core-sdk, gswap-sdk, or deleted.
- [AI agent integration guide](/launchpad-sdk/next/ai-agent-guide.md): How an AI agent or bot drives the SDK: setup, trading, token launches, error handling and the MCP server.
- [API reference (guide)](/launchpad-sdk/next/api-reference.md): A method-by-method guide to LaunchpadSDK with options and examples; the generated TSDoc reference is the complete list.
- [WebSocket and real-time updates](/launchpad-sdk/next/websocket/overview.md): Real-time event streaming for token pools and platform-wide events: what exists and where to start.
- [WebSocket quick start](/launchpad-sdk/next/websocket/quickstart.md): Subscribe to real-time Launchpad events in five minutes.
- [Global feed](/launchpad-sdk/next/websocket/global-feed.md): One subscription that delivers a summary of every token and the site-wide switches.
- [WebSocket authentication](/launchpad-sdk/next/websocket/authentication.md): Authenticate the stream socket to receive user and overseer events and to send chat messages.
- [Agent guide](/launchpad-sdk/agents.md): task recipes, invariants with the test that enforces each, error codes to fixes
- [API reference](/launchpad-sdk/next/api/index.md): 1033 generated pages; typedoc JSON at /launchpad-sdk/next/api.json

## Gala MCP server (@gala-chain/gala-mcp-server 1.0.0-rc.9)

The Gala MCP server: wallet, bridge, Launchpad and GSwap DEX tools and prompts over stdio, in toolsets you select.

- [Full text](/gala-mcp-server/llms-full.txt): every guide of this package in one file
- [Overview](/gala-mcp-server/next/index.md): install line, peers, page list
- [Use Gala from AI tools](/gala-mcp-server/next/ai-tools/overview.md): The ways to use Gala from an AI assistant or agent (the omni-tool Claude Code plugin, the MCP server, the per-package agent guides, llms.txt) and which to choose.
- [MCP server setup](/gala-mcp-server/next/ai-tools/mcp-clients.md): Install and configure the Gala MCP server for Claude Code, Claude Desktop, Cursor or any stdio client: the command, toolsets, every environment variable and how to check it works.
- [The omni-tool plugin for Claude Code](/gala-mcp-server/next/ai-tools/omni-tool-plugin.md): What the omni-tool Claude Code plugin installs (the server, a teaching agent, commands, a skill, a hook), the smaller launchpad and swap plugins, how it relates to the MCP server, and its safety model.
- [Security and keys for agents](/gala-mcp-server/next/ai-tools/security.md): How to give an AI agent access to a wallet safely: start read-only, keep keys out of the conversation, stage before prod, quote before writing, toolsets, and what the code enforces.
- [Agent guide](/gala-mcp-server/next/agents.md): For an AI agent: which package for which job, how to find a tool or a doc, task recipes as tool calls, the invariants with the test that enforces each, and failures with their fix.
- [Troubleshooting AI tool setups](/gala-mcp-server/next/ai-tools/troubleshooting.md): Symptom, cause and fix for a server that does not start, tools that are missing or answer with errors, and the plugin and the server both installed.
- [Gala MCP server](/gala-mcp-server/next/overview.md): What the server offers, how to install and configure it (toolsets, environment, wallet), and the tools and slash commands by area.
- [AI agent patterns](/gala-mcp-server/next/ai-agent-patterns.md): Common workflows, gotchas and parameter constraints for an agent driving the server: trading, DEX swaps, error handling.
- [GSwap pool inspection and quotes](/gala-mcp-server/next/composite-pool-quotes.md): Inspect GSwap pools and quote swaps from the SDKs the composite toolset is built on.
- [Tier 1 workflow prompts](/gala-mcp-server/next/prompts-tier1.md): Quick reference for the tier 1 slash commands: pools, liquidity, bridging, pricing and analytics, with their arguments.
- [Tier 3 workflow prompts](/gala-mcp-server/next/prompts-tier3.md): Quick reference for the tier 3 slash commands: moderation, community engagement and streaming.
- [SDK usage topics](/gala-mcp-server/next/sdk-usage-topics.md): Task-oriented SDK examples, one section per topic (buy and sell, token creation, DEX swaps, streaming, moderation), returned by the explain SDK usage tool.
- [Toolset classification](/gala-mcp-server/next/toolset-classification.md): Which toolset each tool belongs to and why, from the import graph of the handlers.
- [Core toolset reference](/gala-mcp-server/next/reference/core.md): Every tool and prompt of the core toolset: wallets and keys, GALA balance and transfer, bridging, wrap and unwrap, session and docs tools, with parameters.
- [Launchpad toolset reference](/gala-mcp-server/next/reference/launchpad.md): Every tool and prompt of the launchpad toolset: pools, bonding-curve trading, token creation, holders, streaming, chat and moderation, with parameters.
- [GSwap toolset reference](/gala-mcp-server/next/reference/gswap.md): Every tool and prompt of the gswap toolset: DEX quotes, swaps, pools, liquidity positions, fees, market prices and the leaderboard, with parameters.
- [Composite toolset reference](/gala-mcp-server/next/reference/composite.md): Every tool and prompt of the composite toolset, which needs both the launchpad and the gswap client: Launchpad token prices from the DEX market.
- [Agent guide](/gala-mcp-server/agents.md): task recipes, invariants with the test that enforces each, error codes to fixes
- [/mcp/tools.json](/mcp/tools.json): Index of every toolset with its tool and prompt counts and the url of its full reference.
- [/mcp/core/tools.json](/mcp/core/tools.json): Every tool and prompt of the core toolset with parameter types, requiredness and descriptions.
- [/mcp/launchpad/tools.json](/mcp/launchpad/tools.json): Every tool and prompt of the launchpad toolset with parameter types, requiredness and descriptions.
- [/mcp/gswap/tools.json](/mcp/gswap/tools.json): Every tool and prompt of the gswap toolset with parameter types, requiredness and descriptions.
- [/mcp/composite/tools.json](/mcp/composite/tools.json): Every tool and prompt of the composite toolset with parameter types, requiredness and descriptions.