> For the complete documentation index, see [llms.txt](https://perena.gitbook.io/perena/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://perena.gitbook.io/perena/developers/overview.md).

# Overview

SDKs, APIs and on-chain addresses for building on Perena

Everything you need to read Perena data, move funds through Perena vaults, or run a vault of your own.

## Pick your surface

| You want to                                                                              | Use                                                                                                                       | Where it runs             |
| ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
| Read live USD\* price, TVL and tranche state straight from chain                         | [Vault SDK](https://perena.gitbook.io/perena/developers/vault-sdk.md)                                                     | On-chain (Solana mainnet) |
| Deposit, withdraw, or move between USD\*, USD\*P and USD\*J from your own app or program | [Deposits and withdrawals](https://perena.gitbook.io/perena/developers/vault-sdk/deposits-and-withdrawals.md)             | On-chain                  |
| Show historical price, APY, earnings and transparency data                               | [Perena API](https://perena.gitbook.io/perena/developers/perena-api.md)                                                   | REST, read-only           |
| Run or operate a curator vault                                                           | [Curator and operator functions](https://perena.gitbook.io/perena/developers/vault-sdk/curator-and-operator-functions.md) | On-chain + scripts        |
| Maintain an integration built on the pre-V2 USD\* program                                | [Legacy USD\* SDK](https://perena.gitbook.io/perena/developers/legacy-usd-sdk.md)                                         | On-chain                  |
| Trade on Numéraire (the Perena AMM)                                                      | [Numeraire SDK](https://github.com/quineco/numeraire-sdk)                                                                 | On-chain                  |

{% hint style="info" %}
The Vault SDK is the source of truth for anything that signs a transaction or needs a live number. The API serves snapshots and history for dashboards and reporting. Do not use the API as a price oracle.
{% endhint %}

## Addresses

All Perena contracts run on Solana mainnet. There are two deployments of the vault program: **prod** is the live product, **test** is a separate mainnet deployment used for integration testing.

| What                                     | Address                                        |
| ---------------------------------------- | ---------------------------------------------- |
| Vault program (prod)                     | `save8RQVPMWNTzU18t3GBvBkN9hT7jsGjiCQ28FpD9H`  |
| Vault program (test)                     | `6HyT8NQDpXY5wGkvX7haQVJ5nGUBVXQSkaT6Nf7fbsuJ` |
| USD\* vault account (vault id 0, prod)   | `ECJGrTZ6QYMEwiEAnL4oReWF126uc22e9Lojy9qyCjHT` |
| USD\* mint                               | `star9agSpjiFe3M49B3RniVU4CMBBEK3Qnaqn3RGiFM`  |
| USD\*J mint (junior tranche)             | `3AJYCjrhKitmBd8tRUurPA5dGHCAQh6A8L9DkuSC37Rm` |
| USD\*P mint (protected / senior tranche) | `CPFZ7wUFpg5obsGB2GKXQ8rPY5ALuxs87dEjQjsrVxWw` |
| USDC mint (deposit asset)                | `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v` |

USD\*, USD\*P and USD\*J all live on the **same vault account**. USD\* is the regular share; USD\*P and USD\*J are its senior and junior tranches, tracked in a tranche-state account attached to the vault. USDC and every share mint use **6 decimals**.

## Packages

| Package                                                                        | Version | Purpose                                                             |
| ------------------------------------------------------------------------------ | ------- | ------------------------------------------------------------------- |
| [`@perena/vault-sdk`](https://www.npmjs.com/package/@perena/vault-sdk)         | current | Vault V2: accounts, quotes, transaction builders, operator services |
| [`@perena/bankineco-sdk`](https://www.npmjs.com/package/@perena/bankineco-sdk) | legacy  | Pre-V2 USD\* mint/burn/stake flows. Kept for existing integrations  |

Source: [github.com/quineco/bankineco](https://github.com/quineco/bankineco) (`typescript/vault_sdk`).

## Support

For integration questions, email <help@perena.org> or reach the team on Discord. If you are building a deployment venue, a redemption venue, or a nested vault, read [For Partners](https://perena.gitbook.io/perena/protocol/perena-vault-v2/for-partners.md) first.
