Choose Your Integration Path
Amplify SDK
TypeScript / JavaScript — The fastest way to integrate. The SDK handles
ABI encoding, address resolution, token approvals, slippage, and error handling.
Works with React (wagmi), Node.js (viem), and smart wallets (Privy, Alchemy).
Direct Contract Integration
Any language — Call the vault smart contracts directly from Python, Go,
Swift, Kotlin, Flutter, or any EVM-compatible library. Full control over
transaction construction and signing.
| SDK | Direct Contract | |
|---|---|---|
| Languages | TypeScript, JavaScript | Any (Python, Go, Swift, Kotlin, Flutter, etc.) |
| Setup | npm install @paxoslabs/amplify-sdk | RPC endpoint + contract addresses + ABI |
| Address resolution | Automatic via getVaultsByConfig() | REST API or manual configuration |
| Approval handling | Automatic via prepareDepositAuthorization() | Manual approve() calls |
| Slippage protection | Built-in with configurable bps | Manual minimumMint calculation |
| Best for | Web apps, React, Node.js backends | Mobile apps, non-JS backends, full control |
SDK Path
Getting Started
Install the SDK and run your first deposit in under 10 minutes.
Guides
Step-by-step tutorials for deposits, withdrawals, and smart wallets.
API Reference
Complete function reference with parameters, return types, and examples.
Direct Contract Path
Overview & Setup
Contract architecture, address resolution, supported languages, and prerequisites.
Deposits
Standard and permit deposit flows with multi-language examples.
Withdrawals
Submit withdrawal orders and monitor status.
Cancellations
Cancel pending withdrawal orders.
Vault Queries
Read APY, TVL, fees, balances, and withdrawal history via REST API and on-chain.
Smart Contract Source
View the Nucleus BoringVault contracts on GitHub.
What’s New in v0.5.0
vaultNameMigration - All transaction functions now identify vaults byvaultNameinstead ofyieldType— migration guide- Vault Discovery - New
getVaultsByConfig()for multi-filter vault lookup byyieldType,chainId, asset addresses - Withdrawal Assets - New
getWithdrawSupportedAssets()to fetch all supported withdrawal assets grouped by token - Cache Management - Fully documented
initializeCache(),getCache(),refreshVaultCache(),isCacheReady(),waitForCacheReady()
Quick Links
Concepts
Understand vaults, yield types, permits, and slippage controls.
Troubleshooting
Common issues, error codes, and debugging strategies.
Types Reference
TypeScript types, enums, and discriminated unions.
Changelog
Version history and migration guides.
SDK AI Reference
Condensed SDK reference optimized for Cursor, Copilot, and Claude.
Contract AI Reference
Condensed contract integration reference for AI coding assistants.