Solana Transaction Builder

post

Returns a base64 transaction to initiate a Nest vault mint. Deposits USDC from Solana to mint Nest share tokens, which are delivered to the receiver's Solana wallet.

The transaction includes: (1) Creating the receiver's Nest share token ATA if it doesn't exist, (2) Creating the CCTP MessageSent event data account (rent funded by Nest keeper), (3) CCTP depositForBurn instruction to bridge USDC to Plume.

On Plume, the NestVaultComposer receives the USDC, mints vault shares, and sends them back to the receiver via LayerZero OFT. The transaction is pre-signed by the Nest keeper; the caller only needs to sign with the receiver wallet and broadcast.

Body

application/json

rawAmountUsdcintegerOptional

Amount of USDC to deposit, in raw base units (6 decimals). For example, 1000000 (1e6) represents 1.0 USDC.

Example: 1000000

amountUsdcintegerOptionalDeprecated

DEPRECATED: Use rawAmountUsdc instead. Amount of USDC in raw base units (6 decimals).

finalitystring · enumOptional

CCTP finality mode. 'fast' (~1-2 min) has higher fees, 'standard' (~15 min) has lower fees.

Default: standardExample: fastPossible values:

nestVaultSlugstringRequired

Slug identifying the Nest vault. Valid options: nest-alpha-vault, nest-treasury-vault, nest-basis-vault, nest-wisdom-vault, nest-opal-vault, nest-test-vault, nest-scope-vault, nest-lcrd-vault, nest-perena-vault.

Example: nest-alpha-vault

receiverstring · min: 1Required

Base58-encoded Solana public key of the user who will receive the minted Nest share tokens and pay the transaction fees.

Example: CFagSTMBFiMaD4YKHr7mMcKTzpi35DqiBKbDA35BvZgr

priorityFeestring · enumOptional

Optional dynamic priority fee level. The API fetches recent prioritization fees for all transaction accounts and selects low/median/high.

Example: mediumPossible values:

priorityFeeMaxLamportsintegerOptional

Optional maximum total priority fee in lamports. If provided, it takes precedence over priorityFee.

Example: 7500

Responses

200

Transaction built successfully.

application/json

400

Bad request

application/json

403

Receiver wallet failed compliance check

application/json

500

Internal server error

application/json

post

/solana/nest/mint/build-tx

HTTPcURLJavaScriptPython

POST /v1/solana/nest/mint/build-tx HTTP/1.1
Host: api.nest.credit
Content-Type: application/json
Accept: */*
Content-Length: 189

{
  "rawAmountUsdc": 1000000,
  "finality": "fast",
  "nestVaultSlug": "nest-alpha-vault",
  "receiver": "CFagSTMBFiMaD4YKHr7mMcKTzpi35DqiBKbDA35BvZgr",
  "priorityFee": "medium",
  "priorityFeeMaxLamports": 7500
}

{
  "data": {
    "txBase64": "text"
  }
}

post

Returns a base64 transaction to initiate a Nest vault redeem for USDC.

Under the hood, this builds a LayerZero OFT send transaction that transfers Nest shares to the vault's NestVaultComposer contract on Plume, which processes the redemption and returns USDC via CCTP bridge.

The transaction must be signed and sent by the caller's wallet.

Body

application/json

rawAmountNestTokenintegerOptional

Amount of Nest share tokens to redeem, in raw base units (6 decimals). For example, 1000000 (1e6) represents 1.0 Nest share token.

Example: 1000000

amountNestintegerOptionalDeprecated

DEPRECATED: Use rawAmountNestToken instead. Amount of Nest shares in raw base units (6 decimals).

nestVaultSlugstringRequired

Slug identifying the Nest vault. Valid options: nest-alpha-vault, nest-treasury-vault, nest-basis-vault, nest-wisdom-vault, nest-opal-vault, nest-test-vault, nest-scope-vault, nest-lcrd-vault, nest-perena-vault.

Example: nest-alpha-vault

ownerstring · min: 1Required

Base58-encoded Solana public key of the user who owns the Nest share tokens and will pay the transaction fees.

Example: CFagSTMBFiMaD4YKHr7mMcKTzpi35DqiBKbDA35BvZgr

dstEidintegerOptionalDeprecated

DEPRECATED: This field is ignored. Destination is always Plume mainnet.

priorityFeestring · enumOptional

Optional dynamic priority fee level. The API fetches recent prioritization fees for all transaction accounts and selects low/median/high.

Example: mediumPossible values:

priorityFeeMaxLamportsintegerOptional

Optional maximum total priority fee in lamports. If provided, it takes precedence over priorityFee.

Example: 20000

Responses

200

Transaction built successfully.

application/json

400

Bad request

application/json

500

Internal server error

application/json

post

/solana/nest/redeem/build-tx

HTTPcURLJavaScriptPython

POST /v1/solana/nest/redeem/build-tx HTTP/1.1
Host: api.nest.credit
Content-Type: application/json
Accept: */*
Content-Length: 174

{
  "rawAmountNestToken": 1000000,
  "nestVaultSlug": "nest-alpha-vault",
  "owner": "CFagSTMBFiMaD4YKHr7mMcKTzpi35DqiBKbDA35BvZgr",
  "priorityFee": "medium",
  "priorityFeeMaxLamports": 20000
}

{
  "data": {
    "txBase64": "text"
  }
}