# DZap Full LLM Context

Generated: 2026-06-02

This file is a compact full-context bundle for AI assistants. It summarizes the public homepage and key documentation pages, then links to canonical docs for exact request/response schemas. Do not treat this as a replacement for the OpenAPI spec when generating production API clients. Because apparently one machine-readable file is never enough for machines.

## Primary URLs
- Website: https://www.dzap.io/
- Docs: https://docs.dzap.io/
- App: https://app.dzap.io/
- Developer / integration entry: https://dev.dzap.io/
- Docs LLM index: https://docs.dzap.io/llms.txt
- Docs full LLM corpus: https://docs.dzap.io/llms-full.txt
- OpenAPI: https://docs.dzap.io/openapi.yaml
- Trade API docs mirror: https://docs.dzap.io/tradeDocs.json
- Fuse/Zap API docs mirror: https://docs.dzap.io/zapDocs.json
- SDK docs: https://docs.dzap.io/sdk/overview
- AI docs: https://docs.dzap.io/ai/overview
- Agent integration: https://docs.dzap.io/ai/agent-integration


## Product summary
DZap blends zapping infrastructure and AI agents into a DeFi liquidity layer. The homepage positions DZap around one-click DeFi, unified liquidity, and AI-powered execution. The product promise is: swap, bridge, earn, and automate DeFi actions with fewer steps and less integration work.

## Homepage positioning
- Main statement: DZap blends zapping infrastructure and AI agents to provide a smart liquidity layer for DeFi.
- User value: fast, simple, low-friction DeFi actions across tokens, chains, protocols, pools, and yield opportunities.
- Project/developer value: connect apps to 100+ chains and liquidity sources with minimal integration work.
- Product calls to action: Launch App, Integrate Us, Developer Docs, Integrate DZap Infrastructure, Explore AI Agent SDK.

## Product stack
DZap has three main public product surfaces:

### DZap Core
Swap + bridge aggregator. Use Core for direct quote/build/execute flows where the user or application wants full price-route control.

Core request lifecycle:
1. Request quote with source chain, destination chain, tokens, amount, account, and slippage.
2. Pick a ranked quote/route.
3. Build the transaction payload.
4. Get approval if needed.
5. Sign and submit with the user wallet.
6. Track transaction status, especially for cross-chain routes.

Core is a good fit for:
- user-facing swap UI;
- programmatic rebalancing;
- bridge integration;
- same-chain and cross-chain route comparison.

### DZap Fuse
Single-click intent execution. Fuse converts multi-step flows into one user-facing signature. The user signs the desired outcome; a solver handles routing and settlement.

Fuse solves flows like:
- approve -> swap -> bridge -> deposit;
- cross-chain LP entry;
- gasless intent execution;
- bundle-based workflows where separate calls would create intermediate user state.

Fuse intent lifecycle:
1. Quote the intent.
2. Build the bundle or transaction.
3. User signs one EIP-712 typed-data intent or transaction.
4. Solver verifies, simulates, and settles.
5. Track by transaction or intent ID.

Important Fuse terminology:
- Public product name: Fuse.
- Code-level names may still use `Zap*`, for example `getZapQuote`, `buildZapTxn`, `getZapTxnStatus`, `signGaslessDzapUserIntent`, and `/v1/bundle`.

### DZap AI
Natural-language and agent-facing execution stack. DZap AI includes:
- `@dzapio/ai` SDK;
- interactive CLI commands such as `dzap`, `dzapai`, and `DzapAI`;
- Express HTTP server with `/ask`, streaming, sessions, and schedules;
- MCP server via stdio and streamable HTTP at `/mcp`;
- tool categories for wallet/DeFi, market data, data sources, and utilities;
- skills and plugins for AI editors and agent runtimes.

## Architecture
DZap architecture is layered:

```text
Surface layer:    App · SDK · API · MCP · CLI · Skills
Reasoning layer:  ZapBot agent · tool router · memory
Routing engine:   Pathfinder · price service · solver matcher
Execution layer:  DZapDiamond contracts · Permit2 · bridge relayers
```

Integrators touch the surface layer. The routing engine evaluates DEX aggregators, bridges, and native DEXs, then ranks routes by net output after fees, gas, and slippage. The execution layer includes per-chain DZapDiamond routers, Permit2 approval flow, and bridge relayers.

## Chain support
DZap routes across major EVM chains plus Solana and Bitcoin bridge endpoints. The docs warn not to hard-code supported chains because the live list changes. Fetch the canonical list at runtime, for example with `getAllSupportedChains()` from the SDK.

Illustrative chain examples include Ethereum, Arbitrum, Optimism, Base, Polygon, BNB Chain, Avalanche, zkSync Era, Linea, Scroll, Mantle, Blast, Celo, Fantom, Gnosis, Moonbeam, Moonriver, Cronos, Fuse, Kava, Polygon zkEVM, Taiko, Filecoin EVM, Rootstock, Solana mainnet, and BTC bridge endpoints.

## API surfaces

### Fuse API
Base URL: `https://zap.dzap.io/v1`
Auth: public/per-IP limits by default.
Use for intent execution, bundles, gasless flows, quote/build/bundle/execute/status.

### Trade API
Base URL: `https://api.dzap.io/v1`
Auth: optional API key for higher rate limits.
Use for Core swaps, bridges, DCA, tokens, status, and webhooks.

### AI runtime
MCP transport: `https://nlp-ai-439689868940.europe-north1.run.app/mcp`
NLWeb ask endpoint: `https://nlp-ai-439689868940.europe-north1.run.app/ask`

## API conventions agents must follow
- Send JSON over HTTPS.
- Amounts must be strings in token base units, not decimal display values.
- Native EVM token uses `0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE`.
- Slippage uses percent values.
- Errors follow a structured model such as `{ "status": "error", "code": "...", "message": "..." }`.
- Webhooks should verify `DZap-Signature` with HMAC-SHA-256 over the raw request body.
- Mutating endpoints should use `Idempotency-Key` when supported.
- Agent retries must preserve the same idempotency key for the same logical operation.

## SDK quickstart
Install:

```bash
npm install @dzapio/sdk viem
```

Quote example:

```ts
import { DZapClient } from '@dzapio/sdk';

const dzap = DZapClient.getInstance();

const quotes = await dzap.getTradeQuotes({
  fromChain: 42161,
  account: '0xYourAddress',
  data: [{
    amount: '1000000',
    srcToken: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
    destToken: '0x82aF49447D8a07e3bd95BD0d56f35241523fBab1',
    slippage: 1,
  }],
});
```

## REST quickstart
Fuse quote example:

```bash
curl -X POST https://zap.dzap.io/v1/quote \
  -H "Content-Type: application/json" \
  -d '{
    "srcChainId": 42161,
    "destChainId": 42161,
    "account": "0xYourAddress",
    "srcToken": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "destToken": "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1",
    "amount": "1000000",
    "slippage": 1
  }'
```

## AI usage and safety
Use DZap AI when a user wants a natural-language DeFi assistant, a terminal assistant, MCP integration, tool calling, route planning, or agentic execution.

Execution safety requirements:
- Never invent wallet addresses, token addresses, token decimals, chain IDs, route outputs, or API response fields.
- Fetch live chain/token/config data before planning production transactions.
- Distinguish read-only calls from write calls.
- Do not sign or submit anything without explicit user confirmation.
- Always summarize transaction-critical details before confirmation: account, source chain, destination chain, source token, destination token, amount, slippage, recipient, route/provider, estimated output, gas/fees, deadlines, refundee, and failure modes.
- Private keys must never be placed in LLM prompt text or logs.
- Prefer session-scoped credentials for agent execution.
- Cap per-trade and per-day value at the app layer for consumer-facing integrations.

## Security summary
- DZap states that smart contracts are audited by independent firms and reports are public.
- Smart contracts are the audited boundary; upgrades are behind multisig plus timelock according to docs.
- Trade and Fuse APIs are public/rate-limited and validate inputs server-side.
- Fuse solvers are constrained by hash-bound intent fields such as `executorFeesHash` and `swapDataHash`.
- Report vulnerabilities to `support@dzap.io` with `[SECURITY]` in the subject.

## Agent integration artifacts
DZap docs describe the following machine-readable surfaces:
- Docs index: `https://docs.dzap.io/llms.txt`
- Full docs corpus: `https://docs.dzap.io/llms-full.txt`
- OpenAPI contract: `https://docs.dzap.io/openapi.yaml`
- Trade docs JSON: `https://docs.dzap.io/tradeDocs.json`
- Zap/Fuse docs JSON: `https://docs.dzap.io/zapDocs.json`
- WebMCP discovery: `/.well-known/mcp`
- MCP server card: `/.well-known/mcp/server-card.json`
- Agent discovery: `/.well-known/agent.json`
- Agent card: `/.well-known/agent-card.json`
- Skills index: `/.well-known/agent-skills/index.json`
- Markdown routes: `/index.md`, `/api.md`, `/skill.md`

## Recommended root deployment on dzap.io
Publish these files at the public website root:
- `/llms.txt` -> compact index for LLMs.
- `/llm.txt` -> alias/pointer to `/llms.txt` for common typo/singular searches.
- `/llms-full.txt` -> this full context bundle.
- `/ai.txt` -> AI assistant use and safety guide.
- `/agents.txt` -> general coding/agent instructions.
- `/api.txt` -> API summary for agents.
- `/sdk.txt` -> SDK quickstart and examples.
- `/security.txt` -> security and transaction safety summary.
- `/sitemap.txt` -> human/agent URL map.
- `/robots.txt` -> crawler permissions and discovery pointers.

## Source URLs to read for exact details
- Homepage: https://www.dzap.io/
- Docs home: https://docs.dzap.io/
- Quickstart: https://docs.dzap.io/quickstart
- Developer Resources: https://docs.dzap.io/developers
- Product Stack: https://docs.dzap.io/products/product-stack
- Supported Chains: https://docs.dzap.io/products/supported-chains
- System Overview: https://docs.dzap.io/products/architecture/system-overview
- DZap Core: https://docs.dzap.io/products/dzap-core/overview
- DZap Fuse: https://docs.dzap.io/products/dzap-fuse/overview
- Intents: https://docs.dzap.io/products/dzap-fuse/intents
- Execution Flow: https://docs.dzap.io/products/dzap-fuse/execution-flow
- Bundle: https://docs.dzap.io/products/dzap-fuse/bundle
- AI Overview: https://docs.dzap.io/ai/overview
- Agent Integration: https://docs.dzap.io/ai/agent-integration
- API Introduction: https://docs.dzap.io/api/introduction
- SDK Overview: https://docs.dzap.io/sdk/overview
- First Swap Cookbook: https://docs.dzap.io/cookbook/first-swap
- Security & Audits: https://docs.dzap.io/products/security-and-audits