> For the complete documentation index, see [llms.txt](https://docs-v4.nftx.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-v4.nftx.io/agentic-development/best-practices.md).

# Best Practices

Building on NFTX with an AI agent is fast, but the rules that make good software still apply — plus a few that matter more when value moves on-chain. Here's how we recommend working.

## Give the agent the real source

* **Connect the docs; don't rely on memory.** Point your agent at the [MCP server](/agentic-development/mcp-server.md) or the [LLM-ready files](/agentic-development/llm-ready-docs.md) so it answers from the current documentation, not a training snapshot that may predate v4. This is the single biggest quality win.
* **Prefer markdown over scraping.** Use the `.md` pages, `llms.txt`, and `llms-full.txt` rather than parsing the rendered site — it's cleaner and less error-prone.
* **Cite the canonical pages.** For mechanics, lean on [How It Works](/how-it-works/floor-tokens.md) and [Core Concepts](/core-concepts/vaults.md); for the exact surface, the [Contracts](/contracts/contracts.md) and [API Reference](/api-reference/api-reference.md).

## Verify anything on-chain

* **Check addresses against the source.** Never trust a contract address an agent produced from memory — confirm it against [Deployment Addresses](/contracts/addresses.md), per chain.
* **Confirm signatures and parameters.** Function names, arguments, and fee parameters change between versions. Verify generated calls against the [Contracts](/contracts/contracts.md) reference — for example, the listing tax formula and the 2.00x kink live in the [Tax Calculator](/contracts/tax-calculator.md).
* **Treat generated Solidity and calldata as a draft.** Read it, test it, and don't ship it just because it compiles.

## Test before you spend

* **Use testnet first.** Base Sepolia deployments are in [Deployment Addresses](/contracts/addresses.md), and the API's preflight checks and [test-token](/api-reference/test-tokens.md) endpoints let you dry-run flows before touching mainnet.
* **Let the API build the transaction.** For swaps, the [Swaps](/api-reference/swaps.md) endpoint prices and builds the calldata; your wallet signs and submits. That's a smaller surface for an agent to get wrong.

## Keep a human in the loop

* **Approve every transaction yourself.** An agent can draft a transaction; a person should sign it. Don't give an agent keys that can move funds unattended.
* **Never paste secrets into a prompt.** Private keys and seed phrases don't belong in an agent's context, ever.
* **Remember: audited ≠ risk-free.** NFTX runs on non-upgradeable, audited contracts, but no protocol is immune to bugs. Size your early positions accordingly and stay cautious.

{% hint style="success" %}
The short version: **connect the docs, verify on-chain facts against the reference, test on Base Sepolia, and keep a human on the transaction button.**
{% endhint %}