Manifest DEX Integration Guide

Build trading, routing, portfolio, and frontend integrations on top of Manifest's permissionless orderbook.

Overview

Use this skill when the task involves:

• Reading Manifest market state or orderbooks
• Placing, canceling, depositing, or withdrawing via the Manifest SDK
• Choosing between local market balances and global balances
• Handling wrapper setup, seat claims, and wallet-adapter flows
• Understanding Limit, PostOnly, ImmediateOrCancel, Global, Reverse, and ReverseTight order types

Load supporting references as needed:

• resources/manifest-actions.md
• resources/manifest-sdk.md
• docs/troubleshooting.md
• examples/read-market/read-market.ts
• examples/wallet-order/place-order.ts
• examples/global-liquidity/global-order.ts
• examples/reverse-liquidity/amm-style-batch.ts
• templates/manifest-setup.ts

Instructions

1. Determine whether the task is read-only market access or transaction-building.
2. For read-only access, prefer Market reads or ManifestClient.getClientReadOnly(...).
3. For transaction-building, use getClientForMarket(...) for signer-controlled flows, or use getSetupIxs(...) first and then getClientForMarketNoPrivateKey(...) for wallet-adapter flows.
4. Decide whether liquidity should be market-local (wrapper balances plus a market seat) or global (global account plus OrderType.Global).
5. If the task involves recurring two-sided liquidity, evaluate Reverse or ReverseTight instead of ordinary limit orders.
6. For UI/orderbook work, prefer bidsL2() and asksL2() for display-ready levels.
7. When documenting or implementing cleanup behavior, distinguish wrapper-level cancels from core-level cancels. cancelAllIx() does not fully cover all reverse/global edge cases; cancelAllOnCoreIx() is the stronger cleanup path.
8. State assumptions explicitly:

• cluster
• market address
• trader/signer model
• whether wrapper/global setup already exists

Examples

Basic Usage

When user asks: "Show the best bid and ask on a Manifest market"

The agent should:

1. Use Market.loadFromAddress(...) or ManifestClient.getClientReadOnly(...)
2. Read bestBidPrice() and bestAskPrice() or bidsL2() / asksL2()
3. Return prices without introducing signing or setup logic

Wallet Trading Flow

When user asks: "Place a Manifest order from a browser wallet"

The agent should:

1. Call ManifestClient.getSetupIxs(...)
2. If setup is needed, create wrapper state and/or claim the seat first
3. Then use ManifestClient.getClientForMarketNoPrivateKey(...)
4. Build the order instruction with client.placeOrderIx(...)

Global Liquidity Flow

When user asks: "Use the same capital across multiple Manifest markets"

The agent should:

1. Explain that market-local balances are insufficient for this requirement
2. Use global-account setup with createGlobalAddTraderIx(...)
3. Deposit via globalDepositIx(...)
4. Place OrderType.Global orders

Reverse Orders

When user asks: "Provide recurring liquidity that flips after fills"

The agent should:

1. Recommend OrderType.Reverse or OrderType.ReverseTight
2. Explain that reverse orders use spreadBps instead of lastValidSlot
3. Use ReverseTight when tighter spread precision matters
4. Mention that cleanup may require cancelAllOnCoreIx() rather than only wrapper-level cancellation

Copy-paste oriented examples in this skill:

• examples/read-market/read-market.ts
• examples/wallet-order/place-order.ts
• examples/global-liquidity/global-order.ts
• examples/reverse-liquidity/amm-style-batch.ts

Guidelines

• DO: Use getSetupIxs(...) before wallet-adapter trading flows.
• DO: Use getClientReadOnly(...) for anonymous or pre-setup inspection paths.
• DO: Use bidsL2() / asksL2() for UI-facing orderbook displays.
• DO: Separate market-local account logic from global-account logic.
• DO: Mention wrapper state, market seats, and global accounts explicitly when relevant.
• DON'T: Assume a connected wallet already has wrapper state or a market seat.
• DON'T: Treat OrderType.Global as equivalent to ordinary market-local orders.
• DON'T: Use cancelAllIx() as if it always fully cleans up reverse/global edge cases.
• DON'T: Ask for or embed private keys in examples.

Common Errors

Error: Read only

Cause: A write method was called on a read-only client or without a payer/wrapper context.

Solution: Switch to getClientForMarket(...) or complete the getSetupIxs(...) flow and then use getClientForMarketNoPrivateKey(...).

Error: Setup still required

Cause: Wrapper creation or market seat claim has not been completed.

Solution: Run the instructions returned by ManifestClient.getSetupIxs(...) before building normal wrapper-based trading actions.

Error: Global order funded incorrectly

Cause: The trader is using OrderType.Global without a funded global account for the supporting token.

Solution: Run createGlobalAddTraderIx(...) if needed, then globalDepositIx(...), and only then place the global order.

Error: Reverse/global orders remain after cancel-all

Cause: Wrapper-level cancellation does not fully cover all core-level order states.

Solution: Use cancelAllOnCoreIx() when full core cleanup is required.

References

• Official site: https://manifest.trade
• SDK package: https://www.npmjs.com/package/@bonasa-tech/manifest-sdk
• Source repository: https://github.com/Bonasa-Tech/manifest
• TypeScript client docs: https://github.com/Bonasa-Tech/manifest/tree/main/client/ts