nLCRD Integration

nLCRD is the Nest Liquid Credit Vault. This page is organized around the recommended Actions API path first, then the direct contract path for advanced EVM integrations, plus the Solana transaction-builder flow.

Outline

• Quick reference
• Supported assets
• EVM Integration:
  • Actions API (recommended)
  • Direct onchain
• Solana Integration
• Errors and edge cases
• Implementation notes

Quick reference

Field	Value
Vault	Nest Liquid Credit Vault
Symbol	nLCRD
Slug	nest-lcrd-vault
EVM share token	0xdf45b8322ea4ce898331602e2d1f3d1a67ae0ee8
Share decimals	6
EVM Actions API base URL	https://api.nest.credit/v1/actions
Solana API base URL	https://api.nest.credit/v1/solana
Solana share mint	14BM5Nvq2kuJPn4vFNqiPM3XSBzVaqEjZrDT7ZYLS2nB
Solana USDC mint	EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

Supported assets

EVM

Chain	Deposit or redemption asset	nLCRD NestVault	Decimals
Plume98866	USDC0x2223…a7af	0x7195…6c8e	6
Plume98866	pUSD0xdddd…6f3f	0x67b2…edc2	6
Ethereum1	USDC0xa0b8…eb48	0x7195…6c8e	6

Solana

Field	Value
nLCRD SPL mint	14BM5N…S2nB
OFT program ID	ChEfPd…j1th
OFT config key	9AM7Mf…2Wca
Solana USDC mint	EPjFWd…Dt1v
Plume NestVaultComposer for nLCRD	0x63c7…6295

EVM Integration

Actions API (recommended)

Use the EVM Actions API when your app wants Nest to handle quote construction, vault selection, Predicate compliance checks, calldata encoding, and transaction simulation for nLCRD. The API returns transactions that your app signs and sends with the user’s EVM wallet.

This section covers:

• Mint quote
• Build mint transactions
• Redeem quote
• Build redemption transactions
• Pending, update, and claim
• Instant redemption

The base URL is:

https://api.nest.credit/v1/actions

All amounts are raw base-unit integer strings. Do not send decimal UI amounts.

Mint quote

Use the quote route before building transactions. This returns the expected raw share amount, decimals, fee fields, rate fields, and a preview of the transaction steps.

curl -X POST https://api.nest.credit/v1/actions/vaults/nest-lcrd-vault/mint/quote \
  -H 'content-type: application/json' \
  -d '{
    "depositAsset": "0x222365ef19f7947e5484218551b56bb3965aa7af",
    "depositAmount": "1000000",
    "chainId": 98866
  }'

Example response shape:

{
  "data": {
    "slug": "nest-lcrd-vault",
    "shareTokenAddress": "0xdf45b8322ea4ce898331602e2d1f3d1a67ae0ee8",
    "depositAsset": "0x222365ef19f7947e5484218551b56bb3965aa7af",
    "depositAmount": "1000000",
    "depositDecimals": 6,
    "shareAmount": "...",
    "shareDecimals": 6,
    "rate": "...",
    "rateDecimals": 6,
    "feeAmount": "0",
    "fees": {
      "ratePpm": 0,
      "flatAmount": "0",
      "maxRatePpm": 0,
      "maxFlatAmount": "0"
    },
    "steps": [
      { "label": "approve", "description": "Approve PredicateProxy to spend the deposit asset" },
      { "label": "deposit", "description": "Deposit through NestVaultPredicateProxy" }
    ]
  }
}

steps is a preview. The actual build-tx response may omit approve if the wallet already has sufficient allowance.

Build mint transactions

Use build-tx when the user is ready to deposit. The recipient is the EVM address that signs as depositor and receives the minted nLCRD shares.

curl -X POST https://api.nest.credit/v1/actions/vaults/nest-lcrd-vault/mint/build-tx \
  -H 'content-type: application/json' \
  -d '{
    "depositAsset": "0x222365ef19f7947e5484218551b56bb3965aa7af",
    "depositAmount": "1000000",
    "chainId": 98866,
    "recipient": "0x00000000000000000000000000000000000000ab"
  }'

Submit the returned transactions in order. Every returned transaction uses the chain ID from the request. By default, the API simulates the transaction bundle before returning it. User-facing apps should generally keep simulation enabled.

Redeem quote

Use the redeem quote route before submitting a redemption. This quotes the redemption asset amount and validates the selected asset for this vault.

curl -X POST https://api.nest.credit/v1/actions/vaults/nest-lcrd-vault/redeem/quote \
  -H 'content-type: application/json' \
  -d '{
    "redemptionAsset": "0x222365ef19f7947e5484218551b56bb3965aa7af",
    "shareAmount": "1000000",
    "chainId": 98866
  }'

For this guide, treat the NestVault redemption flow as the supported redemption path. If an integration receives an unsupported route value, surface it as an integration error instead of trying to fall back to a different contract flow.

Build redemption transactions

Use this route to submit a redemption request on the same EVM chain.

curl -X POST https://api.nest.credit/v1/actions/vaults/nest-lcrd-vault/redeem/build-tx \
  -H 'content-type: application/json' \
  -d '{
    "redemptionAsset": "0x222365ef19f7947e5484218551b56bb3965aa7af",
    "shareAmount": "1000000",
    "chainId": 98866,
    "user": "0x00000000000000000000000000000000000000ab"
  }'

NestVault redemptions return:

• approve, if the selected NestVault does not already have sufficient share-token allowance.
• requestRedeem, to submit the asynchronous redemption request.

After the request becomes claimable, use the claim routes below.

Pending, update, and claim

For NestVault-backed redemptions:

curl -X POST https://api.nest.credit/v1/actions/vaults/nest-lcrd-vault/claim/pending \
  -H 'content-type: application/json' \
  -d '{
    "redemptionAsset": "0x222365ef19f7947e5484218551b56bb3965aa7af",
    "chainId": 98866,
    "user": "0x00000000000000000000000000000000000000ab"
  }'

curl -X POST https://api.nest.credit/v1/actions/vaults/nest-lcrd-vault/claim/build-tx \
  -H 'content-type: application/json' \
  -d '{
    "redemptionAsset": "0x222365ef19f7947e5484218551b56bb3965aa7af",
    "chainId": 98866,
    "user": "0x00000000000000000000000000000000000000ab"
  }'

claim/build-tx builds a transaction to claim all currently claimable shares for the selected NestVault and user.

The update routes are for reducing an existing pending redemption:

POST /vaults/nest-lcrd-vault/update-redeem/pending
POST /vaults/nest-lcrd-vault/update-redeem/build-tx

newShareAmount is the final pending share amount, not the delta to remove.

Instant redemption

When instant liquidity is available for the selected asset, use:

POST /vaults/nest-lcrd-vault/instant-redeem/quote
POST /vaults/nest-lcrd-vault/instant-redeem/liquidity
POST /vaults/nest-lcrd-vault/instant-redeem/build-tx

The instant-redeem request body uses redemptionAsset, shareAmount, chainId, and user. receiver is optional and defaults to user.

Direct onchain

Use direct contracts only when your integration needs lower-level control than the Actions API provides. This path requires you to handle the full flow yourself:

This section covers:

• Main contracts
• Direct mint outline
• Direct redeem outline

For a direct integration, you handle:

• Validate the selected chain, vault slug, and asset.
• Check Predicate compliance and obtain a valid Predicate message.
• Read the correct NestVault for the asset.
• Quote shares or redemption assets.
• Apply any app-level slippage or UX checks.
• Submit ERC-20 approvals.
• Submit deposit, redeem, update, instant-redeem, or claim calls.
• Track asynchronous redemption state.

Main nLCRD contracts

Contract	Address
nLCRD share token	0xdf45…0ee8
NestVaultPredicateProxy	0xfc0c…9035
USDC NestVault (Plume, Ethereum)	0x7195…6c8e
pUSD NestVault (Plume)	0x67b2…edc2

For accountants, roles, and other shared protocol contracts, use the Smart Contracts page as the source of truth.

Direct mint outline

For nLCRD minting, the direct flow is:

1. Read the NestVault for the selected deposit asset and chain.
2. Call previewDeposit(depositAmount) on that NestVault to estimate shares after fees.
3. Get a Predicate message for the user and chain.
4. Approve NestVaultPredicateProxy to spend the deposit asset.
5. Call NestVaultPredicateProxy.deposit(depositAsset, depositAmount, recipient, nestVault, predicateMessage).

Minimal TypeScript outline:

import { encodeFunctionData, parseUnits } from "viem";

const chainId = 98866;
const recipient = "0x00000000000000000000000000000000000000ab";
const depositAsset = "0x222365ef19f7947e5484218551b56bb3965aa7af";
const depositAmount = parseUnits("1", 6);
const nestVault = "0x7195de4eab3e43910e3bad93882a7b15b9eb6c8e";
const predicateProxy = "0xfc0c4222b3a0c9b060c0b959dec62442036b9035";

// 1. previewDeposit on nestVault
// 2. get Predicate message for recipient
// 3. approve depositAsset -> predicateProxy
// 4. encode PredicateProxy deposit call
const data = encodeFunctionData({
  abi: NestVaultPredicateProxyAbi,
  functionName: "deposit",
  args: [depositAsset, depositAmount, recipient, nestVault, predicateMessage],
});

The Actions API’s mint/build-tx route performs these steps for app integrations and is the preferred reference for expected calldata shape.

Direct redeem outline

For nLCRD redemptions, use the selected NestVault for the redemption asset:

1. Approve the NestVault to spend nLCRD shares, if allowance is insufficient.
2. Call NestVault.requestRedeem(shareAmount, user, user).
3. Wait until shares become claimable.
4. Call NestVault.redeem(claimableShares, user, user) to claim the redemption asset.

If you need to reduce a pending redemption before it is claimable, call NestVault.updateRedeem(newShareAmount, user, user).

Solana Integration

Use the Solana transaction-builder endpoints or the browser SDK. The API returns a base64-encoded Solana VersionedTransaction; the user’s wallet signs and broadcasts it.

This section covers:

• Build Solana mint transaction
• Build Solana redeem transaction
• Browser SDK pattern

The base URL is:

https://api.nest.credit/v1/solana

Build Solana mint transaction

curl -X POST https://api.nest.credit/v1/solana/nest/mint/build-tx \
  -H 'content-type: application/json' \
  -d '{
    "rawAmountUsdc": 1000000,
    "finality": "standard",
    "nestVaultSlug": "nest-lcrd-vault",
    "receiver": "CFagSTMBFiMaD4YKHr7mMcKTzpi35DqiBKbDA35BvZgr"
  }'

Response shape:

{
  "data": {
    "txBase64": "..."
  }
}

The returned transaction:

• Deposits Solana USDC through CCTP.
• Routes to Plume for the nLCRD mint.
• Delivers nLCRD back to the receiver as an SPL token through LayerZero OFT.
• Is pre-signed where needed by Nest keeper infrastructure.
• Still requires the receiver wallet signature before broadcast.

finality can be standard or fast. fast uses the 1 bp CCTP fast-finality fee and is expected to settle faster.

Build Solana redeem transaction

curl -X POST https://api.nest.credit/v1/solana/nest/redeem/build-tx \
  -H 'content-type: application/json' \
  -d '{
    "rawAmountNestToken": 1000000,
    "nestVaultSlug": "nest-lcrd-vault",
    "owner": "CFagSTMBFiMaD4YKHr7mMcKTzpi35DqiBKbDA35BvZgr"
  }'

Response shape:

{
  "data": {
    "txBase64": "..."
  }
}

The Solana redeem builder sends nLCRD SPL shares through the OFT path to the nLCRD composer on Plume. The Plume-side flow processes redemption and returns USDC through CCTP.

dstEid is deprecated for the Solana redeem endpoint. The destination is Plume mainnet.

Browser SDK pattern

The direct Solana API uses rawAmountUsdc. This browser SDK version forwards an amountUsdc field to the API, so pass the raw 6-decimal base-unit amount when using this wrapper.

import { Connection } from "@solana/web3.js";
import { createNestBrowserClient } from "nest-sdk";

const connection = new Connection("https://api.mainnet-beta.solana.com", "confirmed");

const client = createNestBrowserClient({
  connection,
  wallet,
  config: {
    nestApiBaseUrl: "https://api.nest.credit",
  },
});

await client.mintNestToSolana({
  nestVaultSlug: "nest-lcrd-vault",
  amountUsdc: 1000000,
  finality: "standard",
});

The SDK delegates transaction construction to the API, asks the user’s wallet to sign, and sends the signed transaction on Solana.

Errors and edge cases

Condition	Expected behavior
Unsupported vault slug	API returns 400.
Unsupported chain ID	EVM Actions API returns 400.
Unsupported asset for the selected chain	API returns 400.
Non-compliant wallet	EVM mint build returns 400; Solana mint build returns 403.
Deposit too small to mint shares	EVM quote/build returns 400.
Failed transaction simulation	EVM build-tx returns 400 unless skipSimulation is true.
RPC, indexer, or Predicate service issue	API returns 500.
Existing allowance is sufficient	approve may be omitted from returned transactions.

Implementation notes

• Treat every API amount as a raw integer amount.
• Use the API’s returned depositDecimals, shareDecimals, and redemptionDecimals when rendering UI values.
• Execute returned EVM transactions in order.
• Never assume approve is present. Render and execute the returned transactions[].
• Do not reuse quotes indefinitely. Re-quote close to the time the user signs.
• For direct contract integrations, prefer the registry and Smart Contracts page over copying addresses from old integration examples.