Known limitations & performance¶

Honest edges of the current product. Some are deliberate, some are "not yet".

Distribution¶

The SDK isn't on PyPI yet. Install it from git (pip install "primedelta @ git+…"). A pip install primedelta will not work today. See Install the SDK.
The plugin bundle is built from source. There's no pre-built .mcpb download yet — you build it with mcpb and drag it in. See Install the plugin.

The SDK ships contracts for dev and testnet. Point the Python SDK at those. Mainnet support for the SDK is not bundled yet even though the network name is recognized elsewhere.
web3_provider_url is always required by the SDK client — there's no built-in default RPC. (The MCP layer derives one from the network; the SDK does not.)

Browser signing is desktop-only. BrowserSigner needs a local browser and can't run headless, in Docker, in CI, or on a hosted server. Use KMS there. See the signing-modes matrix.
GCP KMS isn't shipped. Only AWS KMS is supported today; see GCP KMS.

Oracle stocks trade only during US market hours. Outside them, a trade reverts (market closed / stale price). Check the market is open first.
Oracle prices expire. An oracle-priced swap uses a signed price with a short deadline — quote and act promptly, and widen slippage to cover the pool's dynamic fee.
Thin pools move on size. A large trade against a shallow AMM pool can move the price sharply or revert with no-liquidity. Check the spot price and quote first.

First call in a session can be slower. The client establishes a session and warms up on first use; subsequent calls are faster. If you run short-lived processes, reuse the session (export_session / import_session) rather than logging in every time.
On-chain balances use one Multicall where available, with a per-token fallback on networks that don't have Multicall3 configured — the fallback is slower.

Claude is the first-class client. Any MCP client can connect (see Use with any MCP client), and ChatGPT works as an advanced setup, but the plugin and prompts are tuned for Claude.

If one of these blocks you, tell the team so it can be prioritized. Compatibility across versions → Versioning & compatibility.