# Paxos Labs Documentation

> Paxos Labs builds infrastructure for stablecoin yield. The Amplify SDK is a TypeScript library that lets developers integrate deposits and withdrawals into DeFi vaults across multiple EVM chains.

## SDK Version

The current SDK version is **1.0.0**. All links below point to the latest version.

## API Specification

- [OpenAPI Spec (REST)](https://docs.paxoslabs.com/v1.0.0/api-reference/openapi.yml): Backend REST API for vault analytics, withdrawal requests, and address book management.

## Getting Started

- [Overview](https://docs.paxoslabs.com/v1.0.0/intro/products/earn/developers/index): SDK overview and integration paths
- [Project setup](https://docs.paxoslabs.com/v1.0.0/intro/products/earn/developers/guides/project-setup): Install, configure, and instantiate AmplifyClient
- [Concepts](https://docs.paxoslabs.com/v1.0.0/intro/products/earn/developers/getting-started/concepts): Vaults, share tokens, deposit/withdraw flows
- [Deposits guide](https://docs.paxoslabs.com/v1.0.0/intro/products/earn/developers/guides/deposits): End-to-end deposit flow with permit and approval paths
- [Withdrawals guide](https://docs.paxoslabs.com/v1.0.0/intro/products/earn/developers/guides/withdrawals): Submit, list, and cancel withdrawal orders
- [Smart Wallets](https://docs.paxoslabs.com/v1.0.0/intro/products/earn/developers/guides/smart-wallets): Smart wallet detection and authorization routing
- [Multi-Chain](https://docs.paxoslabs.com/v1.0.0/intro/products/earn/developers/guides/multi-chain): Cross-chain vault operations
- [Migrating from 0.5.x](https://docs.paxoslabs.com/v1.0.0/intro/products/earn/developers/migrating-from-0-5): Breaking changes and upgrade guide

## SDK Reference (v1.0.0 AmplifyClient)

The SDK uses a subclient pattern. Create `AmplifyClient` once, then call methods on its subclients:

```ts
import { AmplifyClient } from '@paxoslabs/amplify-sdk'

const client = new AmplifyClient({ apiKey: process.env.PAXOS_LABS_API_KEY })

// Vaults subclient
await client.amplify.vaults.list({ filter: 'chainId=1' })
await client.amplify.vaults.listAssets({ filter: 'chainId=1' })
await client.amplify.vaults.getApys({ filter: 'chainId=1' })
await client.amplify.vaults.getTvls({ filter: 'chainId=1' })

// Authorization subclient
await client.core.authorization.authorize({ vaultAddress, tokenAddress, amount, userAddress, chainId })

// Deposit subclient
await client.amplify.deposit.prepareDeposit({ vaultAddress, depositAsset, depositAmount, userAddress, chainId })

// Withdraw subclient
await client.amplify.withdraw.prepareWithdrawal({ vaultAddress, wantAsset, shareAmount, userAddress, chainId })
await client.amplify.withdraw.listRequests({ filter: 'userAddress=0x...' })
await client.amplify.withdraw.cancel({ vaultAddress, orderIndex, chainId })
await client.amplify.withdraw.calculateFee({ offerAmount, wantAsset, vaultAddress, chainId })
```

## AI Coding References

- [SDK AI Reference](https://docs.paxoslabs.com/v1.0.0/intro/products/earn/developers/sdk-ai-reference): Condensed single-page SDK reference optimized for AI context windows (Cursor, Copilot, Claude). Copy this page into your AI assistant for accurate completions.
- [Direct Contract AI Reference](https://docs.paxoslabs.com/v1.0.0/intro/products/earn/developers/direct-contract-ai-reference): On-chain integration reference for direct contract calls without the SDK.
- [API Calldata AI Reference](https://docs.paxoslabs.com/v1.0.0/intro/products/earn/developers/api-calldata-ai-reference): REST endpoint reference for server-side / non-JS integrations.

## Direct Contract Integration

For non-JS backends or direct on-chain interaction:

- [Direct Contract Overview](https://docs.paxoslabs.com/v1.0.0/intro/products/earn/developers/guides/direct-contract/index): Integration without the SDK
- [Direct Contract Setup](https://docs.paxoslabs.com/v1.0.0/intro/products/earn/developers/guides/direct-contract/setup): RPC setup and contract addresses
- [Direct Deposits](https://docs.paxoslabs.com/v1.0.0/intro/products/earn/developers/guides/direct-contract/deposits): Deposit via Teller contract
- [Direct Withdrawals](https://docs.paxoslabs.com/v1.0.0/intro/products/earn/developers/guides/direct-contract/withdrawals): Withdraw via WithdrawQueue contract

## API Calldata Integration

For server-side calldata generation via REST API:

- [API Calldata Overview](https://docs.paxoslabs.com/v1.0.0/intro/products/earn/developers/guides/api-calldata/index): REST API for transaction calldata
- [API Calldata Deposits](https://docs.paxoslabs.com/v1.0.0/intro/products/earn/developers/guides/api-calldata/deposits): Deposit calldata endpoints
- [API Calldata Withdrawals](https://docs.paxoslabs.com/v1.0.0/intro/products/earn/developers/guides/api-calldata/withdrawals): Withdrawal calldata endpoints

## Troubleshooting & Changelog

- [Troubleshooting](https://docs.paxoslabs.com/v1.0.0/intro/products/earn/developers/troubleshooting): Common issues, error codes, and debugging strategies
- [Changelog](https://docs.paxoslabs.com/v1.0.0/intro/products/earn/developers/changelog): Version history, migration guides, and breaking changes