LLM Integration Playbook

This page packages the LLM-oriented resources for Pods API + SDK integrations.

Recommended LLM Inputs

Resource	Use
`/llms.txt`	API docs index and key concepts for retrieval-based assistants
`/llms-privy-integration.txt`	Full one-shot prompt for production-grade Privy widget integration
EarnWidget docs	UI integration contract and host responsibilities
SwapWidget docs	Swap integration patterns and prefill parameters
processBytecode docs	Required tx lifecycle events and error handling

Prompt Template (Copy/Paste)

Implement Pods EarnWidget and SwapWidget in an existing React app.

Constraints:
- Use pods-sdk in host mode (no iframe).
- Install [email protected] and @deframe-sdk/[email protected].
- Set config.components.SwapFormView = PodsSwapFormView inside DeframeProvider config.
- Install Redux peer deps explicitly: @reduxjs/toolkit, react-redux, redux.
- Import @deframe-sdk/components/styles.css once before the host app CSS.
- Keep custody in host app; implement processBytecode for signing and tx submission.
- Use NEXT_PUBLIC_PODS_API_URL, NEXT_PUBLIC_PODS_API_KEY, and NEXT_PUBLIC_PODS_WEBSOCKET_URL as host env names, then map them into the current DeframeProvider API config fields.
- Support both EN and PT language config.
- Add route-safe handling for EarnWidget onRouteChange.
- Add swap prefill support (fromTokenAddress, fromChainId, toTokenAddress, toChainId).
- Emit required tx lifecycle statuses: HOST_ACK, SIGNATURE_PROMPTED, TX_SUBMITTED, TX_CONFIRMED, TX_FINALIZED.
- Map user rejection errors (4001/ACTION_REJECTED) to SIGNATURE_DECLINED.

Deliverables:
1) Host provider wrapper with DeframeProvider config.
2) processBytecode implementation integrated with wallet stack.
3) EarnWidget page and SwapWidget page.
4) Environment variable documentation and integration checklist.

Acceptance Checklist for AI-generated PRs

Uses DeframeProvider with runtime NEXT_PUBLIC_PODS_API_URL and NEXT_PUBLIC_PODS_API_KEY.
Passes walletAddress from authenticated user session.
Implements processBytecode and emits required status events.
Handles rejection and error status paths explicitly.
Does not hardcode API keys or private keys in source.
Keeps host CSS scoped around .deframe-widget.
Registers config.components.SwapFormView = PodsSwapFormView at the provider level.
Includes customer-facing docs and test steps.

​Recommended LLM Inputs

​Prompt Template (Copy/Paste)

​Acceptance Checklist for AI-generated PRs

Recommended LLM Inputs

Prompt Template (Copy/Paste)

Acceptance Checklist for AI-generated PRs